schoolapp-api 2.1.2__tar.gz → 2.1.3__tar.gz

{schoolapp_api-2.1.2 → schoolapp_api-2.1.3}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) [2026] [Aferiad Kamal]
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) [2026] [Aferiad Kamal]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{schoolapp_api-2.1.2/schoolapp_api.egg-info → schoolapp_api-2.1.3}/PKG-INFO

@@ -1,62 +1,62 @@
-Metadata-Version: 2.4
-Name: schoolapp-api
-Version: 2.1.2
-Summary: Professional client for interacting with the School App API
-Author: Aferiad Kamal
-License: MIT
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: beautifulsoup4>=4.9.0
-Dynamic: license-file
-
-# SchoolApp API
-
-A Python library designed to make interacting with the SchoolApp platform a lot less painful. Instead of wrestling with session cookies and manual HTML scraping, this library gives you a clean, object-oriented way to access your grades, attendance, and profile data.
-
-## Why This Exists
-Browsing the SchoolApp web interface manually for updates is slow. If you want to build a custom dashboard, a grade tracker, or a notification bot, you need a reliable way to get that data programmatically. This library takes care of:
-- **Authentication**: Solid session management with automatic CSRF token handling.
-- **Data Cleanup**: Converts messy HTML tables into structured Python objects.
-- **Smart Logic**: Handles nested modules, element-level statistics, and transcript parsing out of the box.
-
-## Quick Start
-
-### Installation
-You can install the library locally using:
-```bash
-pip install schoolapp-api
-```
-
-### Basic Usage
-Getting your data is as simple as this:
-
-```python
-from schoolapp_api import SchoolAppClient
-
-# Initialize and log in
-client = SchoolAppClient()
-if client.login("your.email@example.com", "password"):
-    
-    # Get your basic info
-    profile = client.get_profile()
-    print(f"Hello, {profile['basic_info']['full_name']}!")
-    
-    # Fetch your current semester grades
-    grades = client.get_current_elem_note()
-    for item in grades:
-        print(f"{item.CodeElem}: {item.Moy}")
-```
-
-## Project Layout
-The library is organized into several specific managers, so you always know where to find what you need:
-
-- **`grades`**: Handle module marks, element notes, and academic year results.
-- **`attendance`**: Track your absences and see any sanctions.
-- **`profile`**: Access your personal data and administrative files.
-- **`courses`**: Browse the study plan and available modules.
-
-For the full details on every class and function, head over to the [**/docs**](./docs/README.md) folder.
-
-## Contributions
-Found a bug or have an idea for a new feature? Feel free to open an issue or submit a pull request. Any help making this library better for everyone is appreciated!
+Metadata-Version: 2.4
+Name: schoolapp-api
+Version: 2.1.3
+Summary: Professional client for interacting with the School App API
+Author: Aferiad Kamal
+License: MIT
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: beautifulsoup4>=4.9.0
+Dynamic: license-file
+
+# SchoolApp API
+
+A Python library designed to make interacting with the SchoolApp platform a lot less painful. Instead of wrestling with session cookies and manual HTML scraping, this library gives you a clean, object-oriented way to access your grades, attendance, and profile data.
+
+## Why This Exists
+Browsing the SchoolApp web interface manually for updates is slow. If you want to build a custom dashboard, a grade tracker, or a notification bot, you need a reliable way to get that data programmatically. This library takes care of:
+- **Authentication**: Solid session management with automatic CSRF token handling.
+- **Data Cleanup**: Converts messy HTML tables into structured Python objects.
+- **Smart Logic**: Handles nested modules, element-level statistics, and transcript parsing out of the box.
+
+## Quick Start
+
+### Installation
+You can install the library locally using:
+```bash
+pip install schoolapp-api
+```
+
+### Basic Usage
+Getting your data is as simple as this:
+
+```python
+from schoolapp_api import SchoolAppClient
+
+# Initialize and log in
+client = SchoolAppClient()
+if client.login("your.email@example.com", "password"):
+    
+    # Get your basic info
+    profile = client.get_profile()
+    print(f"Hello, {profile['basic_info']['full_name']}!")
+    
+    # Fetch your current semester grades
+    grades = client.get_current_elem_note()
+    for item in grades:
+        print(f"{item.CodeElem}: {item.Moy}")
+```
+
+## Project Layout
+The library is organized into several specific managers, so you always know where to find what you need:
+
+- **`grades`**: Handle module marks, element notes, and academic year results.
+- **`attendance`**: Track your absences and see any sanctions.
+- **`profile`**: Access your personal data and administrative files.
+- **`courses`**: Browse the study plan and available modules.
+
+For the full details on every class and function, head over to the [**/docs**](./docs/README.md) folder.
+
+## Contributions
+Found a bug or have an idea for a new feature? Feel free to open an issue or submit a pull request. Any help making this library better for everyone is appreciated!

