Python package guidelines (Português)

Esse documento cobre padrões e diretrizes na escrita de PKGBUILDs para softwares Python.

Status de tradução: Esse artigo é uma tradução de Python package guidelines. Data da última tradução: 2019-11-22. Você pode ajudar a sincronizar a tradução, se houver alterações na versão em inglês.

Diretrizes de pacotes do Arch

---

32-bit – CLR – CMake – Cross – DKMS – Eclipse – Electron – Fonte – Free Pascal – GNOME – Go – Haskell – Java – KDE – Kernel – Lisp – Meson – MinGW – Node.js – Nonfree – OCaml – Perl – PHP – Python – R – Ruby – Rust – Shell – VCS – Web – Wine

Nome do pacote

Para módulos de biblioteca do Python 3, use python-nomemódulo. Também use o prefixo se o pacote fornece um programa fortemente atrelado ao ecossistema do Python (p. ex. pip or tox). Para outros aplicativos, use apenas o nome do programa.

O mesmo se aplica para Python 2, exceto que o prefixo (se necessário) é python2-.

Nota: O nome do pacote deve estar todo em minúsculo.

Arquitetura

Veja PKGBUILD (Português)#arch.

Um pacote Python que contenha extensões C usando a palavra-chave ext_modules no setup.py é dependente da arquitetura. Do contrário, muito provavelmente será independente desta.

Fonte

As URLs de download vinculadas do site do PyPI incluem um hash imprevisível que precisa ser obtido no site do PyPI sempre que um pacote precisar ser atualizado. Isso os torna inadequados para uso em um PKGBUILD. PyPI fornece um esquema estável alternativo: matriz PKGBUILD (Português)#source source=() deve usar os seguintes modelos de URL:

Pacote fonte

https://files.pythonhosted.org/packages/source/${_name::1}/$_name/$_name-$pkgver.tar.gz

Pacote wheel Python puro

https://files.pythonhosted.org/packages/py2.py3/${_name::1}/$_name/${_name/-/_}-$pkgver-py2.py3-none-any.whl (Bilíngue compatível com Python 2 e Python 3):https://files.pythonhosted.org/packages/py3/${_name::1}/$_name/${_name/-/_}-$pkgver-py3-none-any.whl (Python 3 apenas)

Note que o nome da distribuição pode conter traços, enquanto sua representação em um nome de arquivo wheel não pode (eles são convertidos em sublinhados).

Pacote wheel específico para arquitetura

neste exemplo para . Também pode ser usado para não repetir a versão do python:

Note que uma variável personalizada $_name é usada em vez de pkgname já que nomes de pacotes python são geralmente prefixados com . Essa variável pode ser definida genericamente da seguinte forma:

_name=${pkgname#python-}

Métodos de instalação

Os pacotes Python geralmente são instalados usando ferramentas específicas da linguagem, como pip ou easy_install, que são comparáveis aos gerenciadores de pacotes dedicados na medida em que foram projetados para buscar os arquivos fonte de um repositório online (geralmente PyPI, o Python Package Index) e rastrear o arquivos relevantes (para uma comparação detalhada entre os dois, veja pip vs easy_install).

No entanto, para gerenciar pacotes Python dentro de PKGBUILDs, o distutils fornecido de forma padrão é a solução mais conveniente, pois usa o setup.py do pacote fonte baixado e instala facilmente arquivos no diretório .

distutils

Um PKGBUILD de distutils é geralmente bem simples:

sendo que:

• python é substituído com o binário correto, ou
• evita a tentativa de instalar diretamente no sistema hospedeiro em vez do arquivo de pacote, que resultaria em um erro de permissão
• --optimize=1 compila arquivos bytecode otimizados ( para Python 2, para Python 3) de forma que eles possam ser rastreados pelo pacman.
• --skip-build otimiza, evitando tentativas desnecessárias de reexecutar as etapas de compilação já executadas na função .

setuptools

A cena de empacotamento de Python migrou em grande parte do distutils para o setuptools, que está ativamente desenvolvido e funciona como uma importação de substituição ao setup.py. A principal diferença para os empacotadores é que setuptools é empacotado separadamente do próprio Python e deve ser especificado como um :

makedepends=('python-setuptools')

Se o pacote resultante incluir executáveis que importam o módulo , os setuptools devem ser adicionalmente especificados como das funções de divididas; alternativamente, se o PKGBUILD apenas instalar o pacote Python para uma única versão do Python, setuptools deve ser movido de para .

pip

Se você precisar usar o pip (fornecido por e python2-pip^AUR) para, por exemplo, instalar pacotes wheel, lembre-se de passar as seguintes opções:

PIP_CONFIG_FILE=/dev/null pip install --isolated --root="$pkgdir" --ignore-installed --no-deps *.whl

• ignora , o qual pode estar anexando sinalizadores arbitrários ao pip.
• --isolated ignora variáveis de ambiente (e, novamente, ) que, do contrário, poderia também estar anexando sinalizadores arbitrários ao pip.
• é necessário até https://github.com/pypa/pip/issues/3063 estar resolvido (do contrário, pip ignora a instalação na presença de uma instalação anterior).
• assegura que dependências não sejam empacotadas junto com pacote principal.

pip não sabe como gerar arquivos (veja https://github.com/pypa/pip/issues/2209). Para gerá-los manualmente após pip ter instalado o módulo, execute:

python -O -m compileall "${pkgdir}/caminho/para/o/módulo"

Tradução 2to3 em tempo de compilação

A maioria dos projetos em Python tem como alvo o Python 2 ou o Python 3, ou ambos usam camadas de compatibilidade como six. No entanto, alguns usam a palavra-chave 2to3 reprovada em setuptools para converter heuristicamente o código-fonte do Python 2 para o Python 3 no momento da criação. Como resultado, os mesmos diretórios de origem não podem ser usados para construir os pacotes divididos do Python 2 e do Python 3.

Para pacotes que fazem isso, precisamos de uma função prepare() que copie a fonte antes que ela seja construída. Em seguida, os pacotes do Python 2 e do Python 3 podem ser convertidos e construídos independentemente, sem se sobreporem uns aos outros.

Verificação

A maioria dos projetos python que fornecem testsuites (que são conjunto ou coleção de testes) usam nosetests ou pytest para executar os testes com test no nome do arquivo ou diretório contendo a testsuite. Em geral, só executar ou pytest é o suficiente para executar a testsuite.

Se houver uma extensão C compilada, os testes precisam ser executados usando um , que reflete a versão maior e menor do Python, para localizá-la e carregá-la.

Alguns projetos fornecem pontos de entrada no setup.py para executar o teste. Isso funciona para pytest e .

Dicas e truques

Usando site-packages

Às vezes, durante a compilação, o teste ou a instalação, é necessário consultar o diretório do sistema. Para não codificar o diretório, use uma chamada para a versão Python do sistema para recuperar o caminho e armazená-lo em uma variável local:

Diretório de teste em site-package

Certifique-se de não instalar um diretório chamado apenas em (por exemplo, /usr/lib/python2.7/site-packages/tests/), pois ele facilmente entra em conflito com outros pacotes Python.