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.