A Python based open data API engine.
Project description
LIBRE: Libre Information Batch Restructuring Engine
The engine that’s powering the liberation of government data for the island of Puerto Rico.
Created by the Office of the Chief Information Officer of the Commonwealth of Puerto Rico
Turn this:
Into this!
Query your data afterwards too!
Installation
OS dependencies
LIBRE supports Spatial queries as such is dependant on several libraries that are installed at the OS level.
If using Ubuntu Linux install the required libraries with:
$ sudo apt-get install libgdal-dev -y
On OSX using MacPorts:
$ sudo port install geos
$ sudo port install gdal
Proceed to install the actual files of LIBRE:
Using pip
Via pip Python packager installer
$ pip install libre
$ libre-admin.py syncdb --migrate
$ cat <<'EOF' > settings_local.py
DEBUG=True
DEVELOPMENT=True
EOF
$ libre-admin.py runserver --pythonpath=.
From GitHub
By cloning the code from the GitHub repository:
$ git clone https://github.com/commonwealth-of-puerto-rico/libre.git
$ cd libre
$ virtualenv venv
$ source venv/bin/activate
$ pip install -r libre/requirements.txt
$ ./manage.py syncdb --migrate
$ cat <<'EOF' > settings_local.py
DEBUG=True
DEVELOPMENT=True
EOF
$ ./manage.py runserver
Docker container
Or by using Yamir Encarnacion’s Docker container:
Use this to build a new image, tagged for easier reuse
$ sudo docker build -t yencarnacion/libre-docker github.com/yencarnacion/libre-docker
Running the container
$ sudo docker run -d -p 8000:8000 yencarnacion/libre-docker
The default username and password for the Docker image are: Username: admin | Password: libre
Once up and running go to <your ip>:8000 in your browser to use LIBRE.
Documentation
Documentation is available at http://libre.readthedocs.org
Release History
1.0.0 (2013-09-19)
Accepted: Added Command Line Interface (CLI) for update_admin_user (#10)
Accepted: Added Pre-Installation Steps necessary to run on OSX (#9)
Closed: Added missing docutils requirement (#8)
Closed: Missing dependency on requirements (#4)
Closed: inotify is not available on macosx-10.8-intel (#2)
Accepted: Add slugify method for automatic slugs (#1)
Fix CSV source issues with CSV file encodings (utf-8, iso-8859-1) by allowing users to specify the file encoding.
Increased required version to Django to 1.5.5
Add scheduling support to Sources
Reduce the data source origin data check resolution to 45 seconds
Fail gracefully when GIS features have no bounds
Add new PythonScript origin
LIBRE is written and maintained by Roberto Rosario and various contributors:
Development Lead
Roberto Rosario <rrosario@ogp.pr.gov> [http://robertorosario.com]
Patches
Axel Rivera <github@riveralabs.com> [http://riveralabs.com]
Yamir Encarnación <info@webninjapr.com> [http://www.webninjapr.com]
Ideas and Suggestions
Andres Colón <levipr@gmail.com>
Bug reports
Carlos Feliciano <c.feliciano2009@gmail.com>
Soynerdito [https://github.com/soynerdito]
Rafael Arce [https://github.com/ran-research-lab]
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.