La guía de paquetes de Python de pyOpenSci#

Nosotros ayudamos a los científicos a crear flujos de trabajo de ciencia abierta.

Versiones en GitHub (la más reciente por fecha) DOI

Sobre esta guía

Image with the pyOpenSci flower logo in the upper right hand corner. The image shows the packaging lifecycle. The graphic shows a high level overview of the elements of a Python package. The inside circle has 5 items - user documentation, code/api, test suite, contributor documentation, project metadata / license / readme. In the middle of the circle is says maintainers and has a small icon with people. On the outside circle there is an arrow and it says infrastructure.

Esta guía te ayudará a:

  1. Aprender como crear un paquete de Python de principio a fin

  2. Entender el ecosistema de herramientas de empaquetado de Python

  3. Navegar y tomar decisiones sobre las opciones de las herramientas

  4. Entender todas las etapas de la creación y mantenimiento de un paquete de Python

Tambien encontrarás recomendaciones y listas de recursos comunitarios sobre empaquetado y documentación de paquetes.

Tutorial Series: Create a Python Package#

The first round of our community-developed, how to create a Python package tutorial series for scientists is complete! Join our community review process or watch development of future tutorials in our GitHub repo here.

✿ Tutorial de Como Crear un Paquete ✿
✿ Tutoriales de Metadatos de Paquetes ✿
✿ Tutoriales sobre Herramientas de Empaquetado ✿
✿ Reference Guides ✿

Paquetes Python para Científicos#

Aprende sobre las mejores prácticas de empaquetado de Python. También conocerás el vibrante ecosistema de herramientas de empaquetado que están disponibles para ayudarte con tus necesidades de empaquetado de Python.

✨ Crea tu paquete ✨
✨ Publica tu paquete ✨

Entiende el ecosistema de empaquetado de Python.Aprende sobre las mejores prácticas para:

Documentación#

✨ Escribe la Documentación ✨
✨ Documentación para Desarrolladores ✨
✨ Documentos para la Comunidad ✨
✨ Publica tu Documentación ✨

Pruebas#

✨ Pruebas para tu paquete ✨
✨ Ejecuta tus pruebas ✨

Contribuir#

✨ Estilo de Código y Formato ✨
✨ ¿Quieres contribuir? ✨

Agradecemos las contribuciones a esta guía. Aprende más sobre como puedes contribuir.

Contributing to the Python Packaging Guide
A group of people building a pyramid with blocks

Una guía creada por la comunidad#

Cada página en esta guía es revisada extensamente por la comunidad. Para asegurar que nuestra guía sea accesible a principiantes y precisa, realizamos revisiones con un conjunto diverso de pythonistas y científicos con una amplia gama de habilidades y experiencia.

Ver los colaboradores de la guía

A quién va dirigida esta guía#

Esta guía es para cualquier persona interesada en aprender más sobre el empaquetado de Python. Es accesible para principiantes y proporcionará:

  1. Ayuda de principio a fin para crear un paquete de Python.

  2. Recursos para ayudarte a navegar el ecosistema de herramientas y enfoques de empaquetado de Python.

  3. Una lista de recursos seleccionados para ayudarte a documentar, usar y mantener tu paquete.

El futuro de esta guía#

Si tienes ideas de cosas que te gustaría ver aclaradas en esta guía, te invitamos a abrir un issue en GitHub..

If you have questions about our peer review process or packaging in general, you are welcome to use our GitHub Discussions.

This living Python packaging guide is updated as tools and best practices evolve in the Python packaging ecosystem. We will be adding new content over the next year.