ScoDoc-Front/app/views/notes.py

# -*- mode: python -*-
# -*- coding: utf-8 -*-

##############################################################################
#
# ScoDoc
#
# Copyright (c) 1999 - 2021 Emmanuel Viennet.  All rights reserved.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#
#   Emmanuel Viennet      emmanuel.viennet@viennet.net
#
##############################################################################

"""
Module notes: issu de ScoDoc7 / ZNotes.py

Emmanuel Viennet, 2021
"""
import sys
import time
import datetime
import jaxml
import pprint

from flask import g
from flask import current_app

from config import Config
from scodoc_manager import sco_mgr
from app.decorators import (
    scodoc7func,
    ScoDoc7Context,
    permission_required,
    admin_required,
    login_required,
)
from app.auth.models import Permission

from app.views import notes_bp as bp

# ---------------

from app.scodoc import sco_utils as scu
from app.scodoc import notesdb as ndb
from app.scodoc.notes_log import log, sendAlarm

from app.scodoc import scolog
from app.scodoc.scolog import logdb

from app.scodoc.sco_exceptions import (
    ScoValueError,
    ScoLockedFormError,
    ScoGenError,
    AccessDenied,
)
from app.scodoc.sco_pdf import PDFLOCK
import app.scodoc.VERSION as VERSION
from app.scodoc.sco_news import NEWS_INSCR, NEWS_NOTE, NEWS_FORM, NEWS_SEM, NEWS_MISC
from app.scodoc.gen_tables import GenTable
from app.scodoc.sco_permissions import Permission, ScoImplement
from app.scodoc.TrivialFormulator import TrivialFormulator
from app.scodoc import sco_core
from app.scodoc import htmlutils
from app.scodoc import html_sco_header
from app.scodoc import notes_table
from app.scodoc import pe_view
from app.scodoc import sco_apogee_compare
from app.scodoc import sco_apogee_csv
from app.scodoc import sco_archives
from app.scodoc import sco_bulletins
from app.scodoc import sco_bulletins_pdf
from app.scodoc import sco_cache
from app.scodoc import sco_codes_parcours
from app.scodoc import sco_compute_moy
from app.scodoc import sco_cost_formation
from app.scodoc import sco_debouche
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_etape_apogee_view
from app.scodoc import sco_evaluations
from app.scodoc import sco_excel
from app.scodoc import sco_export_results
from app.scodoc import sco_formations
from app.scodoc import sco_formsemestre
from app.scodoc import sco_formsemestre_custommenu
from app.scodoc import sco_formsemestre_edit
from app.scodoc import sco_formsemestre_exterieurs
from app.scodoc import sco_formsemestre_inscriptions
from app.scodoc import sco_formsemestre_status
from app.scodoc import sco_formsemestre_validation
from app.scodoc import sco_groups
from app.scodoc import sco_inscr_passage
from app.scodoc import sco_liste_notes
from app.scodoc import sco_lycee
from app.scodoc import sco_moduleimpl
from app.scodoc import sco_moduleimpl_inscriptions
from app.scodoc import sco_moduleimpl_status
from app.scodoc import sco_news
from app.scodoc import sco_parcours_dut
from app.scodoc import sco_placement
from app.scodoc import sco_poursuite_dut
from app.scodoc import sco_prepajury
from app.scodoc import sco_pvjury
from app.scodoc import sco_pvpdf
from app.scodoc import sco_recapcomplet
from app.scodoc import sco_report
from app.scodoc import sco_saisie_notes
from app.scodoc import sco_semset
from app.scodoc import sco_synchro_etuds
from app.scodoc import sco_tag_module
from app.scodoc import sco_ue_external
from app.scodoc import sco_undo_notes
from app.scodoc import scolars

context = ScoDoc7Context(globals())


def sco_publish(route, function, permission):
    """Declare a route for a python function,
    protected by permission and called following ScoDoc 7 Zope standards.
    """
    # f =
    bp.route(route)(permission_required(permission)(scodoc7func(context)(function)))
    # setattr(sys.modules[__name__], f.__name__, f)


# ---------------------  Quelques essais élémentaires:
@bp.route("/essai")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def essai(context, REQUEST=None):
    return essai_(context, REQUEST)


def essai_(context, REQUEST):
    return "<html><body><h2>essai !</h2><p>%s</p><p>%s</p></body></html>" % (
        context,
        REQUEST,
    )


def essai2(context):
    return essai_(context, "sans request")


sco_publish("/essai2", essai2, Permission.ScoImplement)

# ---------------------


# ---------------


@bp.route("/clearcache")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def clearcache(context, REQUEST=None):
    "Efface les caches de notes (utile pendant developpement slt)"
    log("*** clearcache request")
    # Debugging code: compare results before and after cache reconstruction
    # (_should_ be identicals !)
    # Compare XML representation
    cache = sco_core.get_notes_cache(context)
    formsemestre_ids = cache.get_cached_formsemestre_ids()
    docs_before = []
    for formsemestre_id in formsemestre_ids:
        docs_before.append(
            sco_recapcomplet.do_formsemestre_recapcomplet(
                context, REQUEST, formsemestre_id, format="xml", xml_nodate=True
            )
        )
    #
    cache.inval_cache(context)  # >
    # Rebuild cache (useful only to debug)
    docs_after = []
    for formsemestre_id in formsemestre_ids:
        docs_after.append(
            sco_recapcomplet.do_formsemestre_recapcomplet(
                context, REQUEST, formsemestre_id, format="xml", xml_nodate=True
            )
        )
    if docs_before != docs_after:
        log("clearcache: inconsistency !")
        txt = "before=" + repr(docs_before) + "\n\nafter=" + repr(docs_after) + "\n"
        log(txt)
        sendAlarm(context, "clearcache: inconsistency !", txt)


# --------------------------------------------------------------------
#
#    Notes/ methods
#
# --------------------------------------------------------------------

sco_publish(
    "/formsemestre_status",
    sco_formsemestre_status.formsemestre_status,
    Permission.ScoView,
)

sco_publish(
    "/formsemestre_createwithmodules",
    sco_formsemestre_edit.formsemestre_createwithmodules,
    Permission.ScoImplement,
)

# controle d'acces specifique pour dir. etud:
sco_publish(
    "/formsemestre_editwithmodules",
    sco_formsemestre_edit.formsemestre_editwithmodules,
    Permission.ScoView,
)

sco_publish(
    "/formsemestre_clone",
    sco_formsemestre_edit.formsemestre_clone,
    Permission.ScoImplement,
)
sco_publish(
    "/formsemestre_associate_new_version",
    sco_formsemestre_edit.formsemestre_associate_new_version,
    Permission.ScoChangeFormation,
)
sco_publish(
    "/formsemestre_delete",
    sco_formsemestre_edit.formsemestre_delete,
    Permission.ScoImplement,
)
sco_publish(
    "/formsemestre_delete2",
    sco_formsemestre_edit.formsemestre_delete2,
    Permission.ScoImplement,
)
sco_publish(
    "/formsemestre_recapcomplet",
    sco_recapcomplet.formsemestre_recapcomplet,
    Permission.ScoView,
)
sco_publish(
    "/formsemestres_bulletins",
    sco_recapcomplet.formsemestres_bulletins,
    Permission.ScoObservateur,
)
sco_publish(
    "/moduleimpl_status", sco_moduleimpl_status.moduleimpl_status, Permission.ScoView
)
sco_publish(
    "/formsemestre_description",
    sco_formsemestre_status.formsemestre_description,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_status_menubar",
    sco_formsemestre_status.formsemestre_status_menubar,
    Permission.ScoView,
)
sco_publish(
    "/formation_create",
    sco_edit_formation.formation_create,
    Permission.ScoChangeFormation,
)
sco_publish(
    "/formation_delete",
    sco_edit_formation.formation_delete,
    Permission.ScoChangeFormation,
)
sco_publish(
    "/formation_edit", sco_edit_formation.formation_edit, Permission.ScoChangeFormation
)
sco_publish(
    "/formsemestre_bulletinetud",
    sco_bulletins.formsemestre_bulletinetud,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_evaluations_cal",
    sco_evaluations.formsemestre_evaluations_cal,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_evaluations_delai_correction",
    sco_evaluations.formsemestre_evaluations_delai_correction,
    Permission.ScoView,
)
sco_publish(
    "/module_evaluation_renumber",
    sco_evaluations.module_evaluation_renumber,
    Permission.ScoView,
)
sco_publish(
    "/module_evaluation_move",
    sco_evaluations.module_evaluation_move,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_list_saisies_notes",
    sco_undo_notes.formsemestre_list_saisies_notes,
    Permission.ScoView,
)
sco_publish("/ue_create", sco_edit_ue.ue_create, Permission.ScoChangeFormation)
sco_publish("/ue_delete", sco_edit_ue.ue_delete, Permission.ScoChangeFormation)
sco_publish("/ue_edit", sco_edit_ue.ue_edit, Permission.ScoChangeFormation)
sco_publish("/ue_list", sco_edit_ue.ue_list, Permission.ScoView)
sco_publish("/ue_sharing_code", sco_edit_ue.ue_sharing_code, Permission.ScoView)
sco_publish(
    "/edit_ue_set_code_apogee",
    sco_edit_ue.edit_ue_set_code_apogee,
    Permission.ScoChangeFormation,
)
sco_publish(
    "/formation_table_recap", sco_edit_ue.formation_table_recap, Permission.ScoView
)
sco_publish(
    "/formation_add_malus_modules",
    sco_edit_module.formation_add_malus_modules,
    Permission.ScoChangeFormation,
)
sco_publish(
    "/matiere_create", sco_edit_matiere.matiere_create, Permission.ScoChangeFormation
)
sco_publish(
    "/matiere_delete", sco_edit_matiere.matiere_delete, Permission.ScoChangeFormation
)
sco_publish(
    "/matiere_edit", sco_edit_matiere.matiere_edit, Permission.ScoChangeFormation
)
sco_publish(
    "/module_create", sco_edit_module.module_create, Permission.ScoChangeFormation
)
sco_publish(
    "/module_delete", sco_edit_module.module_delete, Permission.ScoChangeFormation
)
sco_publish("/module_edit", sco_edit_module.module_edit, Permission.ScoChangeFormation)
sco_publish(
    "/edit_module_set_code_apogee",
    sco_edit_module.edit_module_set_code_apogee,
    Permission.ScoChangeFormation,
)
sco_publish("/module_list", sco_edit_module.module_list, Permission.ScoView)
sco_publish("/module_tag_search", sco_tag_module.module_tag_search, Permission.ScoView)
sco_publish(
    "/module_tag_set", sco_tag_module.module_tag_set, Permission.ScoEditFormationTags
)

#
@bp.route("/")
@bp.route("/index_html")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def index_html(context, REQUEST=None):
    "Page accueil formations"

    editable = REQUEST.AUTHENTICATED_USER.has_permission(
        Permission.ScoChangeFormation, g.scodoc_dept
    )

    H = [
        html_sco_header.sco_header(
            context, REQUEST, page_title="Programmes formations"
        ),
        """<h2>Programmes pédagogiques</h2>
            """,
    ]
    T = sco_formations.formation_list_table(context, REQUEST=REQUEST)

    H.append(T.html())

    if editable:
        H.append(
            """<p><a class="stdlink" href="formation_create">Créer une formation</a></p>
    <p><a class="stdlink" href="formation_import_xml_form">Importer une formation (xml)</a></p>
        <p class="help">Une "formation" est un programme pédagogique structuré en UE, matières et modules. Chaque semestre se réfère à une formation. La modification d'une formation affecte tous les semestres qui s'y réfèrent.</p>
        """
        )

    H.append(context.sco_footer(REQUEST))
    return "\n".join(H)


# --------------------------------------------------------------------
#
#    Notes Methods
#
# --------------------------------------------------------------------

# --- Formations

sco_publish(
    "/do_formation_create",
    sco_edit_formation.do_formation_create,
    Permission.ScoChangeFormation,
)


@bp.route("/do_formation_delete")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def do_formation_delete(context, oid, REQUEST):
    """delete a formation (and all its UE, matieres, modules)
    XXX delete all ues, will break if there are validations ! USE WITH CARE !
    """
    F = context.formation_list(args={"formation_id": oid})[0]
    if context.formation_has_locked_sems(oid):
        raise ScoLockedFormError()
    cnx = ndb.GetDBConnexion()
    # delete all UE in this formation
    ues = context.do_ue_list({"formation_id": oid})
    for ue in ues:
        context._do_ue_delete(ue["ue_id"], REQUEST=REQUEST, force=True)

    _formationEditor.delete(cnx, oid)

    # news
    sco_news.add(
        context,
        REQUEST,
        typ=NEWS_FORM,
        object=oid,
        text="Suppression de la formation %(acronyme)s" % F,
    )


@bp.route("/formation_list")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formation_list(context, format=None, REQUEST=None, formation_id=None, args={}):
    """List formation(s) with given id, or matching args
    (when args is given, formation_id is ignored).
    """
    # logCallStack()
    if not args:
        if formation_id is None:
            args = {}
        else:
            args = {"formation_id": formation_id}
    cnx = ndb.GetDBConnexion()
    r = sco_formations._formationEditor.list(cnx, args=args)
    # log('%d formations found' % len(r))
    return scu.sendResult(REQUEST, r, name="formation", format=format)


@bp.route("/formation_export")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formation_export(
    context, formation_id, export_ids=False, format=None, REQUEST=None
):
    "Export de la formation au format indiqué (xml ou json)"
    return sco_formations.formation_export(
        context, formation_id, export_ids=export_ids, format=format, REQUEST=REQUEST
    )


@bp.route("/formation_import_xml")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def formation_import_xml(context, file, REQUEST):
    "import d'une formation en XML"
    log("formation_import_xml")
    doc = file.read()
    return sco_formations.formation_import_xml(context, REQUEST, doc)


@bp.route("/formation_import_xml_form")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def formation_import_xml_form(context, REQUEST):
    "form import d'une formation en XML"
    H = [
        html_sco_header.sco_header(
            context, page_title="Import d'une formation", REQUEST=REQUEST
        ),
        """<h2>Import d'une formation</h2>
    <p>Création d'une formation (avec UE, matières, modules)
    à partir un fichier XML (réservé aux utilisateurs avertis)</p>
    """,
    ]
    footer = context.sco_footer(REQUEST)
    tf = TrivialFormulator(
        REQUEST.URL0,
        REQUEST.form,
        (("xmlfile", {"input_type": "file", "title": "Fichier XML", "size": 30}),),
        submitlabel="Importer",
        cancelbutton="Annuler",
    )
    if tf[0] == 0:
        return "\n".join(H) + tf[1] + footer
    elif tf[0] == -1:
        return REQUEST.RESPONSE.redirect(scu.NotesURL())
    else:
        formation_id, _, _ = context.formation_import_xml(tf[2]["xmlfile"], REQUEST)

        return (
            "\n".join(H)
            + """<p>Import effectué !</p>
        <p><a class="stdlink" href="ue_list?formation_id=%s">Voir la formation</a></p>"""
            % formation_id
            + footer
        )


