ScoDoc/tests/api
Emmanuel Viennet b1a45b34f5 API: groups_auto_assignment 2023-05-17 20:54:10 +02:00
..
README.md Automatise les tests unitaires de l'API 2022-12-07 13:22:11 +01: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-05-17 20:53:20 +02:00
exemple-api-basic.py misc minor code cosmetic : no change 2023-03-09 14:24:12 +01:00
exemple-api-scodoc7.py Ajout de timeouts sur toutes les requêtes externes (y compris tests API) 2023-04-06 10:38:31 +02:00
make_samples.py Assiduités : Ajout des tests (Unit/API) 2023-04-17 15:48:30 +02:00
setup_test_api.py Génère JSON avec Flask-JSON. Abandonne jsonify. 2023-05-17 20:52:06 +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_absences.py Ajout de timeouts manquants sur tests API 2023-04-06 11:48:36 +02:00
test_api_assiduites.py Assiduités : Ajout des tests (Unit/API) 2023-04-17 15:48:30 +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 Ajout de timeouts sur toutes les requêtes externes (y compris tests API) 2023-04-06 10:38:31 +02:00
test_api_evaluations.py Ajout de timeouts manquants sur tests API 2023-04-06 11:48:36 +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.py Associations UE / Parcours: UI 2023-05-17 20:53:20 +02:00
test_api_formsemestre_data.py API: groups_auto_assignment 2023-05-17 20:54:10 +02:00
test_api_jury.py API: modif formsemestre/etudiant. TESTS unitaires OK sauf logos. 2022-08-08 10:06:42 +02:00
test_api_justificatif.txt Assiduités : Ajout des tests (Unit/API) 2023-04-17 15:48:30 +02:00
test_api_justificatif2.txt Assiduités : Ajout des tests (Unit/API) 2023-04-17 15:48:30 +02:00
test_api_justificatifs.py Assiduités : Ajout des tests (Unit/API) 2023-04-17 15:48:30 +02:00
test_api_logos.py Ajout de timeouts sur toutes les requêtes externes (y compris tests API) 2023-04-06 10:38:31 +02:00
test_api_partitions.py Ajout explications sur édition partitions + un test unitaire 2023-05-17 20:53:20 +02:00
test_api_permissions.py Génère JSON avec Flask-JSON. Abandonne jsonify. 2023-05-17 20:52:06 +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 Fix test API formation et ajout d'un test (test_formation_export_with_ids) 2023-01-31 15:19:00 -03: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

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

    1. 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
    
  2. On lance le serveur ScoDoc sur cette base

    flask run --host 0.0.0.0
    
  3. 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