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

Adicionando o script de setup

Instalando seu pacote localmente

Usando instalações editáveis

Lidando com dependências

Dependências do usuário

Dependências de desenvolvimento

Incluindo licenças e escrevendo READMEs

Escrevendo um README

MANIFEST - Incluindo arquivos extras no seu pacote

Publicando seu pacote

Gerando uma distribuição

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

# 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


Usando modelos de pacote

Números de versão e histórico

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.


Arquivo de histórico

#!/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


Acompanhando o número da versão com bumpversion

Makefiles e classificadores

#!/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,
)


Classificadores do 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


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.

CONTRIBUTING.md

Desenvolvendo pacotes Python

Exercício interativo prático