@bp.route("/formation_create_new_version")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def formation_create_new_version(context, formation_id, redirect=True, REQUEST=None):
    "duplicate formation, with new version number"
    xml = sco_formations.formation_export(
        context, formation_id, export_ids=True, format="xml"
    )
    new_id, modules_old2new, ues_old2new = sco_formations.formation_import_xml(
        context, REQUEST, xml
    )
    # news
    F = context.formation_list(args={"formation_id": new_id})[0]
    sco_news.add(
        context,
        REQUEST,
        typ=NEWS_FORM,
        object=new_id,
        text="Nouvelle version de la formation %(acronyme)s" % F,
    )
    if redirect:
        return REQUEST.RESPONSE.redirect(
            "ue_list?formation_id=" + new_id + "&msg=Nouvelle version !"
        )
    else:
        return new_id, modules_old2new, ues_old2new


# --- UE
_ueEditor = ndb.EditableTable(
    "notes_ue",
    "ue_id",
    (
        "ue_id",
        "formation_id",
        "acronyme",
        "numero",
        "titre",
        "type",
        "ue_code",
        "ects",
        "is_external",
        "code_apogee",
        "coefficient",
    ),
    sortkey="numero",
    input_formators={"type": ndb.int_null_is_zero},
    output_formators={
        "numero": ndb.int_null_is_zero,
        "ects": ndb.float_null_is_null,
        "coefficient": ndb.float_null_is_zero,
    },
)


@bp.route("/do_ue_create")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def do_ue_create(context, args, REQUEST):
    "create an ue"
    cnx = ndb.GetDBConnexion()
    # check duplicates
    ues = context.do_ue_list(
        {"formation_id": args["formation_id"], "acronyme": args["acronyme"]}
    )
    if ues:
        raise ScoValueError('Acronyme d\'UE "%s" déjà utilisé !' % args["acronyme"])
    # create
    r = context._ueEditor.create(cnx, args)

    # news
    F = context.formation_list(args={"formation_id": args["formation_id"]})[0]
    sco_news.add(
        context,
        REQUEST,
        typ=NEWS_FORM,
        object=args["formation_id"],
        text="Modification de la formation %(acronyme)s" % F,
    )
    return r


def _do_ue_delete(context, ue_id, delete_validations=False, REQUEST=None, force=False):
    "delete UE and attached matieres (but not modules (it should ?))"
    cnx = ndb.GetDBConnexion()
    log("do_ue_delete: ue_id=%s, delete_validations=%s" % (ue_id, delete_validations))
    # check
    ue = context.do_ue_list({"ue_id": ue_id})
    if not ue:
        raise ScoValueError("UE inexistante !")
    ue = ue[0]
    if sco_edit_ue.ue_is_locked(context, ue["ue_id"]):
        raise ScoLockedFormError()
    # Il y a-t-il des etudiants ayant validé cette UE ?
    # si oui, propose de supprimer les validations
    validations = sco_parcours_dut.scolar_formsemestre_validation_list(
        cnx, args={"ue_id": ue_id}
    )
    if validations and not delete_validations and not force:
        return scu.confirm_dialog(
            context,
            "<p>%d étudiants ont validé l'UE %s (%s)</p><p>Si vous supprimez cette UE, ces validations vont être supprimées !</p>"
            % (len(validations), ue["acronyme"], ue["titre"]),
            dest_url="",
            REQUEST=REQUEST,
            target_variable="delete_validations",
            cancel_url="ue_list?formation_id=%s" % ue["formation_id"],
            parameters={"ue_id": ue_id, "dialog_confirmed": 1},
        )
    if delete_validations:
        log("deleting all validations of UE %s" % ue_id)
        ndb.SimpleQuery(
            context,
            "DELETE FROM scolar_formsemestre_validation WHERE ue_id=%(ue_id)s",
            {"ue_id": ue_id},
        )

    # delete all matiere in this UE
    mats = context.do_matiere_list({"ue_id": ue_id})
    for mat in mats:
        context.do_matiere_delete(mat["matiere_id"], REQUEST)
    # delete uecoef and events
    ndb.SimpleQuery(
        context,
        "DELETE FROM notes_formsemestre_uecoef WHERE ue_id=%(ue_id)s",
        {"ue_id": ue_id},
    )
    ndb.SimpleQuery(
        context, "DELETE FROM scolar_events WHERE ue_id=%(ue_id)s", {"ue_id": ue_id}
    )
    cnx = ndb.GetDBConnexion()
    context._ueEditor.delete(cnx, ue_id)
    # > UE delete + supr. validations associées etudiants (cas compliqué, mais rarement utilisé: acceptable de tout invalider ?):
    sco_core.inval_cache(context)
    # news
    F = context.formation_list(args={"formation_id": ue["formation_id"]})[0]
    sco_news.add(
        context,
        REQUEST,
        typ=NEWS_FORM,
        object=ue["formation_id"],
        text="Modification de la formation %(acronyme)s" % F,
    )
    #
    if not force:
        return REQUEST.RESPONSE.redirect(
            scu.NotesURL() + "/ue_list?formation_id=" + str(ue["formation_id"])
        )
    else:
        return None


@bp.route("/do_ue_list")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def do_ue_list(context, *args, **kw):
    "list UEs"
    cnx = ndb.GetDBConnexion()
    return context._ueEditor.list(cnx, *args, **kw)


# --- Matieres
_matiereEditor = ndb.EditableTable(
    "notes_matieres",
    "matiere_id",
    ("matiere_id", "ue_id", "numero", "titre"),
    sortkey="numero",
    output_formators={"numero": ndb.int_null_is_zero},
)


@bp.route("/do_matiere_create")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def do_matiere_create(context, args, REQUEST):
    "create a matiere"
    cnx = ndb.GetDBConnexion()
    # check
    ue = context.do_ue_list({"ue_id": args["ue_id"]})[0]
    # create matiere
    r = context._matiereEditor.create(cnx, args)

    # news
    F = context.formation_list(args={"formation_id": ue["formation_id"]})[0]
    sco_news.add(
        context,
        REQUEST,
        typ=NEWS_FORM,
        object=ue["formation_id"],
        text="Modification de la formation %(acronyme)s" % F,
    )
    return r


@bp.route("/do_matiere_delete")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def do_matiere_delete(context, oid, REQUEST):
    "delete matiere and attached modules"
    cnx = ndb.GetDBConnexion()
    # check
    mat = context.do_matiere_list({"matiere_id": oid})[0]
    ue = context.do_ue_list({"ue_id": mat["ue_id"]})[0]
    locked = sco_edit_matiere.matiere_is_locked(context, mat["matiere_id"])
    if locked:
        log("do_matiere_delete: mat=%s" % mat)
        log("do_matiere_delete: ue=%s" % ue)
        log("do_matiere_delete: locked sems: %s" % locked)
        raise ScoLockedFormError()
    log("do_matiere_delete: matiere_id=%s" % oid)
    # delete all modules in this matiere
    mods = context.do_module_list({"matiere_id": oid})
    for mod in mods:
        context.do_module_delete(mod["module_id"], REQUEST)
    context._matiereEditor.delete(cnx, oid)

    # news
    F = context.formation_list(args={"formation_id": ue["formation_id"]})[0]
    sco_news.add(
        context,
        REQUEST,
        typ=NEWS_FORM,
        object=ue["formation_id"],
        text="Modification de la formation %(acronyme)s" % F,
    )


@bp.route("/do_matiere_list")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def do_matiere_list(context, *args, **kw):
    "list matieres"
    cnx = ndb.GetDBConnexion()
    return context._matiereEditor.list(cnx, *args, **kw)


@bp.route("/do_matiere_edit")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def do_matiere_edit(context, *args, **kw):
    "edit a matiere"
    cnx = ndb.GetDBConnexion()
    # check
    mat = context.do_matiere_list({"matiere_id": args[0]["matiere_id"]})[0]
    if sco_edit_matiere.matiere_is_locked(context, mat["matiere_id"]):
        raise ScoLockedFormError()
    # edit
    context._matiereEditor.edit(cnx, *args, **kw)
    sco_core.inval_cache(context)  # > modif matiere


@bp.route("/do_matiere_formation_id")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def do_matiere_formation_id(context, matiere_id):
    "get formation_id from matiere"
    cnx = ndb.GetDBConnexion()
    cursor = cnx.cursor(cursor_factory=ndb.ScoDocCursor)
    cursor.execute(
        "select UE.formation_id from notes_matieres M, notes_ue UE where M.matiere_id = %(matiere_id)s and M.ue_id = UE.ue_id",
        {"matiere_id": matiere_id},
    )
    res = cursor.fetchall()
    return res[0][0]


# --- Modules
_moduleEditor = ndb.EditableTable(
    "notes_modules",
    "module_id",
    (
        "module_id",
        "titre",
        "code",
        "abbrev",
        "heures_cours",
        "heures_td",
        "heures_tp",
        "coefficient",
        "ue_id",
        "matiere_id",
        "formation_id",
        "semestre_id",
        "numero",
        "code_apogee",
        "module_type"
        #'ects'
    ),
    sortkey="numero, code, titre",
    output_formators={
        "heures_cours": ndb.float_null_is_zero,
        "heures_td": ndb.float_null_is_zero,
        "heures_tp": ndb.float_null_is_zero,
        "numero": ndb.int_null_is_zero,
        "coefficient": ndb.float_null_is_zero,
        "module_type": ndb.int_null_is_zero
        #'ects' : ndb.float_null_is_null
    },
)


@bp.route("/do_module_create")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def do_module_create(context, args, REQUEST):
    "create a module"
    # create
    cnx = ndb.GetDBConnexion()
    r = context._moduleEditor.create(cnx, args)

    # news
    F = context.formation_list(args={"formation_id": args["formation_id"]})[0]
    sco_news.add(
        context,
        REQUEST,
        typ=NEWS_FORM,
        object=args["formation_id"],
        text="Modification de la formation %(acronyme)s" % F,
    )
    return r


@bp.route("/do_module_delete")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def do_module_delete(context, oid, REQUEST):
    "delete module"
    mod = context.do_module_list({"module_id": oid})[0]
    if sco_edit_module.module_is_locked(context, mod["module_id"]):
        raise ScoLockedFormError()

    # S'il y a des moduleimpls, on ne peut pas detruire le module !
    mods = sco_moduleimpl.do_moduleimpl_list(context, module_id=oid)
    if mods:
        err_page = scu.confirm_dialog(
            context,
            message="""<h3>Destruction du module impossible car il est utilisé dans des semestres existants !</h3>""",
            helpmsg="""Il faut d'abord supprimer le semestre. Mais il est peut être préférable de laisser ce programme intact et d'en créer une nouvelle version pour la modifier.""",
            dest_url="ue_list",
            parameters={"formation_id": mod["formation_id"]},
            REQUEST=REQUEST,
        )
        raise ScoGenError(err_page)
    # delete
    cnx = ndb.GetDBConnexion()
    context._moduleEditor.delete(cnx, oid)

    # news
    F = context.formation_list(args={"formation_id": mod["formation_id"]})[0]
    sco_news.add(
        context,
        REQUEST,
        typ=NEWS_FORM,
        object=mod["formation_id"],
        text="Modification de la formation %(acronyme)s" % F,
    )


@bp.route("/do_module_list")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def do_module_list(context, *args, **kw):
    "list modules"
    cnx = ndb.GetDBConnexion()
    return context._moduleEditor.list(cnx, *args, **kw)


@bp.route("/do_module_edit")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def do_module_edit(context, val):
    "edit a module"
    # check
    mod = context.do_module_list({"module_id": val["module_id"]})[0]
    if sco_edit_module.module_is_locked(context, mod["module_id"]):
        # formation verrouillée: empeche de modifier certains champs:
        protected_fields = ("coefficient", "ue_id", "matiere_id", "semestre_id")
        for f in protected_fields:
            if f in val:
                del val[f]
    # edit
    cnx = ndb.GetDBConnexion()
    context._moduleEditor.edit(cnx, val)

    sems = sco_formsemestre.do_formsemestre_list(
        context, args={"formation_id": mod["formation_id"]}
    )
    if sems:
        sco_core.inval_cache(
            context, formsemestre_id_list=[s["formsemestre_id"] for s in sems]
        )  # > modif module


#
@bp.route("/formation_has_locked_sems")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formation_has_locked_sems(context, formation_id):
    "True if there is a locked formsemestre in this formation"
    sems = sco_formsemestre.do_formsemestre_list(
        context, args={"formation_id": formation_id, "etat": "0"}
    )
    return sems


@bp.route("/formation_count_sems")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formation_count_sems(context, formation_id):
    "Number of formsemestre in this formation (locked or not)"
    sems = sco_formsemestre.do_formsemestre_list(
        context, args={"formation_id": formation_id}
    )
    return len(sems)


sco_publish(
    "/module_count_moduleimpls",
    sco_edit_module.module_count_moduleimpls,
    Permission.ScoView,
)

sco_publish("/module_is_locked", sco_edit_module.module_is_locked, Permission.ScoView)

sco_publish(
    "/matiere_is_locked", sco_edit_matiere.matiere_is_locked, Permission.ScoView
)


@bp.route("/module_move")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def module_move(context, module_id, after=0, REQUEST=None, redirect=1):
    """Move before/after previous one (decrement/increment numero)"""
    module = context.do_module_list({"module_id": module_id})[0]
    redirect = int(redirect)
    after = int(after)  # 0: deplace avant, 1 deplace apres
    if after not in (0, 1):
        raise ValueError('invalid value for "after"')
    formation_id = module["formation_id"]
    others = context.do_module_list({"matiere_id": module["matiere_id"]})
    # log('others=%s' % others)
    if len(others) > 1:
        idx = [p["module_id"] for p in others].index(module_id)
        # log('module_move: after=%s idx=%s' % (after, idx))
        neigh = None  # object to swap with
        if after == 0 and idx > 0:
            neigh = others[idx - 1]
        elif after == 1 and idx < len(others) - 1:
            neigh = others[idx + 1]
        if neigh:  #
            # swap numero between partition and its neighbor
            # log('moving module %s' % module_id)
            cnx = ndb.GetDBConnexion()
            module["numero"], neigh["numero"] = neigh["numero"], module["numero"]
            if module["numero"] == neigh["numero"]:
                neigh["numero"] -= 2 * after - 1
            context._moduleEditor.edit(cnx, module)
            context._moduleEditor.edit(cnx, neigh)

    # redirect to ue_list page:
    if redirect:
        return REQUEST.RESPONSE.redirect("ue_list?formation_id=" + formation_id)


