forked from ScoDoc/ScoDoc
337 lines
11 KiB
Python
337 lines
11 KiB
Python
# -*- coding: UTF-8 -*
|
|
|
|
"""Model : site config WORK IN PROGRESS #WIP
|
|
"""
|
|
|
|
from flask import flash
|
|
from app import current_app, db, log
|
|
from app.comp import bonus_spo
|
|
from app.scodoc import sco_utils as scu
|
|
|
|
from app.scodoc.codes_cursus import (
|
|
ABAN,
|
|
ABL,
|
|
ADC,
|
|
ADJ,
|
|
ADJR,
|
|
ADM,
|
|
AJ,
|
|
ATB,
|
|
ATJ,
|
|
ATT,
|
|
CMP,
|
|
DEF,
|
|
DEM,
|
|
EXCLU,
|
|
NAR,
|
|
PASD,
|
|
PAS1NCI,
|
|
RAT,
|
|
RED,
|
|
)
|
|
|
|
CODES_SCODOC_TO_APO = {
|
|
ABAN: "ABAN",
|
|
ABL: "ABL",
|
|
ADC: "ADMC",
|
|
ADJ: "ADM",
|
|
ADJR: "ADM",
|
|
ADM: "ADM",
|
|
AJ: "AJ",
|
|
ATB: "AJAC",
|
|
ATJ: "AJAC",
|
|
ATT: "AJAC",
|
|
CMP: "COMP",
|
|
DEF: "NAR",
|
|
DEM: "NAR",
|
|
EXCLU: "EXC",
|
|
NAR: "NAR",
|
|
PASD: "PASD",
|
|
PAS1NCI: "PAS1NCI",
|
|
RAT: "ATT",
|
|
RED: "RED",
|
|
"NOTES_FMT": "%3.2f",
|
|
}
|
|
|
|
|
|
def code_scodoc_to_apo_default(code):
|
|
"""Conversion code jury ScoDoc en code Apogée
|
|
(codes par défaut, c'est configurable via ScoDocSiteConfig.get_code_apo)
|
|
"""
|
|
return CODES_SCODOC_TO_APO.get(code, "DEF")
|
|
|
|
|
|
class ScoDocSiteConfig(db.Model):
|
|
"""Config. d'un site
|
|
Nouveau en ScoDoc 9: va regrouper les paramètres qui dans les versions
|
|
antérieures étaient dans scodoc_config.py
|
|
"""
|
|
|
|
__tablename__ = "scodoc_site_config"
|
|
|
|
id = db.Column(db.Integer, primary_key=True)
|
|
name = db.Column(db.String(128), nullable=False, index=True)
|
|
value = db.Column(db.Text())
|
|
|
|
BONUS_SPORT = "bonus_sport_func_name"
|
|
NAMES = {
|
|
BONUS_SPORT: str,
|
|
"always_require_ine": bool,
|
|
"SCOLAR_FONT": str,
|
|
"SCOLAR_FONT_SIZE": str,
|
|
"SCOLAR_FONT_SIZE_FOOT": str,
|
|
"INSTITUTION_NAME": str,
|
|
"INSTITUTION_ADDRESS": str,
|
|
"INSTITUTION_CITY": str,
|
|
"DEFAULT_PDF_FOOTER_TEMPLATE": str,
|
|
"enable_entreprises": bool,
|
|
"month_debut_annee_scolaire": int,
|
|
"month_debut_periode2": int,
|
|
# CAS
|
|
"cas_enable": bool,
|
|
"cas_server": str,
|
|
"cas_login_route": str,
|
|
"cas_logout_route": str,
|
|
"cas_validate_route": str,
|
|
"cas_attribute_id": str,
|
|
}
|
|
|
|
def __init__(self, name, value):
|
|
self.name = name
|
|
self.value = value
|
|
|
|
def __repr__(self):
|
|
return f"<{self.__class__.__name__}('{self.name}', '{self.value}')>"
|
|
|
|
@classmethod
|
|
def get_dict(cls) -> dict:
|
|
"Returns all data as a dict name = value"
|
|
return {
|
|
c.name: cls.NAMES.get(c.name, lambda x: x)(c.value)
|
|
for c in ScoDocSiteConfig.query.all()
|
|
}
|
|
|
|
@classmethod
|
|
def set_bonus_sport_class(cls, class_name):
|
|
"""Record bonus_sport config.
|
|
If class_name not defined, raise NameError
|
|
"""
|
|
if class_name not in cls.get_bonus_sport_class_names():
|
|
raise NameError("invalid class name for bonus_sport")
|
|
c = ScoDocSiteConfig.query.filter_by(name=cls.BONUS_SPORT).first()
|
|
if c:
|
|
log("setting to " + class_name)
|
|
c.value = class_name
|
|
else:
|
|
c = ScoDocSiteConfig(cls.BONUS_SPORT, class_name)
|
|
db.session.add(c)
|
|
db.session.commit()
|
|
|
|
@classmethod
|
|
def get_bonus_sport_class_name(cls):
|
|
"""Get configured bonus function name, or None if None."""
|
|
klass = cls.get_bonus_sport_class_from_name()
|
|
if klass is None:
|
|
return ""
|
|
else:
|
|
return klass.name
|
|
|
|
@classmethod
|
|
def get_bonus_sport_class(cls):
|
|
"""Get configured bonus function, or None if None."""
|
|
return cls.get_bonus_sport_class_from_name()
|
|
|
|
@classmethod
|
|
def get_bonus_sport_class_from_name(cls, class_name=None):
|
|
"""returns bonus class with specified name.
|
|
If name not specified, return the configured function.
|
|
None if no bonus function configured.
|
|
If class_name not found in module bonus_sport, returns None
|
|
and flash a warning.
|
|
"""
|
|
if not class_name: # None or ""
|
|
c = ScoDocSiteConfig.query.filter_by(name=cls.BONUS_SPORT).first()
|
|
if c is None:
|
|
return None
|
|
class_name = c.value
|
|
if class_name == "": # pas de bonus défini
|
|
return None
|
|
klass = bonus_spo.get_bonus_class_dict().get(class_name)
|
|
if klass is None:
|
|
flash(
|
|
f"""Fonction de calcul bonus sport inexistante: {class_name}.
|
|
Changez là ou contactez votre administrateur local."""
|
|
)
|
|
return klass
|
|
|
|
@classmethod
|
|
def get_bonus_sport_class_names(cls) -> list:
|
|
"""List available bonus class names
|
|
(starting with empty string to represent "no bonus function").
|
|
"""
|
|
return [""] + sorted(bonus_spo.get_bonus_class_dict().keys())
|
|
|
|
@classmethod
|
|
def get_bonus_sport_class_list(cls) -> list[tuple]:
|
|
"""List available bonus class names
|
|
(starting with empty string to represent "no bonus function").
|
|
"""
|
|
d = bonus_spo.get_bonus_class_dict()
|
|
class_list = [(name, d[name].displayed_name) for name in d]
|
|
class_list.sort(key=lambda x: x[1].replace(" du ", " de "))
|
|
return [("", "")] + class_list
|
|
|
|
@classmethod
|
|
def get_code_apo(cls, code: str) -> str:
|
|
"""La représentation d'un code pour les exports Apogée.
|
|
Par exemple, à l'IUT du H., le code ADM est réprésenté par VAL
|
|
Les codes par défaut sont donnés dans sco_apogee_csv.
|
|
"""
|
|
cfg = ScoDocSiteConfig.query.filter_by(name=code).first()
|
|
if not cfg:
|
|
code_apo = code_scodoc_to_apo_default(code)
|
|
else:
|
|
code_apo = cfg.value
|
|
return code_apo
|
|
|
|
@classmethod
|
|
def get_codes_apo_dict(cls) -> dict[str:str]:
|
|
"Un dict avec code jury : code exporté"
|
|
return {code: cls.get_code_apo(code) for code in CODES_SCODOC_TO_APO}
|
|
|
|
@classmethod
|
|
def set_code_apo(cls, code: str, code_apo: str):
|
|
"""Enregistre nouvelle représentation du code"""
|
|
if code_apo != cls.get_code_apo(code):
|
|
cfg = ScoDocSiteConfig.query.filter_by(name=code).first()
|
|
if cfg is None:
|
|
cfg = ScoDocSiteConfig(code, code_apo)
|
|
else:
|
|
cfg.value = code_apo
|
|
db.session.add(cfg)
|
|
db.session.commit()
|
|
|
|
@classmethod
|
|
def is_cas_enabled(cls) -> bool:
|
|
"""True si on utilise le CAS"""
|
|
cfg = ScoDocSiteConfig.query.filter_by(name="cas_enable").first()
|
|
return cfg is not None and cfg.value
|
|
|
|
@classmethod
|
|
def is_entreprises_enabled(cls) -> bool:
|
|
"""True si on doit activer le module entreprise"""
|
|
cfg = ScoDocSiteConfig.query.filter_by(name="enable_entreprises").first()
|
|
return cfg is not None and cfg.value
|
|
|
|
@classmethod
|
|
def enable_entreprises(cls, enabled=True) -> bool:
|
|
"""Active (ou déactive) le module entreprises. True si changement."""
|
|
if enabled != ScoDocSiteConfig.is_entreprises_enabled():
|
|
cfg = ScoDocSiteConfig.query.filter_by(name="enable_entreprises").first()
|
|
if cfg is None:
|
|
cfg = ScoDocSiteConfig(
|
|
name="enable_entreprises", value="on" if enabled else ""
|
|
)
|
|
else:
|
|
cfg.value = "on" if enabled else ""
|
|
db.session.add(cfg)
|
|
db.session.commit()
|
|
return True
|
|
return False
|
|
|
|
@classmethod
|
|
def get(cls, name: str, default: str = "") -> str:
|
|
"Get configuration param; empty string or specified default if unset"
|
|
cfg = ScoDocSiteConfig.query.filter_by(name=name).first()
|
|
if cfg is None:
|
|
return default
|
|
return cfg.value or ""
|
|
|
|
@classmethod
|
|
def set(cls, name: str, value: str) -> bool:
|
|
"Set parameter, returns True if change. Commit session."
|
|
value_str = str(value or "")
|
|
if (cls.get(name) or "") != value_str:
|
|
cfg = ScoDocSiteConfig.query.filter_by(name=name).first()
|
|
if cfg is None:
|
|
cfg = ScoDocSiteConfig(name=name, value=value_str)
|
|
else:
|
|
cfg.value = str(value or "")
|
|
current_app.logger.info(
|
|
f"""ScoDocSiteConfig: recording {cfg.name}='{cfg.value[:32]}...'"""
|
|
)
|
|
db.session.add(cfg)
|
|
db.session.commit()
|
|
return True
|
|
return False
|
|
|
|
@classmethod
|
|
def _get_int_field(cls, name: str, default=None) -> int:
|
|
"""Valeur d'un champs integer"""
|
|
cfg = ScoDocSiteConfig.query.filter_by(name=name).first()
|
|
if (cfg is None) or cfg.value is None:
|
|
return default
|
|
return int(cfg.value)
|
|
|
|
@classmethod
|
|
def _set_int_field(
|
|
cls,
|
|
name: str,
|
|
value: int,
|
|
default=None,
|
|
range_values: tuple = (),
|
|
) -> bool:
|
|
"""Set champs integer. True si changement."""
|
|
if value != cls._get_int_field(name, default=default):
|
|
if not isinstance(value, int) or (
|
|
range_values and (value < range_values[0]) or (value > range_values[1])
|
|
):
|
|
raise ValueError("invalid value")
|
|
cfg = ScoDocSiteConfig.query.filter_by(name=name).first()
|
|
if cfg is None:
|
|
cfg = ScoDocSiteConfig(name=name, value=str(value))
|
|
else:
|
|
cfg.value = str(value)
|
|
db.session.add(cfg)
|
|
db.session.commit()
|
|
return True
|
|
return False
|
|
|
|
@classmethod
|
|
def get_month_debut_annee_scolaire(cls) -> int:
|
|
"""Mois de début de l'année scolaire."""
|
|
return cls._get_int_field(
|
|
"month_debut_annee_scolaire", scu.MONTH_DEBUT_ANNEE_SCOLAIRE
|
|
)
|
|
|
|
@classmethod
|
|
def get_month_debut_periode2(cls) -> int:
|
|
"""Mois de début de l'année scolaire."""
|
|
return cls._get_int_field("month_debut_periode2", scu.MONTH_DEBUT_PERIODE2)
|
|
|
|
@classmethod
|
|
def set_month_debut_annee_scolaire(
|
|
cls, month: int = scu.MONTH_DEBUT_ANNEE_SCOLAIRE
|
|
) -> bool:
|
|
"""Fixe le mois de début des années scolaires.
|
|
True si changement.
|
|
"""
|
|
if cls._set_int_field(
|
|
"month_debut_annee_scolaire", month, scu.MONTH_DEBUT_ANNEE_SCOLAIRE, (1, 12)
|
|
):
|
|
log(f"set_month_debut_annee_scolaire({month})")
|
|
return True
|
|
return False
|
|
|
|
@classmethod
|
|
def set_month_debut_periode2(cls, month: int = scu.MONTH_DEBUT_PERIODE2) -> bool:
|
|
"""Fixe le mois de début des années scolaires.
|
|
True si changement.
|
|
"""
|
|
if cls._set_int_field(
|
|
"month_debut_periode2", month, scu.MONTH_DEBUT_PERIODE2, (1, 12)
|
|
):
|
|
log(f"set_month_debut_periode2({month})")
|
|
return True
|
|
return False
|