Sistema de Apoio ao Processo Legislativo
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Edward Ribeiro bb3fe7e8aa Add model and new template to painel 9 years ago
.tx Add transifex project config 10 years ago
base Add help topics 10 years ago
comissoes Refactor data migration 10 years ago
legacy Fix pep8 and import sort order 9 years ago
lexml Add missing migrations 10 years ago
locale Update translation files 10 years ago
materia Change all integer model fields to positive 10 years ago
norma Change all integer model fields to positive 10 years ago
painel Add model and new template to painel 9 years ago
parlamentares Add dynamic fields to form in sessao 10 years ago
protocoloadm Change all integer model fields to positive 10 years ago
requirements Add model and new template to painel 9 years ago
sapl Add missing setting for crispy forms + foundation 9 years ago
scripts Add model and new template to painel 9 years ago
sessao Removed field from PresencaOrdemDia 9 years ago
static Add template to Painel in Sessao 9 years ago
templates Add model and new template to painel 9 years ago
.coveragerc Add coverage config file 10 years ago
.gitignore Ignore SASS maps and cache 10 years ago
.travis.yml Add travis conf for basic tests 10 years ago
README.rst Update README on how to run tests after migrations 10 years ago
conftest.py Sort all imports using isort 10 years ago
manage.py Init 10 years ago
pytest.ini Detach legacy migration settings and requirements 10 years ago
qa_check.sh Ignore migrations and ipython_log in isort check 10 years ago
test_and_qa_check.sh Ignore migrations and ipython_log in isort check 10 years ago

README.rst


***********************************************
SAPL - Legislative Process Support System
***********************************************

This page brings together useful information on the current development of
**SAPL - Sistema de Apoio ao Processo Legislativo** (Legislative Process Support System).

That means all information presented here applies only to **version 3.1** and greater.

For more information about the the project as a whole and the current working version of the system (2.5)
please visit the `project page at Interlegis wiki <https://colab.interlegis.leg.br/wiki/ProjetoSapl>`_.


Development Environment Installation
====================================

* Install the following system dependencies (command bellow for Ubuntu)::

sudo apt-get install python3-dev libpq-dev graphviz-dev graphviz \
postgresql postgresql-contrib pgadmin3 python-psycopg2 nodejs npm

sudo npm install -g bower

* Create a virtualenv using python 3 for the project and activate it.
If you use `virtualenvwrapper <https://virtualenvwrapper.readthedocs.org/en/latest/install.html#basic-installation>`_::

mkvirtualenv -p /usr/bin/python3 sapl

* Install python dependencies (run on the project root)::

pip install -r requirements/dev-requirements.txt

* Install bower dependencies (run on the project root)::

./manage.py bower install

* Install `PostgreSQL <https://help.ubuntu.com/community/PostgreSQL>`_ if you haven't already.

* Create a ``sapl`` role with:

- Password ``sapl``
- The privilege ``can create databases``
- A big expiration date (or infinite, using eg ``ALTER ROLE SAPL VALID UNTIL 'infinity';``)

* Create a database ``sapl`` with owner ``sapl``.

* Either run ``./manage.py migrate`` (for an empty database) or restore a database dump.


Instructions for Translators
============================

We use `Transifex <https://www.transifex.com>`_ to manage the project's translations.
If you want to contribute, please setup an account there and request to join us at
the `Transifex SAPL Page <https://www.transifex.com/projects/p/sapl>`_.
Once your join request is accepted, you can start to translate.

To integrate the last translations on a working instance follow these steps:

* Follow the instructions at `Development Environment Installation`_.

* Install `Transifex Client <http://docs.transifex.com/client/config/>`_.

.. warning::
The Transifex Client stores passwords in plain text on the file ``~/.transifexrc``.

We personally prefer to log into Transifex website with social network credentials and change the password used for the client frequently.

* `Pull translations <http://docs.transifex.com/client/pull/>`_ or `push translations <http://docs.transifex.com/client/push/>`_ using the client. Pull only on a clean repo, i.e. commit your changes before pulling new translations.

* Run the program with ``.manage.py runserver`` and check the system to see the translations into effect.

.. note::
The browser language preference is used to choose the translations to display.


General implementation guidelines
=================================

Best practices
--------------

* Use English for all the code, commit messages and project docs.

* Commit messages following the standard 50/72 columns. Start every commit message with a verb in infinitive. For more info on this please check:

- Http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
- Http://stackoverflow.com/questions/2290016/git-commit-messages-50-72-formatting

* Keep all code in standard PEP8 (without exceptions).

* Before every ``git push``:
- Run ``git pull --rebase`` (almost allways).
- In exceptional cases simply use ``git pull`` to produce a merge.

* Before ``git commit``, always:
- Run ``./manage.py check``
- Run all tests with ``py.test`` at the root of the project tree

.. attention::
The database user ``sapl`` needs to have the permission ``create database`` in postgres for the tests to complete successfully

* If you're not part of the core team, fork the repo and submit pull requests.
All are welcome to contribute. Please make a separate pull request for each bugfix/new feature.

* New features are subject to approval, since they may impact a lot of people.
We suggest you open an issue to discuss new features. That can be made in Portuguese, as well as in English.


Tests
-----

* Write tests for all the functionality you implement.

* Keep the test coverage near 100%.

* To run all tests activate your virtualenv and issue these commands
**at the root of the repository**::

py.test

* To run the tests with coverage issue the command::

py.test --cov . --cov-report term --cov-report html && firefox htmlcov/index.html

* The first time you run the tests after a migration (``./manage.py migrate``) use the db recreation option.
This needs to be done only once::

py.test --create-db

Issues
------

* Open all issues about the current development version (3.1) at the
`Github Issue Tracker <https://github.com/interlegis/sapl/issues>`_.

* You can file issues in either Portuguese or English (at least for the time being).