@bp.route("/ue_move")
@permission_required(Permission.ScoChangeFormation)
@scodoc7func(context)
def ue_move(context, ue_id, after=0, REQUEST=None, redirect=1):
    """Move UE before/after previous one (decrement/increment numero)"""
    o = context.do_ue_list({"ue_id": ue_id})[0]
    # log('ue_move %s (#%s) after=%s' % (ue_id, o['numero'], after))
    redirect = int(redirect)
    after = int(after)  # 0: deplace avant, 1 deplace apres
    if after not in (0, 1):
        raise ValueError('invalid value for "after"')
    formation_id = o["formation_id"]
    others = context.do_ue_list({"formation_id": formation_id})
    if len(others) > 1:
        idx = [p["ue_id"] for p in others].index(ue_id)
        neigh = None  # object to swap with
        if after == 0 and idx > 0:
            neigh = others[idx - 1]
        elif after == 1 and idx < len(others) - 1:
            neigh = others[idx + 1]
        if neigh:  #
            # swap numero between partition and its neighbor
            # log('moving ue %s (neigh #%s)' % (ue_id, neigh['numero']))
            cnx = ndb.GetDBConnexion()
            o["numero"], neigh["numero"] = neigh["numero"], o["numero"]
            if o["numero"] == neigh["numero"]:
                neigh["numero"] -= 2 * after - 1
            context._ueEditor.edit(cnx, o)
            context._ueEditor.edit(cnx, neigh)
    # redirect to ue_list page
    if redirect:
        return REQUEST.RESPONSE.redirect("ue_list?formation_id=" + o["formation_id"])


# --- Semestres de formation


@bp.route("/do_formsemestre_create")
@permission_required(Permission.ScoImplement)
@scodoc7func(context)
def do_formsemestre_create(context, args, REQUEST, silent=False):
    "create a formsemestre"
    cnx = ndb.GetDBConnexion()
    formsemestre_id = sco_formsemestre._formsemestreEditor.create(cnx, args)
    if args["etapes"]:
        args["formsemestre_id"] = formsemestre_id
        sco_formsemestre.write_formsemestre_etapes(context, args)
    if args["responsables"]:
        args["formsemestre_id"] = formsemestre_id
        sco_formsemestre.write_formsemestre_responsables(context, args)

    # create default partition
    partition_id = sco_groups.partition_create(
        context, formsemestre_id, default=True, redirect=0, REQUEST=REQUEST
    )
    _group_id = sco_groups.createGroup(
        context, partition_id, default=True, REQUEST=REQUEST
    )

    # news
    if not args.has_key("titre"):
        args["titre"] = "sans titre"
    args["formsemestre_id"] = formsemestre_id
    args["url"] = "Notes/formsemestre_status?formsemestre_id=%(formsemestre_id)s" % args
    if not silent:
        sco_news.add(
            context,
            REQUEST,
            typ=NEWS_SEM,
            text='Création du semestre <a href="%(url)s">%(titre)s</a>' % args,
            url=args["url"],
        )
    return formsemestre_id


@bp.route("/formsemestre_list")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_list(
    context,
    format=None,
    REQUEST=None,
    formsemestre_id=None,
    formation_id=None,
    etape_apo=None,
):
    """List formsemestres in given format.
    kw can specify some conditions: examples:
        formsemestre_list( format='json', formation_id='F777', REQUEST=REQUEST)
    """
    # XAPI: new json api
    args = {}
    L = locals()
    for argname in ("formsemestre_id", "formation_id", "etape_apo"):
        if L[argname] is not None:
            args[argname] = L[argname]
    sems = sco_formsemestre.do_formsemestre_list(context, args=args)
    # log('formsemestre_list: format="%s", %s semestres found' % (format,len(sems)))
    return scu.sendResult(REQUEST, sems, name="formsemestre", format=format)


@bp.route("/XMLgetFormsemestres")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def XMLgetFormsemestres(context, etape_apo=None, formsemestre_id=None, REQUEST=None):
    """List all formsemestres matching etape, XML format
    DEPRECATED: use formsemestre_list()
    """
    log("Warning: calling deprecated XMLgetFormsemestres")
    args = {}
    if etape_apo:
        args["etape_apo"] = etape_apo
    if formsemestre_id:
        args["formsemestre_id"] = formsemestre_id
    if REQUEST:
        REQUEST.RESPONSE.setHeader("content-type", scu.XML_MIMETYPE)
    doc = jaxml.XML_document(encoding=scu.SCO_ENCODING)
    doc.formsemestrelist()
    for sem in sco_formsemestre.do_formsemestre_list(context, args=args):
        doc._push()
        doc.formsemestre(sem)
        doc._pop()
    return repr(doc)


sco_publish(
    "/do_formsemestre_edit",
    sco_formsemestre.do_formsemestre_edit,
    Permission.ScoImplement,
)
sco_publish(
    "/formsemestre_edit_options",
    sco_formsemestre_edit.formsemestre_edit_options,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_change_lock",
    sco_formsemestre_edit.formsemestre_change_lock,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_change_publication_bul",
    sco_formsemestre_edit.formsemestre_change_publication_bul,
    Permission.ScoView,
)
sco_publish(
    "/view_formsemestre_by_etape",
    sco_formsemestre.view_formsemestre_by_etape,
    Permission.ScoView,
)


def _check_access_diretud(
    context, formsemestre_id, REQUEST, required_permission=ScoImplement
):
    """Check if access granted: responsable or ScoImplement
    Return True|False, HTML_error_page
    """
    authuser = REQUEST.AUTHENTICATED_USER
    sem = sco_formsemestre.get_formsemestre(context, formsemestre_id)
    header = html_sco_header.sco_header(
        context, page_title="Accès interdit", REQUEST=REQUEST
    )
    footer = context.sco_footer(REQUEST)
    if (str(authuser) not in sem["responsables"]) and not authuser.has_permission(
        required_permission, context
    ):
        return (
            False,
            "\n".join(
                [
                    header,
                    "<h2>Opération non autorisée pour %s</h2>" % authuser,
                    "<p>Responsable de ce semestre : <b>%s</b></p>"
                    % ", ".join(sem["responsables"]),
                    footer,
                ]
            ),
        )
    else:
        return True, ""


@bp.route("/formsemestre_custommenu_edit")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_custommenu_edit(context, REQUEST, formsemestre_id):
    "Dialogue modif menu"
    # accessible à tous !
    return sco_formsemestre_custommenu.formsemestre_custommenu_edit(
        context, formsemestre_id, REQUEST=REQUEST
    )


# --- dialogue modif enseignants/moduleimpl
@bp.route("/edit_enseignants_form")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def edit_enseignants_form(context, REQUEST, moduleimpl_id):
    "modif liste enseignants/moduleimpl"
    M, sem = sco_moduleimpl.can_change_ens(context, REQUEST, moduleimpl_id)
    # --
    header = html_sco_header.html_sem_header(
        context,
        REQUEST,
        'Enseignants du <a href="moduleimpl_status?moduleimpl_id=%s">module %s</a>'
        % (moduleimpl_id, M["module"]["titre"]),
        page_title="Enseignants du module %s" % M["module"]["titre"],
        javascripts=["libjs/AutoSuggest.js"],
        cssstyles=["css/autosuggest_inquisitor.css"],
        bodyOnLoad="init_tf_form('')",
    )
    footer = context.sco_footer(REQUEST)

    # Liste des enseignants avec forme pour affichage / saisie avec suggestion
    userlist = context.Users.get_userlist()
    login2display = {}  # user_name : forme pour affichage = "NOM Prenom (login)"
    for u in userlist:
        login2display[u["user_name"]] = u["nomplogin"]
        allowed_user_names = login2display.values()

    H = [
        "<ul><li><b>%s</b> (responsable)</li>"
        % login2display.get(M["responsable_id"], M["responsable_id"])
    ]
    for ens in M["ens"]:
        H.append(
            '<li>%s (<a class="stdlink" href="edit_enseignants_form_delete?moduleimpl_id=%s&ens_id=%s">supprimer</a>)</li>'
            % (
                login2display.get(ens["ens_id"], ens["ens_id"]),
                moduleimpl_id,
                ens["ens_id"],
            )
        )
    H.append("</ul>")
    F = """<p class="help">Les enseignants d'un module ont le droit de
    saisir et modifier toutes les notes des évaluations de ce module.
    </p>
    <p class="help">Pour changer le responsable du module, passez par la
    page "<a class="stdlink" href="formsemestre_editwithmodules?formation_id=%s&formsemestre_id=%s">Modification du semestre</a>", accessible uniquement au responsable de la formation (chef de département)
    </p>
    """ % (
        sem["formation_id"],
        M["formsemestre_id"],
    )

    modform = [
        ("moduleimpl_id", {"input_type": "hidden"}),
        (
            "ens_id",
            {
                "input_type": "text_suggest",
                "size": 50,
                "title": "Ajouter un enseignant",
                "allowed_values": allowed_user_names,
                "allow_null": False,
                "text_suggest_options": {
                    "script": "Users/get_userlist_xml?",
                    "varname": "start",
                    "json": False,
                    "noresults": "Valeur invalide !",
                    "timeout": 60000,
                },
            },
        ),
    ]
    tf = TrivialFormulator(
        REQUEST.URL0,
        REQUEST.form,
        modform,
        submitlabel="Ajouter enseignant",
        cancelbutton="Annuler",
    )
    if tf[0] == 0:
        return header + "\n".join(H) + tf[1] + F + footer
    elif tf[0] == -1:
        return REQUEST.RESPONSE.redirect(
            "moduleimpl_status?moduleimpl_id=" + moduleimpl_id
        )
    else:
        ens_id = context.Users.get_user_name_from_nomplogin(tf[2]["ens_id"])
        if not ens_id:
            H.append(
                '<p class="help">Pour ajouter un enseignant, choisissez un nom dans le menu</p>'
            )
        else:
            # et qu'il n'est pas deja:
            if (
                ens_id in [x["ens_id"] for x in M["ens"]]
                or ens_id == M["responsable_id"]
            ):
                H.append(
                    '<p class="help">Enseignant %s déjà dans la liste !</p>' % ens_id
                )
            else:
                sco_moduleimpl.do_ens_create(
                    context, {"moduleimpl_id": moduleimpl_id, "ens_id": ens_id}
                )
                return REQUEST.RESPONSE.redirect(
                    "edit_enseignants_form?moduleimpl_id=%s" % moduleimpl_id
                )
        return header + "\n".join(H) + tf[1] + F + footer


@bp.route("/edit_moduleimpl_resp")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def edit_moduleimpl_resp(context, REQUEST, moduleimpl_id):
    """Changement d'un enseignant responsable de module
    Accessible par Admin et dir des etud si flag resp_can_change_ens
    """
    M, sem = sco_moduleimpl.can_change_module_resp(context, REQUEST, moduleimpl_id)
    H = [
        html_sco_header.html_sem_header(
            context,
            REQUEST,
            'Modification du responsable du <a href="moduleimpl_status?moduleimpl_id=%s">module %s</a>'
            % (moduleimpl_id, M["module"]["titre"]),
            sem,
            javascripts=["libjs/AutoSuggest.js"],
            cssstyles=["css/autosuggest_inquisitor.css"],
            bodyOnLoad="init_tf_form('')",
        )
    ]
    help = """<p class="help">Taper le début du nom de l'enseignant.</p>"""
    # Liste des enseignants avec forme pour affichage / saisie avec suggestion
    userlist = context.Users.get_userlist()
    login2display = {}  # user_name : forme pour affichage = "NOM Prenom (login)"
    for u in userlist:
        login2display[u["user_name"]] = u["nomplogin"]
    allowed_user_names = login2display.values()

    initvalues = M
    initvalues["responsable_id"] = login2display.get(
        M["responsable_id"], M["responsable_id"]
    )
    form = [
        ("moduleimpl_id", {"input_type": "hidden"}),
        (
            "responsable_id",
            {
                "input_type": "text_suggest",
                "size": 50,
                "title": "Responsable du module",
                "allowed_values": allowed_user_names,
                "allow_null": False,
                "text_suggest_options": {
                    "script": "Users/get_userlist_xml?",
                    "varname": "start",
                    "json": False,
                    "noresults": "Valeur invalide !",
                    "timeout": 60000,
                },
            },
        ),
    ]
    tf = TrivialFormulator(
        REQUEST.URL0,
        REQUEST.form,
        form,
        submitlabel="Changer responsable",
        cancelbutton="Annuler",
        initvalues=initvalues,
    )
    if tf[0] == 0:
        return "\n".join(H) + tf[1] + help + context.sco_footer(REQUEST)
    elif tf[0] == -1:
        return REQUEST.RESPONSE.redirect(
            "moduleimpl_status?moduleimpl_id=" + moduleimpl_id
        )
    else:
        responsable_id = context.Users.get_user_name_from_nomplogin(
            tf[2]["responsable_id"]
        )
        if (
            not responsable_id
        ):  # presque impossible: tf verifie les valeurs (mais qui peuvent changer entre temps)
            return REQUEST.RESPONSE.redirect(
                "moduleimpl_status?moduleimpl_id=" + moduleimpl_id
            )
        sco_moduleimpl.do_moduleimpl_edit(
            context,
            {"moduleimpl_id": moduleimpl_id, "responsable_id": responsable_id},
            formsemestre_id=sem["formsemestre_id"],
        )
        return REQUEST.RESPONSE.redirect(
            "moduleimpl_status?moduleimpl_id="
            + moduleimpl_id
            + "&head_message=responsable%20modifié"
        )