{schoolapp_api-2.1.2 → schoolapp_api-2.1.3}/README.md

@@ -1,50 +1,50 @@
-# SchoolApp API
-
-A Python library designed to make interacting with the SchoolApp platform a lot less painful. Instead of wrestling with session cookies and manual HTML scraping, this library gives you a clean, object-oriented way to access your grades, attendance, and profile data.
-
-## Why This Exists
-Browsing the SchoolApp web interface manually for updates is slow. If you want to build a custom dashboard, a grade tracker, or a notification bot, you need a reliable way to get that data programmatically. This library takes care of:
-- **Authentication**: Solid session management with automatic CSRF token handling.
-- **Data Cleanup**: Converts messy HTML tables into structured Python objects.
-- **Smart Logic**: Handles nested modules, element-level statistics, and transcript parsing out of the box.
-
-## Quick Start
-
-### Installation
-You can install the library locally using:
-```bash
-pip install schoolapp-api
-```
-
-### Basic Usage
-Getting your data is as simple as this:
-
-```python
-from schoolapp_api import SchoolAppClient
-
-# Initialize and log in
-client = SchoolAppClient()
-if client.login("your.email@example.com", "password"):
-    
-    # Get your basic info
-    profile = client.get_profile()
-    print(f"Hello, {profile['basic_info']['full_name']}!")
-    
-    # Fetch your current semester grades
-    grades = client.get_current_elem_note()
-    for item in grades:
-        print(f"{item.CodeElem}: {item.Moy}")
-```
-
-## Project Layout
-The library is organized into several specific managers, so you always know where to find what you need:
-
-- **`grades`**: Handle module marks, element notes, and academic year results.
-- **`attendance`**: Track your absences and see any sanctions.
-- **`profile`**: Access your personal data and administrative files.
-- **`courses`**: Browse the study plan and available modules.
-
-For the full details on every class and function, head over to the [**/docs**](./docs/README.md) folder.
-
-## Contributions
-Found a bug or have an idea for a new feature? Feel free to open an issue or submit a pull request. Any help making this library better for everyone is appreciated!
+# SchoolApp API
+
+A Python library designed to make interacting with the SchoolApp platform a lot less painful. Instead of wrestling with session cookies and manual HTML scraping, this library gives you a clean, object-oriented way to access your grades, attendance, and profile data.
+
+## Why This Exists
+Browsing the SchoolApp web interface manually for updates is slow. If you want to build a custom dashboard, a grade tracker, or a notification bot, you need a reliable way to get that data programmatically. This library takes care of:
+- **Authentication**: Solid session management with automatic CSRF token handling.
+- **Data Cleanup**: Converts messy HTML tables into structured Python objects.
+- **Smart Logic**: Handles nested modules, element-level statistics, and transcript parsing out of the box.
+
+## Quick Start
+
+### Installation
+You can install the library locally using:
+```bash
+pip install schoolapp-api
+```
+
+### Basic Usage
+Getting your data is as simple as this:
+
+```python
+from schoolapp_api import SchoolAppClient
+
+# Initialize and log in
+client = SchoolAppClient()
+if client.login("your.email@example.com", "password"):
+    
+    # Get your basic info
+    profile = client.get_profile()
+    print(f"Hello, {profile['basic_info']['full_name']}!")
+    
+    # Fetch your current semester grades
+    grades = client.get_current_elem_note()
+    for item in grades:
+        print(f"{item.CodeElem}: {item.Moy}")
+```
+
+## Project Layout
+The library is organized into several specific managers, so you always know where to find what you need:
+
+- **`grades`**: Handle module marks, element notes, and academic year results.
+- **`attendance`**: Track your absences and see any sanctions.
+- **`profile`**: Access your personal data and administrative files.
+- **`courses`**: Browse the study plan and available modules.
+
+For the full details on every class and function, head over to the [**/docs**](./docs/README.md) folder.
+
+## Contributions
+Found a bug or have an idea for a new feature? Feel free to open an issue or submit a pull request. Any help making this library better for everyone is appreciated!

