Pon en marcha tu paquete convirtiendo scripts que ya has escrito. Crearás un paquete sencillo que podrás usar en tu propio ordenador.

Empezar un paquete

Módulos, paquetes y subpaquetes

De script a paquete

Poniendo tu paquete en acción

Documentación

Escribir la documentación de funciones con pyment

Escribir documentación de funciones con pyment II

Documentación de paquetes y módulos

Estructurar las importaciones

Imports entre módulos hermanos

Importar desde paquetes padre

Exponer funciones a las personas usuarias

De código suelto a paquete local

Haz que tu paquete sea instalable para ti y para otras personas. En este capítulo, aprenderás a gestionar dependencias, escribir READMEs e incluir licencias. También completarás todos los pasos para publicar tu paquete en PyPI, el principal hogar de los paquetes de Python.

Instalar tu propio paquete

Añadir el script de configuración

Instalar tu paquete localmente

Usar instalaciones editables

Gestionar las dependencias

Dependencias del usuario

Dependencias de desarrollo

Incluir licencias y escribir READMEs

Escribir un README

MANIFEST - Incluir archivos extra con tu paquete

Publicar tu paquete

Crear una distribución

Subir distribuciones

Instala tu paquete desde cualquier lugar

Lleva tu paquete a un nivel profesional. Descubre cómo usar pytest para evitar errores, tox para probar tu paquete con varias versiones de Python y flake8 para mantener un gran estilo de código.

Probar tu paquete

Creación del directorio de tests

Escribir algunas pruebas básicas

Ejecutar tus tests

Probar tu paquete en distintos entornos

Configurando tox

Ejecutar tox

Mantén tu paquete con estilo

Filtrado de estilo apropiado

Usar flake8 para limpiar un archivo

Ignorar errores específicos

Configurar flake8

Mejora la calidad de tu paquete

Crea tus paquetes más rápido. En este último capítulo, aprenderás a usar cookiecutter para generar todos los archivos de soporte que necesita tu paquete, Makefiles para simplificar la publicación de nuevas versiones y conocerás los últimos archivos que ayudarán a atraer usuarios y personas colaboradoras.

Desarrollo de paquetes más rápido con plantillas

# Run this script to create package template
# After running you will still need to type in the terminal to specify the template options
cookiecutter https://github.com/audreyfeldroy/cookiecutter-pypackage.git


Uso de plantillas de paquetes

Números de versión e historial

CONTRIBUTING.md

# History

## ____
### _____
____
### ____
____

## 0.1.0
### Added
- First release on PyPI.


# History

## 0.2.0
### Fixed
- Bug fixed in `length` subpackage for inches-to-feet conversion.
### Deprecated
- Removed Python 2.7 support.

## 0.1.0
### Added
- First release on PyPI.


Archivo de historial

#!/usr/bin/env python

"""The setup script."""

from setuptools import setup, find_packages

with open('README.md') as readme_file:
    readme = readme_file.read()

with open('HISTORY.md') as history_file:
	history = history_file.read()

setup(
	author="All credit to you",
    author_email='you@chapter4.com',
    description="A package for converting between imperial unit lengths and weights.",
    name='impyrial',
    packages=find_packages(include=['impyrial', 'impyrial.*']),
    version='0.1.0',
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.6.*",
    classifiers=[
        'Development Status :: 2 - Pre-Alpha',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Programming Language :: Python :: 2',
        'Programming Language :: Python :: 2.7',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
    ],
    license="MIT license",
    long_description=readme + '\n\n' + history,
    keywords='impyrial',    
    zip_safe=False,
)


__doc__ = """
impyrial
========
A package for converting between imperial measurments of length and weight.
"""

__author__ = "All credit to you"
__version__ = '0.1.0'

from . import length  # noqa : F401
from . import weight  # noqa : F401


# Copy and run this command in the terminal to increase the minor package number
bumpversion minor


Seguimiento de la versión con bumpversion

Makefiles y clasificadores

#!/usr/bin/env python

"""The setup script."""

from setuptools import setup, find_packages

with open('README.md') as readme_file:
    readme = readme_file.read()

with open('HISTORY.md') as history_file:
    history = history_file.read()

setup(
    author="All credit to you",
    author_email='you@chapter4.com',
    description="A package for converting between imperial unit lengths and weights.",
    name='impyrial',
    packages=find_packages(include=['impyrial', 'impyrial.*']),
    version='0.1.0',
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.6.*",
    classifiers=[
        'Development Status :: 2 - Pre-Alpha',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
        'Programming Language :: Python :: 3.7',
        'Programming Language :: Python :: 3.8',
    ],
    license="MIT license",
    long_description=readme + '\n\n' + history,
    long_description_content_type='text/markdown',
    keywords='impyrial',    
    zip_safe=False,
)


#!/usr/bin/env python

"""The setup script."""

from setuptools import setup, find_packages

with open('README.md') as readme_file:
    readme = readme_file.read()

with open('HISTORY.md') as history_file:
    history = history_file.read()

setup(
    author="All credit to you",
    author_email='you@chapter4.com',
    description="A package for converting between imperial unit lengths and weights.",
    name='impyrial',
    packages=find_packages(include=['impyrial', 'impyrial.*']),
    version='0.1.0',
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.6.*",
    classifiers=[
        'Development Status :: 2 - Pre-Alpha',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
    ],
    license="MIT license",
    long_description=readme + '\n\n' + history,
    long_description_content_type='text/markdown',
    keywords='impyrial',    
    zip_safe=False,
)


Clasificadores de PyPI

# Run this file to complete the exercise 

# Remove old distributions
make clean

# Run tests
make test

# Make new source and wheel distributions
make dist


Usar Makefiles

Cierre

Desarrollo rápido de paquetes

¿Sueles copiar y pegar el mismo código entre archivos y te gustaría reutilizar y compartir fácilmente esos fragmentos tan útiles? ¡Empaquetar tu código en paquetes de Python puede ayudarte! En este curso, aprenderás sobre la estructura de un paquete y los archivos adicionales necesarios para convertir código suelto en paquetes prácticos. También verás la estructura de importación, la documentación y cómo mantener el estilo de código con flake8. Después acelerarás el desarrollo creando plantillas y usando cookiecutter para generar esqueletos de paquetes. Por último, aprenderás a usar setuptools y twine para compilar y publicar tus paquetes en PyPI, el escaparate mundial de los paquetes de Python.

Introduction to Shell

Writing Functions in Python

Aprende sobre estructura de paquetes, importaciones, documentación y estilo de código, luego publica plantillas.

Desarrollo de paquetes en Python

Aprende a crear tus propios paquetes Python para que el código sea más fácil de usar y compartir con otros.

Clasificadores de PyPI

Desarrollo de paquetes en Python

Ejercicio interactivo práctico