_expr_help = """<p class="help">Expérimental: formule de calcul de la moyenne %(target)s</p>
    <p class="help">Attention: l'utilisation de formules ralenti considérablement
    les traitements. A utiliser uniquement dans els cas ne pouvant pas être traités autrement.</p>
    <p class="help">Dans la formule, les variables suivantes sont définies:</p>
    <ul class="help">
    <li><tt>moy</tt> la moyenne, calculée selon la règle standard (moyenne pondérée)</li>
    <li><tt>moy_is_valid</tt> vrai si la moyenne est valide (numérique)</li>
    <li><tt>moy_val</tt> la valeur de la moyenne (nombre, valant 0 si invalide)</li>
    <li><tt>notes</tt> vecteur des notes (/20) aux %(objs)s</li>
    <li><tt>coefs</tt> vecteur des coefficients des %(objs)s, les coefs des %(objs)s sans notes (ATT, EXC) étant mis à zéro</li>
    <li><tt>cmask</tt> vecteur de 0/1, 0 si le coef correspondant a été annulé</li>
    <li>Nombre d'absences: <tt>nb_abs</tt>, <tt>nb_abs_just</tt>, <tt>nb_abs_nojust</tt> (en demi-journées)</li>
    </ul>
    <p class="help">Les éléments des vecteurs sont ordonnés dans l'ordre des %(objs)s%(ordre)s.</p>
    <p class="help">Les fonctions suivantes sont utilisables: <tt>abs, cmp, dot, len, map, max, min, pow, reduce, round, sum, ifelse</tt>.</p>
    <p class="help">La notation <tt>V(1,2,3)</tt> représente un vecteur <tt>(1,2,3)</tt>.</p>
    <p class="help"></p>Pour indiquer que la note calculée n'existe pas, utiliser la chaîne <tt>'NA'</tt>.</p>
    <p class="help">Vous pouvez désactiver la formule (et revenir au mode de calcul "classique") 
    en supprimant le texte ou en faisant précéder la première ligne par <tt>#</tt></p>
"""


@bp.route("/edit_moduleimpl_expr")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def edit_moduleimpl_expr(context, REQUEST, moduleimpl_id):
    """Edition formule calcul moyenne module
    Accessible par Admin, dir des etud et responsable module
    """
    M, sem = sco_moduleimpl.can_change_ens(context, REQUEST, moduleimpl_id)
    H = [
        html_sco_header.html_sem_header(
            context,
            REQUEST,
            'Modification règle de calcul du <a href="moduleimpl_status?moduleimpl_id=%s">module %s</a>'
            % (moduleimpl_id, M["module"]["titre"]),
            sem,
        ),
        context._expr_help
        % {
            "target": "du module",
            "objs": "évaluations",
            "ordre": " (le premier élément est la plus ancienne évaluation)",
        },
    ]
    initvalues = M
    form = [
        ("moduleimpl_id", {"input_type": "hidden"}),
        (
            "computation_expr",
            {
                "title": "Formule de calcul",
                "input_type": "textarea",
                "rows": 4,
                "cols": 60,
                "explanation": "formule de calcul (expérimental)",
            },
        ),
    ]
    tf = TrivialFormulator(
        REQUEST.URL0,
        REQUEST.form,
        form,
        submitlabel="Modifier formule de calcul",
        cancelbutton="Annuler",
        initvalues=initvalues,
    )
    if tf[0] == 0:
        return "\n".join(H) + tf[1] + context.sco_footer(REQUEST)
    elif tf[0] == -1:
        return REQUEST.RESPONSE.redirect(
            "moduleimpl_status?moduleimpl_id=" + moduleimpl_id
        )
    else:
        sco_moduleimpl.do_moduleimpl_edit(
            context,
            {
                "moduleimpl_id": moduleimpl_id,
                "computation_expr": tf[2]["computation_expr"],
            },
            formsemestre_id=sem["formsemestre_id"],
        )
        sco_core.inval_cache(
            context, formsemestre_id=sem["formsemestre_id"]
        )  # > modif regle calcul
        return REQUEST.RESPONSE.redirect(
            "moduleimpl_status?moduleimpl_id="
            + moduleimpl_id
            + "&head_message=règle%20de%20calcul%20modifiée"
        )


@bp.route("/view_module_abs")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def view_module_abs(context, REQUEST, moduleimpl_id, format="html"):
    """Visualisation des absences a un module"""
    M = sco_moduleimpl.do_moduleimpl_withmodule_list(
        context, moduleimpl_id=moduleimpl_id
    )[0]
    sem = sco_formsemestre.get_formsemestre(context, M["formsemestre_id"])
    debut_sem = ndb.DateDMYtoISO(sem["date_debut"])
    fin_sem = ndb.DateDMYtoISO(sem["date_fin"])
    list_insc = sco_moduleimpl.do_moduleimpl_listeetuds(context, moduleimpl_id)

    T = []
    for etudid in list_insc:
        nb_abs = context.Absences.CountAbs(
            etudid=etudid, debut=debut_sem, fin=fin_sem, moduleimpl_id=moduleimpl_id
        )
        if nb_abs:
            nb_abs_just = context.Absences.CountAbsJust(
                etudid=etudid,
                debut=debut_sem,
                fin=fin_sem,
                moduleimpl_id=moduleimpl_id,
            )
            etud = scolars.get_etud_info(etudid=etudid, filled=True)[0]
            T.append(
                {
                    "nomprenom": etud["nomprenom"],
                    "just": nb_abs_just,
                    "nojust": nb_abs - nb_abs_just,
                    "total": nb_abs,
                    "_nomprenom_target": "ficheEtud?etudid=%s" % etudid,
                }
            )

    H = [
        html_sco_header.html_sem_header(
            context,
            REQUEST,
            'Absences du <a href="moduleimpl_status?moduleimpl_id=%s">module %s</a>'
            % (moduleimpl_id, M["module"]["titre"]),
            page_title="Absences du module %s" % (M["module"]["titre"]),
            sem=sem,
        )
    ]
    if not T and format == "html":
        return (
            "\n".join(H)
            + "<p>Aucune absence signalée</p>"
            + context.sco_footer(REQUEST)
        )

    tab = GenTable(
        titles={
            "nomprenom": "Nom",
            "just": "Just.",
            "nojust": "Non Just.",
            "total": "Total",
        },
        columns_ids=("nomprenom", "just", "nojust", "total"),
        rows=T,
        html_class="table_leftalign",
        base_url="%s?moduleimpl_id=%s" % (REQUEST.URL0, moduleimpl_id),
        filename="absmodule_" + scu.make_filename(M["module"]["titre"]),
        caption="Absences dans le module %s" % M["module"]["titre"],
        preferences=sco_preferences.SemPreferences(
            context,
        ),
    )

    if format != "html":
        return tab.make_page(context, format=format, REQUEST=REQUEST)

    return "\n".join(H) + tab.html() + context.sco_footer(REQUEST)


@bp.route("/edit_ue_expr")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def edit_ue_expr(context, REQUEST, formsemestre_id, ue_id):
    """Edition formule calcul moyenne UE"""
    # Check access
    sem = sco_formsemestre_edit.can_edit_sem(context, REQUEST, formsemestre_id)
    if not sem:
        raise AccessDenied("vous n'avez pas le droit d'effectuer cette opération")
    cnx = ndb.GetDBConnexion()
    #
    ue = context.do_ue_list({"ue_id": ue_id})[0]
    H = [
        html_sco_header.html_sem_header(
            context,
            REQUEST,
            "Modification règle de calcul de l'UE %s (%s)"
            % (ue["acronyme"], ue["titre"]),
            sem,
        ),
        context._expr_help % {"target": "de l'UE", "objs": "modules", "ordre": ""},
    ]
    el = sco_compute_moy.formsemestre_ue_computation_expr_list(
        cnx, {"formsemestre_id": formsemestre_id, "ue_id": ue_id}
    )
    if el:
        initvalues = el[0]
    else:
        initvalues = {}
    form = [
        ("ue_id", {"input_type": "hidden"}),
        ("formsemestre_id", {"input_type": "hidden"}),
        (
            "computation_expr",
            {
                "title": "Formule de calcul",
                "input_type": "textarea",
                "rows": 4,
                "cols": 60,
                "explanation": "formule de calcul (expérimental)",
            },
        ),
    ]
    tf = TrivialFormulator(
        REQUEST.URL0,
        REQUEST.form,
        form,
        submitlabel="Modifier formule de calcul",
        cancelbutton="Annuler",
        initvalues=initvalues,
    )
    if tf[0] == 0:
        return "\n".join(H) + tf[1] + context.sco_footer(REQUEST)
    elif tf[0] == -1:
        return REQUEST.RESPONSE.redirect(
            "formsemestre_status?formsemestre_id=" + formsemestre_id
        )
    else:
        if el:
            el[0]["computation_expr"] = tf[2]["computation_expr"]
            sco_compute_moy.formsemestre_ue_computation_expr_edit(cnx, el[0])
        else:
            sco_compute_moy.formsemestre_ue_computation_expr_create(cnx, tf[2])

        sco_core.inval_cache(
            context, formsemestre_id=formsemestre_id
        )  # > modif regle calcul
        return REQUEST.RESPONSE.redirect(
            "formsemestre_status?formsemestre_id="
            + formsemestre_id
            + "&head_message=règle%20de%20calcul%20modifiée"
        )


@bp.route("/formsemestre_enseignants_list")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_enseignants_list(context, REQUEST, formsemestre_id, format="html"):
    """Liste les enseignants intervenants dans le semestre (resp. modules et chargés de TD)
    et indique les absences saisies par chacun.
    """
    sem = sco_formsemestre.get_formsemestre(context, formsemestre_id)
    # resp. de modules:
    mods = sco_moduleimpl.do_moduleimpl_withmodule_list(
        context, formsemestre_id=formsemestre_id
    )
    sem_ens = {}
    for mod in mods:
        if not mod["responsable_id"] in sem_ens:
            sem_ens[mod["responsable_id"]] = {"mods": [mod]}
        else:
            sem_ens[mod["responsable_id"]]["mods"].append(mod)
    # charges de TD:
    for mod in mods:
        for ensd in mod["ens"]:
            if not ensd["ens_id"] in sem_ens:
                sem_ens[ensd["ens_id"]] = {"mods": [mod]}
            else:
                sem_ens[ensd["ens_id"]]["mods"].append(mod)
    # compte les absences ajoutées par chacun dans tout le semestre
    cnx = ndb.GetDBConnexion()
    cursor = cnx.cursor(cursor_factory=ndb.ScoDocCursor)
    for ens in sem_ens:
        cursor.execute(
            "select * from scolog L, notes_formsemestre_inscription I where method='AddAbsence' and authenticated_user=%(authenticated_user)s and L.etudid = I.etudid and  I.formsemestre_id=%(formsemestre_id)s and date > %(date_debut)s and date < %(date_fin)s",
            {
                "authenticated_user": ens,
                "formsemestre_id": formsemestre_id,
                "date_debut": ndb.DateDMYtoISO(sem["date_debut"]),
                "date_fin": ndb.DateDMYtoISO(sem["date_fin"]),
            },
        )

        events = cursor.dictfetchall()
        sem_ens[ens]["nbabsadded"] = len(events)

    # description textuelle des modules
    for ens in sem_ens:
        sem_ens[ens]["descr_mods"] = ", ".join(
            [x["module"]["code"] for x in sem_ens[ens]["mods"]]
        )

    # ajoute infos sur enseignant:
    for ens in sem_ens:
        sem_ens[ens].update(context.Users.user_info(ens))
        if sem_ens[ens]["email"]:
            sem_ens[ens]["_email_target"] = "mailto:%s" % sem_ens[ens]["email"]

    sem_ens_list = sem_ens.values()
    sem_ens_list.sort(lambda x, y: cmp(x["nomprenom"], y["nomprenom"]))

    # --- Generate page with table
    title = "Enseignants de " + sem["titremois"]
    T = GenTable(
        columns_ids=["nom_fmt", "prenom_fmt", "descr_mods", "nbabsadded", "email"],
        titles={
            "nom_fmt": "Nom",
            "prenom_fmt": "Prénom",
            "email": "Mail",
            "descr_mods": "Modules",
            "nbabsadded": "Saisies Abs.",
        },
        rows=sem_ens_list,
        html_sortable=True,
        html_class="table_leftalign",
        filename=scu.make_filename("Enseignants-" + sem["titreannee"]),
        html_title=html_sco_header.html_sem_header(
            context, REQUEST, "Enseignants du semestre", sem, with_page_header=False
        ),
        base_url="%s?formsemestre_id=%s" % (REQUEST.URL0, formsemestre_id),
        caption="Tous les enseignants (responsables ou associés aux modules de ce semestre) apparaissent. Le nombre de saisies d'absences est le nombre d'opérations d'ajout effectuées sur ce semestre, sans tenir compte des annulations ou double saisies.",
        preferences=sco_preferences.SemPreferences(context, formsemestre_id),
    )
    return T.make_page(
        context, page_title=title, title=title, REQUEST=REQUEST, format=format
    )


@bp.route("/edit_enseignants_form_delete")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def edit_enseignants_form_delete(context, REQUEST, moduleimpl_id, ens_id):
    "remove ens"
    M, _ = sco_moduleimpl.can_change_ens(context, REQUEST, moduleimpl_id)
    # search ens_id
    ok = False
    for ens in M["ens"]:
        if ens["ens_id"] == ens_id:
            ok = True
            break
    if not ok:
        raise ScoValueError("invalid ens_id (%s)" % ens_id)
    sco_moduleimpl.do_ens_delete(context, ens["modules_enseignants_id"])
    return REQUEST.RESPONSE.redirect(
        "edit_enseignants_form?moduleimpl_id=%s" % moduleimpl_id
    )


# --- Gestion des inscriptions aux modules
_formsemestre_inscriptionEditor = ndb.EditableTable(
    "notes_formsemestre_inscription",
    "formsemestre_inscription_id",
    ("formsemestre_inscription_id", "etudid", "formsemestre_id", "etat", "etape"),
    sortkey="formsemestre_id",
)


@bp.route("/do_formsemestre_inscription_create")
@permission_required(Permission.ScoEtudInscrit)
@scodoc7func(context)
def do_formsemestre_inscription_create(context, args, REQUEST, method=None):
    "create a formsemestre_inscription (and sco event)"
    cnx = ndb.GetDBConnexion()
    log("do_formsemestre_inscription_create: args=%s" % str(args))
    sems = sco_formsemestre.do_formsemestre_list(
        context, {"formsemestre_id": args["formsemestre_id"]}
    )
    if len(sems) != 1:
        raise ScoValueError("code de semestre invalide: %s" % args["formsemestre_id"])
    sem = sems[0]
    # check lock
    if sem["etat"] != "1":
        raise ScoValueError("inscription: semestre verrouille")
    #
    r = context._formsemestre_inscriptionEditor.create(cnx, args)
    # Evenement
    scolars.scolar_events_create(
        cnx,
        args={
            "etudid": args["etudid"],
            "event_date": time.strftime("%d/%m/%Y"),
            "formsemestre_id": args["formsemestre_id"],
            "event_type": "INSCRIPTION",
        },
    )
    # Log etudiant
    logdb(
        REQUEST,
        cnx,
        method=method,
        etudid=args["etudid"],
        msg="inscription en semestre %s" % args["formsemestre_id"],
        commit=False,
    )
    #
    sco_core.inval_cache(
        context, formsemestre_id=args["formsemestre_id"]
    )  # > inscription au semestre
    return r


