Empacotamento Python | Código Python Prático

Introdução

Em algum momento, você pode querer fornecer seu código para outra pessoa, possivelmente apenas um colega de trabalho. Esta seção apresenta a técnica mais básica para fazer isso. Para informações mais detalhadas, você precisará consultar o Guia do Usuário de Empacotamento Python.

Criando um arquivo setup.py

Adicione um arquivo setup.py no diretório /home/labex/project ao nível superior do diretório do seu projeto.

## setup.py
import setuptools

setuptools.setup(
    name="porty",
    version="0.0.1",
    author="Your Name",
    author_email="you@example.com",
    description="Practical Python Code",
    packages=setuptools.find_packages(),
)

Criando MANIFEST.in

Se houver arquivos adicionais associados ao seu projeto, especifique-os com um arquivo MANIFEST.in. Por exemplo:

## MANIFEST.in
include *.csv

Coloque o arquivo MANIFEST.in no mesmo diretório que setup.py.

Criando uma distribuição de código-fonte

Para criar uma distribuição do seu código, use o arquivo setup.py. Por exemplo:

$ python setup.py sdist

Isso criará um arquivo .tar.gz ou .zip no diretório dist/. Esse arquivo é algo que você agora pode distribuir para outras pessoas.

Instalando seu código

Outros podem instalar seu código Python usando pip da mesma forma que fazem para outros pacotes. Eles simplesmente precisam fornecer o arquivo criado na etapa anterior. Por exemplo:

$ python -m pip install porty-0.0.1.tar.gz

Comentários

As etapas acima descrevem o básico absoluto mínimo para criar um pacote de código Python que você pode fornecer a outra pessoa. Na realidade, pode ser muito mais complicado, dependendo das dependências de terceiros, se sua aplicação inclui ou não código estrangeiro (ou seja, C/C++), e assim por diante. Cobrir isso está fora do escopo deste curso. Demos apenas um pequeno primeiro passo.

Exercício 9.5: Criar um pacote

Pegue o código porty-app/ que você criou para o Exercício 9.3 e veja se consegue recriar as etapas descritas aqui. Especificamente, adicione um arquivo setup.py e um arquivo MANIFEST.in ao diretório de nível superior. Crie um arquivo de distribuição de origem executando python setup.py sdist.

Como etapa final, veja se consegue instalar seu pacote em um ambiente virtual Python.

Resumo

Parabéns! Você concluiu o laboratório de Distribuição. Você pode praticar mais laboratórios no LabEx para aprimorar suas habilidades.

Compartilhando o Básico do Código Python