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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: schoolapp-api
-Version: 2.1.1
+Version: 2.1.2
 Summary: Professional client for interacting with the School App API
 Author: Aferiad Kamal
 License: MIT

{schoolapp_api-2.1.1 → schoolapp_api-2.1.2}/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.1 → schoolapp_api-2.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "schoolapp-api"
-version = "2.1.1"
+version = "2.1.2"
 description = "Professional client for interacting with the School App API"
 readme = "README.md"
 requires-python = ">=3.7"
@@ -18,3 +18,4 @@ dependencies = [
 
 [tool.setuptools]
 packages = ["schoolapp_api", "schoolapp_api.managers", "schoolapp_api.parsers", "schoolapp_api.types"]
+

{schoolapp_api-2.1.1 → schoolapp_api-2.1.2}/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.0.0"
-__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.1.2"
+__all__ = ["SchoolAppClient", "HTTPClient", "AuthManager"]

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

@@ -1,81 +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 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.1 → schoolapp_api-2.1.2}/schoolapp_api/http_client.py

@@ -1,67 +1,79 @@
-"""
-HTTP Client with session and cookie management
-"""
-import urllib.request
-import urllib.parse
-import urllib.error
-import http.cookiejar
-import logging
-
-from schoolapp_api.constants import DEFAULT_HEADERS
-
-logger = logging.getLogger(__name__)
-
-class HTTPClient:
-    """Base HTTP client for making authenticated requests"""
-    
-    def __init__(self, base_url):
-        self.base_url = base_url
-        self.cookie_jar = http.cookiejar.CookieJar()
-        opener = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(self.cookie_jar))
-        urllib.request.install_opener(opener)
-        self.headers = DEFAULT_HEADERS.copy()
-    
-    def get(self, url, params=None):
-        """Perform GET request"""
-        try:
-            if params:
-                query_string = urllib.parse.urlencode(params, doseq=True)
-                separator = "&" if "?" in url else "?"
-                url = f"{url}{separator}{query_string}"
-
-            req = urllib.request.Request(url, headers=self.headers, method="GET")
-
-            with urllib.request.urlopen(req) as response:
-                code = response.getcode()
-                response_url = response.geturl()
-                content = response.read().decode("utf-8")
-                return code, response_url, content
-
-        except urllib.error.HTTPError as e:
-            logger.error(f"HTTP Error {e.code}: {e.reason}")
-            return e.code, None, None
-        except Exception as e:
-            logger.error(f"GET Error: {e}")
-            return None, None, None
-    
-    def post(self, url, data, referer=None):
-        """Perform POST request"""
-        try:
-            encoded_data = urllib.parse.urlencode(data).encode('utf-8')
-            req = urllib.request.Request(url, data=encoded_data, headers=self.headers)
-            req.add_header('Content-Type', 'application/x-www-form-urlencoded')
-            req.add_header('Origin', self.base_url)
-            if referer:
-                req.add_header('Referer', referer)
-            
-            with urllib.request.urlopen(req) as response:
-                code = response.getcode()
-                response_url = response.geturl()
-                content = response.read().decode('utf-8')
-                return code, response_url, content
-        except urllib.error.HTTPError as e:
-            logger.error(f"HTTP Error {e.code}: {e.reason}")
-            return e.code, None, None
-        except Exception as e:
-            logger.error(f"POST Error: {e}")
-            return None, None, None
+"""
+HTTP Client with session and cookie management
+"""
+import urllib.request
+import urllib.parse
+import urllib.error
+import http.cookiejar
+import logging
+
+from schoolapp_api.constants import DEFAULT_HEADERS
+
+logger = logging.getLogger(__name__)
+
+class NoRedirectHandler(urllib.request.HTTPRedirectHandler):
+    def redirect_request(self, req, fp, code, msg, headers, newurl):
+        raise urllib.error.HTTPError(
+            req.full_url, code, msg, headers, fp
+        )
+
+
+class HTTPClient:
+    """Base HTTP client for making authenticated requests"""
+    
+    def __init__(self, base_url):
+        self.base_url = base_url
+        self.cookie_jar = http.cookiejar.CookieJar()
+        opener = urllib.request.build_opener(
+            urllib.request.HTTPCookieProcessor(self.cookie_jar),
+            NoRedirectHandler()
+        )
+        urllib.request.install_opener(opener)
+        # opener = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(self.cookie_jar))
+        # urllib.request.install_opener(opener)
+        self.headers = DEFAULT_HEADERS.copy()
+    
+    def get(self, url, params=None):
+        """Perform GET request"""
+        try:
+            if params:
+                query_string = urllib.parse.urlencode(params, doseq=True)
+                separator = "&" if "?" in url else "?"
+                url = f"{url}{separator}{query_string}"
+
+            req = urllib.request.Request(url, headers=self.headers, method="GET")
+
+            with urllib.request.urlopen(req) as response:
+                code = response.getcode()
+                response_url = response.geturl()
+                content = response.read().decode("utf-8")
+                return code, response_url, content
+
+        except urllib.error.HTTPError as e:
+            logger.error(f"HTTP Error {e.code}: {e.reason}")
+            return e.code, None, None
+        except Exception as e:
+            logger.error(f"GET Error: {e}")
+            return None, None, None
+    
+    def post(self, url, data, referer=None):
+        """Perform POST request"""
+        try:
+            encoded_data = urllib.parse.urlencode(data).encode('utf-8')
+            req = urllib.request.Request(url, data=encoded_data, headers=self.headers)
+            req.add_header('Content-Type', 'application/x-www-form-urlencoded')
+            req.add_header('Origin', self.base_url)
+            if referer:
+                req.add_header('Referer', referer)
+            
+            with urllib.request.urlopen(req) as response:
+                code = response.getcode()
+                response_url = response.geturl()
+                content = response.read().decode('utf-8')
+                return code, response_url, content
+        except urllib.error.HTTPError as e:
+            logger.error(f"HTTP Error {e.code}: {e.reason}")
+            return e.code, None, None
+        except Exception as e:
+            logger.error(f"POST Error: {e}")
+            return None, None, None

