8. Référence des commandes¶
Note
Cette page est conservée uniquement jusqu'à ce que la documentation setuptool
sur https://setuptools.readthedocs.io/en/latest/setuptools.html couvre de manière indépendante toutes les informations pertinentes actuellement incluses ici.
8.1. Installer des modules: la famille de commande install¶
La commande d'installation s’assure que la commande de construction a bien été lancé puis lance les sous-commandes install_lib, install_data et install_scripts.
8.1.1. install_data¶
Cette commande installe tous les fichiers fournis avec la distribution.
8.1.2. install_scripts¶
Cette commande installe tout les scripts (Python) dans la distribution.
8.2. Créer une distribution source: la commande sdist¶
Les commandes du modèle manifeste sont :
Commande |
Description |
---|---|
include pat1 pat2 ... |
Inclut tous les fichiers ressemblant aux modèles listés |
exclude pat1 pat2 ... |
exclut tous les fichiers ressemblant aux modèles listés |
recursive-include dir pat1 pat2 ... |
inclut récursivement tous les fichiers sous dir ressemblant aux modèles listés |
recursive-exclude dir pat1 pat2 ... |
exclut tous les fichiers sous dir ressemblant aux modèles listés |
global-include pat1 pat2 ... |
Inclut tous les fichiers dans l'arborescence ressemblant aux modèles listés |
global-exclude pat1 pat2 ... |
exclut tous les fichiers dans l'arborescence ressemblant aux modèles listés |
prune dir |
exclut tous les fichiers dans dir |
graft dir |
inclut tous les fichiers dans dir |
Les modèles sont de style Unix glob : *
correspond à n'importe quelle chaîne de caractères d'un nom de fichier valide, ?
correspond à un seul caractère d'un nom de fichier valide et [range]
correspond à n'importe quel caractère dans la range (e.g., a-z
, a-zA-Z
, a-f0-9_.
). La définition de "caractère de nom de fichier valide" est spécifique à chaque plateforme: sur Unix il s'agir de n'importe quel caractère à part le slash; sur Windows il s'agir de n'importe quel caractère a part l'anti-slash et les deux points.