Comece seu pacote convertendo scripts que você já escreveu. Você vai criar um pacote simples para usar no seu próprio computador.

Iniciando um pacote

Módulos, pacotes e subpacotes

Do script ao pacote

Colocando seu pacote para trabalhar

Documentação

Escrevendo documentação de funções com pyment

Escrevendo documentação de funções com pyment II

Documentação de pacote e módulo

Estruturando imports

Imports entre módulos irmãos

Importando do pacote pai

Expondo funções para usuários

De código solto a pacote local

Deixe seu pacote instalável para você e para outras pessoas. Neste capítulo, você vai aprender a lidar com dependências, escrever READMEs e incluir licenças. Você também vai concluir todas as etapas para publicar seu pacote no PyPI — a principal casa dos pacotes Python.

Instalando seu próprio pacote

# 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",
)


Adicionando o script de setup

import impyrial

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


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


Instalando seu pacote 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


Usando instalações editáveis

Lidando com dependências

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'],
)


Dependências do usuário

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


Dependências de desenvolvimento

Incluindo licenças e escrevendo 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
```


Escrevendo um 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 - Incluindo arquivos extras no seu pacote

Publicando seu pacote

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


Gerando uma distribuição

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


Enviando distribuições

Instale seu pacote de qualquer lugar

Leve seu pacote a um padrão profissional. Descubra como usar pytest para evitar erros, tox para testar se seu pacote funciona com várias versões do Python e flake8 para manter um ótimo estilo de código.

Testando seu pacote

Criando o diretório de testes

Escrevendo alguns testes básicos

Executando seus testes

Testando seu pacote em diferentes ambientes

Configurando o tox

Executando o tox

Mantendo seu pacote estiloso

Filtragem adequada de estilo

Usando flake8 para deixar um arquivo em ordem

Ignorando erros específicos

Configurando o flake8

Aumentando a qualidade do seu pacote

Crie seus pacotes com mais rapidez. Neste capítulo final, você vai aprender a usar cookiecutter para gerar todos os arquivos de suporte de que seu pacote precisa, Makefiles para simplificar o lançamento de novas versões e terá uma introdução aos últimos arquivos que seu pacote precisa para atrair usuários e contribuintes.

Desenvolvimento mais rápido de pacotes com templates

Usando modelos de pacote

Números de versão e histórico

CONTRIBUTING.md

Arquivo de histórico

Acompanhando o número da versão com bumpversion

Makefiles e classificadores

Classificadores do PyPI

Usando Makefiles

Encerramento

Desenvolvimento rápido de pacotes

Você vive copiando e colando o mesmo código entre arquivos e queria que fosse mais fácil reutilizar e compartilhar seus trechos incríveis? Empacotar seu código em pacotes Python pode ajudar! Neste curso, você vai aprender sobre a estrutura de pacotes e os arquivos extras necessários para transformar códigos soltos em pacotes práticos. Você também vai aprender sobre a estrutura de imports, documentação e como manter o estilo do código usando o flake8. Depois, vai acelerar o desenvolvimento dos seus pacotes criando templates, usando o cookiecutter para gerar esqueletos de pacotes. Por fim, você vai aprender a usar setuptools e twine para construir e publicar seus pacotes no PyPI — o palco mundial dos pacotes Python.

Introduction to Shell

Writing Functions in Python

Aprenda sobre estrutura de pacotes, importação, documentação e estilo de código. Construa e publique.

Desenvolvendo pacotes Python

Aprenda a criar pacotes Python para tornar seu código mais fácil de usar e compartilhar com outras pessoas.

Dependências de desenvolvimento

Desenvolvendo pacotes Python

Exercício interativo prático