Release de Pacotes do Portal Modelo

Este tutorial trata do procedimento de empacotamento de um componente usado pelo Portal Modelo. Esse procedimento deve ser realizado sempre após a correção de um bloco de problemas ou do desenvolvimento de novas funcionalidades nos pacotes do portal, disponibilizando assim a nova versão do pacote para ser atualizado em uma instalação de Portal Modelo ou liberado em uma nova versão do instalador para a comunidade.

Pré-Requisitos

Antes de prosseguir certifique-se de que os seguintes pré-requisitos estejam resolvidos.

Pacotes

No virtualenv do ambiente de desenvolvimento do Portal Modelo, ou no Python do sistema, instalar os seguintes pacotes:

$ pip install zest.releaser
$ pip install zc.rst2

Configurações de Repositórios

É necessário garantir a existência de um arquivo ~/.pypirc com as configurações para repositórios de pacotes Python. Este arquivo contém atalhos, usuários e senhas a serem utilizados no processo de release dos pacotes.

Um exemplo do conteúdo deste arquivo pode ser visto abaixo:

[distutils]
index-servers =
    pypi
    interlegis
    plonegovbr

[pypi]
username: nomeusuario
password: ********

[interlegis]
username: nomeusuario
password: ********

[plonegovbr]
username: nomeusuario
password: ********

Gerando a Release

Vá até a raiz do pacote, por exemplo:

$ cd src/interlegis.portalmodelo.policy

Validação da Documentação

Na raiz do pacote (e com o virtualenv habilitado) execute o seguinte comando:

$ longtest

Este comando abrirá um navegador com o conteúdo da documentação do pacote (como descrito no arquivo setup.py). Se houver algum erro na documentação ou nas informações você poderá corrigí-lo e executar novamente esse comando para checar se está tudo bem. O objetivo é checar se a documetação que será gerada no Pypi está correta.

Se houver erro na geração da documentação, pode haver problema com a instalação do pacote zc.rst2.

Gerando o Release

Na raiz do pacote (e com o virtualenv habilitado) execute o seguinte comando:

$ fullrelease

E então responda as perguntas que surgirão...

Este comando realizará os seguintes passos:

  • Perguntará qual a versão da release do pacote
  • Criará a tag no sistema de controle de versões
  • Efetuará o upload pacote no repositório do PyPi
  • Atualizará a versão do pacote (adicionando um .dev0 para indicar tratar-se de uma nova etapa de desenvolvimento)
  • Fará commit das alterações e executará o git push, enviando-as para o repositório central

Então, verifique se o pacote já está disponível no Pypi e se os commits já estão disponíveis no repositório central, e pronto!


Voltar para o ProjetoPortalModelo

Última modificação 4 anos atrás Última modificação em 30/10/2014 20:07:47
 

The contents and data of this website are published under license:
Creative Commons 4.0 Brasil - Atribuir Fonte - Compartilhar Igual.