ezCOS 0.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. ezcos-0.0.1/PKG-INFO +132 -0
  2. ezcos-0.0.1/Readme.md +122 -0
  3. ezcos-0.0.1/ezCOS/__init__.py +0 -0
  4. ezcos-0.0.1/ezCOS/ezCOS.py +676 -0
  5. ezcos-0.0.1/ezCOS/utils/tools.py +219 -0
  6. ezcos-0.0.1/ezCOS.egg-info/PKG-INFO +132 -0
  7. ezcos-0.0.1/ezCOS.egg-info/SOURCES.txt +10 -0
  8. ezcos-0.0.1/ezCOS.egg-info/dependency_links.txt +1 -0
  9. ezcos-0.0.1/ezCOS.egg-info/entry_points.txt +2 -0
  10. ezcos-0.0.1/ezCOS.egg-info/top_level.txt +2 -0
  11. ezcos-0.0.1/pyproject.toml +28 -0
  12. ezcos-0.0.1/setup.cfg +4 -0
ezcos-0.0.1/PKG-INFO ADDED
@@ -0,0 +1,132 @@
1
+ Metadata-Version: 2.4
2
+ Name: ezCOS
3
+ Version: 0.0.1
4
+ Summary: Outil de simplification de la gestion des COS.
5
+ Author-email: Géry Casiez <gery.casiez@univ-lille.fr>
6
+ Project-URL: Homepage, https://github.com/casiez/ezCOS
7
+ Classifier: Programming Language :: Python :: 3
8
+ Requires-Python: >=3.0
9
+ Description-Content-Type: text/markdown
10
+
11
+ # ezCOS
12
+
13
+ [![PyPI Version](https://img.shields.io/pypi/v/ezCOS)](https://pypi.org/project/ezCOS/)
14
+ [![Downloads](https://static.pepy.tech/badge/ezCOS)](https://pepy.tech/project/ezCOS)
15
+
16
+ Outil pour faciliter la gestion des comités de sélection (COS) dans les établissements d'enseignement supérieur. Il permet de télécharger les dossiers des candidats depuis Odyssee, de les décompresser et de remplir automatiquement un fichier Excel avec les informations pertinentes sur les candidats... (voir ci-dessous)
17
+
18
+ ezCOS s'appuie sur [odysseeapi](https://github.com/casiez/OdysseeAPI/) pour interagir avec la plateforme Odyssee.
19
+
20
+ ## Installation
21
+
22
+ ```
23
+ pip install ezCOS -U
24
+ ```
25
+
26
+ Créer un répertoire de travail pour le comité de sélection, puis y copier le fichier `config.ini`, les modèles de fichiers Excel et Word depuis le répertoire `templates` dans un répertoire `templates`. Copier également le contenu du répertoire `carbone`dans un répertoire du même nom.
27
+
28
+ Modifier le fichier `config.ini` paramétrer Odyssee et modifier des chemins.
29
+
30
+ ## Etapes
31
+
32
+ 1. Télécharger les dossiers des candidats depuis Odyssee :
33
+ ```
34
+ ezCOS -auth -downloadApplications
35
+ ```
36
+ L'option `-auth` permet de s'authentifier auprès d'Odyssee pour accéder aux dossiers des candidats. L'option `-downloadApplications` lance le processus de téléchargement des dossiers. Les archives zip des dossiers sont téléchargés dans le répertoire `dossiers_candidats`.
37
+
38
+ 1. Décompresser les dossiers des candidats :
39
+ ```
40
+ ezCOS -unzipApplications
41
+ ```
42
+ L'option `-unzipApplications` lance le processus de décompression des archives zip téléchargées. Les dossiers décompressés se trouvent dans le répertoire `dossiers_candidats`.
43
+
44
+ 1. Remplir automatiquement un fichier Excel avec les informations sur les candidats :
45
+ ```
46
+ ezCOS -auth -populateXLSX
47
+ ```
48
+ L'option `-populateXLSX` lance le processus de remplissage du fichier Excel avec les informations extraites des dossiers des candidats. Le fichier `templates/comite.xlsx` est utilisé comme modèle pour créer le fichier `comitePopulated.xlsx` qui contient les informations des candidats et des membres du comité.
49
+
50
+ A cette étape, il faut renommer le fichier `comitePopulated.xlsx` en utilisant celui défini dans la section [FILES] du fichier `config.ini` (ex: `comite.xlsx`).
51
+
52
+ Dans la feuille "Candidats" du fichier Excel, affecter les rapporteurs à chaque candidat en utilisant les listes déroulantes dans la colonne "Rapporteur1" et "Rapporteur2". Les membres du comité sont listés dans l'onglet "MembresComite" du fichier Excel.
53
+
54
+ Dans l'onglet "MembresComite", compléter la section et le statut de chaque membre du comité (Interne / Externe).
55
+
56
+ 1. Générer les avis d'impartialité pour les membres du comité :
57
+ ```
58
+ ezCOS -impartialite
59
+ ```
60
+ L'option `-impartialite` lance le processus de génération des déclarations d'impartialité pour les membres du comité, à partir du modèle `templates/Impartialite.xlsx`. Les décalrations sont sauvegardées dans le répertoire `impartialite`.
61
+
62
+ 1. Génération des modèles de rapports pré-complétés pour les rapporteurs :
63
+ ```
64
+ ezCOS -r1
65
+ ```
66
+ L'option `-r1` lance le processus de génération des modèles de rapports pré-complétés pour les rapporteurs, avec les infos des candidats et à partir du modèle `templates/NOMCANDIDATprenom-NOMRAPPORTEUR.docx`. Les rapports sont générés au format DOCX et sauvegardés dans le répertoire `rapportsMembresReunion1`.
67
+
68
+ 1. Affectation des rapporteurs sur Odyssee :
69
+ ````
70
+ ezCOS -auth -assignOdyssee
71
+ ```
72
+ L'option `-assignOdyssee` lance le processus d'affectation des rapporteurs sur Odyssee, en utilisant les informations du fichier Excel. Les rapporteurs sont affectés aux candidats sur Odyssee en fonction des choix faits dans les colonnes "Rapporteur1" et "Rapporteur2" du fichier Excel.
73
+
74
+ Vérifier le résultat de l'affectation des rapporteurs sur Odyssee.
75
+
76
+ 1. Génération du PV de répartition des rapporteurs :
77
+ ```
78
+ ezCOS -pvRepart
79
+ ```
80
+ L'option `-pvRepart` lance le processus de génération du PV de répartition des rapporteurs, à partir du modèle `templates/PVrepartition.docx`. Le PV est sauvegardé sous le nom `PVrepartitionRapporteurs.docx`.
81
+
82
+ 1. Génération des attestations de participation en visio pour les membres du comité :
83
+ ```
84
+ ezCOS -attestationsVisio
85
+ ```
86
+ L'option `-attestationsVisio` lance le processus de génération des attestations de participation en visio pour les membres du comité, à partir du modèle `templates/Attestation_visioconference_membre.docx`. Les attestations sont générées au format DOCX et sauvegardées dans le répertoire `attestationsVisio`.
87
+
88
+ 1. Téléchargement des rapports des rapporteurs depuis Odyssee :
89
+ ```
90
+ ezCOS -auth -reports
91
+ ```
92
+ L'option `-reports` lance le processus de téléchargement des rapports des rapporteurs depuis Odyssee. Les rapports sont téléchargés au format PDF et sauvegardés dans le répertoire `rapportsOdyssee`.
93
+
94
+ 1. Extraction des avis des rapports des rapporteurs et mise à jour du fichier Excel :
95
+ ```
96
+ ezCOS -reports2xlsx
97
+ ```
98
+ L'option `-reports2xlsx` lance le processus d'extraction des avis des rapports des rapporteurs et de mise à jour du fichier Excel. Les avis sont extraits des rapports PDF téléchargés à l'étape précédente, puis reportés dans les colonnes "AvisRapp1" et "AvisRapp2" du fichier Excel. Par précaution, le script crée une copie du fichier Excel avant de le modifier, avec le suffixe "-2". Les avis sont ensuite à copier dans le fichier Excel original.
99
+
100
+ 1. Avis par candidat et vote suite à la première réunion du comité de sélection :
101
+ ```
102
+ ezCOS -auth -avisPremiereReunion
103
+ ```
104
+ L'option `-avisPremiereReunion` utilise la colonne "AvisAudition" du fichier Excel pour générer un avis global. Les lignes de cette colonne doivent être remplies avec des codes (ex: "A", "B", "C", "D") séparés par des virgules, et définis dans la feuille AvisDetailles du fichier Excel. Les candidats auditionnés doivent avoir au moinns un avis "A" dans cette colonne.
105
+
106
+ Les résultats du vote sont dans les colonnes correspondantes du fichier Excel.
107
+
108
+ Vérifier le résultat de la mise à jour des avis et des votes sur Odyssee.
109
+
110
+ 1. Génération des convocations pour les candidats auditionnés :
111
+ ```
112
+ ezCOS -convocCandidats
113
+ ```
114
+ L'option `-convocCandidats` lance le processus de génération des convocations pour les candidats auditionnés, à partir du modèle `templates/Convocation_candidats.docx`. Les convocations sont générées au format DOCX et sauvegardées dans le répertoire `convocationsAuditions`.
115
+
116
+ 1. Conversion au format PDF des convocations pour les candidats auditionnés :
117
+ ```
118
+ ezCOS -convocCandidatsPDF
119
+ ```
120
+ L'option `-convocCandidatsPDF` lance le processus de conversion au format PDF des convocations pour les candidats auditionnés, à partir des fichiers DOCX générés à l'étape précédente. Les convocations au format PDF sont sauvegardées dans le répertoire `convocationsAuditions`.
121
+
122
+ 1. Envoi des convocations aux candidats auditionnés par email :
123
+ ```
124
+ ezCOS -envoimailauditionnes
125
+ ```
126
+ L'option `-envoimailauditionnes` lance le processus d'envoi des convocations aux candidats auditionnés par email, en utilisant les adresses email extraites des dossiers des candidats. Les convocations au format PDF sont envoyées en pièce jointe.
127
+
128
+ Le template `templates/mailCandidatsAuditionnes.txt` est utilisé pour le corps du mail.
129
+
130
+ Les mails ne sont pas envoyés directement, mais préparés dans le client de messagerie Thunderbird. Vérifier les mails préparés dans Thunderbird avant de les envoyer.
131
+
132
+ Vérifier que vous avez bien configuré `convocations-candidats` dans le fichier de config.ini (mettre le chemin absolu), ainsi que le chemin vers thunderbird (`thunderbird-bin`).
ezcos-0.0.1/Readme.md ADDED
@@ -0,0 +1,122 @@
1
+ # ezCOS
2
+
3
+ [![PyPI Version](https://img.shields.io/pypi/v/ezCOS)](https://pypi.org/project/ezCOS/)
4
+ [![Downloads](https://static.pepy.tech/badge/ezCOS)](https://pepy.tech/project/ezCOS)
5
+
6
+ Outil pour faciliter la gestion des comités de sélection (COS) dans les établissements d'enseignement supérieur. Il permet de télécharger les dossiers des candidats depuis Odyssee, de les décompresser et de remplir automatiquement un fichier Excel avec les informations pertinentes sur les candidats... (voir ci-dessous)
7
+
8
+ ezCOS s'appuie sur [odysseeapi](https://github.com/casiez/OdysseeAPI/) pour interagir avec la plateforme Odyssee.
9
+
10
+ ## Installation
11
+
12
+ ```
13
+ pip install ezCOS -U
14
+ ```
15
+
16
+ Créer un répertoire de travail pour le comité de sélection, puis y copier le fichier `config.ini`, les modèles de fichiers Excel et Word depuis le répertoire `templates` dans un répertoire `templates`. Copier également le contenu du répertoire `carbone`dans un répertoire du même nom.
17
+
18
+ Modifier le fichier `config.ini` paramétrer Odyssee et modifier des chemins.
19
+
20
+ ## Etapes
21
+
22
+ 1. Télécharger les dossiers des candidats depuis Odyssee :
23
+ ```
24
+ ezCOS -auth -downloadApplications
25
+ ```
26
+ L'option `-auth` permet de s'authentifier auprès d'Odyssee pour accéder aux dossiers des candidats. L'option `-downloadApplications` lance le processus de téléchargement des dossiers. Les archives zip des dossiers sont téléchargés dans le répertoire `dossiers_candidats`.
27
+
28
+ 1. Décompresser les dossiers des candidats :
29
+ ```
30
+ ezCOS -unzipApplications
31
+ ```
32
+ L'option `-unzipApplications` lance le processus de décompression des archives zip téléchargées. Les dossiers décompressés se trouvent dans le répertoire `dossiers_candidats`.
33
+
34
+ 1. Remplir automatiquement un fichier Excel avec les informations sur les candidats :
35
+ ```
36
+ ezCOS -auth -populateXLSX
37
+ ```
38
+ L'option `-populateXLSX` lance le processus de remplissage du fichier Excel avec les informations extraites des dossiers des candidats. Le fichier `templates/comite.xlsx` est utilisé comme modèle pour créer le fichier `comitePopulated.xlsx` qui contient les informations des candidats et des membres du comité.
39
+
40
+ A cette étape, il faut renommer le fichier `comitePopulated.xlsx` en utilisant celui défini dans la section [FILES] du fichier `config.ini` (ex: `comite.xlsx`).
41
+
42
+ Dans la feuille "Candidats" du fichier Excel, affecter les rapporteurs à chaque candidat en utilisant les listes déroulantes dans la colonne "Rapporteur1" et "Rapporteur2". Les membres du comité sont listés dans l'onglet "MembresComite" du fichier Excel.
43
+
44
+ Dans l'onglet "MembresComite", compléter la section et le statut de chaque membre du comité (Interne / Externe).
45
+
46
+ 1. Générer les avis d'impartialité pour les membres du comité :
47
+ ```
48
+ ezCOS -impartialite
49
+ ```
50
+ L'option `-impartialite` lance le processus de génération des déclarations d'impartialité pour les membres du comité, à partir du modèle `templates/Impartialite.xlsx`. Les décalrations sont sauvegardées dans le répertoire `impartialite`.
51
+
52
+ 1. Génération des modèles de rapports pré-complétés pour les rapporteurs :
53
+ ```
54
+ ezCOS -r1
55
+ ```
56
+ L'option `-r1` lance le processus de génération des modèles de rapports pré-complétés pour les rapporteurs, avec les infos des candidats et à partir du modèle `templates/NOMCANDIDATprenom-NOMRAPPORTEUR.docx`. Les rapports sont générés au format DOCX et sauvegardés dans le répertoire `rapportsMembresReunion1`.
57
+
58
+ 1. Affectation des rapporteurs sur Odyssee :
59
+ ````
60
+ ezCOS -auth -assignOdyssee
61
+ ```
62
+ L'option `-assignOdyssee` lance le processus d'affectation des rapporteurs sur Odyssee, en utilisant les informations du fichier Excel. Les rapporteurs sont affectés aux candidats sur Odyssee en fonction des choix faits dans les colonnes "Rapporteur1" et "Rapporteur2" du fichier Excel.
63
+
64
+ Vérifier le résultat de l'affectation des rapporteurs sur Odyssee.
65
+
66
+ 1. Génération du PV de répartition des rapporteurs :
67
+ ```
68
+ ezCOS -pvRepart
69
+ ```
70
+ L'option `-pvRepart` lance le processus de génération du PV de répartition des rapporteurs, à partir du modèle `templates/PVrepartition.docx`. Le PV est sauvegardé sous le nom `PVrepartitionRapporteurs.docx`.
71
+
72
+ 1. Génération des attestations de participation en visio pour les membres du comité :
73
+ ```
74
+ ezCOS -attestationsVisio
75
+ ```
76
+ L'option `-attestationsVisio` lance le processus de génération des attestations de participation en visio pour les membres du comité, à partir du modèle `templates/Attestation_visioconference_membre.docx`. Les attestations sont générées au format DOCX et sauvegardées dans le répertoire `attestationsVisio`.
77
+
78
+ 1. Téléchargement des rapports des rapporteurs depuis Odyssee :
79
+ ```
80
+ ezCOS -auth -reports
81
+ ```
82
+ L'option `-reports` lance le processus de téléchargement des rapports des rapporteurs depuis Odyssee. Les rapports sont téléchargés au format PDF et sauvegardés dans le répertoire `rapportsOdyssee`.
83
+
84
+ 1. Extraction des avis des rapports des rapporteurs et mise à jour du fichier Excel :
85
+ ```
86
+ ezCOS -reports2xlsx
87
+ ```
88
+ L'option `-reports2xlsx` lance le processus d'extraction des avis des rapports des rapporteurs et de mise à jour du fichier Excel. Les avis sont extraits des rapports PDF téléchargés à l'étape précédente, puis reportés dans les colonnes "AvisRapp1" et "AvisRapp2" du fichier Excel. Par précaution, le script crée une copie du fichier Excel avant de le modifier, avec le suffixe "-2". Les avis sont ensuite à copier dans le fichier Excel original.
89
+
90
+ 1. Avis par candidat et vote suite à la première réunion du comité de sélection :
91
+ ```
92
+ ezCOS -auth -avisPremiereReunion
93
+ ```
94
+ L'option `-avisPremiereReunion` utilise la colonne "AvisAudition" du fichier Excel pour générer un avis global. Les lignes de cette colonne doivent être remplies avec des codes (ex: "A", "B", "C", "D") séparés par des virgules, et définis dans la feuille AvisDetailles du fichier Excel. Les candidats auditionnés doivent avoir au moinns un avis "A" dans cette colonne.
95
+
96
+ Les résultats du vote sont dans les colonnes correspondantes du fichier Excel.
97
+
98
+ Vérifier le résultat de la mise à jour des avis et des votes sur Odyssee.
99
+
100
+ 1. Génération des convocations pour les candidats auditionnés :
101
+ ```
102
+ ezCOS -convocCandidats
103
+ ```
104
+ L'option `-convocCandidats` lance le processus de génération des convocations pour les candidats auditionnés, à partir du modèle `templates/Convocation_candidats.docx`. Les convocations sont générées au format DOCX et sauvegardées dans le répertoire `convocationsAuditions`.
105
+
106
+ 1. Conversion au format PDF des convocations pour les candidats auditionnés :
107
+ ```
108
+ ezCOS -convocCandidatsPDF
109
+ ```
110
+ L'option `-convocCandidatsPDF` lance le processus de conversion au format PDF des convocations pour les candidats auditionnés, à partir des fichiers DOCX générés à l'étape précédente. Les convocations au format PDF sont sauvegardées dans le répertoire `convocationsAuditions`.
111
+
112
+ 1. Envoi des convocations aux candidats auditionnés par email :
113
+ ```
114
+ ezCOS -envoimailauditionnes
115
+ ```
116
+ L'option `-envoimailauditionnes` lance le processus d'envoi des convocations aux candidats auditionnés par email, en utilisant les adresses email extraites des dossiers des candidats. Les convocations au format PDF sont envoyées en pièce jointe.
117
+
118
+ Le template `templates/mailCandidatsAuditionnes.txt` est utilisé pour le corps du mail.
119
+
120
+ Les mails ne sont pas envoyés directement, mais préparés dans le client de messagerie Thunderbird. Vérifier les mails préparés dans Thunderbird avant de les envoyer.
121
+
122
+ Vérifier que vous avez bien configuré `convocations-candidats` dans le fichier de config.ini (mettre le chemin absolu), ainsi que le chemin vers thunderbird (`thunderbird-bin`).
ezcos-0.0.1/ezCOS/__init__.py ADDED
File without changes