esprit-py 0.3.2__tar.gz → 0.3.4__tar.gz

{esprit-py-0.3.2/esprit_py.egg-info → esprit-py-0.3.4}/PKG-INFO

@@ -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)
@@ -26,6 +26,7 @@ License-File: LICENSE
 - Get your grades
 - Get your absences
 - Get your credits
+- Calculate your total semester average
 
 ## Installation
 
@@ -33,13 +34,55 @@ License-File: LICENSE
 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;
 
 ```python
 from esprit import Esprit
 
 # Create an Esprit object
-esprit = Esprit()
+esprit = Esprit(
+    driver_path="C:/path/to/chromedriver.exe",)
 
 # Replace with your actual ID and password
 id = 'ID'
@@ -58,5 +101,7 @@ if absences is not None:
         print(absence)
 else:
     print("Failed to get absences.")
+
 ```
+
 More examples can be found in the [examples folder](examples)

esprit-py-0.3.4/README.md

@@ -0,0 +1,90 @@
+# <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)
+
+## 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.2 → esprit-py-0.3.4}/esprit/absence.py

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

{esprit-py-0.3.2 → esprit-py-0.3.4}/esprit/auth.py

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

{esprit-py-0.3.2 → esprit-py-0.3.4}/esprit/credit.py

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

{esprit-py-0.3.2 → esprit-py-0.3.4}/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-py-0.3.4/esprit/grade.py

@@ -0,0 +1,102 @@
+from bs4 import BeautifulSoup
+import pandas as pd
+import numpy as np
+
+
+class Grade:
+    """
+    A class used to represent a Grade.
+
+    ...
+
+    Attributes
+    ----------
+    url : str
+        a formatted string that represents the URL of the grade page
+    session : requests.Session
+        a Session object from the requests library
+
+    Methods
+    -------
+    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):
+        self.url = "https://esprit-tn.com/ESPOnline/Etudiants/Resultat2021.aspx"
+        self.session = session
+
+    def get_grades(self):
+        """
+        Returns a list of grades for the student.
+
+        Returns
+        -------
+        list
+            a list of grades, each represented as a list of strings. The first list is the headers.
+            Returns None if the page does not contain the expected text.
+        """
+        response = self.session.get(self.url)
+        soup = BeautifulSoup(response.text, 'html.parser')
+
+        # Check if the <h1> tag with the text "Notes Des Modules" exists
+        h1_tag = soup.find('h1', text=' Notes Des Modules ')
+        if h1_tag is None:
+            print("The page does not contain the expected text.")
+            return None
+
+        table = soup.find('table', {'id': 'ContentPlaceHolder1_GridView1'})
+        rows = table.find_all('tr')
+        headers = [cell.text.strip() for cell in rows[0].find_all('th')]
+        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-py-0.3.2 → esprit-py-0.3.4}/esprit/time_schedule.py

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

esprit-py-0.3.4/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 → esprit-py-0.3.4/esprit_py.egg-info}/PKG-INFO

@@ -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)
@@ -26,6 +26,7 @@ License-File: LICENSE
 - Get your grades
 - Get your absences
 - Get your credits
+- Calculate your total semester average
 
 ## Installation
 
@@ -33,13 +34,55 @@ License-File: LICENSE
 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;
 
 ```python
 from esprit import Esprit
 
 # Create an Esprit object
-esprit = Esprit()
+esprit = Esprit(
+    driver_path="C:/path/to/chromedriver.exe",)
 
 # Replace with your actual ID and password
 id = 'ID'
@@ -58,5 +101,7 @@ if absences is not None:
         print(absence)
 else:
     print("Failed to get absences.")
+
 ```
+
 More examples can be found in the [examples folder](examples)

{esprit-py-0.3.2 → esprit-py-0.3.4}/esprit_py.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ esprit/credit.py
 esprit/esprit.py
 esprit/grade.py
 esprit/time_schedule.py
+esprit/utils.py
 esprit_py.egg-info/PKG-INFO
 esprit_py.egg-info/SOURCES.txt
 esprit_py.egg-info/dependency_links.txt

{esprit-py-0.3.2 → esprit-py-0.3.4}/esprit_py.egg-info/requires.txt

@@ -2,3 +2,5 @@ requests
 beautifulsoup4
 PyPDF2
 selenium
+numpy
+pandas

{esprit-py-0.3.2 → esprit-py-0.3.4}/setup.py

@@ -11,7 +11,7 @@ with codecs.open(os.path.join(here, "README.md"), encoding="utf-8") as fh:
 with open(os.path.join(here, 'requirements.txt')) as f:
     requirements = f.read().splitlines()
 
-VERSION = '0.3.2'
+VERSION = '0.3.4'
 DESCRIPTION = ' A Python library for interacting with data from esprit-tn.com'
 LONG_DESCRIPTION = 'esprit-py, provides a set of tools for interacting with data from the Esprit website. It includes functionalities for scraping grades, absences, time schedules, and credits. It also provides the ability to download files and get class week schedules.'
 

esprit-py-0.3.2/README.md

@@ -1,45 +0,0 @@
-# <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
-
-## Installation
-
-```bash
-pip install esprit-py
-```
-
-## Example
-
-```python
-from esprit import Esprit
-
-# Create an Esprit object
-esprit = Esprit()
-
-# 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.2/esprit/grade.py

@@ -1,52 +0,0 @@
-import requests
-from bs4 import BeautifulSoup
-
-
-class Grade:
-    """
-    A class used to represent a Grade.
-
-    ...
-
-    Attributes
-    ----------
-    url : str
-        a formatted string that represents the URL of the grade page
-    session : requests.Session
-        a Session object from the requests library
-
-    Methods
-    -------
-    get_grades():
-        Returns a list of grades for the student.
-    """
-
-    def __init__(self, session):
-        self.url = "https://esprit-tn.com/ESPOnline/Etudiants/Resultat2021.aspx"
-        self.session = session
-
-    def get_grades(self):
-        """
-        Returns a list of grades for the student.
-
-        Returns
-        -------
-        list
-            a list of grades, each represented as a list of strings. The first list is the headers.
-            Returns None if the page does not contain the expected text.
-        """
-        response = self.session.get(self.url)
-        soup = BeautifulSoup(response.text, 'html.parser')
-
-        # Check if the <h1> tag with the text "Notes Des Modules" exists
-        h1_tag = soup.find('h1', text=' Notes Des Modules ')
-        if h1_tag is None:
-            print("The page does not contain the expected text.")
-            return None
-
-        table = soup.find('table', {'id': 'ContentPlaceHolder1_GridView1'})
-        rows = table.find_all('tr')
-        headers = [cell.text.strip() for cell in rows[0].find_all('th')]
-        grades = [headers] + [[cell.text.strip() for cell in row.find_all('td')]
-                              for row in rows[1:]]  # Skip header row
-        return grades