dh_python3 - Online na nuvem

PROGRAMA:

NOME

dh_python3 - calcula dependências Python, adiciona scripts de mantenedor para compilar bytes
arquivos, etc.

SINOPSE

dh_python3 -p PACKAGE [-V [XY] [-] [AB]] DIR [-X REGEXPR]

DESCRIÇÃO

QUICK GUIA PARA MANUTENÇÃO
· Se necessário, descreva as versões Python 3 suportadas por meio do campo X-Python3-Version em
debian / control,

· Construir depende de dh-python

· Build-depend on python3 ou python3-all ou python3-all-dev,

· Construir módulo / aplicativo usando seu sistema de construção padrão, lembre-se de construir
extensões para todas as versões Python 3 suportadas (loop over versões py3 -vr),

· Instalar arquivos no padrão locais, adicionar --install-layout = deb para setup.py's
comando install se o seu pacote estiver usando distutils,

· adicionar python3 para dh's - com opção, ou:

· incluir /usr/share/cdbs/1/class/python-distutils.mk em debian / rules e dependem de
CDB (> = 0.4.90), ou:

· ligar dh_python3 no binário-* alvo,

· adicionar $ {python3: Depends} Depende

NOTAS
dependências
dh_python3 tenta traduzir dependências Python do requer.txt arquivo para o Debian
dependências. Em muitos casos, isso funciona sem qualquer configuração adicional porque
dh_python3 vem com um mapeamento embutido de nomes de módulos Python para pacotes Debian que é
periodicamente regenerado a partir do arquivo Debian. Por padrão, as informações da versão em
as dependências do Python são descartadas. Se você quiser que dh_python3 gere mais estrito
dependências (por exemplo, para evitar problemas de ABI), ou se o mapeamento automático não funcionar
corretamente para o seu pacote, você deve fornecer ao dh_python3 regras adicionais para o
tradução do módulo Python para dependências do pacote Debian.

Para um pacote python3-foo isso depende de um pacote barra python3, existem dois arquivos que
pode fornecer tais regras:

1. Se o python3-foo pacote de origem vem com um debian / py3dist-overrides arquivo, este arquivo
é usado por dh_python3 durante a construção de python3-foo.

2. Se o barra python3 pacote de origem vem com um debian / python3-bar.pydist arquivo (e usa
dh_python3), este arquivo será incluído no pacote binário como
/ usr / share / dh-python / dist / cpython3 / python3-bar. Durante a construção de python3-foo,
dh_python3 irá então encontrar e usar o arquivo.

Ambos os arquivos têm o mesmo formato descrito em /usr/share/doc/dh-python/README.PyDist. Se
tudo o que você deseja é gerar dependências com controle de versão (e assumindo que o barra python3
pacote fornece o píbar Módulo Python), na maioria dos casos, será suficiente colocar o
linha píbar barra python3; PEP386 em qualquer um dos arquivos acima.

investidores privados dirs
/ usr / share / foo, / usr / share / games / foo, / usr / lib / foo e / usr / lib / games / foo investidores privados
diretórios são verificados em busca de arquivos Python por padrão (onde Foo é o nome do pacote binário). Se
seu pacote está enviando arquivos Python em algum outro diretório, adicione outra chamada dh_python3
no debian / rules com o nome do diretório como argumento - você pode usar diferentes conjuntos de opções
nesta chamada. Se você precisar alterar as opções (por exemplo, uma lista de versões Python 3 compatíveis)
para um diretório privado que é verificado por padrão, invoque dh_python3 com --skip-private
opção e adicionar outra chamada com um caminho para este diretório e novas opções.

depurar pacotes
Em pacotes binários cujo nome termina com -dbg, todos os arquivos em / usr / lib / python3 / dist-packages /
diretório que tem extensões diferentes de so or h são removidos por padrão. Usar
Opção --no-dbg-cleaning para desabilitar este recurso.

pyinstall arquivos
Os arquivos listados no arquivo debian / pkg.pyinstall serão instalados como módulos públicos (ou seja, em
... / dist-packages / directory) para todas as versões Python solicitadas.

