CONTRIBUTING.md

# Contribuer au développement de Néobab

Ce projet utilise [Poetry][] pour gérer ses dépendances. Cet outil est nécessaire
pour la plupart des opérations de développement.

[Poetry]: https://python-poetry.org/docs

Il est conseillé de gérer manuellement son environnement virtuel afin de
ne pas avoir à ajouter `poetry run` avant chaque commande.

Pour installer le logiciel et ses dépendances de développement :

    $ poetry install

Pour lancer le serveur :

    $ invoke -e serve

Avant de *commiter* des changements :

    $ invoke -e format test

Pour avoir la liste des commandes disponibles :

    $ invoke -l

Pour créer un paquet Python :

    $ invoke -e build
    $ # Si nécessaire, enregistrer les modifications.
    
    $ export VERSION="x.y.z"
    $ poetry version $VERSION
    $ git ci -m "Incrémente la version à $VERSION." pyproject.toml
    $ git tag -a $VERSION -m "version $VERSION"
    $ poetry build
    $ poetry publish -r <REPO_NAME>


## Gestion de la base de données

Pour générer une nouvelle migration après une modification du schéma :

    $ neobab config.ini revision add "Description du changement"
    $ # la passer en revue
    $ neobab config.ini db migrate


## Gestion des traductions

Quand des chaînes à traduire ont été rajoutées dans le code, il faut les extraire :

    $ invoke -e i18n.extract i18n.update

Il faut ensuite procéder à leur traduction avec, par exemple, [Poedit][] :

    $ poedit neobab/locale/fr_FR/LC_MESSAGES/neobab.po

Poedit devrait générer la version compilée (`.mo`), mais cela peut aussi être fait
manuellement.

    $ invoke -e i18n.compile

[Poedit]: https://poedit.net/


## Génération du schéma de la base de données

La génération du schéma dépend de `dot` qui est disponible dans la suite logiciel
`graphviz`.

    $ python utils/extract_schema.py development.ini doc/db_schema.png