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.