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

esprit-py-0.3.4/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.1
+Name: esprit-py
+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)
+Keywords: python,api
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+
+# <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.3/PKG-INFO → esprit-py-0.3.4/README.md

@@ -1,20 +1,3 @@
-Metadata-Version: 2.1
-Name: esprit-py
-Version: 0.3.3
-Summary:  A Python library for interacting with data from esprit-tn.com
-Home-page: https://github.com/TheLime1/esprit.py
-Author: Lime1 (Aymen Hmani)
-Keywords: python,api
-Classifier: Development Status :: 1 - Planning
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: Unix
-Classifier: Operating System :: MacOS :: MacOS X
-Classifier: Operating System :: Microsoft :: Windows
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
-
 # <img src="https://esprit.tn/favicon.ico" width="28px" /> esprit-py
 
 > [!NOTE]
@@ -26,6 +9,7 @@ License-File: LICENSE
 - Get your grades
 - Get your absences
 - Get your credits
+- Calculate your total semester average
 
 ## Installation
 
@@ -35,7 +19,46 @@ 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
@@ -64,4 +87,4 @@ else:
 
 ```
 
-More examples can be found in the [examples folder](examples)
+More examples can be found in the [examples folder](examples)

{esprit-py-0.3.3 → esprit-py-0.3.4}/esprit/absence.py

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

{esprit-py-0.3.3 → 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.3 → esprit-py-0.3.4}/esprit/credit.py

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

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

@@ -0,0 +1,107 @@
+Metadata-Version: 2.1
+Name: esprit-py
+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)
+Keywords: python,api
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+
+# <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.3 → 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.3 → 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.3'
+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.3/README.md

@@ -1,50 +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
-```
-
-download `chromedriver` from [here](https://googlechromelabs.github.io/chrome-for-testing/#stable)
-
-## Example
-
-```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.3/esprit_py.egg-info/PKG-INFO

@@ -1,67 +0,0 @@
-Metadata-Version: 2.1
-Name: esprit-py
-Version: 0.3.3
-Summary:  A Python library for interacting with data from esprit-tn.com
-Home-page: https://github.com/TheLime1/esprit.py
-Author: Lime1 (Aymen Hmani)
-Keywords: python,api
-Classifier: Development Status :: 1 - Planning
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: Unix
-Classifier: Operating System :: MacOS :: MacOS X
-Classifier: Operating System :: Microsoft :: Windows
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
-
-# <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
-```
-
-download `chromedriver` from [here](https://googlechromelabs.github.io/chrome-for-testing/#stable)
-
-## Example
-
-```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)