Installation des packages Python à l’aide de pip
et de requirements.txt
.
Contenu
- Installer les paquets avec
pip
etrequirements.txt
- Comment écrire
requirements.txt
- Créer
requirements.txt
avecpip freeze
Pour obtenir des informations de base sur son utilisation pip
, telles que l’installation, la mise à jour et la désinstallation de packages, consultez l’article suivant.
Installer les paquets avec pip
etrequirements.txt
La commande suivante installe les packages en masse selon le fichier de configuration, requirements.txt
. Dans certains environnements, utilisez pip3
plutôt pip
.
$ pip install -r requirements.txt
Le fichier de configuration peut être nommé arbitrairement, bien qu’il requirements.txt
soit couramment utilisé.
Placez-le requirements.txt
dans le répertoire où vous prévoyez d’exécuter la commande. Si le fichier se trouve dans un autre répertoire, spécifiez son chemin, par exemple path/to/requirements.txt
.
Comment écrirerequirements.txt
requirements.txt
En voici un exemple .
###### Requirements without Version Specifiers ######
nose
nose-cov
beautifulsoup4
#
###### Requirements with Version Specifiers ######
# See https://www.python.org/dev/peps/pep-0440/#version-specifiers
docopt == 0.6.1 # Version Matching. Must be version 0.6.1
keyring >= 4.1.1 # Minimum version 4.1.1
coverage != 3.5 # Version Exclusion. Anything except version 3.5
Mopidy-Dirble ~= 1.1 # Compatible release. Same as >= 1.1, == 1.*
Comme avec le code Python, des commentaires peuvent être inclus dans requirements.txt
using #
.
Vous pouvez spécifier la version d’un package à l’aide de ==
, >
, >=
, <
, <=
, etc. L’omission du spécificateur de version installe la dernière version.
Deux conditions peuvent être combinées avec AND en les séparant par une virgule. Dans l’exemple suivant, une version de 1.0
ou ultérieure et 2.0
ou antérieure ( 1.0 <= ver <= 2.0
) est installée.
package >= 1.0, <= 2.0
Reportez-vous à la documentation officielle pour les spécifications détaillées.
- Format du fichier d’exigences – documentation pip v24.1
- Spécificateurs d’exigences – documentation pip v24.1
- Spécificateurs de version – Guide de l’utilisateur du packaging Python
Créer requirements.txt
avecpip freeze
pip freeze
affiche les packages et leurs versions installés dans l’environnement actuel dans un format qui peut être utilisé comme requirements.txt
.
- Vérifiez tous les packages Python installés avec pip list/freeze
$ pip freeze
agate==1.6.0
agate-dbf==0.2.0
agate-excel==0.2.1
agate-sql==0.5.2
...
En utilisant l’opérateur de redirection >
, vous pouvez enregistrer la sortie pip freeze
dans un fichier. Ce fichier peut être utilisé pour installer les mêmes versions de packages dans un environnement différent.
Tout d’abord, redirigez la sortie pip freeze
vers un fichier nommé requirements.txt
.
$ pip freeze > requirements.txt
Ensuite, copiez ou déplacez-le requirements.txt
vers un environnement différent et utilisez-le pour installer les packages.
$ pip install -r requirements.txt
En suivant ces étapes, vous pouvez facilement répliquer la configuration exacte du package d’un environnement à un autre.