librus-python-api 1.0.1__tar.gz → 1.0.3__tar.gz

{librus_python_api-1.0.1 → librus_python_api-1.0.3}/API.md

@@ -112,7 +112,7 @@ refunded. Exhaustion raises `LimitError`; deadlines raise `OperationTimeoutError
 
 ## Configuration
 
-- `SchedulerLimits`: 5 requests/second, burst 10, 2 active requests, 1 per
+- `SchedulerLimits`: 10 requests/second, burst 20, 4 active requests, 1 per
   account, 32 queued (8 per account), 16 accounts, 32 concurrent operations
   (8 per account). These are engineering defaults, not a published Librus quota.
 - `TransportLimits`: 30 s request and 10 s connect timeouts, 4 MiB bodies, 10

{librus_python_api-1.0.1 → librus_python_api-1.0.3}/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 1.0.3 (2026-10-06) - Notification counts for parent logins
+
+Compatible patch release. The public library API is unchanged.
+
+- Read `notification_counts()` from the information page (`/informacja`), which
+  every login can open, instead of the student landing route `/uczen/index`.
+  That route returned 403 for a parent login in a live check, and the session
+  was unusable afterwards. The counters come from the menu shared by every
+  page, so the result is unchanged for student logins. The read is now
+  retry-safe: a proven session expiry is recovered once.
+- Count the modern messages launcher link (`/wiadomosci3`) as the messages
+  category. Before, schools linking it showed no messages counter.
+- Keep `/uczen/index` only as an accepted login redirect target. It is never
+  requested directly.
+
+## 1.0.2 (2026-10-06) - Faster shared request policy
+
+Compatible patch release. The public library API is unchanged.
+
+- Raise the default `SchedulerLimits` to 10 requests/second, a shared burst of
+  20 and four simultaneous requests across the service (from 5, 10 and 2).
+  Each login still runs one request at a time, queue limits are unchanged, and
+  429/503 responses still pause all traffic and resume without a burst. Measured
+  with the MCP consumer on four logins, the earlier policy made real workloads
+  about 35% slower than the unthrottled apix-based client. Pass explicit lower
+  `SchedulerLimits` where stricter traffic is required.
+
 ## 1.0.1 (2026-10-06) - Bounded subject frequency and reliability fixes
 
 Compatible patch release. The public library API is unchanged.

{librus_python_api-1.0.1 → librus_python_api-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: librus-python-api
-Version: 1.0.1
+Version: 1.0.3
 Summary: Independent bounded async Librus Synergia client
 Project-URL: Repository, https://github.com/krzysztofbury/librus-python-api
 Project-URL: Issues, https://github.com/krzysztofbury/librus-python-api/issues
@@ -51,7 +51,7 @@ See [limitations](#supported-features-and-limitations) below.
 Install the exact release from PyPI after its gated publication completes:
 
 ```sh
-python -m pip install librus-python-api==1.0.1
+python -m pip install librus-python-api==1.0.3
 ```
 
 Pin the exact version qualified by your application. Before publication, use a
@@ -67,7 +67,7 @@ python -m pip install .
 To install a locally built wheel instead:
 
 ```sh
-python -m pip install ./dist/librus_python_api-1.0.1-py3-none-any.whl
+python -m pip install ./dist/librus_python_api-1.0.3-py3-none-any.whl
 ```
 
 No CLI or background process is installed: import the library in your own program.
@@ -183,7 +183,8 @@ except LibrusError as error:
 ```
 
 A budget covers login, queueing and all pages of an operation. Defaults allow
-5 requests/second, a burst of 10 and two simultaneous requests across the service.
+10 requests/second, a burst of 20 and four simultaneous requests across the
+service, with one at a time per login.
 Fresh reads are the default. Unsupported layouts raise typed errors rather than
 silently returning incomplete data. Cursors detect changes; they are not snapshots.
 

{librus_python_api-1.0.1 → librus_python_api-1.0.3}/README.md

