Metadata-Version: 2.1
Name: brasil.gov.agenda
Version: 2.0a1
Summary: Agenda de membros do Governo Brasileiro
Home-page: https://github.com/plonegovbr/brasil.gov.agenda
Author: PloneGovBr
Author-email: gov@plone.org.br
License: GPLv2
Description: ************************************************
        .gov.br: Agenda de Membros do Governo Brasileiro
        ************************************************
        
        .. contents:: Conteúdo
           :depth: 2
        
        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 <http://www.planalto.gov.br/ccivil_03/_Ato2011-2014/2013/Lei/L12813.htm>`_ 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:
        
        .. image:: http://img.shields.io/pypi/v/brasil.gov.agenda.svg
            :target: https://pypi.python.org/pypi/brasil.gov.agenda
        
        .. image:: https://img.shields.io/travis/plonegovbr/brasil.gov.agenda/master.svg
            :target: http://travis-ci.org/plonegovbr/brasil.gov.agenda
        
        .. image:: https://img.shields.io/coveralls/plonegovbr/brasil.gov.agenda/master.svg
            :target: https://coveralls.io/r/plonegovbr/brasil.gov.agenda
        
        Instalação
        ------------
        
        Para habilitar a instalação deste produto em um ambiente que utilize o buildout:
        
        1. 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
        
        2. Após alterar o arquivo de configuração é necessário executar ''bin/buildout'', que atualizará sua instalação.
        
        3. Reinicie o Plone
        
        4. Acesse o painel de controle e instale o produto **Brasil.gov.br: Agenda de Membros do Governo Brasileiro**.
        
        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:
        
        .. code-block:: cfg
        
            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:
        
        .. code-block:: cfg
        
            extends =
                https://raw.github.com/collective/buildout.plonetest/master/test-4.3.x.cfg
                https://raw.github.com/collective/buildout.plonetest/master/qa.cfg
                http://downloads.plone.org.br/release/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 <https://webpack.js.org/>`_ 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 <https://github.com/simplesconsultoria/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:
        
        .. code-block:: console
        
            $ 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.
        
        .. code-block:: console
        
            $ 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.
        
        .. code-block:: console
        
            $ 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.
        
        .. code-block:: console
        
            $ bin/build-brasilgovagenda
        
        Este comando cria o CSS minificado, 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 <https://github.com/zestsoftware/zest.releaser/issues/261>`_ ou você vai criar uma distribuição quebrada:
        
        * execute ``longtest`` e ``fullrelease``, como de costume
        * responda "não" para evitar o upload ao PyPI e continue normalmente
        * 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 <https://upload.pypi.org/help/#file-name-reuse>`_.
        
        Colaboradores
        ---------------
        
        * Érico Andrei (ericof)
        * Felipe Duardo (felipeduardo)
        * Danilo Barbato (dbarbato)
        * Eduardo Goulart
        * Héctor Velarde (hvelarde)
        * Rodrigo Ferreira de Souza (rodfersou)
        
        Changelog
        ---------
        
        2.0a1 (2018-06-06)
        ^^^^^^^^^^^^^^^^^^
        
        - Adiciona dependência no plone4.csrffixes e corrige testes.
          [rodfersou]
        
        - Atualiza layout e funcionalidades da view de Agenda.
          [rodfersou]
        
        - Remove registro de subscribers durante migração de conteúdo;
          isso evita erros na importação dos compromissos de uma agenda.
          [hvelarde]
        
        - Remove dependência no five.grok da declaração de subscribers.
          [hvelarde]
        
        - Atualiza layout e funcionalidades do tile de Agenda.
          [rodfersou]
        
        - Adiciona suporte para processamento de recursos estáticos usando o `webpack`_.
          [rodfersou]
        
Keywords: plonegovbr agenda brasil plone dexterity
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.3
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: test
