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

# Import required functions
____

# Call setup function
____(
    author="<your-name>",
    description="____",
    name="____",
    packages=____(____=____),
    version="____",
)


# Import required functions
from setuptools import setup, find_packages

# Call setup function
setup(
    author="<your-name>",
    description="A package for converting imperial lengths and weights.",
    name="impyrial",
    packages=find_packages(include=["impyrial", "impyrial.*"]),
    version="0.1.0",
)


Añadir el script de configuración

import impyrial

result = impyrial.length.convert_unit(10, 'in', 'yd')
print(result)


# Run this to install the package locally
pip install -e .


Instalar tu paquete localmente

"""Conversions between ounces and larger imperial weight units"""
OUNCES_PER_POUND = 160  # 16 ounces in a pound
OUNCES_PER_STONE = OUNCES_PER_POUND * 14.0  # 14 pounds in a stone

UNITS = ("oz", "lb", "st")


def ounces_to_pounds(x, reverse=False):
    """Convert weights between ounces and pounds.

    Parameters
    ----------
    x : array_like
        Weights in pounds.
    reverse : bool, optional
        If this is set to true this function converts from pounds to ounces
        instead of the default behaviour of ounces to pounds.

    Returns
    -------
    ndarray
        An array of converted weights with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * OUNCES_PER_POUND
    else:
        return x / OUNCES_PER_POUND


def ounces_to_stone(x, reverse=False):
    """Convert weights between ounces and stone.

    Parameters
    ----------
    x : array_like
        Weights in stone.
    reverse : bool, optional
        If this is set to true this function converts from stone to ounces
        instead of the default behaviour of ounces to stone.

    Returns
    -------
    ndarray
        An array of converted weights with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * OUNCES_PER_STONE
    else:
        return x / OUNCES_PER_STONE


import impyrial

result = impyrial.weight.convert_unit(2, 'lb', 'oz')
print(result)


"""Conversions between ounces and larger imperial weight units"""
OUNCES_PER_POUND = 16.0  # 16 ounces in a pound
OUNCES_PER_STONE = OUNCES_PER_POUND * 14.0  # 14 pounds in a stone

UNITS = ("oz", "lb", "st")


def ounces_to_pounds(x, reverse=False):
    """Convert weights between ounces and pounds.

    Parameters
    ----------
    x : array_like
        Weights in pounds.
    reverse : bool, optional
        If this is set to true this function converts from pounds to ounces
        instead of the default behaviour of ounces to pounds.

    Returns
    -------
    ndarray
        An array of converted weights with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * OUNCES_PER_POUND
    else:
        return x / OUNCES_PER_POUND


def ounces_to_stone(x, reverse=False):
    """Convert weights between ounces and stone.

    Parameters
    ----------
    x : array_like
        Weights in stone.
    reverse : bool, optional
        If this is set to true this function converts from stone to ounces
        instead of the default behaviour of ounces to stone.

    Returns
    -------
    ndarray
        An array of converted weights with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * OUNCES_PER_STONE
    else:
        return x / OUNCES_PER_STONE


Usar instalaciones editables

Gestionar las dependencias

from setuptools import setup, find_packages

# Add install requirements
setup(
    author="<your-name>",
    description="A package for converting imperial lengths and weights.",
    name="impyrial",
    packages=find_packages(include=["impyrial", "impyrial.*"]),
    version="0.1.0",
    ____=____,
)


from setuptools import setup, find_packages

# Add install requirements
setup(
    author="<your-name>",
    description="A package for converting imperial lengths and weights.",
    name="impyrial",
    packages=find_packages(include=["impyrial", "impyrial.*"]),
    version="0.1.0",
    install_requires=['numpy>=1.10', 'pandas'],
)


Dependencias del usuario

# Run this script to install the package locally
pip freeze > requirements.txt


Dependencias de desarrollo

Incluir licencias y escribir READMEs

____

A package for converting between imperial unit lengths and weights.

This package was created for the ____DataCamp____ course "Developing Python Packages".

### Features

- Convert lengths between miles, yards, feet and inches.
- Convert weights between hundredweight, stone, pounds and ounces.

### Usage

____
import impyrial

# Convert 500 miles to feet
impyrial.length.convert_unit(500, from_unit='yd', to_unit='ft')  # returns 1500.0

# Convert 100 ounces to pounds
impyrial.weight.convert_unit(100, from_unit='oz', to_unit='lb')  # returns 6.25
____


# impyrial

A package for converting between imperial unit lengths and weights.

This package was created for the [DataCamp](https://www.datacamp.com) course "Developing Python Packages".

### Features

- Convert lengths between miles, yards, feet and inches.
- Convert weights between hundredweight, stone, pounds and ounces.

### Usage

```
import impyrial

# Convert 500 miles to feet
impyrial.length.convert_unit(500, from_unit='yd', to_unit='ft')  # returns 1500.0

# Convert 100 ounces to pounds
impyrial.weight.convert_unit(100, from_unit='oz', to_unit='lb')  # returns 6.25
```


Escribir un README

# impyrial

A package for converting between imperial unit lengths and weights.

This package was created for the [DataCamp](https://www.datacamp.com) course Developing Python Packages.

### Features

- Convert lengths between miles, yards, feet and inches.
- Convert weights between hundredweight, stone, pounds and ounces.

### Usage

```
import impyrial

# convert 500 miles to feet
impyrial.length.convert_unit(500, from_unit='yd', to_unit='ft')  # returns 1500.0

# convert 100 ounces to pounds
impyrial.weight.convert_unit(100, from_unit='oz', to_unit='lb')  # returns 6.25
```


MANIFEST - Incluir archivos extra con tu paquete

Publicar tu paquete

# Run this code to complete the exercise
python3 setup.py sdist bdist_wheel


Crear una distribución

# Run the following in the terminal:
# twine upload dist/*


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

Uso de plantillas de paquetes

Números de versión e historial

CONTRIBUTING.md

Archivo de historial

Seguimiento de la versión con bumpversion

Makefiles y clasificadores

Clasificadores de PyPI

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.

Escribir un README

Desarrollo de paquetes en Python

Ejercicio interactivo práctico