History

Emmanuel Viennet 0eb00b0919 API doc: ameliore script sample + sample evaluation		2023-08-28 12:15:53 +02:00
..
__init__.py	Fixes #374 : bulletins BUT si non publiés	2022-05-04 05:45:46 +02:00
dotenv_exemple	Automatise les tests unitaires de l'API	2022-12-07 13:22:11 +01:00
essai_tous_semestres.py	mini-script d'essai de l'API	2023-04-13 08:42:53 +02:00
exemple-api-basic.py	WIP: modernisation evaluations	2023-08-22 17:05:04 +02:00
exemple-api-scodoc7.py	WIP: modernisation evaluations	2023-08-22 17:05:04 +02:00
make_samples.py	API doc: ameliore script sample + sample evaluation	2023-08-28 12:15:53 +02:00
README.md	Automatise les tests unitaires de l'API	2022-12-07 13:22:11 +01:00
setup_test_api.py	Fix tests unitaires API (ok)	2023-08-27 22:18:57 +02:00
start_api_server.sh	Building script: integrate full unit tests and API tests	2023-02-21 12:46:52 +01:00
test_api_assiduites.py	Fix tests unitaires API (ok)	2023-08-27 22:18:57 +02:00
test_api_billets.py	renomme /billets_absence/add en /billets_absence/create	2022-08-02 08:48:08 +02:00
test_api_departements.py	Ajout de timeouts sur toutes les requêtes externes (y compris tests API)	2023-04-06 10:38:31 +02:00
test_api_etudiants.py	Modification codage dates évaluations	2023-08-25 17:58:57 +02:00
test_api_evaluations.py	API evaluation: create avec poids, /delete + tests unitaires + corrections	2023-08-26 16:34:56 +02:00
test_api_formations.py	Ajout de timeouts sur toutes les requêtes externes (y compris tests API)	2023-04-06 10:38:31 +02:00
test_api_formsemestre_data.py	API: groups_auto_assignment	2023-05-15 23:39:08 +02:00
test_api_formsemestre.py	Fix tests unitaires API (ok)	2023-08-27 22:18:57 +02:00
test_api_jury.py	Nouvelle page de visu/saisie des décisions RCUEs: validation_rcues	2023-07-16 19:59:45 +02:00
test_api_justificatif2.txt	Assiduités : Ajout des tests (Unit/API)	2023-06-02 11:41:35 +02:00
test_api_justificatif.txt	Assiduités : Ajout des tests (Unit/API)	2023-06-02 11:41:35 +02:00
test_api_justificatifs.py	Assiduites : external_data + raison null	2023-07-31 16:16:18 +02:00
test_api_logos.py	- API: added POST etudiant/etudid/int:etudid/photo	2023-08-11 23:15:17 +02:00
test_api_partitions.py	Ajout explications sur édition partitions + un test unitaire	2023-04-13 08:41:16 +02:00
test_api_permissions.py	- API: added POST etudiant/etudid/int:etudid/photo	2023-08-11 23:15:17 +02:00
test_api_users.py	Test API: fix (login utilisateur unique)	2023-01-31 15:25:24 -03:00
test_test.py	Fix #578 API : Gestion semestre verrouillé. + tests unitaires API OK.	2023-01-24 08:12:24 -03:00
tools_test_api.py	Modification codage dates évaluations	2023-08-25 17:58:57 +02:00

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