Search and consult CADA advices
Project description
A simplistic interface to search and consult CADA advices.
This is the engine behing http://cada.data.gouv.fr.
Compatibility
CADA has been tested on Python 2.7, MongoDB 2.4+ and ElasticSearch 1.1.
The ElasticSearch ICU Analysis plugin is required.
You can install it with:
bin/plugin -install elasticsearch/elasticsearch-analysis-icu/2.1.0
Installation
You can install Cada with pip:
$ pip install cada
or with easy_install:
$ easy_install cada
You need to create the cada working directory, designed by $HOME in this documentation:
$ mkdir -p $HOME && cd $HOME $ vim cada.cfg # See configuration $ wget http://cada.data.gouv.fr/export -O data.csv $ cada load data.csv # Load initial data $ cada static # Optionnal: collect static assets for proper caching $ cada runserver
Configuration
All configuration is done trhough the cada.cfg file in $HOME. It’s basically a Python file with constants defined in it:
SERVER_NAME: the public server name. Mainly used in emails.
SECRET_KEY: the common crypto hash.Used for session by exemple.
ELASTICSEARCH_URL: the ElasticSearch server URL in host:port format. Default to localhost:9200 if not set
MONGODB_SETTINGS: a dictionnary to configure MongoDB. Default to {'DB': 'cada'}. See the official flask-mongoengine documentation for more details.
Mails
Mail server configuration is done through the following variables:
MAIL_SERVER: SMTP server hostname. Default to localhost.
MAIL_PORT: SMTP server port. Default to 25.
MAIL_USE_TLS: activate TLS. Default to False.
MAIL_USE_SSL: activate SSL. Default to False.
MAIL_USERNAME: optionnal SMTP server username.
MAIL_PASSWORD: optionnal SMTP server password.
MAIL_DEFAULT_SENDER: Sender email used for mailings. Default to cada@localhost.
ANON_ALERT_MAIL: destination mail for anonimysation alerts. Default to cada.alert@localhost.
See the official Flask-Mail documentation for more details.
Sentry
There is an optionnal support for Sentry. You need to install the required dependencies:
$ pip install raven[flask] # Or, to install it with cada $ pip install cada[sentry]
You need to add your Sentry DSN to the configuration
SENTRY_DSN = 'https://xxxxx:xxxxxx@sentry.mydomain.com/id'
Piwik
There is an optionnal Piwik support. You simply need to add your Piwik server URL and your Piwik project ID to the configuration:
PIWIK_URL = 'piwik.mydomain.com' PIWIK_ID = X
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.