@bp.route("/do_formsemestre_inscription_delete")
@permission_required(Permission.ScoImplement)
@scodoc7func(context)
def do_formsemestre_inscription_delete(context, oid, formsemestre_id=None):
    "delete formsemestre_inscription"
    cnx = ndb.GetDBConnexion()
    context._formsemestre_inscriptionEditor.delete(cnx, oid)

    sco_core.inval_cache(
        context, formsemestre_id=formsemestre_id
    )  # > desinscription du semestre


@bp.route("/do_formsemestre_inscription_list")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def do_formsemestre_inscription_list(context, *args, **kw):
    "list formsemestre_inscriptions"
    cnx = ndb.GetDBConnexion()
    return context._formsemestre_inscriptionEditor.list(cnx, *args, **kw)


@bp.route("/do_formsemestre_inscription_listinscrits")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def do_formsemestre_inscription_listinscrits(
    context, formsemestre_id, format=None, REQUEST=None
):
    """Liste les inscrits (état I) à ce semestre et cache le résultat"""
    cache = context.get_formsemestre_inscription_cache()
    r = cache.get(formsemestre_id)
    if r is None:
        # retreive list
        r = context.do_formsemestre_inscription_list(
            args={"formsemestre_id": formsemestre_id, "etat": "I"}
        )
        cache.set(formsemestre_id, r)
    return scu.sendResult(REQUEST, r, format=format, name="inscrits")


@bp.route("/do_formsemestre_inscription_edit")
@permission_required(Permission.ScoImplement)
@scodoc7func(context)
def do_formsemestre_inscription_edit(context, args=None, formsemestre_id=None):
    "edit a formsemestre_inscription"
    cnx = ndb.GetDBConnexion()
    context._formsemestre_inscriptionEditor.edit(cnx, args)
    sco_core.inval_cache(
        context, formsemestre_id=formsemestre_id
    )  # > modif inscription semestre (demission ?)


@bp.route("/formsemestre_desinscription")
@permission_required(Permission.ScoImplement)
@scodoc7func(context)
def formsemestre_desinscription(
    context, etudid, formsemestre_id, REQUEST=None, dialog_confirmed=False
):
    """desinscrit l'etudiant de ce semestre (et donc de tous les modules).
    A n'utiliser qu'en cas d'erreur de saisie.
    S'il s'agit d'un semestre extérieur et qu'il n'y a plus d'inscrit,
    le semestre sera supprimé.
    """
    sem = sco_formsemestre.get_formsemestre(context, formsemestre_id)
    # -- check lock
    if sem["etat"] != "1":
        raise ScoValueError("desinscription impossible: semestre verrouille")

    # -- Si décisions de jury, désinscription interdite
    nt = sco_core.get_notes_cache(context).get_NotesTable(context, formsemestre_id)
    if nt.etud_has_decision(etudid):
        raise ScoValueError(
            """Désinscription impossible: l'étudiant a une décision de jury 
            (la supprimer avant si nécessaire: 
            <a href="formsemestre_validation_suppress_etud?etudid=%s&formsemestre_id=%s">
            supprimer décision jury</a>
            )
            """
            % (etudid, formsemestre_id)
        )
    if not dialog_confirmed:
        etud = scolars.get_etud_info(etudid=etudid, filled=1)[0]
        if sem["modalite"] != "EXT":
            msg_ext = """
            <p>%s sera désinscrit de tous les modules du semestre %s (%s - %s).</p>
            <p>Cette opération ne doit être utilisée que pour corriger une <b>erreur</b> !
            Un étudiant réellement inscrit doit le rester, le faire éventuellement <b>démissionner<b>.
            </p>
            """ % (
                etud["nomprenom"],
                sem["titre_num"],
                sem["date_debut"],
                sem["date_fin"],
            )
        else:  # semestre extérieur
            msg_ext = """
            <p>%s sera désinscrit du semestre extérieur %s (%s - %s).</p>
            """ % (
                etud["nomprenom"],
                sem["titre_num"],
                sem["date_debut"],
                sem["date_fin"],
            )
            inscrits = context.do_formsemestre_inscription_list(
                args={"formsemestre_id": formsemestre_id}
            )
            nbinscrits = len(inscrits)
            if nbinscrits <= 1:
                msg_ext = """<p class="warning">Attention: le semestre extérieur sera supprimé
                car il n'a pas d'autre étudiant inscrit.
                </p>
                """
        return scu.confirm_dialog(
            context,
            """<h2>Confirmer la demande de desinscription ?</h2>""" + msg_ext,
            dest_url="",
            REQUEST=REQUEST,
            cancel_url="formsemestre_status?formsemestre_id=%s" % formsemestre_id,
            parameters={"etudid": etudid, "formsemestre_id": formsemestre_id},
        )

    context.do_formsemestre_desinscription(etudid, formsemestre_id, REQUEST=REQUEST)

    return (
        html_sco_header.sco_header(context, REQUEST)
        + '<p>Etudiant désinscrit !</p><p><a class="stdlink" href="%s/ficheEtud?etudid=%s">retour à la fiche</a>'
        % (scu.ScoURL(), etudid)
        + context.sco_footer(REQUEST)
    )


@bp.route("/do_formsemestre_desinscription")
@permission_required(Permission.ScoImplement)
@scodoc7func(context)
def do_formsemestre_desinscription(context, etudid, formsemestre_id, REQUEST=None):
    """Désinscription d'un étudiant.
    Si semestre extérieur et dernier inscrit, suppression de ce semestre.
    """
    sem = sco_formsemestre.get_formsemestre(context, formsemestre_id)
    # -- check lock
    if sem["etat"] != "1":
        raise ScoValueError("desinscription impossible: semestre verrouille")

    # -- Si decisions de jury, desinscription interdite
    nt = sco_core.get_notes_cache(context).get_NotesTable(context, formsemestre_id)
    if nt.etud_has_decision(etudid):
        raise ScoValueError(
            "desinscription impossible: l'étudiant a une décision de jury (la supprimer avant si nécessaire)"
        )

    insem = context.do_formsemestre_inscription_list(
        args={"formsemestre_id": formsemestre_id, "etudid": etudid}
    )
    if not insem:
        raise ScoValueError("%s n'est pas inscrit au semestre !" % etudid)
    insem = insem[0]
    # -- desinscription de tous les modules
    cnx = ndb.GetDBConnexion()
    cursor = cnx.cursor(cursor_factory=ndb.ScoDocCursor)
    cursor.execute(
        "select moduleimpl_inscription_id from notes_moduleimpl_inscription Im, notes_moduleimpl M  where Im.etudid=%(etudid)s and Im.moduleimpl_id = M.moduleimpl_id and M.formsemestre_id = %(formsemestre_id)s",
        {"etudid": etudid, "formsemestre_id": formsemestre_id},
    )
    res = cursor.fetchall()
    moduleimpl_inscription_ids = [x[0] for x in res]
    for moduleimpl_inscription_id in moduleimpl_inscription_ids:
        sco_moduleimpl.do_moduleimpl_inscription_delete(
            context, moduleimpl_inscription_id, formsemestre_id=formsemestre_id
        )
    # -- desincription du semestre
    context.do_formsemestre_inscription_delete(
        insem["formsemestre_inscription_id"], formsemestre_id=formsemestre_id
    )
    # --- Semestre extérieur
    if sem["modalite"] == "EXT":
        inscrits = context.do_formsemestre_inscription_list(
            args={"formsemestre_id": formsemestre_id}
        )
        nbinscrits = len(inscrits)
        if nbinscrits == 0:
            log(
                "do_formsemestre_desinscription: suppression du semestre extérieur %s"
                % formsemestre_id
            )
            sco_formsemestre_edit.do_formsemestre_delete(
                context, formsemestre_id, REQUEST=REQUEST
            )

    if REQUEST:
        logdb(
            REQUEST,
            cnx,
            method="formsemestre_desinscription",
            etudid=etudid,
            msg="desinscription semestre %s" % formsemestre_id,
            commit=False,
        )


@bp.route("/etud_desinscrit_ue")
@permission_required(Permission.ScoEtudInscrit)
@scodoc7func(context)
def etud_desinscrit_ue(context, etudid, formsemestre_id, ue_id, REQUEST=None):
    """Desinscrit l'etudiant de tous les modules de cette UE dans ce semestre."""
    sco_moduleimpl_inscriptions.do_etud_desinscrit_ue(
        context, etudid, formsemestre_id, ue_id, REQUEST=REQUEST
    )
    return REQUEST.RESPONSE.redirect(
        scu.ScoURL()
        + "/Notes/moduleimpl_inscriptions_stats?formsemestre_id="
        + formsemestre_id
    )


@bp.route("/etud_inscrit_ue")
@permission_required(Permission.ScoEtudInscrit)
@scodoc7func(context)
def etud_inscrit_ue(context, etudid, formsemestre_id, ue_id, REQUEST=None):
    """Inscrit l'etudiant de tous les modules de cette UE dans ce semestre."""
    sco_moduleimpl_inscriptions.do_etud_inscrit_ue(
        context, etudid, formsemestre_id, ue_id, REQUEST=REQUEST
    )
    return REQUEST.RESPONSE.redirect(
        scu.ScoURL()
        + "/Notes/moduleimpl_inscriptions_stats?formsemestre_id="
        + formsemestre_id
    )


# --- Inscriptions
sco_publish(
    "/formsemestre_inscription_with_modules_form",
    sco_formsemestre_inscriptions.formsemestre_inscription_with_modules_form,
    Permission.ScoEtudInscrit,
)
sco_publish(
    "/formsemestre_inscription_with_modules_etud",
    sco_formsemestre_inscriptions.formsemestre_inscription_with_modules_etud,
    Permission.ScoEtudInscrit,
)
sco_publish(
    "/formsemestre_inscription_with_modules",
    sco_formsemestre_inscriptions.formsemestre_inscription_with_modules,
    Permission.ScoEtudInscrit,
)
sco_publish(
    "/formsemestre_inscription_option",
    sco_formsemestre_inscriptions.formsemestre_inscription_option,
    Permission.ScoEtudInscrit,
)
sco_publish(
    "/do_moduleimpl_incription_options",
    sco_formsemestre_inscriptions.do_moduleimpl_incription_options,
    Permission.ScoEtudInscrit,
)
sco_publish(
    "/formsemestre_inscrits_ailleurs",
    sco_formsemestre_inscriptions.formsemestre_inscrits_ailleurs,
    Permission.ScoView,
)
sco_publish(
    "/moduleimpl_inscriptions_edit",
    sco_moduleimpl_inscriptions.moduleimpl_inscriptions_edit,
    Permission.ScoEtudInscrit,
)
sco_publish(
    "/moduleimpl_inscriptions_stats",
    sco_moduleimpl_inscriptions.moduleimpl_inscriptions_stats,
    Permission.ScoView,
)


# --- Evaluations
_evaluationEditor = ndb.EditableTable(
    "notes_evaluation",
    "evaluation_id",
    (
        "evaluation_id",
        "moduleimpl_id",
        "jour",
        "heure_debut",
        "heure_fin",
        "description",
        "note_max",
        "coefficient",
        "visibulletin",
        "publish_incomplete",
        "evaluation_type",
        "numero",
    ),
    sortkey="numero desc, jour desc, heure_debut desc",  # plus recente d'abord
    output_formators={
        "jour": ndb.DateISOtoDMY,
        "visibulletin": str,
        "publish_incomplete": str,
        "numero": ndb.int_null_is_zero,
    },
    input_formators={
        "jour": ndb.DateDMYtoISO,
        "heure_debut": ndb.TimetoISO8601,  # converti par do_evaluation_list
        "heure_fin": ndb.TimetoISO8601,  # converti par do_evaluation_list
        "visibulletin": int,
        "publish_incomplete": int,
    },
)


def _evaluation_check_write_access(context, REQUEST, moduleimpl_id=None):
    """Vérifie que l'on a le droit de modifier, créer ou détruire une
    évaluation dans ce module.
    Sinon, lance une exception.
    (nb: n'implique pas le droit de saisir ou modifier des notes)
    """
    # acces pour resp. moduleimpl et resp. form semestre (dir etud)
    if moduleimpl_id is None:
        raise ValueError("no moduleimpl specified")  # bug
    authuser = REQUEST.AUTHENTICATED_USER
    uid = str(authuser)
    M = sco_moduleimpl.do_moduleimpl_list(context, moduleimpl_id=moduleimpl_id)[0]
    sem = sco_formsemestre.get_formsemestre(context, M["formsemestre_id"])

    if (
        (not authuser.has_permission(Permission.ScoEditAllEvals, context))
        and uid != M["responsable_id"]
        and uid not in sem["responsables"]
    ):
        if sem["ens_can_edit_eval"]:
            for ens in M["ens"]:
                if ens["ens_id"] == uid:
                    return  # ok
        raise AccessDenied("Modification évaluation impossible pour %s" % (uid,))


@bp.route("/do_evaluation_create")
@permission_required(Permission.ScoEnsView)
@scodoc7func(context)
def do_evaluation_create(
    context,
    moduleimpl_id=None,
    jour=None,
    heure_debut=None,
    heure_fin=None,
    description=None,
    note_max=None,
    coefficient=None,
    visibulletin=None,
    publish_incomplete=None,
    evaluation_type=None,
    numero=None,
    REQUEST=None,
    **kw
):
    """Create an evaluation"""
    args = locals()
    log("do_evaluation_create: args=" + str(args))
    context._evaluation_check_write_access(REQUEST, moduleimpl_id=moduleimpl_id)
    context._check_evaluation_args(args)
    # Check numeros
    sco_evaluations.module_evaluation_renumber(
        context, moduleimpl_id, REQUEST=REQUEST, only_if_unumbered=True
    )
    if not "numero" in args or args["numero"] is None:
        n = None
        # determine le numero avec la date
        # Liste des eval existantes triees par date, la plus ancienne en tete
        ModEvals = context.do_evaluation_list(
            args={"moduleimpl_id": moduleimpl_id},
            sortkey="jour asc, heure_debut asc",
        )
        if args["jour"]:
            next_eval = None
            t = (
                ndb.DateDMYtoISO(args["jour"]),
                ndb.TimetoISO8601(args["heure_debut"]),
            )
            for e in ModEvals:
                if (
                    ndb.DateDMYtoISO(e["jour"]),
                    ndb.TimetoISO8601(e["heure_debut"]),
                ) > t:
                    next_eval = e
                    break
            if next_eval:
                n = sco_evaluations.module_evaluation_insert_before(
                    context, ModEvals, next_eval, REQUEST
                )
            else:
                n = None  # a placer en fin
        if n is None:  # pas de date ou en fin:
            if ModEvals:
                log(pprint.pformat(ModEvals[-1]))
                n = ModEvals[-1]["numero"] + 1
            else:
                n = 0  # the only one
        # log("creating with numero n=%d" % n)
        args["numero"] = n

    #
    cnx = ndb.GetDBConnexion()
    r = context._evaluationEditor.create(cnx, args)

    # news
    M = sco_moduleimpl.do_moduleimpl_list(context, moduleimpl_id=moduleimpl_id)[0]
    mod = context.do_module_list(args={"module_id": M["module_id"]})[0]
    mod["moduleimpl_id"] = M["moduleimpl_id"]
    mod["url"] = "Notes/moduleimpl_status?moduleimpl_id=%(moduleimpl_id)s" % mod
    sco_news.add(
        context,
        REQUEST,
        typ=NEWS_NOTE,
        object=moduleimpl_id,
        text='Création d\'une évaluation dans <a href="%(url)s">%(titre)s</a>' % mod,
        url=mod["url"],
    )

    return r


