N03

📁 Gestionnaire de Notes CLI

fs.promises

Un outil en ligne de commande pour gérer vos notes, construit avec Node.js et le module fs.promises. Les notes sont persistées dans un fichier notes.json. Aucune dépendance externe — uniquement la bibliothèque standard Node.js.

▶ Lancer le projet

# 1. Aller dans le dossier
cd 03-filesystem/mini-projet

# 2. Aucune installation nécessaire (pas de dépendances)
# Le projet utilise uniquement les modules natifs Node.js

# 3. Utiliser directement
node app.js

Commandes disponibles

Commande	Description	Exemple
`node app.js add "texte"`	Ajouter une note	`node app.js add "Apprendre async/await"`
`node app.js list`	Lister toutes les notes	`node app.js list`
`node app.js delete <id>`	Supprimer une note par ID	`node app.js delete 1700000000000`
`node app.js search <terme>`	Rechercher dans les notes	`node app.js search async`

Exemple de session

$ node app.js add "Apprendre async/await avec fs.promises"
✓ Note ajoutée (ID: 1700000000001)
   → "Apprendre async/await avec fs.promises"

$ node app.js add "Relire le cours N03 sur les streams"
✓ Note ajoutée (ID: 1700000000002)

$ node app.js list
╔═══ Notes (2) ═══════════════════════════════╗
║ [1700000000001] Apprendre async/await avec fs.promises
║     15/11/2024 10:30
║ [1700000000002] Relire le cours N03 sur les streams
║     15/11/2024 10:31
╚═══════════════════════════════════════════════════╝

✓ 2 note(s) au total.

$ node app.js search async
✓ 1 résultat(s) pour "async" :
╔═══ Notes (1) ═══════════════════════════════╗
║ [1700000000001] Apprendre async/await avec fs.promises
║     15/11/2024 10:30
╚═══════════════════════════════════════════════════╝

$ node app.js delete 1700000000001
✓ Note supprimée : "Apprendre async/await avec fs.promises"

Structure de notes.json

[
  {
    "id": 1700000000001,
    "texte": "Apprendre async/await avec fs.promises",
    "date": "2024-11-15T09:30:00.001Z"
  },
  {
    "id": 1700000000002,
    "texte": "Relire le cours N03 sur les streams",
    "date": "2024-11-15T09:31:00.002Z"
  }
]

Concepts N03 illustrés

fs.promises.readFile() — lecture asynchrone avec async/await
fs.promises.writeFile() — écriture atomique du fichier JSON
path.join(__dirname, ...) — chemin absolu vers notes.json
JSON.parse / JSON.stringify — sérialisation des données
Gestion d'erreur ENOENT — fichier absent au premier lancement
IIFE async (async () => { ... })() — point d'entrée asynchrone
process.argv — lecture des arguments CLI

Code source — app.js

/* Chargement... */

⚠️ Ce projet tourne localement — Node.js doit être installé. Aucun npm install nécessaire : ce projet n'utilise que les modules natifs de Node.js (fs, path). Téléchargez Node.js sur nodejs.org.

← Cours N03 N04 — HTTP Natif →