schoolapp-api 2.0.0__tar.gz → 2.1.1__tar.gz

schoolapp_api-2.1.1/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: schoolapp-api
+Version: 2.1.1
+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.1/README.md

@@ -0,0 +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-2.0.0 → schoolapp_api-2.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "schoolapp-api"
-version = "2.0.0"
+version = "2.1.1"
 description = "Professional client for interacting with the School App API"
 readme = "README.md"
 requires-python = ">=3.7"

schoolapp_api-2.1.1/schoolapp_api.egg-info/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: schoolapp-api
+Version: 2.1.1
+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.0.0/PKG-INFO

@@ -1,91 +0,0 @@
-Metadata-Version: 2.4
-Name: schoolapp-api
-Version: 2.0.0
-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
-
-# School App Client - Refactored
-
-Clean, organized structure for the School App client with proper separation of concerns.
-
-## 📁 Project Structure
-
-```
-├── http_client.py         # Base HTTP client (GET/POST requests, cookie management)
-├── auth.py                # Authentication & CSRF token handling
-├── school_app_client.py   # Main API client (combines everything)
-└── example_usage.py       # Usage example
-```
-
-## 🎯 Architecture
-
-### 1. **http_client.py** - HTTP Layer
-- Handles raw HTTP operations (GET/POST)
-- Cookie jar and session management
-- Common headers configuration
-- Error handling for network requests
-
-### 2. **auth.py** - Authentication Layer
-- Login flow management
-- CSRF token extraction and updates
-- Session state tracking
-- Decoupled from HTTP implementation
-
-### 3. **school_app_client.py** - API Layer
-- High-level API methods (`get_filieres()`, `get_modules()`)
-- Orchestrates HTTP client and auth manager
-- Business logic for School App endpoints
-
-## 🚀 Usage
-
-```python
-from school_app_client import SchoolAppClient
-
-# Initialize
-client = SchoolAppClient()
-
-# Login
-client.login("your.email@example.com", "password")
-
-# Fetch data
-filieres = client.get_filieres()
-modules = client.get_modules(niveau="1A", filiere="API-MPT", semestre="S1")
-
-# If you encounter 403 errors, force CSRF refresh
-modules = client.get_modules(
-    niveau="1A", 
-    filiere="API-MPT", 
-    semestre="S1",
-    refresh_csrf=True
-)
-```
-
-## ✨ Benefits of This Structure
-
-- **Separation of Concerns**: Each module has a single responsibility
-- **Testability**: Easy to mock and unit test each layer
-- **Maintainability**: Changes in one layer don't affect others
-- **Extensibility**: Easy to add new endpoints or authentication methods
-- **Reusability**: HTTP client can be used for other projects
-
-## 🎯 Key Features
-
-- **Automatic CSRF Management**: CSRF tokens are automatically refreshed from page content
-- **Session Persistence**: Cookie-based session management keeps you logged in
-- **Smart Error Handling**: Detects 403 errors and suggests CSRF refresh
-- **Optional CSRF Force Refresh**: Use `refresh_csrf=True` to force token refresh before requests
-- **Clean Separation**: HTTP, Auth, and API layers are completely decoupled
-
-## 🔧 Potential Extensions
-
-- Add logging module
-- Implement response parsers (HTML → structured data)
-- Add caching layer
-- Create async version using `aiohttp`
-- Add retry logic with exponential backoff

schoolapp_api-2.0.0/README.md

