Installer des outils : brew, apt, npm
Un gestionnaire de paquets installe un logiciel en une commande, avec tout ce dont il a besoin, et sait le mettre à jour ou le retirer proprement.
Le problème
Le projet dépend déjà de deux gestionnaires, sans le dire :
- le jeu a besoin de
pygameetpillow, installés parpipà partir derequirements.;txt - sa documentation, comme ce site de formation, a besoin de
zudoku,reactetmermaid, installés parnpmà partir d'un fichierpackage.json.
Et pour avoir python et node eux-mêmes, il faut un troisième outil : brew sur macOS, apt sur Ubuntu ou Debian.
Quand on ne sait pas lequel fait quoi, on finit par copier des commandes trouvées en ligne. La deuxième ligne du README en est la trace : pip install - ne fait pas ce que son auteur voulait. La bonne option est -r.
La notion
Paquet, dépendance, dépôt
| Mot | Sens |
|---|---|
| Paquet | Un logiciel ou une bibliothèque, prêt à être installé |
| Dépendance | Un paquet dont un autre a besoin pour fonctionner |
| Dépôt, ou registre | Le serveur où le gestionnaire télécharge les paquets |
| Version | Le numéro qui identifie un état précis du paquet |
Le gestionnaire résout les dépendances à notre place : demander zudoku installe aussi les centaines de paquets dont il a besoin.
Deux niveaux
La règle : les outils s'installent au niveau système, les bibliothèques d'un projet s'installent dans le dossier du projet.
Les commandes, côte à côte
| Action | brew | apt | pip | npm |
|---|---|---|---|---|
| Installer | brew install git | sudo apt install git | pip install pygame | npm install mermaid |
| Retirer | brew uninstall git | sudo apt remove git | pip uninstall pygame | npm uninstall mermaid |
| Lister | brew list | apt list -- | pip list | npm list |
| Chercher | brew search node | apt search node | sur pypi.org | npm search mermaid |
| Mettre à jour | brew upgrade | sudo apt upgrade | pip install -- | npm update |
| Tout installer d'un projet | pip install - | npm install |
brew, sur macOS
Homebrew n'est pas fourni avec macOS : on l'installe une fois, avec la commande donnée sur son site.
Bash
Une formula est un outil en ligne de commande, un cask une application avec fenêtre. brew s'utilise sans sudo.
apt, sur Debian et Ubuntu
apt est fourni avec le système. C'est lui qu'on utilisera sur un serveur ou dans une machine virtuelle.
Bash
sudo lance la commande avec les droits d'administrateur, et demande le mot de passe. Il est nécessaire parce qu'apt modifie le système.
npm, pour JavaScript
npm arrive avec Node.js. Contrairement à brew et apt, il travaille dans le dossier du projet.
| Fichier ou dossier | Rôle | Dans Git ? |
|---|---|---|
package.json | Les dépendances voulues et les scripts du projet | Oui |
package- | Les versions exactes réellement installées | Oui |
node_ | Les paquets téléchargés | Non |
Le package.json de ce site, à la racine du dépôt :
JSON
Bash
L'option -g installe un paquet pour toute la machine. À réserver aux outils qu'on utilise partout, jamais aux dépendances d'un projet.
pip et npm : le même schéma
Les deux font le même travail pour deux langages.
| Rôle | Python | JavaScript |
|---|---|---|
| Gestionnaire | pip | npm |
| Liste des dépendances | requirements. | package.json |
| Versions exactes | requirements. avec == | package- |
| Dossier d'installation | .venv/ | node_ |
| Isolation par projet | À créer avec python3 - | Automatique |
| Dépôt public | pypi.org | npmjs.com |
Figer les versions
Sans version précise, deux personnes qui installent le projet à un mois d'écart n'obtiennent pas les mêmes paquets. Le jour où une bibliothèque change de comportement, le jeu marche chez l'un et pas chez l'autre.
Le requirements. du projet le fait correctement :
Code
| Écriture | Sens |
|---|---|
pygame== | Exactement cette version |
pygame>=2.6 | Cette version ou plus récente |
"^11.17.2" dans package.json | 11.17.2 ou plus, mais pas 12 |
Les trois nombres d'une version se lisent majeur.mineur.correctif. Par convention, un changement de majeur peut casser du code existant, un changement de mineur ajoute sans casser, un correctif répare.
Dans le projet
Les deux lignes du README, corrigées et dans le bon ordre :
Bash
Et quand on ajoute une dépendance, par exemple pytest :
Bash
pip freeze écrit tout ce qui est installé dans l'environnement. D'où l'importance de l'environnement virtuel : sans lui, le fichier se remplit des paquets de tous les autres projets de la machine.
Les précautions
- Installer peu. Chaque paquet est du code écrit par quelqu'un d'autre, qui s'exécute sur la machine.
- Vérifier le nom. Des paquets malveillants portent des noms proches de paquets connus.
- Lire avant de coller. Une commande du type
curl ...télécharge un script et l'exécute sans qu'on l'ait lu.| bash - Ne pas mettre
sudodevantpipounpm. Si une installation demande des droits d'administrateur, c'est qu'elle ne se fait pas dans le dossier du projet.
À retenir
brewetaptinstallent des outils sur la machine.pipetnpminstallent des bibliothèques dans un projet.- La liste des dépendances va dans Git, le dossier des paquets installés n'y va pas.
apt updaterafraîchit la liste,apt upgrademet à jour.- Des versions figées donnent le même projet chez tout le monde.
Exercices
- Corriger le
README.mddu projet avec les bonnes commandes d'installation. - Trouver avec quel gestionnaire
python3,nodeetgitont été installés sur sa machine.whichaide. - Dans un environnement virtuel neuf, installer
pytest, mettre à jourrequirements., et regarder ce qui a été ajouté en plus detxt pytest. Pourquoi ? - À la racine de ce dépôt, supprimer
node_modules, puis le reconstruire. Combien de temps, combien de paquets ? - Vérifier que
.venvetnode_modulessont bien ignorés par Git.