Publics pt is an open source Django website and API to query and analyse data of the portuguese state. Thanks for checking it out.
The portuguese state does not provide a consistent way to query public data, nor relating this data. This website aims to:
- Provide a consistent way to query portuguese public data using Django ORM
- Interrelate different public data
- Extract and present statistical features of the data
This project consists of 4 components:
- A set of crawlers and validators that retrieve information from official databases and store them in Django models
- A set of Django models (in Django Apps) to store the data in a database
- A database with read access to anyone so anyone can query it by git-cloning this code.
- A website that uses the above points to provide some statistical features of the databases
We focus on three aspects of the portuguese state:
- Public Contracts: contracts between entities with a value and other fields.
- Members of the Parliament: Persons that have mandates in legislatures of the parliament.
- Laws: documents that are officially published as laws.
We use Django ORM for the API and database and d3.js for visualisations of statistical quantities of the database. The official website is written in English and translated to portuguese (via i18n), also hosted here.
The code is licenced under BSD.
The API and the crawler are documented.
1- Install Django and bindings to mysql.
pip install django
pip install PyMySQL
2- Install django-treebeard, a dependency.
pip install django-treebeard
3- Download the source
git clone [email protected]:jorgecarleitao/public-contracts.git
Enter in the project's directory: cd public-contracts.
4- Run the example:
python -m contracts.tools.example
you should see two numbers.
If something went wrong, please report an issue so we can help you and improve these instructions.