5c1bc42918 | ||
---|---|---|
.vscode | ||
resources | ||
src | ||
.editorconfig | ||
.flake8 | ||
.gitignore | ||
.prettierrc | ||
.pylintrc | ||
.yamllint | ||
MANIFEST.in | ||
Makefile | ||
NOTE.md | ||
README.md | ||
config.yml | ||
docker-compose.yml | ||
pyproject.toml | ||
requirements.txt | ||
setup.cfg | ||
setup.py | ||
thsf.Dockerfile | ||
thsf.net.code-workspace |
README.md
THSF.NET
Le site du THSF
Fonctionnement du site
Le site du THSF est une application Python Flask configurée à partir du fichier config.yml
situé à la racine du dépôt.
Il n'est généralement pas nécessaire de modifier ce fichier de configuration, cependant il ets possible d'augmenter le niveau de log en modifiant la clef de configuration log::root::level
en la passant à DEBUG
(valeur en production: INFO
).
Conteneur
Un fichier thsf.Dockerfile
ainsi que le fichier docker-compose.yml
correspondant permettront de rapidement démarrer localement une instance du site du THSF.
Démarrer une instance du site du THSF
Assurez vous d'avoir l'environnement de conteneurisation adéquat (i.e: docker + docker-compose) puis exécuter directement les commandes suivantes depuis la racine du dépôt:
docker-compose build
docker-compose up -d
Le site du THSF écoutera alors sur le port TCP/8042:
http://127.0.0.1:8042
Arrêter une instance du site du THSF
docker-compose down
Apporter des modifications au site
Important: Avant d'apporter la moindre modification, pensez à créer une nouvelle branche à l'aide de la commande suivante en remplaçant ma_branche
par le nom de votre branche:
git checkout -b ma_branche
Le code de l'application Python Flask se situe dans le répertoire src
et une fois votre branche créée, vous pouvez apporter toutes les modification souhaitées.
Créer un patch contenant toutes vos modifications
Une fois satisfaits de vos modifications vous pouvez créer un patch regroupant l'ensemble de vos modifications à l'aide la commande suivante
git diff -u --patch master..ma_branche > mes_modifications.patch
Vous pouvez faire parvenir votre fichier de patch à contact@tetalab.org pour que vos modifications soient incorporées au site après vérification.
Publication automatisée des modifications
Note: Cette partie ne concerne que les personnes ayant un accès en écriture sur le dépôt Git.
Il n'est pas possible de pousser directement des modifications sur la branche master
.
Pour modifier le site, il est nécessaire de créer une branche spécifique et d'y pousser vos modifications.
Lorsque vous êtes satisfaits de vos modifications, vous pouvez créer une demande d'ajout de votre branche sur la branche master
.
Lorsque la demande de fusion sera acceptée, vos modifications seront automatiquement publiées sur le site du THSF.
Vous pouvez auto-accepter vos demandes de fusion si vous faites partie des développeurs autorisés.