Installation d’un environnement de développement local

Les différents modules sont sur https://git.0d.be/, ils sont nommés django-panik-* pour les modules partagés et panikdb pour PanikDB et panikweb pour la partie site web (il y a aussi des modules panikweb-* pour les spécificités de différentes radios).

Pour démarrer en local il vaut mieux utiliser une version récente de Debian (une version d’Ubuntu doit également fonctionner mais ça n’est pas testé).

Dans un répertoire servant au projet, il suffit de télécharger les différents modules via git, ex :

mkdir ~/src/maradio
cd ~/src/maradio
git clone https://git.0d.be/g/panikdb.git

Ensuite, depuis le répertoire de panikdb, le script setup_dev_env.py peut être utilisé pour déployer le nécessaire, c’est-à-dire lancer l’installation de quelques paquets système (installés en utilisant sudo apt install, il faut donc nécessairement que le compte utilisé puisse utiliser cette commande), les différentes dépendances des modules, et télécharger si nécessaire les modules complémentaires à panikdb.

Ce script doit être exécuté depuis un environnement virtuel Python pour ne pas interférer avec l’installation générale.

cd ~/src/maradio/panikdb
python3 -m venv ~/src/maradio/env
source ~/src/maradio/env/bin/activate
python3 setup_dev_env.py

Une fois l’installation terminée, il reste quelques éléments à configurer, il est possible pour cela de créer un fichier local_settings.py dans le répertoire du module panikdb (i.e. ~/src/maradio/panikdb/panikdb/ ← attention au double panikdb), c’est dans ce fichier que se paramétrera par exemple l’accès à la base de données,

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'radio',
        'USER': '',
        'PASSWORD': '',
        'HOST': '',
        'PORT': '',
    },
}

Alternativement au fichier local_settings.py, il est possible de pointer des fichiers  de configuration via les variables d’environnement PANIKDB_SETTINGS_FILE et PANIKWEB_SETTINGS_FILE.