# 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_rpm` — Build a binary distribution as a Redhat RPM and SRPM
  - 9.30. `distutils.command.sdist` — Build a source distribution
  - 9.31. `distutils.command.build` — Build all files of a package
  - 9.32. `distutils.command.build_clib` — Build any C libraries in a package
  - 9.33. `distutils.command.build_ext` — Build any extensions in a package
  - 9.34. `distutils.command.build_py` — Build the .py/.pyc files of a package
  - 9.35. `distutils.command.build_scripts` — Build the scripts of a package
  - 9.36. `distutils.command.clean` — Clean a package build area
  - 9.37. `distutils.command.config` — Perform package configuration
  - 9.38. `distutils.command.install` — Install a package
  - 9.39. `distutils.command.install_data` — Install data files from a package
  - 9.40. `distutils.command.install_headers` — Install C/C++ header files from a package
  - 9.41. `distutils.command.install_lib` — Install library files from a package
  - 9.42. `distutils.command.install_scripts` — Install script files from a package
  - 9.43. `distutils.command.register` — Register a module with the Python Package Index
  - 9.44. `distutils.command.check` — Check the meta-data of a package