Metadata-Version: 2.1
Name: gpulr
Version: 1.9
Summary: Module pour gérer les connexions et récupérer des informations depuis le site GPU
Home-page: https://github.com/Paulin17/GPU_Python_Module
Author: DOYON Paulin
Author-email: contact@paulinodoyn.fr
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: beautifulsoup4

# GPU Module Repository



## Description

Ce repository contient le module `GPU` conçu pour gérer les connexions et récupérer des informations depuis le site GPU. Il inclut des fonctions pour se connecter, obtenir des informations sur les étudiants, lister les semaines disponibles et télécharger les données d'une semaine spécifique. Il contient également des classes pour représenter des événements et des étudiants, ainsi qu'un agenda pour gérer ces événements.



## Installation

Pour utiliser ce module, assurez-vous que tous les fichiers nécessaires sont dans le même répertoire et que vous avez configuré les variables d'environnement si nécessaire.



### Pré-requis

- Python 3.x

- Modules `re`,`requests`, `BeautifulSoup`, et `datetime`



## Contenu du Module



### Fichiers et Fonctions Principales



- **fonctions.py**

  - `get_connection(login: int, password: str='123') -> requests.Session`: Connexion à GPU via une requête POST et retourne la session avec les cookies.

  - `get_infos(session: requests.Session) -> tuple[str, int, int]`: Récupère les informations de l'étudiant en utilisant la session active.

  - `list_semaine(session: requests.Session) -> list[int]`: Récupère la liste des semaines disponibles à partir de la page d'agenda étudiant.

  - `get_Semaine(num_etu: int, week: int, session: requests.Session, directory: str) -> None`: Télécharge les données d'une semaine donnée et les enregistre dans un fichier VCS.

  - `get_Semaine_Pdf(num_etu: int, week: int, year: int, session: requests.Session, directory: str) -> None`:Télécharge les données d'une semaine donnée et les enregistre dans un fichier PDF.





- **class_perso.py**

  - `Event`: Classe représentant un événement iCalendar (RFC 5545).

    - `__init__(self, sequence: int, uid: str, dtstamp: datetime.datetime, description: str, summary: str, location: str, dtstart: datetime.datetime, dtend: datetime.datetime, priority: int, event_class: str) -> None`: Initialise un événement avec tous ses attributs.

    - `__str__(self) -> str`: Retourne une chaîne lisible représentant l'événement.

    - `format_datas(self) -> None`: Restructure les données de l'événement.

    - `ajouter_heure_si_hiver(self) -> None`: Rajoute une heure au début et à la fin d'un événement si celui-ci est dans l'heure d'hiver.

    - `parse_datetime(ical_date: str) -> datetime.datetime`: Convertit une chaîne de date au format iCalendar en objet datetime.

    - `from_ical(cls, ical_data: dict[str, str]) -> 'Event'`: Crée une instance d'Event à partir des données iCalendar.

  - `Student`: Classe représentant un étudiant.

    - `__init__(self, num: int, nom: Optional[str] = None, td: Optional[int] = None, tp: Optional[int] = None) -> None`: Initialise un nouvel étudiant avec un numéro, et éventuellement un nom, un groupe de TD et un groupe de TP.

    - `__repr__(self) -> str`: Retourne une représentation de l'étudiant.

    - `_completer_infos(self) -> None`: Complète les informations de l'étudiant en utilisant les fonctions get_connection et get_infos.

  - `Agenda`: Classe représentant un agenda pour un étudiant.

    - `__init__(self, student: Student) -> None`: Initialise un nouvel agenda pour un étudiant.

    - `__len__(self) -> int`: Renvoie le nombre d'événements dans l'agenda.

    - `ajouter_event(self, event: Event) -> None`: Ajoute un événement à l'agenda.

    - `ajouter_events(self, events: list[Event]) -> None`: Ajoute plusieurs événements à l'agenda.

    - `__repr__(self) -> str`: Retourne une représentation sous forme de chaîne de l'agenda.

    - `restructuration(self) -> None`: Restructure les données des événements.

    - `export(self, filename: str) -> None`: Exporte l'agenda dans un fichier iCalendar.



## Utilisation



### Exemple d'Utilisation



```python

import gpulr as GPU

import os,sys



def main(etudiant: GPU.Student) -> None:

    # Définition des paramètres

    num_etu = etudiant.num

    etu_directory = str(num_etu)

    temp_dir_week = f"{etu_directory}/week_temp"



    print("Démarrage du script")

    # Création des répertoires

    os.makedirs(etu_directory, exist_ok=True)

    os.makedirs(temp_dir_week, exist_ok=True)



    try:

        print('Initialisation de la connexion à GPU')

        user_session = GPU.get_connection(num_etu)

    except ConnectionError:

        print('ConnectionError: Échec de la connexion')

        return



    print('Connecté avec succès')



    semaines_dispo = GPU.list_semaine(user_session)

    print(f'Liste des semaines disponibles : {semaines_dispo}')



    for numero in semaines_dispo:

        print(f'Téléchargement de la semaine {numero}')

        GPU.get_Semaine(num_etu, numero, user_session, temp_dir_week)



    agenda = GPU.Agenda(etudiant)

    for file in os.listdir(temp_dir_week):

        file_path = os.path.join(temp_dir_week, file)

        with open(file_path, 'r') as f:

            agenda.ajouter_events(GPU.parse_multiple_events(f.readlines()))

    

    

    print("Restructuration des événements")

    agenda.restructuration()



    print(f"Export de l'agenda dans le fichier {etu_directory}/{num_etu}.ics")

    agenda.export(f"{etu_directory}/{num_etu}.ics")



if __name__ == "__main__":

    # Passer le numéro étudiant comme argument

    if len(sys.argv) != 2:

        print("Usage: python script.py <num_etu>")

        sys.exit(1)

    main(GPU.Student(int(sys.argv[1])))

```



