esprit-py 0.3.2__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:
@@ -11,10 +13,10 @@ class Esprit:
         self.session = requests.Session()
         self.auth = Auth(driver_path, driver, debug, headless)
         self.grade_scrape = Grade(self.session)
-        self.grade_scrape = Grade(self.session)
         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)
@@ -24,6 +26,9 @@ class Esprit:
     def get_grades(self):
         return self.grade_scrape.get_grades()
 
+    def calculate_average(self, grades):
+        return self.grade_scrape.calculate_average(grades)
+
     def get_absences(self):
         return self.absence_scrape.get_absences()
 
@@ -41,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,5 +1,6 @@
-import requests
 from bs4 import BeautifulSoup
+import pandas as pd
+import numpy as np
 
 
 class Grade:
@@ -19,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):
@@ -50,3 +53,50 @@ class Grade:
         grades = [headers] + [[cell.text.strip() for cell in row.find_all('td')]
                               for row in rows[1:]]  # Skip header row
         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])
+
+        # Replace empty strings with NaN
+        df.replace('', np.nan, inplace=True)
+
+        # Replace comma with dot and convert to float
+        for col in ['COEF', 'NOTE_CC', 'NOTE_TP', 'NOTE_EXAM']:
+            df[col] = df[col].str.replace(',', '.').astype(float)
+
+        # Calculate the average based on available grades
+
+        def calculate_average(row):
+            if pd.isna(row['NOTE_TP']):
+                if pd.isna(row['NOTE_CC']):
+                    return row['NOTE_EXAM']
+                else:
+                    return row['NOTE_EXAM'] * 0.6 + row['NOTE_CC'] * 0.4
+            elif pd.isna(row['NOTE_CC']):
+                return row['NOTE_EXAM'] * 0.8 + row['NOTE_TP'] * 0.2
+            else:
+                return row['NOTE_EXAM'] * 0.5 + row['NOTE_CC'] * 0.3 + row['NOTE_TP'] * 0.2
+
+        df['MOYENNE'] = df.apply(calculate_average, axis=1)
+
+        # Calculate the total average
+        total_average = (df['MOYENNE'] * df['COEF']).sum() / df['COEF'].sum()
+
+        # Append the total average to the DataFrame
+        df = df._append({'DESIGNATION': 'Moyenne', 'COEF': df['COEF'].sum(
+        ), 'MOYENNE': total_average}, ignore_index=True)
+
+        print(df)
+        return total_average

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.2.dist-info → esprit_py-0.3.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: esprit-py
-Version: 0.3.2
+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)
@@ -17,6 +17,8 @@ Requires-Dist: requests
 Requires-Dist: beautifulsoup4
 Requires-Dist: PyPDF2
 Requires-Dist: selenium
+Requires-Dist: numpy
+Requires-Dist: pandas
 
 
 # <img src="https://esprit.tn/favicon.ico" width="28px" /> esprit-py
@@ -41,6 +43,8 @@ Requires-Dist: selenium
 
 - Get your credits
 
+- Calculate your total semester average
+
 
 
 ## Installation
@@ -55,7 +59,89 @@ pip install esprit-py
 
 
 
-## Example
+download `chromedriver` from [here](https://googlechromelabs.github.io/chrome-for-testing/#stable)
+
+
+
+## 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;
 
 
 
@@ -67,7 +153,9 @@ from esprit import Esprit
 
 # Create an Esprit object
 
-esprit = Esprit()
+esprit = Esprit(
+
+    driver_path="C:/path/to/chromedriver.exe",)
 
 
 
@@ -105,6 +193,10 @@ 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.2.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=5ixvBZESBxlco2AA4apPPfTDUx8wNuc5blC-FZu7dpc,1625
-esprit/grade.py,sha256=EAgYvA-490Jj9TeUCIlSQeW4aVu2gcmfujNxDG-91Fw,1648
-esprit/time_schedule.py,sha256=sU2gwV9dmIyFhSe0qlxTGg05L7lhLbD0YN0qhMXdNc0,6490
-esprit_py-0.3.2.dist-info/LICENSE,sha256=DOcn7qpE6TsUEcakIsDDKm757jx5YlQ8fXDiED21P_w,1089
-esprit_py-0.3.2.dist-info/METADATA,sha256=CWa2zN-6vYcdZOhIKdrkHZqd3vLoEGiCW43hnSr-9zA,1722
-esprit_py-0.3.2.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
-esprit_py-0.3.2.dist-info/top_level.txt,sha256=aS9besFTZ4EYTsoBJVf3GaMjQtJLgLaK7WqAxSvGVdQ,7
-esprit_py-0.3.2.dist-info/RECORD,,