Uniform access to data sources and services
Go to file
Frédéric Péters c372900be9
gitea-wip/passerelle/pipeline/head There was a failure building this commit Details
gitea/passerelle/pipeline/head Something is wrong with the build of this commit Details
tox: limit enum34 to 1.1.6, for python 2 compatibility
failed build: https://jenkins.entrouvert.org/job/passerelle/1170/consoleFull
2020-02-22 10:00:10 +01:00
debian debian: log tenants names on migrate_schemas (#39779) 2020-02-12 15:24:01 +01:00
functests toulouse_axel: add labels to explain some values (#39291) 2020-02-13 15:47:05 +01:00
passerelle lille urban card: make photo optional (#40085) 2020-02-22 09:37:09 +01:00
tests remove tlmcom connector (#39778) 2020-02-20 15:34:28 +01:00
.coveragerc add .coveragerc to omit south_migrations/ directories 2015-04-17 16:00:55 +02:00
.gitignore gitignore: add build and htmlcov (#37479) 2019-11-13 13:19:39 +01:00
Jenkinsfile jenkins: run tests against python3 (#38781) 2020-01-29 10:30:47 +01:00
LICENSE this will be AGPL 2013-02-11 11:04:19 +01:00
MANIFEST.in sp_fr: distribute XSD files (#31595) 2019-04-29 17:16:30 +02:00
README misc: remove legal info of deleted icon file (#21134) 2018-01-12 08:41:57 +01:00
config_example.py New organization of settings 2014-10-02 09:54:39 +02:00
get_wcs.sh misc: reduce verbosity of get_wcs.sh and pylint.sh 2019-11-19 17:29:43 +01:00
jenkins.sh run pylint inside tox 2016-06-09 16:37:30 +02:00
manage.py settings: changed to single file, with a execfile() tacked at the end (#6465) 2015-02-10 13:06:55 +01:00
pylint.sh misc: reduce verbosity of get_wcs.sh and pylint.sh 2019-11-19 17:29:43 +01:00
requirements.txt update dependances, accepting django 1.11 (#19890) 2017-11-29 01:07:58 +01:00
setup.py setup: use cmis-maykin in python install (#38781) 2020-01-29 10:30:47 +01:00
tox.ini tox: limit enum34 to 1.1.6, for python 2 compatibility 2020-02-22 10:00:10 +01:00

README

Passerelle provides an uniform access to multiple data sources and services.

Quickstart
==========

Setting up an environment (virtualenv)
--------------------------------------

The first thing you'll need is the Python virtualenv package. You probably
already have this, but if not, you can install it with:

    $ easy_install -UZ virtualenv

Once that's done, choose a location for the environment, and create it with the
virtualenv command. For our guide, we're going to choose "venv" in the current
directory:

    $ virtualenv venv
    $ source venv/bin/activate

From Passerelle source directory install required Python packages:

    $ pip install -e .

Initializing the database (quickstart: sqlite3)
-----------------------------------------------

To create the database, execute the following line:

    $ python manage.py migrate

The new database is created inside `passerelle.sqlite3` in the current
directory.

Create a first user with administrative rights:

    $ python manage.py createsuperuser


Running
-------

The command line for starting is:

    $ python manage.py runserver

Passerelle is available on http://127.0.0.1:8000/


Settings
--------

Default settings are loaded from settings.py, they can be overloaded by a
local_settings.py file set in the same directory, or by a file referenced
in the PASSERELLE_SETTINGS_FILE environment variable.


Tests
-----

Unit tests are written using py.test, and its pytest-django support library and
run using tox.

  tox

To run a specific test under a specific environment.

  tox -e django18 -- tests/test_csv_datasource.py

LICENSES
========

Passerelle
Copyright (C) 2013-2014 Entr'ouvert <info@entrouvert.com>

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU Affero General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option) any
later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See the GNU Affero General Public License for more
details.

You should have received a copy of the GNU Affero General Public License along
with this program (LICENSE file). If not, see <http://www.gnu.org/licenses/>.


Copyright
---------

django-jsonresponse (https://github.com/jjay/django-jsonresponse)
 # Files: passerelle/utils/jsonresponse.py
 # Copyright (c) 2012 Yasha Borevich <j.borevich@gmail.com>
 # Licensed under the BSD license