Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/commonwealth-of-puerto-rico/libre

LIBRE = Libre Information Batch Restructuring Engine.
https://github.com/commonwealth-of-puerto-rico/libre

Last synced: about 1 month ago
JSON representation

LIBRE = Libre Information Batch Restructuring Engine.

Awesome Lists containing this project

README

        

LIBRE: Libre Information Batch Restructuring Engine
===================================================

.. image:: https://travis-ci.org/commonwealth-of-puerto-rico/libre.png?branch=master
:target: https://travis-ci.org/commonwealth-of-puerto-rico/libre

.. image:: https://coveralls.io/repos/commonwealth-of-puerto-rico/libre/badge.png?branch=master
:target: https://coveralls.io/r/commonwealth-of-puerto-rico/libre?branch=master

.. image:: https://badge.fury.io/py/libre.png
:target: http://badge.fury.io/py/libre

.. image:: https://pypip.in/d/libre/badge.png
:target: https://crate.io/packages/libre/

Created by the `Office of the Chief Information Officer `_ of
the Commonwealth of Puerto Rico in 2013 as a prototype to show off the potential of opening data.

Resources of the Office of the CIO, once commited to this project, are no longer available.
We invite the community to continue its development.

.. image:: https://raw.github.com/commonwealth-of-puerto-rico/libre/master/docs/_static/libre_logo.png

.. image:: https://raw.github.com/commonwealth-of-puerto-rico/libre/master/docs/_static/main_diagram.png

Turn this:
----------

.. image:: https://raw.github.com/commonwealth-of-puerto-rico/libre/master/docs/_static/before.png

Into this!
----------

.. image:: https://raw.github.com/commonwealth-of-puerto-rico/libre/master/docs/_static/after.png

Query your data afterwards too!
-------------------------------

.. image:: https://raw.github.com/commonwealth-of-puerto-rico/libre/master/docs/_static/math_query.png

Links
=====

- Documentation: https://libre.readthedocs.org/en/latest/
- PyPI: https://pypi.python.org/pypi/libre
- Source: https://github.com/commonwealth-of-puerto-rico/libre
- Video: http://www.youtube.com/watch?v=pbY_dKlniHM

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:

.. code-block:: bash

$ sudo apt-get install libgdal-dev -y

On OSX using MacPorts:

.. code-block:: bash

$ sudo port install geos
$ sudo port install gdal

Proceed to install the actual files of **LIBRE**:

Using pip
---------

Via `pip `_ Python packager installer

.. code-block:: bash

$ 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:

.. code-block:: bash

$ 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

.. code-block:: bash

$ sudo docker build -t yencarnacion/libre-docker github.com/yencarnacion/libre-docker

Running the container

.. code-block:: bash

$ 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 `:8000` in your browser to use **LIBRE**.

.. image:: https://d2weczhvl823v0.cloudfront.net/commonwealth-of-puerto-rico/libre/trend.png
:target: https://bitdeli.com/free