pywebtop 0.0.1__py3-none-any.whl → 0.0.2__py3-none-any.whl

{pywebtop-0.0.1.dist-info → pywebtop-0.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pywebtop
-Version: 0.0.1
+Version: 0.0.2
 Summary: Unofficial async Python API wrapper for Webtop (SmartSchool)
 Home-page: https://github.com/t0mer/pywebtop
 Download-URL: https://pypi.org/project/pywebtop/
@@ -40,6 +40,11 @@ Dynamic: summary
 
 # pywebtop
 
+
+[![PyPI version](https://badge.fury.io/py/pywebtop.svg)](https://badge.fury.io/py/pywebtop)
+[![Python Versions](https://img.shields.io/pypi/pyversions/pywebtop.svg)](https://pypi.org/project/pywebtop/)
+[![License](https://img.shields.io/github/license/t0mer/pywebtop.svg)](https://github.com/t0mer/pywebtop/blob/main/LICENSE)
+
 An unofficial async Python API wrapper for **Webtop** (SmartSchool educational platform). This library provides easy access to Webtop's student portal API endpoints for retrieving grades, homework, schedules, messages, notifications, and more.
 
 ## Features
@@ -52,6 +57,7 @@ An unofficial async Python API wrapper for **Webtop** (SmartSchool educational p
 - 🔔 **Notifications** - Get unread notifications and notification settings
 - 📊 **Discipline Events** - Retrieve behavior/discipline records
 - ⚙️ **Configurable** - Custom base URL, timeout, and auto-login support
+- 👥 **Multi-Student Support** - Discover and switch between siblings/linked accounts
 
 ## Installation
 
@@ -157,6 +163,26 @@ session = await client.login()
 # session.first_name, session.last_name - user names
 ```
 
+#### Managing Multiple Students
+If a parent account is linked to multiple students (e.g., siblings), you can discover and switch between them.
+##### `get_linked_students()`
+Get a list of all students linked to the current account.
+```python
+students = await client.get_linked_students()
+for student in students:
+    print(f"Name: {student.get('studentLogin')}, ID: {student.get('studentId')}")
+```
+
+##### `switch_student()`
+Switch the active session to a specific student. This updates the session context for all subsequent requests.
+
+```python
+# Switch to a student using their ID
+new_session = await client.switch_student(student_id="...")
+print(f"Switched to school: {new_session.school_name}")
+```
+
+
 #### Dashboard & Students
 
 ##### `get_students()`
@@ -414,6 +440,25 @@ except Exception as e:
 
 Authentication is handled automatically via httpx's cookie jar. The token is stored as a cookie and included in all subsequent requests.
 
+### Obtaining the `data` Parameter
+
+The `data` parameter is an encryption key used by the Webtop API. To find your specific `data` value:
+
+1. **Use Browser DevTools:**
+   - Open your browser and navigate to the Webtop login page
+   - Open Developer Tools (F12)
+   - Go to the Network tab
+   - Log in to Webtop
+   - Find the `LoginByUserNameAndPassword` request
+   - Check the request payload - the `Data` field contains your encryption key
+
+2. **Default Value:**
+   - The default value `+Aabe7FAdVluG6Lu+0ibrA==` works for most SmartSchool installations
+   - If login fails, you may need to capture your specific `data` value using the method above
+
+**Note:** The `data` parameter appears to be institution-specific. Once you find the correct value for your school, it should remain constant.
+
+
 ## Configuration
 
 ### Custom Base URL

pywebtop-0.0.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+pywebtop-0.0.2.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+webtop/__init__.py,sha256=7ZxOqQrUn_zGb2ssl6wHwEq5-bC0z7UPzQrODTbHzCs,265
+webtop/client.py,sha256=Ww6Ddum4tap9V__U9AJsq8K6TNUhEUVlTRyJ7prkqOo,18801
+webtop/exceptions.py,sha256=MXCrWO3oCPYvjOi3FRw0hHA5wrt_GECtu4LH1gHrVsU,248
+webtop/models.py,sha256=eeLE6KIWtfirQv2kOpkwY3-XAijjxaLiSPc2MRxC_hU,557
+pywebtop-0.0.2.dist-info/METADATA,sha256=DkElOrbHdcYDswJgpPHwts6dBTWIUG0oKLw01WRmRYU,15022
+pywebtop-0.0.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+pywebtop-0.0.2.dist-info/top_level.txt,sha256=_bDSmWeeECbJ-EVE_vSOQjwJIC-EJkFxNOBDpiBLP1c,7
+pywebtop-0.0.2.dist-info/RECORD,,

{pywebtop-0.0.1.dist-info → pywebtop-0.0.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.10.1)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

webtop/client.py

@@ -162,6 +162,60 @@ class WebtopClient:
         logger.info("Auto-login triggered")
         await self.login()
 
+    async def switch_student(self, student_id: str, saved_user: str = "") -> WebtopSession:
+        """
+        Switch the active student context (e.g. for siblings in different schools).
+        
+        POST /server/api/user/ChangeUser
+        """
+        logger.info(f"Switching to student_id: {student_id[:10]}...")
+        try:
+            resp = await self._http.post(
+                "/server/api/user/ChangeUser",
+                json={
+                    "StudentId": student_id,
+                    "institutionCode": None,
+                    "savedUser": saved_user,
+                    "userType": None
+                },
+            )
+            
+            if resp.status_code >= 400:
+                logger.error(f"Switch student failed: {resp.status_code} {resp.text}")
+                raise WebtopLoginError(f"Switch student failed: {resp.text}")
+
+            data = resp.json()
+            if data.get("status") is not True:
+                 logger.error(f"Switch student returned status=false: {data}")
+                 raise WebtopLoginError(f"Switch student failed: {data}")
+                 
+            new_data = data.get("data")
+            if not new_data:
+                raise WebtopLoginError("Switch student succeeded but returned no data")
+
+            # Update session
+            token = new_data.get("token")
+            # Update cookie if token changed
+            if token:
+                self._http.cookies.set("webToken", token)
+            
+            self._session = WebtopSession(
+                token=token,
+                user_id=new_data.get("userId"),
+                student_id=new_data.get("id"), # Note: response uses 'id', request uses 'StudentId'
+                school_id=new_data.get("schoolId"),
+                school_name=new_data.get("schoolName"),
+                first_name=new_data.get("firstName"),
+                last_name=new_data.get("lastName"),
+                raw_login_data=new_data,
+            )
+            logger.info(f"Switched successfully to: {self._session.first_name} {self._session.last_name}")
+            return self._session
+
+        except Exception as e:
+            logger.error(f"Failed to switch student: {e}")
+            raise
+
     async def request(
         self,
         method: str,
@@ -202,6 +256,31 @@ class WebtopClient:
 
         return resp
 
+    async def get_linked_students(self) -> list[Dict[str, Any]]:
+        """
+        Get all students linked to this account (e.g. siblings in different schools).
+        
+        POST /server/api/user/GetMultipleUsersForUser
+        """
+        logger.info("Fetching linked students...")
+        try:
+            resp = await self.request(
+                "POST", 
+                "/server/api/user/GetMultipleUsersForUser", 
+                json={}
+            )
+            data = resp.json()
+            if data.get("status") is not True:
+                logger.error(f"Failed to get linked students: {data}")
+                raise WebtopRequestError(f"Failed to get linked students: {data}")
+            
+            students = data.get("data", [])
+            logger.info(f"Found {len(students)} linked students")
+            return students
+        except Exception as e:
+            logger.error(f"Failed to get linked students: {e}")
+            raise
+
     # -----------------------------
     # Endpoints
     # -----------------------------
@@ -219,7 +298,18 @@ class WebtopClient:
                 json={},
             )
             data = resp.json()
-            logger.info("Students dashboard fetched successfully")
+            if isinstance(data, dict) and 'data' in data:
+                 # Check if 'data' is the new structure (dict) or old (list)
+                 payload = data['data']
+                 if isinstance(payload, dict):
+                     # New format: It returns a config object. The actual students might be in
+                     # specific apps or the structure completely changed.
+                     # For now, return the raw payload so the user can parse it,
+                     # but log the structure for debugging.
+                     logger.info(f"Dashboard returned dictionary payload with keys: {payload.keys()}")
+                 elif isinstance(payload, list):
+                     logger.info(f"Dashboard returned list of {len(payload)} students")
+            
             return data
         except Exception as e:
             logger.error(f"Failed to get students: {e}")

pywebtop-0.0.1.dist-info/RECORD

@@ -1,9 +0,0 @@
-pywebtop-0.0.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-webtop/__init__.py,sha256=7ZxOqQrUn_zGb2ssl6wHwEq5-bC0z7UPzQrODTbHzCs,265
-webtop/client.py,sha256=sNa4EJCa8PHmJLyRal0dV5pEKC58RuyS9faJ325HEqQ,14897
-webtop/exceptions.py,sha256=MXCrWO3oCPYvjOi3FRw0hHA5wrt_GECtu4LH1gHrVsU,248
-webtop/models.py,sha256=eeLE6KIWtfirQv2kOpkwY3-XAijjxaLiSPc2MRxC_hU,557
-pywebtop-0.0.1.dist-info/METADATA,sha256=YS0czfrTfgbBpj7QtcclUg5Ma7PNRRH1Btt0oJYri8s,13106
-pywebtop-0.0.1.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-pywebtop-0.0.1.dist-info/top_level.txt,sha256=_bDSmWeeECbJ-EVE_vSOQjwJIC-EJkFxNOBDpiBLP1c,7
-pywebtop-0.0.1.dist-info/RECORD,,