@@ -1,79 +0,0 @@
-# School App Client - Refactored
-
-Clean, organized structure for the School App client with proper separation of concerns.
-
-## 📁 Project Structure
-
-```
-├── http_client.py         # Base HTTP client (GET/POST requests, cookie management)
-├── auth.py                # Authentication & CSRF token handling
-├── school_app_client.py   # Main API client (combines everything)
-└── example_usage.py       # Usage example
-```
-
-## 🎯 Architecture
-
-### 1. **http_client.py** - HTTP Layer
-- Handles raw HTTP operations (GET/POST)
-- Cookie jar and session management
-- Common headers configuration
-- Error handling for network requests
-
-### 2. **auth.py** - Authentication Layer
-- Login flow management
-- CSRF token extraction and updates
-- Session state tracking
-- Decoupled from HTTP implementation
-
-### 3. **school_app_client.py** - API Layer
-- High-level API methods (`get_filieres()`, `get_modules()`)
-- Orchestrates HTTP client and auth manager
-- Business logic for School App endpoints
-
-## 🚀 Usage
-
-```python
-from school_app_client import SchoolAppClient
-
-# Initialize
-client = SchoolAppClient()
-
-# Login
-client.login("your.email@example.com", "password")
-
-# Fetch data
-filieres = client.get_filieres()
-modules = client.get_modules(niveau="1A", filiere="API-MPT", semestre="S1")
-
-# If you encounter 403 errors, force CSRF refresh
-modules = client.get_modules(
-    niveau="1A", 
-    filiere="API-MPT", 
-    semestre="S1",
-    refresh_csrf=True
-)
-```
-
-## ✨ Benefits of This Structure
-
-- **Separation of Concerns**: Each module has a single responsibility
-- **Testability**: Easy to mock and unit test each layer
-- **Maintainability**: Changes in one layer don't affect others
-- **Extensibility**: Easy to add new endpoints or authentication methods
-- **Reusability**: HTTP client can be used for other projects
-
-## 🎯 Key Features
-
-- **Automatic CSRF Management**: CSRF tokens are automatically refreshed from page content
-- **Session Persistence**: Cookie-based session management keeps you logged in
-- **Smart Error Handling**: Detects 403 errors and suggests CSRF refresh
-- **Optional CSRF Force Refresh**: Use `refresh_csrf=True` to force token refresh before requests
-- **Clean Separation**: HTTP, Auth, and API layers are completely decoupled
-
-## 🔧 Potential Extensions
-
-- Add logging module
-- Implement response parsers (HTML → structured data)
-- Add caching layer
-- Create async version using `aiohttp`
-- Add retry logic with exponential backoff

schoolapp_api-2.0.0/schoolapp_api.egg-info/PKG-INFO

@@ -1,91 +0,0 @@
-Metadata-Version: 2.4
-Name: schoolapp-api
-Version: 2.0.0
-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
-
-# School App Client - Refactored
-
-Clean, organized structure for the School App client with proper separation of concerns.
-
-## 📁 Project Structure
-
-```
-├── http_client.py         # Base HTTP client (GET/POST requests, cookie management)
-├── auth.py                # Authentication & CSRF token handling
-├── school_app_client.py   # Main API client (combines everything)
-└── example_usage.py       # Usage example
-```
-
-## 🎯 Architecture
-
-### 1. **http_client.py** - HTTP Layer
-- Handles raw HTTP operations (GET/POST)
-- Cookie jar and session management
-- Common headers configuration
-- Error handling for network requests
-
-### 2. **auth.py** - Authentication Layer
-- Login flow management
-- CSRF token extraction and updates
-- Session state tracking
-- Decoupled from HTTP implementation
-
-### 3. **school_app_client.py** - API Layer
-- High-level API methods (`get_filieres()`, `get_modules()`)
-- Orchestrates HTTP client and auth manager
-- Business logic for School App endpoints
-
-## 🚀 Usage
-
-```python
-from school_app_client import SchoolAppClient
-
-# Initialize
-client = SchoolAppClient()
-
-# Login
-client.login("your.email@example.com", "password")
-
-# Fetch data
-filieres = client.get_filieres()
-modules = client.get_modules(niveau="1A", filiere="API-MPT", semestre="S1")
-
-# If you encounter 403 errors, force CSRF refresh
-modules = client.get_modules(
-    niveau="1A", 
-    filiere="API-MPT", 
-    semestre="S1",
-    refresh_csrf=True
-)
-```
-
-## ✨ Benefits of This Structure
-
-- **Separation of Concerns**: Each module has a single responsibility
-- **Testability**: Easy to mock and unit test each layer
-- **Maintainability**: Changes in one layer don't affect others
-- **Extensibility**: Easy to add new endpoints or authentication methods
-- **Reusability**: HTTP client can be used for other projects
-
-## 🎯 Key Features
-
-- **Automatic CSRF Management**: CSRF tokens are automatically refreshed from page content
-- **Session Persistence**: Cookie-based session management keeps you logged in
-- **Smart Error Handling**: Detects 403 errors and suggests CSRF refresh
-- **Optional CSRF Force Refresh**: Use `refresh_csrf=True` to force token refresh before requests
-- **Clean Separation**: HTTP, Auth, and API layers are completely decoupled
-
-## 🔧 Potential Extensions
-
-- Add logging module
-- Implement response parsers (HTML → structured data)
-- Add caching layer
-- Create async version using `aiohttp`
-- Add retry logic with exponential backoff