Diferencias entre distribute, distutils, setuptools y distutils2?

A partir de enero de 2017, todas las demás respuestas a esta pregunta están al menos dos años desactualizadas. Cuando encuentre consejos sobre problemas de empaquetado de Python, recuerde mirar la fecha de publicación y no confíe en la información desactualizada.

La Guía del Usuario de Python Packaging vale la pena leerla. Cada página tiene una fecha de "última revisión" mostrada, por lo que puede verificar la actualidad del manual, y es bastante completo. El hecho de que está alojado en un subdominio de python.org de la Python Software Foundation solo le agrega credibilidad. La página Resúmenes de proyectos es especialmente relevante aquí.

Resumen de herramientas:

Aquí hay un resumen del panorama del packaging de Python en enero de 2017:

Herramientas soportadas:

• Distutils sigue siendo la herramienta estándar para empaquetar en Python. Está incluido en la biblioteca estándar (Python 2 y Python 3.0 a 3.6). Es útil para Python simple distribuciones, pero carece de características. Introduce el paquete Python distutils que se puede importar en su script setup.py.

  • _{Documentos oficiales | distutils sección de la Guía del Usuario del Paquete Python}

• Setuptools fue desarrollado para superar las limitaciones de Distutils, y no está incluido en la biblioteca estándar. Introdujo una utilidad de línea de comandos llamada easy_install. También introdujo el paquete Python setuptools que se puede importar en su script setup.py, y el paquete Python pkg_resources que se puede importar en su código para localizar los archivos de datos instalados con una distribución. Una de sus trampas es que monkey-patches el paquete Python distutils. Debería funcionar bien con pip. ve lanzamientos regulares.

  • _{Documentos oficiales | Pypi page | Repositorio de GitHub | setuptools sección del Usuario del Paquete Python Guía}

• Scikit-build es un generador de sistema de compilación mejorado que utiliza internamente CMake para construir extensiones compiladas de Python. Debido a que scikit-build no está basado en distutils, realmente no tiene ninguna de sus limitaciones. Cuando ninja-build está presente, scikit-build puede compilar proyectos grandes más de tres veces más rápido que las alternativas. Debería funcionar bien con pip. ve lanzamientos regulares.

  • _{Official docs | Pypi page | Repositorio de GitHub}

Herramientas obsoletas/abandonadas:

• Distribuir era un tenedor de Setuptools. Compartía el mismo espacio de nombres, por lo que si tuviera Distribuy instalado, import setuptools importaría el paquete distribuido con Distribute. Distribuir se fusionó de nuevo en Setuptools 0.7, así que ya no necesitas usar Distribute. De hecho, la versión en Pypi es solo una capa de compatibilidad que instala Setuptools.

• Distutils2 fue un intento de tomar lo mejor de Distutils, Setuptools y Distribuir y convertirse en la herramienta estándar incluida en la biblioteca estándar de Python. La idea era que Distutils2 se distribuyera para versiones antiguas de Python, y que Distutils2 se renombrara a packaging para Python 3.3, que lo incluiría en su biblioteca estándar. Sin embargo, estos planes no salieron según lo previsto, y actualmente, Distutils2 es un proyecto abandonado. El último lanzamiento fue en marzo de 2012, y su página de inicio Pypi finalmente se ha actualizado para reflejar su muerte.

Alpha software:

• Distlib es una herramienta que tiene como objetivo implementar un subconjunto de la funcionalidad de las herramientas anteriores, pero solo la funcionalidad que está muy bien definida en los PEPS aceptados. Es una de las herramientas de la PyPA (Python Package Authority), y espero que sea incluido eventualmente en la biblioteca estándar de Python algún día. Todavía se considera software alfa, por lo que los usuarios finales tengan cuidado.

  • _{Documentos oficiales | Pypi page | Repo de Bitbucket | distlib sección de la Guía del Usuario del Paquete Python}

• Hay un par de herramientas más (por ejemplo: Bento), pero no las mencionaré ya que son demasiado oscuras o de nicho o tempranas o no desarrolladas para esto responder post, o de lo contrario no son alternativas directas.

Recomendación:

Así que en conclusión, de todas estas opciones, recomendaría Setuptools, a menos que sus requisitos sean muy básicos y solo necesite Distutils. Setuptools funciona muy bien con Virtualenv y Pip, herramientas que recomiendo encarecidamente. Virtualenv y Pip podrían considerarse oficiales, ya que son parte de PyPA, y Python 3 ahora se envía ensurepip (que le ayuda a instalar pip en algunos sistemas).

Si usted está buscando en Virtualenv, usted podría estar interesado en esta pregunta: ¿Cuál es la diferencia entre venv, pyvenv, pyenv, virtualenv, virtualenvwrapper, ¿etc?. (Sí, lo sé, gimo contigo.)

Como nota al margen, recomiendo usar Virtualenv 1.10 o superior, ya que es la primera versión que reconoce la fusión Setuptools/Distribute, tanto para Python 2 como para 3.