# Distribuer des modules Python (Version historique)

Auteurs

  Greg Ward, Anthony Baxter

Email

  distutils-sig@python.org

Voir aussi

Distribuer des modules Python

  La documentation actuelle de distribution de modules

Note

The entire `distutils` package has been deprecated and will be removed in Python 3.12. This documentation is retained as a reference only, and will be removed with the package. See the What's New entry for more information.

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.

Note

Ce guide ne couvre que les outils de base, fournis avec cette version de Python, pour construire et distribuer des extensions. D'autres outils peuvent être plus sécurisés et plus simple à utiliser. Consultez quick recommendations section dans le Python Packaging User Guide pour plus d'informations.

Ce document décrit les outils de distribution de Python ("Distutils") du point de vue d'un développeur de modules. Il décrit les capacités sous-jacentes sur lesquelles `setuptools` s'appuie pour permettre aux développeurs Python de créer des modules Python et des extensions disponibles à une large audience.

- 1. Introduction à Distutils
  - 1.1. Concepts et Terminologie
  - 1.2. Un exemple simple
  - 1.3. Terminologie Python générale
  - 1.4. Terminologie spécifique à Distutils
- 2. Rédaction du script `setup.py`
  - 2.1. Lister l'ensemble des paquets
  - 2.2. Lister chaque module indépendamment
  - 2.3. Description des modules d'extension
  - 2.4. Relations entre distributions et paquets
  - 2.5. Installation des scripts
  - 2.6. Installation de paquets de données
  - 2.7. Installation de fichiers additionnels
  - 2.8. Métadonnées additionnelles
  - 2.9. Débogage du script `setup.py`
- 3. Writing the Setup Configuration File
- 4. Créer une distribution source
  - 4.1. Spécifier les fichiers à distribuer
  - 4.2. Options pour le manifeste
- 5. Créer une distribution compilée
  - 5.1. Créer un paquet RPM
  - 5.2. Compiler pour toute les plateformes Windows
- 6. Distutils Examples
  - 6.1. Pure Python distribution (by module)
  - 6.2. Pure Python distribution (by package)
  - 6.3. Single extension module
  - 6.4. Checking a package
  - 6.5. Reading the metadata
- 7. Extension de Distutils
  - 7.1. Intégrer de nouvelles commandes
  - 7.2. Ajout de nouveaux types de distribution
- 8. Référence des commandes
  - 8.1. Installer des modules: la famille de commande install
  - 8.2. Créer une distribution source: la commande sdist
- 9. Référence de l'API
  - 9.1. `distutils.core` — Fonctionnalités principales du module Distutils
  - 9.2. `distutils.ccompiler` — Classe de base CCompiler
  - 9.3. `distutils.unixccompiler` — Compilateur C Unix
  - 9.4. `distutils.msvccompiler` — Compilateur Microsoft
  - 9.5. `distutils.bcppcompiler` — Compilateur Borland
  - 9.6. `distutils.cygwincompiler` — Compilateur Cygwin
  - 9.7. `distutils.archive_util` — Utilitaires d'archivage
  - 9.8. `distutils.dep_util` — Vérification des dépendances
  - 9.9. `distutils.dir_util` — Opérations sur l'arborescence des répertoires
  - 9.10. `distutils.file_util` — Traitements mono-fichier
  - 9.11. `distutils.util` — Autres fonctions de service
  - 9.12. `distutils.dist` — La classe Distribution
  - 9.13. `distutils.extension` — La classe Extension
  - 9.14. `distutils.debug` — Mode de débogage du module Distutils
  - 9.15. `distutils.errors` — Exceptions du module Distutils
  - 9.16. `distutils.fancy_getopt` — Encapsulation du module getopt standard
  - 9.17. `distutils.filelist` — La classe FileList liste des fichiers
  - 9.18. `distutils.log` — Journalisation basée sur le style de la PEP 282
  - 9.19. `distutils.spawn` — Crée un sous-processus
  - 9.20. `distutils.sysconfig` — Informations de configuration du système
  - 9.21. `distutils.text_file` — La classe TextFile
  - 9.22. `distutils.version` — Classes de numéros de version
  - 9.23. `distutils.cmd` — Classe de base abstraite pour les commandes Distutils
  - 9.24. Créer une nouvelle commande Distutils
  - 9.25. `distutils.command` — Commandes Distutils individuelles
  - 9.26. `distutils.command.bdist` — Construit un installateur binaire
  - 9.27. `distutils.command.bdist_packager` — Classe de base abstraite pour empaqueteurs
  - 9.28. `distutils.command.bdist_dumb` — Construit un installateur passif (dumb)
  - 9.29. `distutils.command.bdist_msi` — Construit un installateur Microsoft
  - 9.30. `distutils.command.bdist_rpm` — Construit une distribution binaire au format Redhat RPM et SRPM
  - 9.31. `distutils.command.sdist` — Construit une distribution source
  - 9.32. `distutils.command.build` — Construit tous les fichiers d'un paquet
  - 9.33. `distutils.command.build_clib` — Construit toutes les bibliothèques C d'un paquet
  - 9.34. `distutils.command.build_ext` — Construit toutes les extensions d'un paquet
  - 9.35. `distutils.command.build_py` — Construit les fichiers .py/.pyc d'un paquet
  - 9.36. `distutils.command.build_scripts` — Construit les scripts d'un paquet
  - 9.37. `distutils.command.clean` — Nettoie un dossier de compilation d'un paquet
  - 9.38. `distutils.command.config` — Effectue la configuration d'un paquet
  - 9.39. `distutils.command.install` — Installe un paquet
  - 9.40. `distutils.command.install_data` — Installe les fichiers de données d'un paquet
  - 9.41. `distutils.command.install_headers` — Installe les fichiers d'en-tête C/C++ d'un paquet
  - 9.42. `distutils.command.install_lib` — Installe les fichiers de bibliothèque à partir d'un paquet
  - 9.43. `distutils.command.install_scripts` — Installe les fichiers de script d'un paquet
  - 9.44. `distutils.command.register` — Enregistre un module dans l'Index des paquets Python (Python Package Index ou PyPI en anglais)
  - 9.45. `distutils.command.check` — Vérifie les méta-données d'un paquet