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.

Cientista de dados Em Python

Desenvolvedor Python

Climate informatics researcher

Faster package development with templates

Templates

cookiecutter

Using cookiecutter

Template output

Let's practice!

Desenvolvimento rápido de pacotes - Desenvolvimento mais rápido de pacotes com templates

Desenvolvimento mais rápido de pacotes com templates

Create Your Free Account