Distribuindo Módulos Python (Versão legada)
*******************************************

Autor:
   Greg Ward, Anthony Baxter

E-mail:
   distutils-sig@python.org

Ver também:

  Distribuindo módulos Python
     As documentações de distribuição do módulo atualizadas

Nota:

  Todo o pacote "distutils" foi descontinuado e será removido no
  Python 3.12. Esta documentação é mantida apenas como referência e
  será removida com o pacote. Veja a entrada no O que há de novo para
  mais informações.

Nota:

  Este documento está sendo mantido apenas até que a documentação do
  "setuptools" em
  https://setuptools.readthedocs.io/en/latest/setuptools.html cubra
  independentemente todas as informações relevantes atualmente
  incluídas aqui.

Nota:

  Este guia cobre apenas as ferramentas básicas para construir e
  distribuir extensões que são fornecidas como parte desta versão do
  Python. Ferramentas de terceiros oferecem alternativas mais fáceis
  de usar e mais seguras. Consulte a quick recommendations section no
  Guia do Usuário de Pacotes Python para maiores informações

Este documento descreve os Utilitários de Distribuição do Python
("Distutils") do ponto de vista do desenvolvedor do módulo,
descrevendo os recursos subjacentes que o "setuptools" constrói para
permitir que os desenvolvedores do Python disponibilizem módulos e
extensões do Python prontamente disponíveis para um público mais
amplo.

* 1. Uma Introdução ao Distutils

  * 1.1. Conceitos & Terminologias

  * 1.2. Um Exemplo Simples

  * 1.3. Terminologia geral do Python

  * 1.4. Terminologia específica do Distutils

* 2. Escrevendo o Script de Configuração

  * 2.1. Listing whole packages

  * 2.2. Listing individual modules

  * 2.3. Describing extension modules

  * 2.4. Relationships between Distributions and Packages

  * 2.5. Installing Scripts

  * 2.6. Installing Package Data

  * 2.7. Installing Additional Files

  * 2.8. Additional meta-data

  * 2.9. Debugging the setup script

* 3. Escrevendo o arquivo de configuração de instalação

* 4. Criando uma Distribuição Fonte

  * 4.1. Specifying the files to distribute

  * 4.2. Manifest-related options

* 5. Criando Distribuições Compiladas

  * 5.1. Creating RPM packages

  * 5.2. Cross-compiling on Windows

* 6. Exemplos de Distutils

  * 6.1. Distribuição Python pura (por módulo)

  * 6.2. Distribuição Python pura (por pacote)

  * 6.3. Módulo de extensão única

  * 6.4. Verificando um pacote

  * 6.5. Lendo os metadados

* 7. Estendendo Distutils

  * 7.1. Integrando novos comandos

  * 7.2. Adicionando novos tipos de distribuição

* 8. Referência de comando

  * 8.1. Instalando módulos modules: a família de comandos **install**

  * 8.2. Criando uma distribuição de fontes: o comando **sdist**

* 9. Referência da API

  * 9.1. "distutils.core" --- funcionalidade principal Distutils

  * 9.2. "distutils.ccompiler" --- CCompiler base class

  * 9.3. "distutils.unixccompiler" --- Unix C Compiler

  * 9.4. "distutils.msvccompiler" --- Microsoft Compiler

  * 9.5. "distutils.bcppcompiler" --- Borland Compiler

  * 9.6. "distutils.cygwincompiler" --- Cygwin Compiler

  * 9.7. "distutils.archive_util" ---  Archiving utilities

  * 9.8. "distutils.dep_util" --- Dependency checking

  * 9.9. "distutils.dir_util" --- Directory tree operations

  * 9.10. "distutils.file_util" --- Single file operations

  * 9.11. "distutils.util" --- Miscellaneous other utility functions

  * 9.12. "distutils.dist" --- The Distribution class

  * 9.13. "distutils.extension" --- The Extension class

  * 9.14. "distutils.debug" --- Distutils debug mode

  * 9.15. "distutils.errors" --- Distutils exceptions

  * 9.16. "distutils.fancy_getopt" --- Wrapper around the standard
    getopt module

  * 9.17. "distutils.filelist" --- The FileList class

  * 9.18. "distutils.log" --- Simple **PEP 282**-style logging

  * 9.19. "distutils.spawn" --- Spawn a sub-process

  * 9.20. "distutils.sysconfig" --- System configuration information

  * 9.21. "distutils.text_file" --- The TextFile class

  * 9.22. "distutils.version" --- Version number classes

  * 9.23. "distutils.cmd" --- Abstract base class for Distutils
    commands

  * 9.24. Creating a new Distutils command

  * 9.25. "distutils.command" --- Individual Distutils commands

  * 9.26. "distutils.command.bdist" --- Build a binary installer

  * 9.27. "distutils.command.bdist_packager" --- Abstract base class
    for packagers

  * 9.28. "distutils.command.bdist_dumb" --- Build a "dumb" installer

  * 9.29. "distutils.command.bdist_msi" --- Build a Microsoft
    Installer binary package

  * 9.30. "distutils.command.bdist_rpm" --- Build a binary
    distribution as a Redhat RPM and SRPM

  * 9.31. "distutils.command.sdist" --- Build a source distribution

  * 9.32. "distutils.command.build" --- Build all files of a package

  * 9.33. "distutils.command.build_clib" --- Build any C libraries in
    a package

  * 9.34. "distutils.command.build_ext" --- Build any extensions in a
    package

  * 9.35. "distutils.command.build_py" --- Build the .py/.pyc files of
    a package

  * 9.36. "distutils.command.build_scripts" --- Build the scripts of a
    package

  * 9.37. "distutils.command.clean" --- Clean a package build area

  * 9.38. "distutils.command.config" --- Perform package configuration

  * 9.39. "distutils.command.install" --- Install a package

  * 9.40. "distutils.command.install_data" --- Install data files from
    a package

  * 9.41. "distutils.command.install_headers" --- Install C/C++ header
    files from a package

  * 9.42. "distutils.command.install_lib" --- Install library files
    from a package

  * 9.43. "distutils.command.install_scripts" --- Install script files
    from a package

  * 9.44. "distutils.command.register" --- Register a module with the
    Python Package Index

  * 9.45. "distutils.command.check" --- Check the meta-data of a
    package
