esprit-py 0.3.3__py3-none-any.whl → 0.3.4__py3-none-any.whl

esprit/absence.py

@@ -1,4 +1,3 @@
-import requests
 from bs4 import BeautifulSoup
 
 

esprit/auth.py

@@ -114,6 +114,7 @@ class Auth:
                   Login failed!
                   -------------
                   ''')
+            return None
 
 
 # Code for debugging login

esprit/credit.py

@@ -1,4 +1,3 @@
-import requests
 from bs4 import BeautifulSoup
 
 

esprit/esprit.py

@@ -4,6 +4,8 @@ from .grade import Grade
 from .absence import Absence
 from .time_schedule import TimeSchedule
 from .credit import Credit
+from .utils import Utils
+# from .exceptions import EspritException #TODO
 
 
 class Esprit:
@@ -14,6 +16,7 @@ class Esprit:
         self.absence_scrape = Absence(self.session)
         self.time_schedule_scrape = TimeSchedule(self.session)
         self.credit = Credit(self.session)
+        self.utils = Utils(self.session)
 
     def login(self, username, password):
         cookies = self.auth.login(username, password)
@@ -43,3 +46,9 @@ class Esprit:
 
     def get_credits(self):
         return self.credit.get_credits()
+
+    def get_student_name(self):
+        return self.utils.get_student_name()
+
+    def get_student_class(self):
+        return self.utils.get_student_class()

esprit/grade.py

@@ -1,4 +1,3 @@
-import requests
 from bs4 import BeautifulSoup
 import pandas as pd
 import numpy as np
@@ -21,6 +20,8 @@ class Grade:
     -------
     get_grades():
         Returns a list of grades for the student.
+    calculate_average(grades):
+        Calculate the average grade based on the given grades.
     """
 
     def __init__(self, session):
@@ -54,6 +55,17 @@ class Grade:
         return grades
 
     def calculate_average(self, grades):
+        """
+        Calculate the average grade based on the given grades.
+
+        Parameters
+        ----------
+        grades (list): A list of lists representing the grades. The first list should contain the column names.
+
+        Returns
+        -------
+        float: The calculated average grade.
+        """
         # Convert the list of lists to a DataFrame
         df = pd.DataFrame(grades[1:], columns=grades[0])
 

esprit/time_schedule.py

@@ -1,4 +1,3 @@
-import requests
 from bs4 import BeautifulSoup
 from datetime import datetime
 import re

esprit/utils.py

@@ -0,0 +1,57 @@
+from bs4 import BeautifulSoup
+
+
+class Utils:
+    """
+    A utility class for interacting with the ESPRIT website.
+    """
+
+    def __init__(self, session):
+        self.url = "https://esprit-tn.com/ESPOnline/Etudiants/Accueil.aspx"
+        self.session = session
+
+    def get_student_name(self):
+        """
+        Get the name of the student from the ESPRIT website.
+
+        Returns:
+            The name of the student, or None if the name could not be found.
+        """
+        response = self.session.get(self.url)
+        soup = BeautifulSoup(response.text, 'html.parser')
+
+        # Check if the <p> tag with the class "lead" and the string "Vous pouvez consulter dans cet espace :" exists
+        p_tag = soup.find('p', class_='lead',
+                          string='Vous pouvez consulter dans cet espace :')
+        if p_tag is None:
+            print("The page does not contain the expected text.")
+            return None
+
+        span = soup.find('span', {'id': 'Label2', 'class': 'h4 text-info'})
+        if span is not None:
+            return span.text.strip()
+        else:
+            return None
+
+    def get_student_class(self):
+        """
+        Get the class of the student from the ESPRIT website.
+
+        Returns:
+            The class of the student, or None if the class could not be found.
+        """
+        response = self.session.get(self.url)
+        soup = BeautifulSoup(response.text, 'html.parser')
+
+        # Check if the <p> tag with the class "lead" and the string "Vous pouvez consulter dans cet espace :" exists
+        p_tag = soup.find('p', class_='lead',
+                          string='Vous pouvez consulter dans cet espace :')
+        if p_tag is None:
+            print("The page does not contain the expected text.")
+            return None
+
+        span = soup.find('span', {'id': 'Label3'})
+        if span is not None:
+            return span.text.strip()
+        else:
+            return None

{esprit_py-0.3.3.dist-info → esprit_py-0.3.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: esprit-py
-Version: 0.3.3
+Version: 0.3.4
 Summary: A Python library for interacting with data from esprit-tn.com
 Home-page: https://github.com/TheLime1/esprit.py
 Author: Lime1 (Aymen Hmani)
@@ -23,51 +23,180 @@ Requires-Dist: pandas
 
 # <img src="https://esprit.tn/favicon.ico" width="28px" /> esprit-py
 
+
+
 > [!NOTE]
+
 > Please note that this library is not an official API provided by Esprit and is intended for educational and personal use only.
 
+
+
 ## Features
 
+
+
 - Get your exact timetable pdf *not 300 pages pdf*
+
 - Get your grades
+
 - Get your absences
+
 - Get your credits
 
+- Calculate your total semester average
+
+
+
 ## Installation
 
+
+
 ```bash
+
 pip install esprit-py
+
 ```
 
+
+
 download `chromedriver` from [here](https://googlechromelabs.github.io/chrome-for-testing/#stable)
 
-## Example
+
+
+## Examples
+
+
+
+get your total avreage:
+
+
+
+```python
+
+from esprit import Esprit
+
+
+
+# Replace with your actual ID and password
+
+id = 'ID'
+
+password = 'PASSWORD'
+
+
+
+grades = None
+
+
+
+# Keep trying to get grades until it is successful cuz esprit use garabage servers
+
+while grades is None:
+
+    try:
+
+        # Create an Esprit object
+
+        esprit = Esprit(
+
+            driver_path="C:/path/to/chromedriver.exe")
+
+
+
+        # Attempt to log in
+
+        esprit.login(id, password)
+
+
+
+        # Get grades
+
+        grades = esprit.get_grades()
+
+
+
+    except Exception as e:
+
+        print(f"An error occurred: {e}. Retrying...")
+
+
+
+if grades is not None:
+
+    for grade in grades:
+
+        print(grade)
+
+else:
+
+    print("Failed to get grades.")
+
+
+
+esprit.calculate_average(grades)
+
+
+
+```
+
+
+
+get a list of all your absences;
+
+
 
 ```python
+
 from esprit import Esprit
 
+
+
 # Create an Esprit object
+
 esprit = Esprit(
+
     driver_path="C:/path/to/chromedriver.exe",)
 
+
+
 # Replace with your actual ID and password
+
 id = 'ID'
+
 password = 'PASSWORD'
 
+
+
 # Attempt to log in
+
 if esprit.login(id, password):
+
     print("Login successful.")
+
 else:
+
     print("Login failed.")
 
+
+
 # Get absences
+
 absences = esprit.get_absences()
+
 if absences is not None:
+
     for absence in absences:
+
         print(absence)
+
 else:
+
     print("Failed to get absences.")
 
+
+
 ```
 
+
+
 More examples can be found in the [examples folder](examples)

esprit_py-0.3.4.dist-info/RECORD

@@ -0,0 +1,13 @@
+esprit/__init__.py,sha256=PnahGRQ5xmA26XMFaj9ImLty9OEmYwnBqLanvGXZwwU,28
+esprit/absence.py,sha256=1CE7FCnWUr9omNXkgFH4Q3Vq5FkonjAEOmAOarXoCqU,1649
+esprit/auth.py,sha256=rT46FuRfeM3cCit5ltsLvXxN6rOUY7XEagGcJMXPVlI,4059
+esprit/credit.py,sha256=G4UPVaJEFiucF4dbmwLcCl_OUD419UstPRJ3GeGj5nI,1730
+esprit/esprit.py,sha256=kj46pKuyuJZuCKVxwBehKZVKycKauGYSKpMDmo3n-lw,1961
+esprit/grade.py,sha256=Wt5rjcqHAaG2gQ5DaqaMUMkP7ImMhZhQqoJTxTZkXhk,3504
+esprit/time_schedule.py,sha256=APash3wNe09kdwJDl3B1Du1WH71h6j3TAirVGoWndCc,6473
+esprit/utils.py,sha256=evATWiuwSp80IvKV-jkjLX8kNW6tEYR4Iakr-HQu9gs,2009
+esprit_py-0.3.4.dist-info/LICENSE,sha256=DOcn7qpE6TsUEcakIsDDKm757jx5YlQ8fXDiED21P_w,1089
+esprit_py-0.3.4.dist-info/METADATA,sha256=cYU7wA9DFyaYz8-I8R9vkdM_vIP2xF3e8QXxCdhw0Ao,2863
+esprit_py-0.3.4.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
+esprit_py-0.3.4.dist-info/top_level.txt,sha256=aS9besFTZ4EYTsoBJVf3GaMjQtJLgLaK7WqAxSvGVdQ,7
+esprit_py-0.3.4.dist-info/RECORD,,

esprit_py-0.3.3.dist-info/RECORD

@@ -1,12 +0,0 @@
-esprit/__init__.py,sha256=PnahGRQ5xmA26XMFaj9ImLty9OEmYwnBqLanvGXZwwU,28
-esprit/absence.py,sha256=qOFyK0QmSaWYrz_2RlDFcCom-m6QZLJAzG1dBj3YkbI,1666
-esprit/auth.py,sha256=-jkquqEGZ8I7K61T4QsXHLfDTIwdhbirOrtEmGysbqQ,4034
-esprit/credit.py,sha256=iKy_lTR_iLAkpRkP92l2gAUi4Dh6JvLidxGhuM9YJ68,1747
-esprit/esprit.py,sha256=xjXqkXIGgV5J0DGSwBIM-ihj7123SH7DASzHPL0Fzpg,1680
-esprit/grade.py,sha256=ip30Aavx9mCdwIpziXLENLMaEmaIM6mkC3EXnT0041g,3098
-esprit/time_schedule.py,sha256=sU2gwV9dmIyFhSe0qlxTGg05L7lhLbD0YN0qhMXdNc0,6490
-esprit_py-0.3.3.dist-info/LICENSE,sha256=DOcn7qpE6TsUEcakIsDDKm757jx5YlQ8fXDiED21P_w,1089
-esprit_py-0.3.3.dist-info/METADATA,sha256=TfDmCND5Di6lTJHWIf8-MaalKcTQ0veV3g1gbEaJPnM,1833
-esprit_py-0.3.3.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
-esprit_py-0.3.3.dist-info/top_level.txt,sha256=aS9besFTZ4EYTsoBJVf3GaMjQtJLgLaK7WqAxSvGVdQ,7
-esprit_py-0.3.3.dist-info/RECORD,,