ScoDoc-PE/tests/unit/sco_fake_gen.py

425 lines
13 KiB
Python
Raw Normal View History

2020-12-26 00:11:55 +01:00
# -*- mode: python -*-
# -*- coding: utf-8 -*-
"""Creation environnement pour test.
A utiliser avec debug.py (côté serveur).
La classe ScoFake offre un ensemble de raccourcis permettant d'écrire
facilement des tests ou de reproduire des bugs.
2020-12-26 00:11:55 +01:00
"""
2020-12-27 13:45:24 +01:00
from functools import wraps
2021-08-10 09:10:36 +02:00
import random
2020-12-26 00:11:55 +01:00
import sys
import string
2021-08-10 09:10:36 +02:00
import typing
2020-12-26 00:11:55 +01:00
from config import Config
2021-08-10 09:10:36 +02:00
from app.auth.models import User
2021-08-12 13:54:56 +02:00
from app.models import NotesFormModalite
2021-06-24 10:59:03 +02:00
from app.scodoc import notesdb as ndb
from app.scodoc import sco_codes_parcours
from app.scodoc import sco_edit_formation
from app.scodoc import sco_edit_matiere
from app.scodoc import sco_edit_module
from app.scodoc import sco_edit_ue
from app.scodoc import sco_etud
from app.scodoc import sco_evaluations
from app.scodoc import sco_formations
from app.scodoc import sco_formsemestre
from app.scodoc import sco_formsemestre_inscriptions
from app.scodoc import sco_formsemestre_validation
from app.scodoc import sco_moduleimpl
from app.scodoc import sco_saisie_notes
from app.scodoc import sco_synchro_etuds
from app.scodoc import sco_utils as scu
from app.scodoc.notes_log import log
from app.scodoc.sco_exceptions import ScoValueError
2020-12-26 00:11:55 +01:00
random.seed(12345) # tests reproductibles
2021-06-24 10:59:03 +02:00
2021-08-24 09:22:14 +02:00
DEMO_DIR = Config.SCODOC_DIR + "/tools/demo/"
2021-01-02 00:10:29 +01:00
NOMS = [x.strip() for x in open(DEMO_DIR + "/noms.txt").readlines()]
PRENOMS_H = [x.strip() for x in open(DEMO_DIR + "/prenoms-h.txt").readlines()]
PRENOMS_F = [x.strip() for x in open(DEMO_DIR + "/prenoms-f.txt").readlines()]
2021-06-24 10:59:03 +02:00
PRENOMS_X = [x.strip() for x in open(DEMO_DIR + "/prenoms-x.txt").readlines()]
2020-12-26 00:11:55 +01:00
def id_generator(size=6, chars=string.ascii_uppercase + string.digits):
return "".join(random.choice(chars) for _ in range(size))
2020-12-27 13:45:24 +01:00
def logging_meth(func):
@wraps(func)
def wrapper_logging_meth(self, *args, **kwargs):
r = func(self, *args, **kwargs)
# self.log("%s(%s) -> \n%s" % (func.__name__, kwargs, pprint.pformat(r)))
2020-12-27 13:45:24 +01:00
return r
return wrapper_logging_meth
2021-07-09 23:31:16 +02:00
class ScoFake(object):
2021-08-07 16:34:03 +02:00
"""Helper for ScoDoc tests"""
def __init__(self, verbose=True):
2020-12-26 00:11:55 +01:00
self.verbose = verbose
2021-08-10 09:10:36 +02:00
self.default_user = User.query.filter_by(user_name="bach").first()
if not self.default_user:
raise ScoValueError('User test "bach" not found !')
2020-12-26 00:11:55 +01:00
def log(self, msg):
if self.verbose:
print("ScoFake: " + str(msg), file=sys.stderr)
sys.stderr.flush()
log("ScoFake: " + str(msg))
def civilitenomprenom(self):
2020-12-26 00:11:55 +01:00
"""un nom et un prenom au hasard,
toujours en majuscules.
"""
civilite = random.choice(("M", "M", "M", "F", "F", "F", "X"))
if civilite == "F":
2020-12-26 00:11:55 +01:00
prenom = random.choice(PRENOMS_F)
elif civilite == "M":
2020-12-26 00:11:55 +01:00
prenom = random.choice(PRENOMS_H)
elif civilite == "X":
prenom = random.choice(PRENOMS_X)
else:
raise ValueError("invalid civilite value")
return civilite, random.choice(NOMS).upper(), prenom.upper()
2020-12-26 00:11:55 +01:00
2020-12-27 13:45:24 +01:00
@logging_meth
2020-12-26 00:11:55 +01:00
def create_etud(
self,
2020-12-26 00:11:55 +01:00
cnx=None,
code_nip="",
nom="",
prenom="",
code_ine="",
civilite="",
2020-12-26 00:11:55 +01:00
etape="TST1",
email="test@localhost",
emailperso="perso@localhost",
date_naissance="01/01/2001",
lieu_naissance="Paris",
dept_naissance="75",
domicile="1, rue du test",
codepostaldomicile="75123",
villedomicile="TestCity",
paysdomicile="France",
telephone="0102030405",
typeadresse="domicile",
boursier=None,
description="etudiant test",
):
"""Crée un étudiant"""
if not cnx:
2021-06-15 13:59:56 +02:00
cnx = ndb.GetDBConnexion()
2020-12-26 00:11:55 +01:00
if code_nip == "":
code_nip = str(random.randint(10000, 99999))
if not civilite or not nom or not prenom:
r_civilite, r_nom, r_prenom = self.civilitenomprenom()
if not civilite:
civilite = r_civilite
2020-12-26 00:11:55 +01:00
if not nom:
nom = r_nom
if not prenom:
prenom = r_prenom
etud = sco_etud.create_etud(cnx, args=locals())
inscription = "2020" # pylint: disable=possibly-unused-variable
sco_synchro_etuds.do_import_etud_admission(cnx, etud["etudid"], locals())
2020-12-26 00:11:55 +01:00
return etud
2020-12-27 13:45:24 +01:00
@logging_meth
2020-12-26 00:11:55 +01:00
def create_formation(
self,
acronyme="test",
titre="Formation test",
titre_officiel="Le titre officiel de la formation test",
type_parcours=sco_codes_parcours.ParcoursDUT.TYPE_PARCOURS,
formation_code=None,
code_specialite=None,
):
"""Crée une formation"""
2021-01-28 23:02:18 +01:00
if not acronyme:
2020-12-26 00:11:55 +01:00
acronyme = "TEST" + str(random.randint(100000, 999999))
2021-08-20 01:09:55 +02:00
oid = sco_edit_formation.do_formation_create(locals())
2021-08-19 10:28:35 +02:00
oids = sco_formations.formation_list(formation_id=oid)
2020-12-27 13:45:24 +01:00
if not oids:
raise ScoValueError("formation not created !")
return oids[0]
2020-12-26 00:11:55 +01:00
2020-12-27 13:45:24 +01:00
@logging_meth
def create_ue(
self,
formation_id=None,
acronyme=None,
numero=None,
titre="",
type=None,
ue_code=None,
ects=None,
is_external=None,
code_apogee=None,
coefficient=None,
):
"""Crée une UE"""
if numero is None:
2021-08-20 01:09:55 +02:00
numero = sco_edit_ue.next_ue_numero(formation_id, 0)
oid = sco_edit_ue.do_ue_create(locals())
oids = sco_edit_ue.do_ue_list(args={"ue_id": oid})
2020-12-27 13:45:24 +01:00
if not oids:
raise ScoValueError("ue not created !")
return oids[0]
@logging_meth
def create_matiere(self, ue_id=None, titre=None, numero=None):
2021-08-20 01:09:55 +02:00
oid = sco_edit_matiere.do_matiere_create(locals())
oids = sco_edit_matiere.do_matiere_list(args={"matiere_id": oid})
2020-12-27 13:45:24 +01:00
if not oids:
raise ScoValueError("matiere not created !")
return oids[0]
2020-12-26 00:11:55 +01:00
2020-12-27 13:45:24 +01:00
@logging_meth
def create_module(
self,
titre=None,
code=None,
heures_cours=None,
heures_td=None,
heures_tp=None,
coefficient=None,
ue_id=None,
formation_id=None,
matiere_id=None,
semestre_id=1,
numero=None,
abbrev=None,
ects=None,
code_apogee=None,
module_type=None,
):
2021-08-20 01:09:55 +02:00
oid = sco_edit_module.do_module_create(locals())
oids = sco_edit_module.do_module_list(args={"module_id": oid})
2020-12-27 13:45:24 +01:00
if not oids:
raise ScoValueError("module not created ! (oid=%s)" % oid)
return oids[0]
2020-12-26 00:11:55 +01:00
2020-12-27 13:45:24 +01:00
@logging_meth
def create_formsemestre(
self,
formation_id=None,
semestre_id=None,
titre=None,
date_debut=None,
date_fin=None,
etat=None,
gestion_compensation=None,
bul_hide_xml=None,
gestion_semestrielle=None,
bul_bgcolor=None,
2021-08-12 13:54:56 +02:00
modalite=NotesFormModalite.DEFAULT_MODALITE,
2020-12-27 13:45:24 +01:00
resp_can_edit=None,
resp_can_change_ens=None,
ens_can_edit_eval=None,
elt_sem_apo=None,
elt_annee_apo=None,
etapes=None,
2021-08-10 09:10:36 +02:00
responsables=None, # sequence of resp. ids
2020-12-27 13:45:24 +01:00
):
2021-08-10 09:10:36 +02:00
if responsables is None:
responsables = (self.default_user.id,)
oid = sco_formsemestre.do_formsemestre_create(locals())
2020-12-27 13:45:24 +01:00
oids = sco_formsemestre.do_formsemestre_list(
2021-08-19 10:28:35 +02:00
args={"formsemestre_id": oid}
2020-12-27 13:45:24 +01:00
) # API inconsistency
if not oids:
raise ScoValueError("formsemestre not created !")
return oids[0]
@logging_meth
def create_moduleimpl(
self,
2021-08-10 09:10:36 +02:00
module_id: int = None,
formsemestre_id: int = None,
responsable_id: typing.Optional[int] = None,
2020-12-27 13:45:24 +01:00
):
2021-08-10 09:10:36 +02:00
if not responsable_id:
responsable_id = self.default_user.id
2021-08-20 01:09:55 +02:00
oid = sco_moduleimpl.do_moduleimpl_create(locals())
oids = sco_moduleimpl.do_moduleimpl_list(moduleimpl_id=oid) # API inconsistency
2020-12-27 13:45:24 +01:00
if not oids:
raise ScoValueError("moduleimpl not created !")
return oids[0]
@logging_meth
def inscrit_etudiant(self, sem, etud):
2020-12-26 00:11:55 +01:00
sco_formsemestre_inscriptions.do_formsemestre_inscription_with_modules(
sem["formsemestre_id"],
etud["etudid"],
etat="I",
2020-12-27 13:45:24 +01:00
etape=etud.get("etape", None),
2020-12-26 00:11:55 +01:00
method="test_inscrit_etudiant",
)
2020-12-27 13:45:24 +01:00
@logging_meth
def create_evaluation(
self,
moduleimpl_id=None,
jour=None,
heure_debut="8h00",
heure_fin="9h00",
description=None,
note_max=20,
coefficient=None,
visibulletin=None,
publish_incomplete=None,
evaluation_type=None,
numero=None,
):
args = locals()
del args["self"]
oid = sco_evaluations.do_evaluation_create(**args)
oids = sco_evaluations.do_evaluation_list(args={"evaluation_id": oid})
2020-12-27 13:45:24 +01:00
if not oids:
raise ScoValueError("evaluation not created !")
return oids[0]
@logging_meth
def create_note(
self,
evaluation=None,
etud=None,
note=None,
comment=None,
2021-08-10 12:57:38 +02:00
user=None, # User instance
2020-12-27 13:45:24 +01:00
):
2021-08-10 12:57:38 +02:00
if user is None:
user = self.default_user
2020-12-27 13:45:24 +01:00
return sco_saisie_notes._notes_add(
2021-08-10 12:57:38 +02:00
user,
2020-12-27 13:45:24 +01:00
evaluation["evaluation_id"],
[(etud["etudid"], note)],
comment=comment,
)
2021-01-28 23:02:18 +01:00
def setup_formation(
self,
nb_semestre=1,
nb_ue_per_semestre=2,
nb_module_per_ue=2,
acronyme=None,
titre=None,
):
"""Création d'une formation, avec UE, modules et évaluations.
Formation avec `nb_semestre` comportant chacun `nb_ue_per_semestre` UE
et dans chaque UE `nb_module_per_ue` modules (on a une seule matière par UE).
Returns:
formation (dict), liste d'ue (dicts), liste de modules.
"""
2021-01-28 23:02:18 +01:00
f = self.create_formation(acronyme=acronyme, titre=titre)
ue_list = []
mod_list = []
for semestre_id in range(1, nb_semestre + 1):
for n in range(1, nb_ue_per_semestre + 1):
ue = self.create_ue(
formation_id=f["formation_id"],
acronyme="TSU%s%s" % (semestre_id, n),
titre="ue test %s%s" % (semestre_id, n),
)
ue_list.append(ue)
mat = self.create_matiere(ue_id=ue["ue_id"], titre="matière test")
for _ in range(nb_module_per_ue):
mod = self.create_module(
matiere_id=mat["matiere_id"],
semestre_id=semestre_id,
code="TSM%s" % len(mod_list),
coefficient=1.0,
titre="module test",
ue_id=ue["ue_id"], # faiblesse de l'API
formation_id=f["formation_id"], # faiblesse de l'API
)
mod_list.append(mod)
return f, ue_list, mod_list
def setup_formsemestre(
self,
f,
mod_list,
semestre_id=1,
date_debut="01/01/2020",
date_fin="30/06/2020",
nb_evaluations_per_module=1,
2021-01-28 23:02:18 +01:00
titre=None,
2021-08-10 12:57:38 +02:00
responsables=None, # list of users ids
2021-01-28 23:02:18 +01:00
modalite=None,
):
"""Création semestre, avec modules et évaluations."""
sem = self.create_formsemestre(
formation_id=f["formation_id"],
semestre_id=semestre_id,
date_debut=date_debut,
date_fin=date_fin,
2021-01-28 23:02:18 +01:00
titre=titre,
responsables=responsables,
modalite=modalite,
)
eval_list = []
for mod in mod_list:
if mod["semestre_id"] == semestre_id:
mi = self.create_moduleimpl(
module_id=mod["module_id"],
formsemestre_id=sem["formsemestre_id"],
responsable_id="bach",
)
for e_idx in range(1, nb_evaluations_per_module + 1):
e = self.create_evaluation(
moduleimpl_id=mi["moduleimpl_id"],
jour=date_debut,
description="evaluation test %s" % e_idx,
coefficient=1.0,
)
eval_list.append(e)
return sem, eval_list
def set_etud_notes_sem(
self, sem, eval_list, etuds, notes=None, random_min=0, random_max=20
):
"""Met des notes aux étudiants indiqués des evals indiquées.
Args:
sem: dict
eval_list: list of dicts
etuds: list of dicts
notes: liste des notes (float).
Si non spécifié, tire au hasard dans `[random_min, random_max]`
"""
set_random = notes is None
for e in eval_list:
if set_random:
notes = [float(random.randint(random_min, random_max)) for _ in etuds]
for etud, note in zip(etuds, notes):
self.create_note(evaluation=e, etud=etud, note=note)
def set_code_jury(
self,
sem,
etud,
code_etat=sco_codes_parcours.ADM,
devenir=sco_codes_parcours.NEXT,
assidu=True,
):
"""Affecte décision de jury"""
sco_formsemestre_validation.formsemestre_validation_etud_manu(
formsemestre_id=sem["formsemestre_id"],
etudid=etud["etudid"],
code_etat=code_etat,
devenir=devenir,
assidu=assidu,
)