def _check_evaluation_args(context, args):
    "Check coefficient, dates and duration, raises exception if invalid"
    moduleimpl_id = args["moduleimpl_id"]
    # check bareme
    note_max = args.get("note_max", None)
    if note_max is None:
        raise ScoValueError("missing note_max")
    try:
        note_max = float(note_max)
    except ValueError:
        raise ScoValueError("Invalid note_max value")
    if note_max < 0:
        raise ScoValueError("Invalid note_max value (must be positive or null)")
    # check coefficient
    coef = args.get("coefficient", None)
    if coef is None:
        raise ScoValueError("missing coefficient")
    try:
        coef = float(coef)
    except ValueError:
        raise ScoValueError("Invalid coefficient value")
    if coef < 0:
        raise ScoValueError("Invalid coefficient value (must be positive or null)")
    # check date
    jour = args.get("jour", None)
    args["jour"] = jour
    if jour:
        M = sco_moduleimpl.do_moduleimpl_list(context, moduleimpl_id=moduleimpl_id)[0]
        sem = sco_formsemestre.get_formsemestre(context, M["formsemestre_id"])
        d, m, y = [int(x) for x in sem["date_debut"].split("/")]
        date_debut = datetime.date(y, m, d)
        d, m, y = [int(x) for x in sem["date_fin"].split("/")]
        date_fin = datetime.date(y, m, d)
        # passe par ndb.DateDMYtoISO pour avoir date pivot
        y, m, d = [int(x) for x in ndb.DateDMYtoISO(jour).split("-")]
        jour = datetime.date(y, m, d)
        if (jour > date_fin) or (jour < date_debut):
            raise ScoValueError(
                "La date de l'évaluation (%s/%s/%s) n'est pas dans le semestre !"
                % (d, m, y)
            )
    heure_debut = args.get("heure_debut", None)
    args["heure_debut"] = heure_debut
    heure_fin = args.get("heure_fin", None)
    args["heure_fin"] = heure_fin
    if jour and ((not heure_debut) or (not heure_fin)):
        raise ScoValueError("Les heures doivent être précisées")
    d = ndb.TimeDuration(heure_debut, heure_fin)
    if d and ((d < 0) or (d > 60 * 12)):
        raise ScoValueError("Heures de l'évaluation incohérentes !")


@bp.route("/evaluation_delete")
@permission_required(Permission.ScoEnsView)
@scodoc7func(context)
def evaluation_delete(context, REQUEST, evaluation_id):
    """Form delete evaluation"""
    El = context.do_evaluation_list(args={"evaluation_id": evaluation_id})
    if not El:
        raise ValueError("Evalution inexistante ! (%s)" % evaluation_id)
    E = El[0]
    M = sco_moduleimpl.do_moduleimpl_list(context, moduleimpl_id=E["moduleimpl_id"])[0]
    Mod = context.do_module_list(args={"module_id": M["module_id"]})[0]
    tit = "Suppression de l'évaluation %(description)s (%(jour)s)" % E
    etat = sco_evaluations.do_evaluation_etat(context, evaluation_id)
    H = [
        html_sco_header.html_sem_header(context, REQUEST, tit, with_h2=False),
        """<h2 class="formsemestre">Module <tt>%(code)s</tt> %(titre)s</h2>""" % Mod,
        """<h3>%s</h3>""" % tit,
        """<p class="help">Opération <span class="redboldtext">irréversible</span>. Si vous supprimez l'évaluation, vous ne pourrez pas retrouver les notes associées.</p>""",
    ]
    warning = False
    if etat["nb_notes_total"]:
        warning = True
        nb_desinscrits = etat["nb_notes_total"] - etat["nb_notes"]
        H.append(
            """<div class="ue_warning"><span>Il y a %s notes""" % etat["nb_notes_total"]
        )
        if nb_desinscrits:
            H.append(
                """ (dont %s d'étudiants qui ne sont plus inscrits)""" % nb_desinscrits
            )
        H.append(""" dans l'évaluation</span>""")
        if etat["nb_notes"] == 0:
            H.append(
                """<p>Vous pouvez quand même supprimer l'évaluation, les notes des étudiants désincrits seront effacées.</p>"""
            )

    if etat["nb_notes"]:
        H.append(
            """<p>Suppression impossible (effacer les notes d'abord)</p><p><a class="stdlink" href="moduleimpl_status?moduleimpl_id=%s">retour au tableau de bord du module</a></p></div>"""
            % E["moduleimpl_id"]
        )
        return "\n".join(H) + context.sco_footer(REQUEST)
    if warning:
        H.append("""</div>""")

    tf = TrivialFormulator(
        REQUEST.URL0,
        REQUEST.form,
        (("evaluation_id", {"input_type": "hidden"}),),
        initvalues=E,
        submitlabel="Confirmer la suppression",
        cancelbutton="Annuler",
    )
    if tf[0] == 0:
        return "\n".join(H) + tf[1] + context.sco_footer(REQUEST)
    elif tf[0] == -1:
        return REQUEST.RESPONSE.redirect(
            scu.ScoURL()
            + "/Notes/moduleimpl_status?moduleimpl_id="
            + E["moduleimpl_id"]
        )
    else:
        sco_evaluations.do_evaluation_delete(context, REQUEST, E["evaluation_id"])
        return (
            "\n".join(H)
            + """<p>OK, évaluation supprimée.</p>
        <p><a class="stdlink" href="%s">Continuer</a></p>"""
            % (
                scu.ScoURL()
                + "/Notes/moduleimpl_status?moduleimpl_id="
                + E["moduleimpl_id"]
            )
            + context.sco_footer(REQUEST)
        )


@bp.route("/do_evaluation_list")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def do_evaluation_list(context, args, sortkey=None):
    """List evaluations, sorted by numero (or most recent date first).

    Ajoute les champs:
    'duree' : '2h30'
    'matin' : 1 (commence avant 12:00) ou 0
    'apresmidi' : 1 (termine après 12:00) ou 0
    'descrheure' : ' de 15h00 à 16h30'
    """
    cnx = ndb.GetDBConnexion()
    evals = context._evaluationEditor.list(cnx, args, sortkey=sortkey)
    # calcule duree (chaine de car.) de chaque evaluation et ajoute jouriso, matin, apresmidi
    for e in evals:
        heure_debut_dt = e["heure_debut"] or datetime.time(
            8, 00
        )  # au cas ou pas d'heure (note externe?)
        heure_fin_dt = e["heure_fin"] or datetime.time(8, 00)
        e["heure_debut"] = ndb.TimefromISO8601(e["heure_debut"])
        e["heure_fin"] = ndb.TimefromISO8601(e["heure_fin"])
        e["jouriso"] = ndb.DateDMYtoISO(e["jour"])
        heure_debut, heure_fin = e["heure_debut"], e["heure_fin"]
        d = ndb.TimeDuration(heure_debut, heure_fin)
        if d is not None:
            m = d % 60
            e["duree"] = "%dh" % (d / 60)
            if m != 0:
                e["duree"] += "%02d" % m
        else:
            e["duree"] = ""
        if heure_debut and (not heure_fin or heure_fin == heure_debut):
            e["descrheure"] = " à " + heure_debut
        elif heure_debut and heure_fin:
            e["descrheure"] = " de %s à %s" % (heure_debut, heure_fin)
        else:
            e["descrheure"] = ""
        # matin, apresmidi: utile pour se referer aux absences:
        if heure_debut_dt < datetime.time(12, 00):
            e["matin"] = 1
        else:
            e["matin"] = 0
        if heure_fin_dt > datetime.time(12, 00):
            e["apresmidi"] = 1
        else:
            e["apresmidi"] = 0

    return evals


@bp.route("/do_evaluation_list_in_formsemestre")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def do_evaluation_list_in_formsemestre(context, formsemestre_id):
    "list evaluations in this formsemestre"
    mods = sco_moduleimpl.do_moduleimpl_list(context, formsemestre_id=formsemestre_id)
    evals = []
    for mod in mods:
        evals += context.do_evaluation_list(
            args={"moduleimpl_id": mod["moduleimpl_id"]}
        )
    return evals


@bp.route("/do_evaluation_edit")
@permission_required(Permission.ScoEnsView)
@scodoc7func(context)
def do_evaluation_edit(context, REQUEST, args):
    "edit a evaluation"
    evaluation_id = args["evaluation_id"]
    the_evals = context.do_evaluation_list({"evaluation_id": evaluation_id})
    if not the_evals:
        raise ValueError("evaluation inexistante !")
    moduleimpl_id = the_evals[0]["moduleimpl_id"]
    args["moduleimpl_id"] = moduleimpl_id
    context._check_evaluation_args(args)
    context._evaluation_check_write_access(REQUEST, moduleimpl_id=moduleimpl_id)
    cnx = ndb.GetDBConnexion()
    context._evaluationEditor.edit(cnx, args)
    # inval cache pour ce semestre
    M = sco_moduleimpl.do_moduleimpl_list(context, moduleimpl_id=moduleimpl_id)[0]
    sco_core.inval_cache(
        context, formsemestre_id=M["formsemestre_id"]
    )  # > evaluation_edit (coef, ...)


@bp.route("/evaluation_edit")
@permission_required(Permission.ScoEnsView)
@scodoc7func(context)
def evaluation_edit(context, evaluation_id, REQUEST):
    "form edit evaluation"
    return sco_evaluations.evaluation_create_form(
        context, evaluation_id=evaluation_id, REQUEST=REQUEST, edit=True
    )


@bp.route("/evaluation_create")
@permission_required(Permission.ScoEnsView)
@scodoc7func(context)
def evaluation_create(context, moduleimpl_id, REQUEST):
    "form create evaluation"
    return sco_evaluations.evaluation_create_form(
        context, moduleimpl_id=moduleimpl_id, REQUEST=REQUEST, edit=False
    )


@bp.route("/evaluation_listenotes")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def evaluation_listenotes(context, REQUEST=None):
    """Affichage des notes d'une évaluation"""
    if REQUEST.form.get("format", "html") == "html":
        H = html_sco_header.sco_header(
            context,
            REQUEST,
            cssstyles=["css/verticalhisto.css"],
            javascripts=["js/etud_info.js"],
            init_qtip=True,
        )
        F = context.sco_footer(REQUEST)
    else:
        H, F = "", ""
    B = context.do_evaluation_listenotes(REQUEST)
    return H + B + F


sco_publish(
    "/do_evaluation_listenotes",
    sco_liste_notes.do_evaluation_listenotes,
    Permission.ScoView,
)
sco_publish(
    "/evaluation_list_operations",
    sco_undo_notes.evaluation_list_operations,
    Permission.ScoView,
)
sco_publish(
    "/evaluation_check_absences_html",
    sco_liste_notes.evaluation_check_absences_html,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_check_absences_html",
    sco_liste_notes.formsemestre_check_absences_html,
    Permission.ScoView,
)

# --- Placement des étudiants pour l'évaluation
sco_publish(
    "/placement_eval_selectetuds",
    sco_placement.placement_eval_selectetuds,
    Permission.ScoEnsView,
)
sco_publish("/do_placement", sco_placement.do_placement, Permission.ScoEnsView)

# --- Saisie des notes
sco_publish(
    "/saisie_notes_tableur",
    sco_saisie_notes.saisie_notes_tableur,
    Permission.ScoEnsView,
)
sco_publish(
    "/feuille_saisie_notes",
    sco_saisie_notes.feuille_saisie_notes,
    Permission.ScoEnsView,
)
sco_publish("/saisie_notes", sco_saisie_notes.saisie_notes, Permission.ScoEnsView)
sco_publish("/save_note", sco_saisie_notes.save_note, Permission.ScoEnsView)
sco_publish(
    "/do_evaluation_set_missing",
    sco_saisie_notes.do_evaluation_set_missing,
    Permission.ScoEnsView,
)
sco_publish(
    "/evaluation_suppress_alln",
    sco_saisie_notes.evaluation_suppress_alln,
    Permission.ScoView,
)


def _notes_getall(
    context, evaluation_id, table="notes_notes", filter_suppressed=True, by_uid=None
):
    """get tt les notes pour une evaluation: { etudid : { 'value' : value, 'date' : date ... }}
    Attention: inclue aussi les notes des étudiants qui ne sont plus inscrits au module.
    """
    # log('_notes_getall( e=%s fs=%s )' % (evaluation_id, filter_suppressed))
    do_cache = (
        filter_suppressed and table == "notes_notes" and (by_uid is None)
    )  # pas de cache pour (rares) appels via undo_notes ou specifiant un enseignant
    if do_cache:
        cache = sco_core.get_evaluations_cache(context)
        r = cache.get(evaluation_id)
        if r != None:
            return r
    cnx = ndb.GetDBConnexion()
    cursor = cnx.cursor(cursor_factory=ndb.ScoDocCursor)
    cond = " where evaluation_id=%(evaluation_id)s"
    if by_uid:
        cond += " and uid=%(by_uid)s"

    cursor.execute(
        "select * from " + table + cond,
        {"evaluation_id": evaluation_id, "by_uid": by_uid},
    )
    res = cursor.dictfetchall()
    d = {}
    if filter_suppressed:
        for x in res:
            if x["value"] != scu.NOTES_SUPPRESS:
                d[x["etudid"]] = x
    else:
        for x in res:
            d[x["etudid"]] = x
    if do_cache:
        cache.set(evaluation_id, d)
    return d