{schoolapp_api-2.1.2 → schoolapp_api-2.1.3}/pyproject.toml

@@ -1,21 +1,20 @@
-[build-system]
-requires = ["setuptools>=61.0"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "schoolapp-api"
-version = "2.1.2"
-description = "Professional client for interacting with the School App API"
-readme = "README.md"
-requires-python = ">=3.7"
-license = {text = "MIT"}
-authors = [
-    {name = "Aferiad Kamal"}
-]
-dependencies = [
-    "beautifulsoup4>=4.9.0",
-]
-
-[tool.setuptools]
-packages = ["schoolapp_api", "schoolapp_api.managers", "schoolapp_api.parsers", "schoolapp_api.types"]
-
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "schoolapp-api"
+version = "2.1.3"
+description = "Professional client for interacting with the School App API"
+readme = "README.md"
+requires-python = ">=3.7"
+license = {text = "MIT"}
+authors = [
+    {name = "Aferiad Kamal"}
+]
+dependencies = [
+    "beautifulsoup4>=4.9.0",
+]
+
+[tool.setuptools]
+packages = ["schoolapp_api", "schoolapp_api.managers", "schoolapp_api.parsers", "schoolapp_api.types"]

{schoolapp_api-2.1.2 → schoolapp_api-2.1.3}/schoolapp_api/__init__.py

@@ -1,10 +1,10 @@
-"""
-Professional School App API Client
-"""
-
-from .school_app_client import SchoolAppClient
-from .http_client import HTTPClient
-from .auth import AuthManager
-
-__version__ = "2.1.2"
-__all__ = ["SchoolAppClient", "HTTPClient", "AuthManager"]
+"""
+Professional School App API Client
+"""
+
+from .school_app_client import SchoolAppClient
+from .http_client import HTTPClient
+from .auth import AuthManager
+
+__version__ = "2.0.0"
+__all__ = ["SchoolAppClient", "HTTPClient", "AuthManager"]

{schoolapp_api-2.1.2 → schoolapp_api-2.1.3}/schoolapp_api/auth.py

@@ -1,95 +1,95 @@
-"""
-Authentication and CSRF token management
-"""
-import re
-import logging
-from schoolapp_api.constants import LOGIN_URL
-
-logger = logging.getLogger(__name__)
-
-class AuthManager:
-    """Handles authentication and CSRF token management"""
-    
-    def __init__(self, http_client, base_url):
-        self.http_client = http_client
-        self.base_url = base_url
-        self.login_url = LOGIN_URL
-        self.csrf_token = None
-        self.logged_in = False
-    
-    @staticmethod
-    def extract_csrf_token(html_content):
-        """Extract CSRF token from HTML content"""
-        match = re.search(r'name=["\']_csrf["\']\s+value=["\']([^"\']+)["\']', html_content)
-        return match.group(1) if match else None
-    
-    def update_csrf_token(self, html_content):
-        """Update CSRF token from HTML content"""
-        new_csrf = self.extract_csrf_token(html_content)
-        if new_csrf:
-            self.csrf_token = new_csrf
-            return True
-        return False
-    
-    def login(self, email, password):
-        """Login and maintain session"""
-        if self.logged_in:
-            logger.info("Already logged in!")
-            return True
-        
-        logger.info("Fetching login page...")
-        code, url, content = self.http_client.get(self.login_url)
-        
-        if not content or not self.update_csrf_token(content):
-            logger.error("Failed to fetch login page or retrieve CSRF token.")
-            return False
-        
-        logger.info(f"Got CSRF token, logging in...")
-        login_data = {
-            '_csrf': self.csrf_token,
-            'email': email,
-            'password': password
-        }
-        
-        code, response_url, content = self.http_client.post(
-            self.login_url, 
-            login_data, 
-            referer=self.login_url
-        )
-        
-        if response_url and ("/login" in response_url and "error" in response_url):
-            logger.error("Login failed! Invalid credentials.")
-            return False
-        
-        logger.info("Login successful!")
-        self.logged_in = True
-        return True
-    
-    def is_logged_in(self):
-        """Check if currently logged in"""
-        return self.logged_in
-    
-    def check_session(self):
-        """
-        Confirm whether the session is still valid.
-        """
-        code, url, content = self.http_client.get(self.login_url)
-
-        # If server redirects us back to login, session is dead
-        if url and "/login" in url:
-            self.logged_in = False
-            return False
-
-        self.logged_in = True
-        return True
-
-    def refresh_csrf_from_url(self, url):
-        """Fetch a fresh CSRF token from a specific page"""
-        try:
-            code, response_url, content = self.http_client.get(url)
-            if content and self.update_csrf_token(content):
-                return True
-            return False
-        except Exception as e:
-            logger.warning(f"CSRF refresh warning: {e}")
-            return False
+"""
+Authentication and CSRF token management
+"""
+import re
+import logging
+from schoolapp_api.constants import LOGIN_URL
+
+logger = logging.getLogger(__name__)
+
+class AuthManager:
+    """Handles authentication and CSRF token management"""
+    
+    def __init__(self, http_client, base_url):
+        self.http_client = http_client
+        self.base_url = base_url
+        self.login_url = LOGIN_URL
+        self.csrf_token = None
+        self.logged_in = False
+    
+    @staticmethod
+    def extract_csrf_token(html_content):
+        """Extract CSRF token from HTML content"""
+        match = re.search(r'name=["\']_csrf["\']\s+value=["\']([^"\']+)["\']', html_content)
+        return match.group(1) if match else None
+    
+    def update_csrf_token(self, html_content):
+        """Update CSRF token from HTML content"""
+        new_csrf = self.extract_csrf_token(html_content)
+        if new_csrf:
+            self.csrf_token = new_csrf
+            return True
+        return False
+    
+    def login(self, email, password):
+        """Login and maintain session"""
+        if self.logged_in:
+            logger.info("Already logged in!")
+            return True
+        
+        logger.info("Fetching login page...")
+        code, url, content = self.http_client.get(self.login_url)
+        
+        if not content or not self.update_csrf_token(content):
+            logger.error("Failed to fetch login page or retrieve CSRF token.")
+            return False
+        
+        logger.info(f"Got CSRF token, logging in...")
+        login_data = {
+            '_csrf': self.csrf_token,
+            'email': email,
+            'password': password
+        }
+        
+        code, response_url, content = self.http_client.post(
+            self.login_url, 
+            login_data, 
+            referer=self.login_url
+        )
+        
+        if response_url and ("/login" in response_url and "error" in response_url):
+            logger.error("Login failed! Invalid credentials.")
+            return False
+        
+        logger.info("Login successful!")
+        self.logged_in = True
+        return True
+    
+    def is_logged_in(self):
+        """Check if currently logged in"""
+        return self.logged_in
+    
+    def check_session(self):
+        """
+        Confirm whether the session is still valid.
+        """
+        code, url, content = self.http_client.get(self.login_url)
+
+        # If server redirects us back to login, session is dead
+        if url and "/login" in url:
+            self.logged_in = False
+            return False
+
+        self.logged_in = True
+        return True
+
+    def refresh_csrf_from_url(self, url):
+        """Fetch a fresh CSRF token from a specific page"""
+        try:
+            code, response_url, content = self.http_client.get(url)
+            if content and self.update_csrf_token(content):
+                return True
+            return False
+        except Exception as e:
+            logger.warning(f"CSRF refresh warning: {e}")
+            return False

{schoolapp_api-2.1.2 → schoolapp_api-2.1.3}/schoolapp_api/constants.py

@@ -1,38 +1,38 @@
-"""
-Centralized constants for the School App API
-"""
-
-BASE_URL = "https://schoolapp.ensam-umi.ac.ma"
-
-# Endpoints
-LOGIN_URL = f"{BASE_URL}/login"
-INDEX_URL = f"{BASE_URL}/index"
-MODULES_URL = f"{BASE_URL}/plan-etudes-view/modules"
-FILIERES_URL = f"{BASE_URL}/plan-etudes-view/filieres"
-
-# Student Grade Endpoints
-CURRENT_ELEM_URL = f"{BASE_URL}/student/noteselem-encours"
-CURRENT_MOD_URL = f"{BASE_URL}/student/notesmod-encours"
-ELEM_URL = f"{BASE_URL}/student/noteselem"
-MOD_URL = f"{BASE_URL}/student/notesmod"
-ANNEES_URL = f"{BASE_URL}/student/notesannee"
-SEMESTRES_URL = f"{BASE_URL}/student/notessem"
-
-# Absence and Sanctions Endpoints
-ABSENCES_URL = f"{BASE_URL}/student/absence/bilan"
-SANCTIONS_URL = f"{BASE_URL}/student/absence/sanctions"
-
-# Stats Endpoints
-EVAL_STAT_URL = f"{BASE_URL}/notes-stat/elemevalsat"
-MOD_STAT_URL = f"{BASE_URL}/notes-stat/modsat"
-ANNEE_STAT_URL = f"{BASE_URL}/notes-stat/anneesat"
-SEM_STAT_URL = f"{BASE_URL}/notes-stat/semsat"
-
-# Default Headers
-DEFAULT_HEADERS = {
-    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
-    'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7',
-    'Accept-Language': 'en-US,en;q=0.9,fr;q=0.8',
-    'Connection': 'keep-alive',
-    'Upgrade-Insecure-Requests': '1'
-}
+"""
+Centralized constants for the School App API
+"""
+
+BASE_URL = "https://schoolapp.ensam-umi.ac.ma"
+
+# Endpoints
+LOGIN_URL = f"{BASE_URL}/login"
+INDEX_URL = f"{BASE_URL}/index"
+MODULES_URL = f"{BASE_URL}/plan-etudes-view/modules"
+FILIERES_URL = f"{BASE_URL}/plan-etudes-view/filieres"
+
+# Student Grade Endpoints
+CURRENT_ELEM_URL = f"{BASE_URL}/student/noteselem-encours"
+CURRENT_MOD_URL = f"{BASE_URL}/student/notesmod-encours"
+ELEM_URL = f"{BASE_URL}/student/noteselem"
+MOD_URL = f"{BASE_URL}/student/notesmod"
+ANNEES_URL = f"{BASE_URL}/student/notesannee"
+SEMESTRES_URL = f"{BASE_URL}/student/notessem"
+
+# Absence and Sanctions Endpoints
+ABSENCES_URL = f"{BASE_URL}/student/absence/bilan"
+SANCTIONS_URL = f"{BASE_URL}/student/absence/sanctions"
+
+# Stats Endpoints
+EVAL_STAT_URL = f"{BASE_URL}/notes-stat/elemevalsat"
+MOD_STAT_URL = f"{BASE_URL}/notes-stat/modsat"
+ANNEE_STAT_URL = f"{BASE_URL}/notes-stat/anneesat"
+SEM_STAT_URL = f"{BASE_URL}/notes-stat/semsat"
+
+# Default Headers
+DEFAULT_HEADERS = {
+    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+    'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7',
+    'Accept-Language': 'en-US,en;q=0.9,fr;q=0.8',
+    'Connection': 'keep-alive',
+    'Upgrade-Insecure-Requests': '1'
+}