@@ -25,7 +25,7 @@ See [limitations](#supported-features-and-limitations) below.
 Install the exact release from PyPI after its gated publication completes:
 
 ```sh
-python -m pip install librus-python-api==1.0.1
+python -m pip install librus-python-api==1.0.3
 ```
 
 Pin the exact version qualified by your application. Before publication, use a
@@ -41,7 +41,7 @@ python -m pip install .
 To install a locally built wheel instead:
 
 ```sh
-python -m pip install ./dist/librus_python_api-1.0.1-py3-none-any.whl
+python -m pip install ./dist/librus_python_api-1.0.3-py3-none-any.whl
 ```
 
 No CLI or background process is installed: import the library in your own program.
@@ -157,7 +157,8 @@ except LibrusError as error:
 ```
 
 A budget covers login, queueing and all pages of an operation. Defaults allow
-5 requests/second, a burst of 10 and two simultaneous requests across the service.
+10 requests/second, a burst of 20 and four simultaneous requests across the
+service, with one at a time per login.
 Fresh reads are the default. Unsupported layouts raise typed errors rather than
 silently returning incomplete data. Cursors detect changes; they are not snapshots.
 

{librus_python_api-1.0.1 → librus_python_api-1.0.3}/src/librus_python_api/__init__.py

@@ -120,7 +120,7 @@ from librus_python_api.models import (
 from librus_python_api.sending import SendAttempt
 from librus_python_api.service import AccountClient, LibrusService
 
-__version__ = "1.0.1"
+__version__ = "1.0.3"
 
 __all__ = [
     "AccountContext",

{librus_python_api-1.0.1 → librus_python_api-1.0.3}/src/librus_python_api/config.py

@@ -337,8 +337,10 @@ ENDPOINTS: Mapping[str, Endpoint] = MappingProxyType(
                 False,
                 Evidence.SYNTHETIC_ONLY,
             ),
+            # Accepted only as a redirect target during login. Never requested
+            # directly: it answers parent logins with 403.
             Endpoint(
-                "notification_counts",
+                "login_student_landing",
                 "GET",
                 "/uczen/index",
                 SideEffect.AUTHENTICATION,
@@ -695,6 +697,10 @@ CHECKPOINT_TIMEOUT_SECONDS = 5.0
 CHECKPOINT_MAX_TIMEOUT_SECONDS = 30.0
 SCHEDULE_RESPONSE_VERSION = 1
 SCHEDULE_MAX_EVENTS = 1024
+# Every Synergia page carries the counter menu. The information page is
+# readable by student and parent logins alike; the student landing route
+# (/uczen/index) answers parent logins with 403 and is not used.
+NOTIFICATION_COUNTS_ENDPOINT = "student_information"
 NOTIFICATION_MAX_MENU_ITEMS = 64
 NOTIFICATION_MAX_COUNT = 1000000
 NOTIFICATION_DESTINATIONS = MappingProxyType(
@@ -702,6 +708,7 @@ NOTIFICATION_DESTINATIONS = MappingProxyType(
         "/przegladaj_oceny/uczen": "grades",
         "/przegladaj_nb/uczen": "attendance",
         "/wiadomosci": "messages",
+        "/wiadomosci3": "messages",
         "/ogloszenia": "announcements",
         "/terminarz": "agenda",
         "/moje_zadania": "homework",
@@ -1284,13 +1291,14 @@ class SchedulerLimits(_ValidatedConfig):
     Queue limits count waiting requests, separately from active requests. Rate
     tokens count every admitted attempt, including future auth/redirect/retry
     requests. Parent and student logins each occupy their own account slot.
-    A shared ten-token burst accommodates sequential cold-login hops; refill at
-    five tokens/second bounds sustained traffic without one-second hop delays.
+    A shared twenty-token burst accommodates two concurrent cold-login chains;
+    refill at ten tokens/second bounds sustained traffic across all accounts.
+    One active request per account keeps each login's session state sequential.
     """
 
-    requests_per_second: PositiveFinite = 5.0
-    burst: PositiveCount = 10
-    active_requests: PositiveCount = 2
+    requests_per_second: PositiveFinite = 10.0
+    burst: PositiveCount = 20
+    active_requests: PositiveCount = 4
     active_requests_per_account: PositiveCount = 1
     queued_requests: QueueCount = 32
     queued_requests_per_account: QueueCount = 8

{librus_python_api-1.0.1 → librus_python_api-1.0.3}/src/librus_python_api/service.py

@@ -42,6 +42,7 @@ from librus_python_api.config import (
     GRADE_MAX_WINDOW_DAYS,
     MESSAGE_MAX_CURSOR_IDS,
     MODERN_RECIPIENT_OPERATIONS,
+    NOTIFICATION_COUNTS_ENDPOINT,
     SCHEDULE_RESPONSE_VERSION,
     SESSION_COOKIE,
     AccountCredentials,
@@ -816,7 +817,7 @@ class AccountClient:
 
         async def fetch(budget: RequestBudget, _: bool) -> NotificationCounts:
             items = await self._page(
-                "notification_counts", budget, parse_notification_counts
+                NOTIFICATION_COUNTS_ENDPOINT, budget, parse_notification_counts
             )
             return NotificationCounts(
                 self._session_identity(),
@@ -825,7 +826,11 @@ class AccountClient:
             )
 
         return await self._read(
-            ("notification_counts",), fetch, budget, max_age_seconds
+            ("notification_counts",),
+            fetch,
+            budget,
+            max_age_seconds,
+            endpoint=NOTIFICATION_COUNTS_ENDPOINT,
         )
 
     async def consume_schedule_events(