Sintaxe: caminho / para / arquivo [VERSION_RANGE] [NOMEESPAÇO]

O diretório debian é automaticamente removido do caminho, então você pode colocar seus arquivos em
diretório debian / e instale-os a partir deste local (se você quiser instalá-los em
namespace "debian", defina NAMESPACE como debian). Se NAMESPACE for definido, todos os arquivos listados irão
ser instalado no diretório ... / dist-packages / NAMESPACE /.

Exemplos:

· foo.py instala ... / dist-packages / foo.py para todas as versões Python suportadas

· foo / bar.py 3.3- instala ... / dist-packages / foo / bar.py para versões> = 3.3

· foo / bar.py Spam instala ... / dist-packages / spam / bar.py

· debian / *. py spam.egg 3.2 instala arquivos ... / python3.2 / dist-packages / spam / egg / *. py

pirremove arquivos
Se você deseja remover alguns módulos públicos (ou seja, arquivos no diretório ... / dist-packages /)
instalado pelo sistema de compilação (de todas as versões Python suportadas ou apenas de um subconjunto de
essas versões), adicione-os ao arquivo debian / pkg.pyremove.

Exemplos:

· * .pth remove arquivos .pth de ... / dist-packages /

· bar / baz.py 3.2 remove ... / python3.2 / dist-packages / bar / baz.py

predominante suportado / omissão Python versões
Se você deseja substituir a lista do sistema de versões Python suportadas ou a padrão
(por exemplo, para construir um pacote que inclui links simbólicos para versões anteriores do Python ou compilar .py
arquivos apenas para determinada versão do intérprete), você pode fazer isso via DEBPYTHON3_SUPPORTADO e / ou
DEBPYTHON3_DEFAULT env. variáveis.

Exemplo: 3.2,3.3 limita a lista de versões Python com suporte para Python 3.2 e Python
3.3.

OPÇÕES

--versão
mostrar o número da versão do programa e sair

-h, --Socorro
mostrar mensagem de ajuda e sair

- sem adivinhação-deps
desabilitar adivinhação de dependências

--no-dbg-limpeza
não remova nenhum arquivo dos pacotes de depuração

--no-ext-rename não adiciona tags mágicas nem tuplas multiarch a nomes de arquivos de extensão

--no-shebang-reescrever
não reescrever shebangs

--skip-privado
não verifique diretórios privados

-v, --verbose
ligue o modo verboso

-i, --indep
atuar em pacotes independentes de arquitetura

-a, --arco
agir em pacotes dependentes de arquitetura

-q, --quieto
fique quieto

-p PACKAGE, --package =PACKAGE
agir no pacote denominado PACKAGE

-N NO_PACKAGE, --no-package =NO_PACKAGE
não atue no pacote especificado

-V VRANGE
especificar a lista de versões Python 3 suportadas. Ver py3compilar(1) para exemplos

-X REGEX, --exclude =REGEX
excluir itens que correspondam a determinado REGEXPR. Você pode usar esta opção várias vezes para
construir uma lista de coisas a serem excluídas.

--compilar-tudo
compilar todos os arquivos de determinado diretório privado em postinst / rtupdate não apenas o
aqueles fornecidos pelo pacote (ou seja, não passe o parâmetro --package para
py3compile / py3clean)

--depends =DEPENDE
traduzir os requisitos fornecidos em dependências do Debian e adicioná-los ao
$ {python3: Depends}. Use-o para itens ausentes em require.txt

--recommends =RECOMENDA
traduzir os requisitos fornecidos em dependências do Debian e adicioná-los ao
$ {python3: Recomendações}

--suggests =SUGESTÕES
traduzir os requisitos fornecidos em dependências do Debian e adicioná-los ao
$ {python3: Sugere}

--requires =NOME DO ARQUIVO
traduzir os requisitos de determinado (s) arquivo (s) em dependências do Debian e adicioná-los ao
$ {python3: Depends}

--shebang =COMANDO
usar o comando dado como shebang em scripts

--ignore-shebangs
não traduza shebangs em dependências do Debian

Use dh_python3 online usando serviços onworks.net