ich-324-p04-tom

Module npm réalisé dans le cadre du cours ICH-324 – Prendre en charge des processus DevOps avec des outils logiciels (exercice P04 – Packages et dépendances).

Utilisation

npm install ich-324-p04-tom

const myLib = require('ich-324-p04-tom');

console.log(myLib.hello('Tom'));      // Hello, Tom!
console.log(myLib.shout('it works')); // IT WORKS!!!

| Fonction | Description | | -------------- | --------------------------------------------------- | | hello(name) | Retourne Hello, <name>! | | shout(word) | Retourne le mot en majuscules suivi de !!! |

Opérations réalisées

Exercice 1 – Prérequis

1. Vérification de Node.js et npm : node -v / npm -v
2. Création d'un compte gratuit sur npmjs.com
3. Connexion au compte GitHub
4. Initialisation du projet : npm init (nom : ich-324-p04-tom, en minuscules car npm refuse les majuscules dans les noms de packages)
5. Initialisation du dépôt git : git init
6. Création du dépôt GitHub ICH-324-P04-tom et push du projet :

   git remote add origin https://github.com/kaitoooooooooooooooooooo/ICH-324-P04-tom.git
   git push -u origin main

Exercice 2 – Publication sur npmjs.com

1. Ajout du code du module dans index.js (fonctions hello et shout, exportées via module.exports)
2. Génération d'un access token sur npmjs.com (Access Tokens → Generate New Token) :
   • Token name : ICH-324
   • Bypass two-factor authentication : coché
   • Packages and scopes : Read and write
   • Select packages : All packages
   • Expiration : 90 jours
3. Configuration du token dans npm :

   npm config set //registry.npmjs.org/:_authToken="<token>"

   Le token est enregistré dans le .npmrc de l'utilisateur, jamais dans le dépôt (.npmrc est dans le .gitignore).
4. Publication :

   npm publish --access public

5. Vérification sur https://www.npmjs.com/package/ich-324-p04-tom : version, README affiché, fichiers publiés, nombre de téléchargements, dépendances (aucune), lien vers le dépôt GitHub. En ligne de commande : npm view ich-324-p04-tom.
6. Documentation dans ce README, commit et push.

Publier une nouvelle version

npm refuse de republier un numéro de version existant. Il faut l'incrémenter (SemVer) avant chaque publication :

npm version patch   # 1.0.0 -> 1.0.1 (correctif)
npm version minor   # 1.0.0 -> 1.1.0 (nouvelle fonctionnalité compatible)
npm version major   # 1.0.0 -> 2.0.0 (changement cassant)
npm publish

Tests

npm test