IDK/ScoDoc

History

Emmanuel Viennet 5ec598e693 Recherche étudiant: réparations et améliorations		2024-07-03 21:32:33 +02:00
..
__init__.py
dotenv_exemple
dump_all_results.py	Script API pour enregistrer tous les résultats.	2024-05-25 13:03:51 +02:00
essai_tous_semestres.py
exemple-api-basic.py
exemple-api-list-modules.py
exemple-api-scodoc7.py
make_samples.py
README.md
setup_test_api.py	Edition en ligne des codes Apgee UE/RCUE. Ajout API.	2024-06-21 00:53:52 +02:00
start_api_server.sh
test_api_assiduites.py	Remise en état api/assiduites/evaluations	2024-06-26 11:23:58 +02:00
test_api_billets.py
test_api_departements.py	API departement: ameliore code et doc.	2024-06-22 17:02:29 +02:00
test_api_etudiants.py	Améliore/met à jour tests unitaires API	2024-04-11 06:00:00 +02:00
test_api_evaluations.py
test_api_formations.py	Recherche étudiant: réparations et améliorations	2024-07-03 21:32:33 +02:00
test_api_formsemestre_data.py
test_api_formsemestre.py	Edition en ligne des codes Apgee UE/RCUE. Ajout API.	2024-06-21 00:53:52 +02:00
test_api_jury.py
test_api_justificatif2.txt
test_api_justificatif.txt
test_api_justificatifs.py	Assiduité : ajout test api manquant closes #689	2024-03-01 12:56:00 +01:00
test_api_logos.py
test_api_partitions.py
test_api_permissions.py	Fix API unit test	2024-06-23 21:13:40 +02:00
test_api_users.py
test_test.py
tools_test_api.py

README.md

Tests unitaires de l'API ScoDoc

Lancement des tests

La première fois, copier le fichier tests/api/dotenv_exemple vers tests/api/.env. Il est normalement inutile de modifier son contenu.

Dans un shell, lancer le script start_api_server.py, qui se charge d'initialiser une base SQL de test et de lancer le serveur ScoDoc approprié.

tests/api/start_api_server.sh

Dans un autre shell, lancer les tests:

pytest tests/api

Notes sur la démarche

On génère une base SQL de test: voir tools/fakedatabase/create_test_api_database.py

En tant qu'utilisateur scodoc, lancer:

# evite de modifier /opt/scodoc/.env
export FLASK_ENV=test_api
export FLASK_DEBUG=1 
tools/create_database.sh --drop SCODOC_TEST_API
flask db upgrade
flask sco-db-init --erase
flask init-test-database

en plus court:

export FLASK_ENV=test_api && tools/create_database.sh --drop SCODOC_TEST_API && flask db upgrade &&flask sco-db-init --erase && flask init-test-database

On lance le serveur ScoDoc sur cette base
```
flask run --host 0.0.0.0
```
On lance les tests unitaires API

    pytest tests/api/test_api_departements.py

Rappel: pour interroger l'API, il fait avoir un utilisateur avec (au moins) la permission ScoView dans tous les départements. Pour en créer un:

 flask user-create lecteur_api LecteurAPI @all
 flask user-password lecteur_api
 flask edit-role LecteurAPI -a ScoView
 flask user-role lecteur_api -a LecteurAPI