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:

  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. Créer un installateur Windows

  * 5.3. Compiler pour toute les plateformes Windows

  * 5.4. Contrôle d'accès utilisateur Vista (UAC)

* 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.bdist_wininst" — Construit un
    installateur Windows

  * 9.32. "distutils.command.sdist" — Construit une distribution
    source

  * 9.33. "distutils.command.build" — Construit tous les fichiers d'un
    paquet

  * 9.34. "distutils.command.build_clib" — Construit toutes les
    bibliothèques C d'un paquet

  * 9.35. "distutils.command.build_ext" — Construit toutes les
    extensions d'un paquet

  * 9.36. "distutils.command.build_py" — Construit les fichiers
    *.py/.pyc* d'un paquet

  * 9.37. "distutils.command.build_scripts" — Construit les scripts
    d'un paquet

  * 9.38. "distutils.command.clean" — Nettoie un dossier de
    compilation d'un paquet

  * 9.39. "distutils.command.config" — Effectue la configuration d'un
    paquet

  * 9.40. "distutils.command.install" — Installe un paquet

  * 9.41. "distutils.command.install_data" — Installe les fichiers de
    données d'un paquet

  * 9.42. "distutils.command.install_headers" — Installe les fichiers
    d'en-tête C/C++ d'un paquet

  * 9.43. "distutils.command.install_lib" — Installe les fichiers de
    bibliothèque à partir d'un paquet

  * 9.44. "distutils.command.install_scripts" — Installe les fichiers
    de script d'un paquet

  * 9.45. "distutils.command.register" — Enregistre un module dans
    l'Index des paquets Python (*Python Package Index* ou *PyPI* en
    anglais)

  * 9.46. "distutils.command.check" — Vérifie les méta-données d'un
    paquet