# --- Bulletins
@bp.route("/formsemestre_bulletins_pdf")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_bulletins_pdf(
    context, formsemestre_id, REQUEST, version="selectedevals"
):
    "Publie les bulletins dans un classeur PDF"
    pdfdoc, filename = sco_bulletins_pdf.get_formsemestre_bulletins_pdf(
        context, formsemestre_id, REQUEST, version=version
    )
    return scu.sendPDFFile(REQUEST, pdfdoc, filename)


@bp.route("/formsemestre_bulletins_pdf_choice")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_bulletins_pdf_choice(context, REQUEST, formsemestre_id, version=None):
    """Choix version puis envois classeur bulletins pdf"""
    if version:
        pdfdoc, filename = sco_bulletins_pdf.get_formsemestre_bulletins_pdf(
            context, formsemestre_id, REQUEST, version=version
        )
        return scu.sendPDFFile(REQUEST, pdfdoc, filename)
    return formsemestre_bulletins_choice(
        context,
        REQUEST,
        formsemestre_id,
        title="Choisir la version des bulletins à générer",
        explanation=expl_bull,
    )


@bp.route("/etud_bulletins_pdf")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def etud_bulletins_pdf(context, etudid, REQUEST, version="selectedevals"):
    "Publie tous les bulletins d'un etudiants dans un classeur PDF"
    pdfdoc, filename = sco_bulletins_pdf.get_etud_bulletins_pdf(
        context, etudid, REQUEST, version=version
    )
    return scu.sendPDFFile(REQUEST, pdfdoc, filename)


@bp.route("/formsemestre_bulletins_mailetuds_choice")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_bulletins_mailetuds_choice(
    context,
    REQUEST,
    formsemestre_id,
    version=None,
    dialog_confirmed=False,
    prefer_mail_perso=0,
):
    """Choix version puis envois classeur bulletins pdf"""
    if version:
        return context.formsemestre_bulletins_mailetuds(
            formsemestre_id,
            REQUEST,
            version=version,
            dialog_confirmed=dialog_confirmed,
            prefer_mail_perso=prefer_mail_perso,
        )
    expl_bull = """Versions des bulletins:<ul><li><bf>courte</bf>: moyennes des modules</li><li><bf>intermédiaire</bf>: moyennes des modules et notes des évaluations sélectionnées</li><li><bf>complète</bf>: toutes les notes</li><ul>"""
    return formsemestre_bulletins_choice(
        context,
        REQUEST,
        formsemestre_id,
        title="Choisir la version des bulletins à envoyer par mail",
        explanation="Chaque étudiant ayant une adresse mail connue de ScoDoc recevra une copie PDF de son bulletin de notes, dans la version choisie.</p><p>"
        + expl_bull,
        choose_mail=True,
    )


# not published
def formsemestre_bulletins_choice(
    context, REQUEST, formsemestre_id, title="", explanation="", choose_mail=False
):
    """Choix d'une version de bulletin"""
    sem = sco_formsemestre.get_formsemestre(context, formsemestre_id)
    H = [
        html_sco_header.html_sem_header(context, REQUEST, title, sem),
        """
      <form name="f" method="GET" action="%s">
      <input type="hidden" name="formsemestre_id" value="%s"></input>
      """
        % (REQUEST.URL0, formsemestre_id),
    ]
    H.append("""<select name="version" class="noprint">""")
    for (v, e) in (
        ("short", "Version courte"),
        ("selectedevals", "Version intermédiaire"),
        ("long", "Version complète"),
    ):
        H.append('<option value="%s">%s</option>' % (v, e))

    H.append("""</select>&nbsp;&nbsp;<input type="submit" value="Générer"/>""")
    if choose_mail:
        H.append(
            """<div><input type="checkbox" name="prefer_mail_perso" value="1">Utiliser si possible les adresses personnelles</div>"""
        )

    H.append("""<p class="help">""" + explanation + """</p>""")

    return "\n".join(H) + html_sco_header.sco_footer(context, REQUEST)


@bp.route("/formsemestre_bulletins_mailetuds")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_bulletins_mailetuds(
    context,
    formsemestre_id,
    REQUEST,
    version="long",
    dialog_confirmed=False,
    prefer_mail_perso=0,
):
    "envoi a chaque etudiant (inscrit et ayant un mail) son bulletin"
    prefer_mail_perso = int(prefer_mail_perso)
    nt = sco_core.get_notes_cache(context).get_NotesTable(
        context, formsemestre_id
    )  # > get_etudids
    etudids = nt.get_etudids()
    #
    if not sco_bulletins.can_send_bulletin_by_mail(context, formsemestre_id, REQUEST):
        raise AccessDenied("vous n'avez pas le droit d'envoyer les bulletins")
    # Confirmation dialog
    if not dialog_confirmed:
        return scu.confirm_dialog(
            context,
            "<h2>Envoyer les %d bulletins par e-mail aux étudiants ?" % len(etudids),
            dest_url="",
            REQUEST=REQUEST,
            cancel_url="formsemestre_status?formsemestre_id=%s" % formsemestre_id,
            parameters={
                "version": version,
                "formsemestre_id": formsemestre_id,
                "prefer_mail_perso": prefer_mail_perso,
            },
        )

    # Make each bulletin
    nb_send = 0
    for etudid in etudids:
        h, _ = sco_bulletins.do_formsemestre_bulletinetud(
            context,
            formsemestre_id,
            etudid,
            version=version,
            prefer_mail_perso=prefer_mail_perso,
            format="pdfmail",
            nohtml=True,
            REQUEST=REQUEST,
        )
        if h:
            nb_send += 1
    #
    return (
        html_sco_header.sco_header(context, REQUEST)
        + '<p>%d bulletins sur %d envoyés par mail !</p><p><a class="stdlink" href="formsemestre_status?formsemestre_id=%s">continuer</a></p>'
        % (nb_send, len(etudids), formsemestre_id)
        + context.sco_footer(REQUEST)
    )


sco_publish(
    "/external_ue_create_form",
    sco_ue_external.external_ue_create_form,
    Permission.ScoView,
)


@bp.route("/appreciation_add_form")
@permission_required(Permission.ScoEnsView)
@scodoc7func(context)
def appreciation_add_form(
    context,
    etudid=None,
    formsemestre_id=None,
    id=None,  # si id, edit
    suppress=False,  # si true, supress id
    REQUEST=None,
):
    "form ajout ou edition d'une appreciation"
    cnx = ndb.GetDBConnexion()
    authuser = REQUEST.AUTHENTICATED_USER
    if id:  # edit mode
        apps = scolars.appreciations_list(cnx, args={"id": id})
        if not apps:
            raise ScoValueError("id d'appreciation invalide !")
        app = apps[0]
        formsemestre_id = app["formsemestre_id"]
        etudid = app["etudid"]
    if REQUEST.form.has_key("edit"):
        edit = int(REQUEST.form["edit"])
    elif id:
        edit = 1
    else:
        edit = 0
    sem = sco_formsemestre.get_formsemestre(context, formsemestre_id)
    # check custom access permission
    can_edit_app = (str(authuser) in sem["responsables"]) or (
        authuser.has_permission(Permission.ScoEtudInscrit, context)
    )
    if not can_edit_app:
        raise AccessDenied("vous n'avez pas le droit d'ajouter une appreciation")
    #
    bull_url = "formsemestre_bulletinetud?formsemestre_id=%s&etudid=%s" % (
        formsemestre_id,
        etudid,
    )
    if suppress:
        scolars.appreciations_delete(cnx, id)
        logdb(REQUEST, cnx, method="appreciation_suppress", etudid=etudid, msg="")
        return REQUEST.RESPONSE.redirect(bull_url)
    #
    etud = scolars.get_etud_info(etudid=etudid, filled=1)[0]
    if id:
        a = "Edition"
    else:
        a = "Ajout"
    H = [
        html_sco_header.sco_header(context, REQUEST)
        + "<h2>%s d'une appréciation sur %s</h2>" % (a, etud["nomprenom"])
    ]
    F = context.sco_footer(REQUEST)
    descr = [
        ("edit", {"input_type": "hidden", "default": edit}),
        ("etudid", {"input_type": "hidden"}),
        ("formsemestre_id", {"input_type": "hidden"}),
        ("id", {"input_type": "hidden"}),
        ("comment", {"title": "", "input_type": "textarea", "rows": 4, "cols": 60}),
    ]
    if id:
        initvalues = {
            "etudid": etudid,
            "formsemestre_id": formsemestre_id,
            "comment": app["comment"],
        }
    else:
        initvalues = {}
    tf = TrivialFormulator(
        REQUEST.URL0,
        REQUEST.form,
        descr,
        initvalues=initvalues,
        cancelbutton="Annuler",
        submitlabel="Ajouter appréciation",
    )
    if tf[0] == 0:
        return "\n".join(H) + "\n" + tf[1] + F
    elif tf[0] == -1:
        return REQUEST.RESPONSE.redirect(bull_url)
    else:
        args = {
            "etudid": etudid,
            "formsemestre_id": formsemestre_id,
            "author": str(authuser),
            "comment": tf[2]["comment"],
            "zope_authenticated_user": str(authuser),
            "zope_remote_addr": REQUEST.REMOTE_ADDR,
        }
        if edit:
            args["id"] = id
            scolars.appreciations_edit(cnx, args)
        else:  # nouvelle
            scolars.appreciations_create(cnx, args, has_uniq_values=False)
        # log
        logdb(
            REQUEST,
            cnx,
            method="appreciation_add",
            etudid=etudid,
            msg=tf[2]["comment"],
        )
        # ennuyeux mais necessaire (pour le PDF seulement)
        sco_core.inval_cache(
            context, pdfonly=True, formsemestre_id=formsemestre_id
        )  # > appreciation_add
        return REQUEST.RESPONSE.redirect(bull_url)


# --- FORMULAIRE POUR VALIDATION DES UE ET SEMESTRES


@bp.route("/formsemestre_validation_etud_form")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_validation_etud_form(
    context,
    formsemestre_id,
    etudid=None,
    etud_index=None,
    check=0,
    desturl="",
    sortcol=None,
    REQUEST=None,
):
    "Formulaire choix jury pour un étudiant"
    readonly = not sco_permissions.can_validate_sem(context, REQUEST, formsemestre_id)
    return sco_formsemestre_validation.formsemestre_validation_etud_form(
        context,
        formsemestre_id,
        etudid=etudid,
        etud_index=etud_index,
        check=check,
        readonly=readonly,
        desturl=desturl,
        sortcol=sortcol,
        REQUEST=REQUEST,
    )


@bp.route("/formsemestre_validation_etud")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_validation_etud(
    context,
    formsemestre_id,
    etudid=None,
    codechoice=None,
    desturl="",
    sortcol=None,
    REQUEST=None,
):
    "Enregistre choix jury pour un étudiant"
    if not sco_permissions.can_validate_sem(context, REQUEST, formsemestre_id):
        return scu.confirm_dialog(
            context,
            message="<p>Opération non autorisée pour %s</h2>"
            % REQUEST.AUTHENTICATED_USER,
            dest_url=scu.ScoURL(),
            REQUEST=REQUEST,
        )

    return sco_formsemestre_validation.formsemestre_validation_etud(
        context,
        formsemestre_id,
        etudid=etudid,
        codechoice=codechoice,
        desturl=desturl,
        sortcol=sortcol,
        REQUEST=REQUEST,
    )


@bp.route("/formsemestre_validation_etud_manu")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_validation_etud_manu(
    context,
    formsemestre_id,
    etudid=None,
    code_etat="",
    new_code_prev="",
    devenir="",
    assidu=False,
    desturl="",
    sortcol=None,
    REQUEST=None,
):
    "Enregistre choix jury pour un étudiant"
    if not sco_permissions.can_validate_sem(context, REQUEST, formsemestre_id):
        return scu.confirm_dialog(
            context,
            message="<p>Opération non autorisée pour %s</h2>"
            % REQUEST.AUTHENTICATED_USER,
            dest_url=scu.ScoURL(),
            REQUEST=REQUEST,
        )

    return sco_formsemestre_validation.formsemestre_validation_etud_manu(
        context,
        formsemestre_id,
        etudid=etudid,
        code_etat=code_etat,
        new_code_prev=new_code_prev,
        devenir=devenir,
        assidu=assidu,
        desturl=desturl,
        sortcol=sortcol,
        REQUEST=REQUEST,
    )


@bp.route("/formsemestre_validate_previous_ue")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_validate_previous_ue(
    context, formsemestre_id, etudid=None, REQUEST=None
):
    "Form. saisie UE validée hors ScoDoc "
    if not sco_permissions.can_validate_sem(context, REQUEST, formsemestre_id):
        return scu.confirm_dialog(
            context,
            message="<p>Opération non autorisée pour %s</h2>"
            % REQUEST.AUTHENTICATED_USER,
            dest_url=scu.ScoURL(),
            REQUEST=REQUEST,
        )
    return sco_formsemestre_validation.formsemestre_validate_previous_ue(
        context, formsemestre_id, etudid, REQUEST=REQUEST
    )


sco_publish(
    "/formsemestre_ext_create_form",
    sco_formsemestre_exterieurs.formsemestre_ext_create_form,
    Permission.ScoView,
)


@bp.route("/formsemestre_ext_edit_ue_validations")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_ext_edit_ue_validations(
    context, formsemestre_id, etudid=None, REQUEST=None
):
    "Form. edition UE semestre extérieur"
    if not sco_permissions.can_validate_sem(context, REQUEST, formsemestre_id):
        return scu.confirm_dialog(
            context,
            message="<p>Opération non autorisée pour %s</h2>"
            % REQUEST.AUTHENTICATED_USER,
            dest_url=scu.ScoURL(),
            REQUEST=REQUEST,
        )
    return sco_formsemestre_exterieurs.formsemestre_ext_edit_ue_validations(
        context, formsemestre_id, etudid, REQUEST=REQUEST
    )


sco_publish(
    "/get_etud_ue_cap_html",
    sco_formsemestre_validation.get_etud_ue_cap_html,
    Permission.ScoView,
)


@bp.route("/etud_ue_suppress_validation")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def etud_ue_suppress_validation(context, etudid, formsemestre_id, ue_id, REQUEST=None):
    """Suppress a validation (ue_id, etudid) and redirect to formsemestre"""
    if not sco_permissions.can_validate_sem(context, REQUEST, formsemestre_id):
        return scu.confirm_dialog(
            context,
            message="<p>Opération non autorisée pour %s</h2>"
            % REQUEST.AUTHENTICATED_USER,
            dest_url=scu.ScoURL(),
            REQUEST=REQUEST,
        )
    return sco_formsemestre_validation.etud_ue_suppress_validation(
        context, etudid, formsemestre_id, ue_id, REQUEST=REQUEST
    )