{schoolapp_api-2.1.1 → schoolapp_api-2.1.2}/schoolapp_api/school_app_client.py

@@ -1,64 +1,64 @@
-"""
-Professional client for interacting with the School App
-"""
-from schoolapp_api.http_client import HTTPClient
-from schoolapp_api.auth import AuthManager
-from schoolapp_api.constants import BASE_URL
-from schoolapp_api.managers import (
-    GradesManager, AttendanceManager, ProfileManager, CourseManager
-)
-
-class SchoolAppClient:
-    """Main client for the School App API"""
-    
-    def __init__(self, base_url=BASE_URL):
-        self.base_url = base_url
-        self.http_client = HTTPClient(self.base_url)
-        self.auth = AuthManager(self.http_client, self.base_url)
-        
-        # Initialize Managers
-        self.grades = GradesManager(self)
-        self.attendance = AttendanceManager(self)
-        self.profile = ProfileManager(self)
-        self.courses = CourseManager(self)
-        
-    def login(self, email, password):
-        """Authenticate user"""
-        return self.auth.login(email, password)
-    
-    # ---------------------------------------------------------
-    # Legacy / Convenience methods for backward compatibility
-    # ---------------------------------------------------------
-    
-    def get_profile(self):
-        return self.profile.get_profile()
-    
-    def get_filieres(self):
-        return self.profile.get_filieres()
-    
-    def get_absences(self):
-        return self.attendance.get_absences()
-    
-    def get_sanctions(self):
-        return self.attendance.get_sanctions()
-    
-    def get_elem_note(self):
-        return self.grades.get_element_notes()
-    
-    def get_current_elem_note(self):
-        return self.grades.get_element_notes(current=True)
-    
-    def get_mod_note(self):
-        return self.grades.get_module_notes()
-    
-    def get_current_mod_note(self):
-        return self.grades.get_module_notes(current=True)
-    
-    def get_annee(self):
-        return self.grades.get_years()
-    
-    def get_semestre(self):
-        return self.grades.get_semesters()
-    
-    def get_modules(self, niveau, filiere, semestre, refresh_csrf=False):
+"""
+Professional client for interacting with the School App
+"""
+from schoolapp_api.http_client import HTTPClient
+from schoolapp_api.auth import AuthManager
+from schoolapp_api.constants import BASE_URL
+from schoolapp_api.managers import (
+    GradesManager, AttendanceManager, ProfileManager, CourseManager
+)
+
+class SchoolAppClient:
+    """Main client for the School App API"""
+    
+    def __init__(self, base_url=BASE_URL):
+        self.base_url = base_url
+        self.http_client = HTTPClient(self.base_url)
+        self.auth = AuthManager(self.http_client, self.base_url)
+        
+        # Initialize Managers
+        self.grades = GradesManager(self)
+        self.attendance = AttendanceManager(self)
+        self.profile = ProfileManager(self)
+        self.courses = CourseManager(self)
+        
+    def login(self, email, password):
+        """Authenticate user"""
+        return self.auth.login(email, password)
+    
+    # ---------------------------------------------------------
+    # Legacy / Convenience methods for backward compatibility
+    # ---------------------------------------------------------
+    
+    def get_profile(self):
+        return self.profile.get_profile()
+    
+    def get_filieres(self):
+        return self.profile.get_filieres()
+    
+    def get_absences(self):
+        return self.attendance.get_absences()
+    
+    def get_sanctions(self):
+        return self.attendance.get_sanctions()
+    
+    def get_elem_note(self):
+        return self.grades.get_element_notes()
+    
+    def get_current_elem_note(self):
+        return self.grades.get_element_notes(current=True)
+    
+    def get_mod_note(self):
+        return self.grades.get_module_notes()
+    
+    def get_current_mod_note(self):
+        return self.grades.get_module_notes(current=True)
+    
+    def get_annee(self):
+        return self.grades.get_years()
+    
+    def get_semestre(self):
+        return self.grades.get_semesters()
+    
+    def get_modules(self, niveau, filiere, semestre, refresh_csrf=False):
         return self.courses.get_modules(niveau, filiere, semestre, refresh_csrf)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: schoolapp-api
-Version: 2.1.1
+Version: 2.1.2
 Summary: Professional client for interacting with the School App API
 Author: Aferiad Kamal
 License: MIT