.gov.br: Agenda de Membros do Governo Brasileiro
Conteúdo
Introdução
Este pacote provê tipos de conteúdo necessários a gestão de Agendas de membros do Governo Brasileiro conforme disposto na Lei 12.813, de 16 de Maio de 2013 artigos 2o. e 11o.
Estado deste pacote
O brasil.gov.agenda tem testes automatizados e, a cada alteração em seu código os testes são executados pelo serviço Travis.
O estado atual dos testes pode ser visto nas imagens a seguir:
Instalação
Para habilitar a instalação deste produto em um ambiente que utilize o buildout:
-
Editar o arquivo buildout.cfg (ou outro arquivo de configuração) e adicionar o pacote
brasil.gov.agenda
à lista de eggs da instalação:[buildout] ... eggs = brasil.gov.agenda
-
Após alterar o arquivo de configuração é necessário executar ''bin/buildout'', que atualizará sua instalação.
-
Reinicie o Plone
-
Acesse o painel de controle e instale o produto Brasil.gov.br: Agenda de Membros do Governo Brasileiro.
Atualização de 1.x a 2.x
Warning
Só atualize para a versão 2.x do pacote depois de atualizar à versão mais recente da branch 1.x.
As atualizações da versão 1.x à 2.x só são suportadas das versões mais recentes de cada branch. Antes de atualizar confira que você está efetivamente utilizando a última versão da branch 1.x e que não existem upgrade steps pendentes de serem aplicados.
Foi removida a dependência no collective.portlet.calendar pois o layout do IDG 2.x não faz uso de portlets. Remova manualmente todos os portlets de calendario estendido e desinstale esse pacote antes de atualizar.
O portlet de Busca de Agenda foi inabilitado e será completamente removido na versão 3.0. Remova manualmente todos os portlets de Busca de Agenda de seu site.
Rodando o buildout de uma tag antiga do pacote
Para atender ao relato de ter vários jobs de integração contínua em pacotes brasil.gov.* (ver https://github.com/plonegovbr/portalpadrao.release/issues/11), no fim da seção extends do buildout.cfg de todos os pacotes brasil.gov.* temos a seguinte linha:
https://raw.githubusercontent.com/plonegovbr/portal.buildout/master/buildout.d/versions.cfg
Hoje, esse arquivo contém sempre as versões pinadas de um release a ser lançado. Por esse motivo, quando é feito o checkout de uma tag mais antiga provavelmente você não conseguirá rodar o buildout. Dessa forma, após fazer o checkout de uma tag antiga, recomendamos que adicione, na última linha do extends, o arquivo de versões do IDG compatível com aquela tag, presente no repositório https://github.com/plonegovbr/portalpadrao.release/.
Exemplo: você clonou o repositório do brasil.gov.portal na sua máquina, e deu checkout na tag 1.0.5. Ao editar o buildout.cfg, ficaria dessa forma, já com a última linha adicionada:
extends =
https://raw.github.com/collective/buildout.plonetest/master/test-4.3.x.cfg
https://raw.github.com/collective/buildout.plonetest/master/qa.cfg
https://raw.githubusercontent.com/plonegovbr/portalpadrao.release/master/1.0.4/versions.cfg
https://raw.githubusercontent.com/plonegovbr/portal.buildout/master/buildout.d/versions.cfg
https://raw.githubusercontent.com/plone/plone.app.robotframework/master/versions.cfg
https://raw.githubusercontent.com/plonegovbr/portalpadrao.release/master/1.0.5/versions.cfg
Para saber qual arquivo de versões é compatível, no caso do brasil.gov.portal, é simples pois é a mesma versão (no máximo um bug fix, por exemplo, brasil.gov.portal é 1.1.3 e o arquivo de versão é 1.1.3.1). Para os demais pacotes, recomendamos comparar a data da tag do pacote e a data nos changelog entre uma versão e outra para adivinhar a versão compatível.
Desenvolvimento
Utilizamos webpack para gerenciar o conteúdo estático do tema, tomando vantagem das diversas ferramentas e plugins disponíveis para suprir nossas necessidades.
Utilizamos a receita de buildout sc.recipe.staticresources para integrar o webpack no Plone.
Ao desenvolver os temas iniciamos o watcher do webpack e trabalhamos somente na pasta "webpack" alterando os arquivos; o webpack se encarrega de processar e gerar os arquivos em seu endereço final.
Este pacote adiciona os seguintes comandos na pasta bin do buildout para processar automaticamente os recursos estáticos:
$ bin/env-brasilgovagenda
Este comando adiciona no terminal o node do buildout no PATH do sistema, dessa forma voce pode trabalhar com webpack conforme a documentação oficial.
$ bin/watch-brasilgovagenda
Este comando instrui ao webpack para esperar por qualquer mudança nos arquivos SASS e gera a versão minificada do CSS para a aplicação.
$ bin/debug-brasilgovagenda
Este comando faz o mesmo que o comando watch, mas não minifica o CSS final. Utilizado para debugar a geração do CSS.
$ bin/build-brasilgovagenda
Este comando cria os recursos minificados, mas não espera por mudanças.
Fazendo releases com o zest.releaser
Os recursos estáticos do pacote são gerados usando o webpack e não são inclusos no VCS. Se você está fazendo release usando o zest.releaser, você precisa fazer upload manual dos arquivos no PyPI ou você vai criar uma distribuição quebrada:
- execute
longtest
, como de costume - execute
fullrelease
, como de costume, respondendo "não" a pergunta "Check out the tag?" para evitar o upload ao PyPI - faça checkout na tag do release que você está liberando
- execute
bin/build-brasilgovagenda
para criar os recursos estáticos - crie os arquivos da distribuição usando
python setup.py sdist bdist_wheel
, como de costume - faça o upload manual dos arquivos usando
twine upload dist/*
Em caso de erro você terá que criar um novo release pois o PyPI Warehouse não permite reutilizar um nome de arquivo.