Informations
Objectif et Description du projet
Ce projet a pour objectif d’extraire les données des fichiers des emplois du temps des 3 formations du département : BUT1, BUT2, BUT3 que vous aurez préalablement extraits du logiciel ADE de l’Université afin de déterminer pour chaque salle des indicateurs d’occupation.
Données affichées
- Voici les données qui seront affichées :
heures d’utilisation
heures d’utilisation moyenne par semaine
heures d’utilisation moyenne par jour
taux d’occupation en pourcentage
Utilisation du programme
Avant de commencer l’installation, vérifier que Python 3 minimum est installé sur le PC, pour vérifier, ouvrir un terminal et taper la commande python sur Windows ou python3 sur Linux, et que la connexion à Internet fonctionne correctement
Téléchargez le fichier ZIP du projet en cliquant sur le lien suivant :
Décompressez le fichier ZIP que vous venez de télécharger :
Sur Windows : Faites un clic droit sur le fichier ZIP puis sélectionnez « Extraire tout… »
Sur Mac : Double-cliquez simplement sur le fichier ZIP
Sur Linux : Utilisez la commande unzip ou utilisez l’extracteur d’archives graphique
Ouvrez un terminal et placez-vous dans le répertoire du projet :
cd icalendar-statistiques-occupation-des-salles
Installer les modules requis à l’aide de la commande suivante
pip install -r requirements.txt
Lancer ensuite le programme en utilisant la commande suivante.
Sous Windows :
python occupation/occupation.py --input-file fichier1.ics fichier2.ics fichier3.ics --output-dir html/
Sous Linux :
python3 occupation/occupation.py --input-file fichier1.ics fichier2.ics fichier3.ics --output-dir html/
Note : remplacer les noms des fichiers
Les données sont accessibles ensuite dans le fichier html/index.html de l’arborescence.
Le projet est maintenant installé ! Les données d’utilisation sont maintenant affichées sur la page HTML.
Structure du Projet / Arborescence
Vous trouverez dans le projet la structure suivante :
- `occupation.py`: Script principal pour lancer le traitement.
- `module_occupation.py`: Module contenant les fonctions de traitement des fichiers iCalendar.
- `test_occupation.py`: Fichier de tests unitaires pour les fonctions du module.
- `tests/`: Répertoire contenant les scripts de test unitaire.
- `html/` : Répertoire contenant le fichier HTML généré par le script, ainsi que la feuille de style CSS
- `data/` : Emplacement des fichiers calendriers
- `doc-projet/` : Notre diagramme de cas d'utilisation fait avec Umbrelo
Documentation
Dans le dossier docs une documentation générée avec le logiciel Sphinx sera disponible afin de documenter le projet avec également un rappel du cahier des charges du projet
Prérequis
Python 3 minimum
Accès Internet