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

Ce document décrit les outils de distribution de Python ("Distutils")
du point de vue d'un développeur de modules. Il décrit comment
utiliser *Distutils* pour rendre des modules et extensions Python
disponible à une large audience, simplement, avec un faible surcoût
sur les mécaniques de construction, déploiement et installation.

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.

* 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. L'index de paquets Python (*Python Package Index* : PyPI)

  * 6.1. PyPI overview

  * 6.2. Distutils commands

  * 6.3. PyPI package display

* 7. Exemples

  * 7.1. Pure Python distribution (by module)

  * 7.2. Pure Python distribution (by package)

  * 7.3. Single extension module

  * 7.4. Checking a package

  * 7.5. Reading the metadata

* 8. Extension de Distutils

  * 8.1. Intégrer de nouvelles commandes

  * 8.2. Ajout de nouveaux types de distribution

* 9. Référence des commandes

  * 9.1. Installer des modules: la famille de commande **install**

  * 9.2. Créer une distribution source: la commande **sdist**

* 10. Référence de l'API

  * 10.1. "distutils.core" --- Fonctionnalités principales du module
    Distutils

  * 10.2. "distutils.ccompiler" — Classe de base CCompiler

  * 10.3. "distutils.unixccompiler" — Compilateur C Unix

  * 10.4. "distutils.msvccompiler" — Compilateur Microsoft

  * 10.5. "distutils.bcppcompiler" — Compilateur Borland

  * 10.6. "distutils.cygwincompiler" — Compilateur Cygwin

  * 10.7. "distutils.archive_util" — Utilitaires d'archivage

  * 10.8. "distutils.dep_util" — Vérification des dépendances

  * 10.9. "distutils.dir_util" --- Opérations sur l'arborescence des
    répertoires

  * 10.10. "distutils.file_util" — Traitements mono-fichier

  * 10.11. "distutils.util" — Autres fonctions de service

  * 10.12. "distutils.dist" — La classe Distribution

  * 10.13. "distutils.extension" — La classe Extension

  * 10.14. "distutils.debug" — Mode de débogage du module *Distutils*

  * 10.15. "distutils.errors" — Exceptions du module *Distutils*

  * 10.16. "distutils.fancy_getopt" --- Encapsulation du module
    *getopt* standard

  * 10.17. "distutils.filelist" — La classe *FileList* liste des
    fichiers

  * 10.18. "distutils.log" --- Journalisation basée sur le style de la
    PEP 282

  * 10.19. "distutils.spawn" — Crée un sous-processus

  * 10.20. "distutils.sysconfig" --- Informations de configuration du
    système

  * 10.21. "distutils.text_file" — La classe TextFile

  * 10.22. "distutils.version" — Classes de numéros de version

  * 10.23. "distutils.cmd" --- Classe de base abstraite pour les
    commandes *Distutils*

  * 10.24. Créer une nouvelle commande *Distutils*

  * 10.25. "distutils.command" — Commandes *Distutils* individuelles

  * 10.26. "distutils.command.bdist" — Construit un installateur
    binaire

  * 10.27. "distutils.command.bdist_packager" --- Classe de base
    abstraite pour empaqueteurs

  * 10.28. "distutils.command.bdist_dumb" --- Construit un
    installateur passif (*dumb*)

  * 10.29. "distutils.command.bdist_msi" --- Construit un installateur
    Microsoft

  * 10.30. "distutils.command.bdist_rpm" --- Construit une
    distribution binaire au format Redhat RPM et SRPM

  * 10.31. "distutils.command.bdist_wininst" --- Construit un
    installateur Windows

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

  * 10.33. "distutils.command.build" --- Construit tous les fichiers
    d'un paquet

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

  * 10.35. "distutils.command.build_ext" --- Construit toutes les
    extensions d'un paquet

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

  * 10.37. "distutils.command.build_scripts" --- Construit les scripts
    d'un paquet

  * 10.38. "distutils.command.clean" --- Nettoie un dossier de
    compilation d'un paquet

  * 10.39. "distutils.command.config" --- Effectue la configuration
    d'un paquet

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

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

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

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

  * 10.44. "distutils.command.install_scripts" --- Installe les
    fichiers de script d'un paquet

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

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