@bp.route("/formsemestre_validation_auto")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_validation_auto(context, formsemestre_id, REQUEST):
    "Formulaire saisie automatisee des decisions d'un semestre"
    if not sco_permissions.can_validate_sem(context, REQUEST, formsemestre_id):
        return scu.confirm_dialog(
            context,
            message="<p>Opération non autorisée pour %s</h2>"
            % REQUEST.AUTHENTICATED_USER,
            dest_url=scu.ScoURL(),
            REQUEST=REQUEST,
        )

    return sco_formsemestre_validation.formsemestre_validation_auto(
        context, formsemestre_id, REQUEST
    )


@bp.route("/do_formsemestre_validation_auto")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def do_formsemestre_validation_auto(context, formsemestre_id, REQUEST):
    "Formulaire saisie automatisee des decisions d'un semestre"
    if not sco_permissions.can_validate_sem(context, REQUEST, formsemestre_id):
        return scu.confirm_dialog(
            context,
            message="<p>Opération non autorisée pour %s</h2>"
            % REQUEST.AUTHENTICATED_USER,
            dest_url=scu.ScoURL(),
            REQUEST=REQUEST,
        )

    return sco_formsemestre_validation.do_formsemestre_validation_auto(
        context, formsemestre_id, REQUEST
    )


@bp.route("/formsemestre_fix_validation_ues")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_fix_validation_ues(context, formsemestre_id, REQUEST=None):
    "Verif/reparation codes UE"
    if not sco_permissions.can_validate_sem(context, REQUEST, formsemestre_id):
        return scu.confirm_dialog(
            context,
            message="<p>Opération non autorisée pour %s</h2>"
            % REQUEST.AUTHENTICATED_USER,
            dest_url=scu.ScoURL(),
            REQUEST=REQUEST,
        )

    return sco_formsemestre_validation.formsemestre_fix_validation_ues(
        context, formsemestre_id, REQUEST
    )


@bp.route("/formsemestre_validation_suppress_etud")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def formsemestre_validation_suppress_etud(
    context, formsemestre_id, etudid, REQUEST=None, dialog_confirmed=False
):
    """Suppression des decisions de jury pour un etudiant."""
    if not sco_permissions.can_validate_sem(context, REQUEST, formsemestre_id):
        return scu.confirm_dialog(
            context,
            message="<p>Opération non autorisée pour %s</h2>"
            % REQUEST.AUTHENTICATED_USER,
            dest_url=scu.ScoURL(),
            REQUEST=REQUEST,
        )
    if not dialog_confirmed:
        sem = sco_formsemestre.get_formsemestre(context, formsemestre_id)
        etud = scolars.get_etud_info(etudid=etudid, filled=1)[0]
        nt = sco_core.get_notes_cache(context).get_NotesTable(
            context, formsemestre_id
        )  # > get_etud_decision_sem
        decision_jury = nt.get_etud_decision_sem(etudid)
        if decision_jury:
            existing = (
                "<p>Décision existante: %(code)s du %(event_date)s</p>" % decision_jury
            )
        else:
            existing = ""
        return scu.confirm_dialog(
            context,
            """<h2>Confirmer la suppression des décisions du semestre %s (%s - %s) pour %s ?</h2>%s
            <p>Cette opération est irréversible.
            </p>
            """
            % (
                sem["titre_num"],
                sem["date_debut"],
                sem["date_fin"],
                etud["nomprenom"],
                existing,
            ),
            OK="Supprimer",
            dest_url="",
            REQUEST=REQUEST,
            cancel_url="formsemestre_validation_etud_form?formsemestre_id=%s&etudid=%s"
            % (formsemestre_id, etudid),
            parameters={"etudid": etudid, "formsemestre_id": formsemestre_id},
        )

    sco_formsemestre_validation.formsemestre_validation_suppress_etud(
        context, formsemestre_id, etudid
    )
    return REQUEST.RESPONSE.redirect(
        scu.ScoURL()
        + "/Notes/formsemestre_validation_etud_form?formsemestre_id=%s&etudid=%s&head_message=Décision%%20supprimée"
        % (formsemestre_id, etudid)
    )


# ------------- PV de JURY et archives
sco_publish("/formsemestre_pvjury", sco_pvjury.formsemestre_pvjury, Permission.ScoView)
sco_publish(
    "/formsemestre_lettres_individuelles",
    sco_pvjury.formsemestre_lettres_individuelles,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_pvjury_pdf", sco_pvjury.formsemestre_pvjury_pdf, Permission.ScoView
)
sco_publish(
    "/feuille_preparation_jury",
    sco_prepajury.feuille_preparation_jury,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_archive", sco_archives.formsemestre_archive, Permission.ScoView
)
sco_publish(
    "/formsemestre_delete_archive",
    sco_archives.formsemestre_delete_archive,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_list_archives",
    sco_archives.formsemestre_list_archives,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_get_archived_file",
    sco_archives.formsemestre_get_archived_file,
    Permission.ScoView,
)
sco_publish("/view_apo_csv", sco_etape_apogee_view.view_apo_csv, Permission.ScoEditApo)
sco_publish(
    "/view_apo_csv_store",
    sco_etape_apogee_view.view_apo_csv_store,
    Permission.ScoEditApo,
)
sco_publish(
    "/view_apo_csv_download_and_store",
    sco_etape_apogee_view.view_apo_csv_download_and_store,
    Permission.ScoEditApo,
)
sco_publish(
    "/view_apo_csv_delete",
    sco_etape_apogee_view.view_apo_csv_delete,
    Permission.ScoEditApo,
)
sco_publish(
    "/view_scodoc_etuds", sco_etape_apogee_view.view_scodoc_etuds, Permission.ScoEditApo
)
sco_publish(
    "/view_apo_etuds", sco_etape_apogee_view.view_apo_etuds, Permission.ScoEditApo
)
sco_publish(
    "/apo_semset_maq_status",
    sco_etape_apogee_view.apo_semset_maq_status,
    Permission.ScoEditApo,
)
sco_publish(
    "/apo_csv_export_results",
    sco_etape_apogee_view.apo_csv_export_results,
    Permission.ScoEditApo,
)

# sco_semset
sco_publish("/semset_page", sco_semset.semset_page, Permission.ScoEditApo)
sco_publish("/do_semset_create", sco_semset.do_semset_create, Permission.ScoEditApo)
sco_publish("/do_semset_delete", sco_semset.do_semset_delete, Permission.ScoEditApo)
sco_publish(
    "/edit_semset_set_title", sco_semset.edit_semset_set_title, Permission.ScoEditApo
)
sco_publish("/do_semset_add_sem", sco_semset.do_semset_add_sem, Permission.ScoEditApo)
sco_publish(
    "/do_semset_remove_sem", sco_semset.do_semset_remove_sem, Permission.ScoEditApo
)

# sco_export_result
sco_publish(
    "/scodoc_table_results",
    sco_export_results.scodoc_table_results,
    Permission.ScoEditApo,
)

sco_publish(
    "/apo_compare_csv_form", sco_apogee_compare.apo_compare_csv_form, Permission.ScoView
)
sco_publish("/apo_compare_csv", sco_apogee_compare.apo_compare_csv, Permission.ScoView)

# ------------- INSCRIPTIONS: PASSAGE D'UN SEMESTRE A UN AUTRE
sco_publish(
    "/formsemestre_inscr_passage",
    sco_inscr_passage.formsemestre_inscr_passage,
    Permission.ScoEtudInscrit,
)
sco_publish(
    "/formsemestre_synchro_etuds",
    sco_synchro_etuds.formsemestre_synchro_etuds,
    Permission.ScoView,
)

# ------------- RAPPORTS STATISTIQUES
sco_publish(
    "/formsemestre_report_counts",
    sco_report.formsemestre_report_counts,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_suivi_cohorte",
    sco_report.formsemestre_suivi_cohorte,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_suivi_parcours",
    sco_report.formsemestre_suivi_parcours,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_etuds_lycees",
    sco_lycee.formsemestre_etuds_lycees,
    Permission.ScoView,
)
sco_publish(
    "/scodoc_table_etuds_lycees",
    sco_lycee.scodoc_table_etuds_lycees,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_graph_parcours",
    sco_report.formsemestre_graph_parcours,
    Permission.ScoView,
)
sco_publish(
    "/formsemestre_poursuite_report",
    sco_poursuite_dut.formsemestre_poursuite_report,
    Permission.ScoView,
)
sco_publish("/pe_view_sem_recap", pe_view.pe_view_sem_recap, Permission.ScoView)
sco_publish(
    "/report_debouche_date", sco_debouche.report_debouche_date, Permission.ScoView
)
sco_publish(
    "/formsemestre_estim_cost",
    sco_cost_formation.formsemestre_estim_cost,
    Permission.ScoView,
)

# --------------------------------------------------------------------
# DEBUG


@bp.route("/check_sem_integrity")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def check_sem_integrity(context, formsemestre_id, REQUEST):
    """Debug.
    Check that ue and module formations are consistents
    """
    sem = sco_formsemestre.get_formsemestre(context, formsemestre_id)

    modimpls = sco_moduleimpl.do_moduleimpl_list(
        context, formsemestre_id=formsemestre_id
    )
    bad_ue = []
    bad_sem = []
    for modimpl in modimpls:
        mod = context.do_module_list({"module_id": modimpl["module_id"]})[0]
        ue = context.do_ue_list({"ue_id": mod["ue_id"]})[0]
        if ue["formation_id"] != mod["formation_id"]:
            modimpl["mod"] = mod
            modimpl["ue"] = ue
            bad_ue.append(modimpl)
        if sem["formation_id"] != mod["formation_id"]:
            bad_sem.append(modimpl)
            modimpl["mod"] = mod

    return (
        html_sco_header.sco_header(context, REQUEST=REQUEST)
        + "<p>formation_id=%s" % sem["formation_id"]
        + "<h2>Inconsistent UE/MOD:</h2>"
        + "<br/>".join([str(x) for x in bad_ue])
        + "<h2>Inconsistent SEM/MOD:</h2>"
        + "<br/>".join([str(x) for x in bad_sem])
        + context.sco_footer(REQUEST)
    )


@bp.route("/check_form_integrity")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def check_form_integrity(context, formation_id, fix=False, REQUEST=None):
    "debug"
    log("check_form_integrity: formation_id=%s  fix=%s" % (formation_id, fix))
    ues = context.do_ue_list(args={"formation_id": formation_id})
    bad = []
    for ue in ues:
        mats = context.do_matiere_list(args={"ue_id": ue["ue_id"]})
        for mat in mats:
            mods = context.do_module_list({"matiere_id": mat["matiere_id"]})
            for mod in mods:
                if mod["ue_id"] != ue["ue_id"]:
                    if fix:
                        # fix mod.ue_id
                        log(
                            "fix: mod.ue_id = %s (was %s)" % (ue["ue_id"], mod["ue_id"])
                        )
                        mod["ue_id"] = ue["ue_id"]
                        context.do_module_edit(mod)
                    bad.append(mod)
                if mod["formation_id"] != formation_id:
                    bad.append(mod)
    if bad:
        txth = "<br/>".join([str(x) for x in bad])
        txt = "\n".join([str(x) for x in bad])
        log("check_form_integrity: formation_id=%s\ninconsistencies:" % formation_id)
        log(txt)
        # Notify by e-mail
        sendAlarm(context, "Notes: formation incoherente !", txt)
    else:
        txth = "OK"
        log("ok")
    return (
        html_sco_header.sco_header(context, REQUEST=REQUEST)
        + txth
        + context.sco_footer(REQUEST)
    )


@bp.route("/check_formsemestre_integrity")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def check_formsemestre_integrity(context, formsemestre_id, REQUEST=None):
    "debug"
    log("check_formsemestre_integrity: formsemestre_id=%s" % (formsemestre_id))
    # verifie que tous les moduleimpl d'un formsemestre
    # se réfèrent à un module dont l'UE appartient a la même formation
    # Ancien bug: les ue_id étaient mal copiés lors des création de versions
    # de formations
    diag = []

    Mlist = sco_moduleimpl.do_moduleimpl_withmodule_list(
        context, formsemestre_id=formsemestre_id
    )
    for mod in Mlist:
        if mod["module"]["ue_id"] != mod["matiere"]["ue_id"]:
            diag.append(
                "moduleimpl %s: module.ue_id=%s != matiere.ue_id=%s"
                % (
                    mod["moduleimpl_id"],
                    mod["module"]["ue_id"],
                    mod["matiere"]["ue_id"],
                )
            )
        if mod["ue"]["formation_id"] != mod["module"]["formation_id"]:
            diag.append(
                "moduleimpl %s: ue.formation_id=%s != mod.formation_id=%s"
                % (
                    mod["moduleimpl_id"],
                    mod["ue"]["formation_id"],
                    mod["module"]["formation_id"],
                )
            )
    if diag:
        sendAlarm(
            context,
            "Notes: formation incoherente dans semestre %s !" % formsemestre_id,
            "\n".join(diag),
        )
        log("check_formsemestre_integrity: formsemestre_id=%s" % formsemestre_id)
        log("inconsistencies:\n" + "\n".join(diag))
    else:
        diag = ["OK"]
        log("ok")
    return (
        html_sco_header.sco_header(context, REQUEST=REQUEST)
        + "<br/>".join(diag)
        + context.sco_footer(REQUEST)
    )


@bp.route("/check_integrity_all")
@permission_required(Permission.ScoView)
@scodoc7func(context)
def check_integrity_all(context, REQUEST=None):
    "debug: verifie tous les semestres et tt les formations"
    # formations
    for F in context.formation_list():
        context.check_form_integrity(F["formation_id"], REQUEST=REQUEST)
    # semestres
    for sem in sco_formsemestre.do_formsemestre_list(context):
        context.check_formsemestre_integrity(sem["formsemestre_id"], REQUEST=REQUEST)
    return (
        html_sco_header.sco_header(context, REQUEST=REQUEST)
        + "<p>empty page: see logs and mails</p>"
        + context.sco_footer(REQUEST)
    )


# --------------------------------------------------------------------
#     Support for legacy ScoDoc 7 API
# --------------------------------------------------------------------
sco_publish(
    "/do_moduleimpl_list", sco_moduleimpl.do_moduleimpl_list, Permission.ScoView
)
sco_publish(
    "/do_moduleimpl_withmodule_list",
    sco_moduleimpl.do_moduleimpl_withmodule_list,
    Permission.ScoView,
)