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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/API.md +1 -1
  2. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/CHANGELOG.md +12 -0
  3. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/PKG-INFO +5 -4
  4. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/README.md +4 -3
  5. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/__init__.py +1 -1
  6. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/config.py +6 -5
  7. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/.gitignore +0 -0
  8. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/LICENSE +0 -0
  9. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/SECURITY.md +0 -0
  10. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/pyproject.toml +0 -0
  11. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/_notification_bootstrap.py +0 -0
  12. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/_notification_codec.py +0 -0
  13. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/_storage.py +0 -0
  14. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/_windows_filesystem.py +0 -0
  15. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/announcements.py +0 -0
  16. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/attachment_routes.py +0 -0
  17. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/attachments.py +0 -0
  18. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/attendance.py +0 -0
  19. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/attendance_frequency.py +0 -0
  20. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/budget.py +0 -0
  21. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/checkpoint.py +0 -0
  22. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/completed_lessons.py +0 -0
  23. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/detail_fields.py +0 -0
  24. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/diagnostics.py +0 -0
  25. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/exceptions.py +0 -0
  26. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/files.py +0 -0
  27. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/grade_parsers.py +0 -0
  28. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/grade_records.py +0 -0
  29. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/homework_range.py +0 -0
  30. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/lifecycle.py +0 -0
  31. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/markup.py +0 -0
  32. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/message_content.py +0 -0
  33. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/messages.py +0 -0
  34. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/models.py +0 -0
  35. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/modern_body.py +0 -0
  36. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/modern_mailbox.py +0 -0
  37. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/modern_messages.py +0 -0
  38. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/notification_models.py +0 -0
  39. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/notification_persistence.py +0 -0
  40. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/notification_workflow.py +0 -0
  41. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/notifications.py +0 -0
  42. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/parsers.py +0 -0
  43. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/parsing.py +0 -0
  44. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/persistence.py +0 -0
  45. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/py.typed +0 -0
  46. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/recipients.py +0 -0
  47. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/scheduler.py +0 -0
  48. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/school_reads.py +0 -0
  49. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/sending.py +0 -0
  50. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/service.py +0 -0
  51. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/timetable.py +0 -0
  52. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/src/librus_python_api/transport.py +0 -0
  53. {librus_python_api-1.0.1 → librus_python_api-1.0.2}/uv.lock +0 -0
@@ -112,7 +112,7 @@ refunded. Exhaustion raises `LimitError`; deadlines raise `OperationTimeoutError
112
112
 
113
113
  ## Configuration
114
114
 
115
- - `SchedulerLimits`: 5 requests/second, burst 10, 2 active requests, 1 per
115
+ - `SchedulerLimits`: 10 requests/second, burst 20, 4 active requests, 1 per
116
116
  account, 32 queued (8 per account), 16 accounts, 32 concurrent operations
117
117
  (8 per account). These are engineering defaults, not a published Librus quota.
118
118
  - `TransportLimits`: 30 s request and 10 s connect timeouts, 4 MiB bodies, 10
@@ -1,5 +1,17 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.0.2 (2026-10-06) - Faster shared request policy
4
+
5
+ Compatible patch release. The public library API is unchanged.
6
+
7
+ - Raise the default `SchedulerLimits` to 10 requests/second, a shared burst of
8
+ 20 and four simultaneous requests across the service (from 5, 10 and 2).
9
+ Each login still runs one request at a time, queue limits are unchanged, and
10
+ 429/503 responses still pause all traffic and resume without a burst. Measured
11
+ with the MCP consumer on four logins, the earlier policy made real workloads
12
+ about 35% slower than the unthrottled apix-based client. Pass explicit lower
13
+ `SchedulerLimits` where stricter traffic is required.
14
+
3
15
  ## 1.0.1 (2026-10-06) - Bounded subject frequency and reliability fixes
4
16
 
5
17
  Compatible patch release. The public library API is unchanged.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: librus-python-api
3
- Version: 1.0.1
3
+ Version: 1.0.2
4
4
  Summary: Independent bounded async Librus Synergia client
5
5
  Project-URL: Repository, https://github.com/krzysztofbury/librus-python-api
6
6
  Project-URL: Issues, https://github.com/krzysztofbury/librus-python-api/issues
@@ -51,7 +51,7 @@ See [limitations](#supported-features-and-limitations) below.
51
51
  Install the exact release from PyPI after its gated publication completes:
52
52
 
53
53
  ```sh
54
- python -m pip install librus-python-api==1.0.1
54
+ python -m pip install librus-python-api==1.0.2
55
55
  ```
56
56
 
57
57
  Pin the exact version qualified by your application. Before publication, use a
@@ -67,7 +67,7 @@ python -m pip install .
67
67
  To install a locally built wheel instead:
68
68
 
69
69
  ```sh
70
- python -m pip install ./dist/librus_python_api-1.0.1-py3-none-any.whl
70
+ python -m pip install ./dist/librus_python_api-1.0.2-py3-none-any.whl
71
71
  ```
72
72
 
73
73
  No CLI or background process is installed: import the library in your own program.
@@ -183,7 +183,8 @@ except LibrusError as error:
183
183
  ```
184
184
 
185
185
  A budget covers login, queueing and all pages of an operation. Defaults allow
186
- 5 requests/second, a burst of 10 and two simultaneous requests across the service.
186
+ 10 requests/second, a burst of 20 and four simultaneous requests across the
187
+ service, with one at a time per login.
187
188
  Fresh reads are the default. Unsupported layouts raise typed errors rather than
188
189
  silently returning incomplete data. Cursors detect changes; they are not snapshots.
189
190
 
@@ -25,7 +25,7 @@ See [limitations](#supported-features-and-limitations) below.
25
25
  Install the exact release from PyPI after its gated publication completes:
26
26
 
27
27
  ```sh
28
- python -m pip install librus-python-api==1.0.1
28
+ python -m pip install librus-python-api==1.0.2
29
29
  ```
30
30
 
31
31
  Pin the exact version qualified by your application. Before publication, use a
@@ -41,7 +41,7 @@ python -m pip install .
41
41
  To install a locally built wheel instead:
42
42
 
43
43
  ```sh
44
- python -m pip install ./dist/librus_python_api-1.0.1-py3-none-any.whl
44
+ python -m pip install ./dist/librus_python_api-1.0.2-py3-none-any.whl
45
45
  ```
46
46
 
47
47
  No CLI or background process is installed: import the library in your own program.
@@ -157,7 +157,8 @@ except LibrusError as error:
157
157
  ```
158
158
 
159
159
  A budget covers login, queueing and all pages of an operation. Defaults allow
160
- 5 requests/second, a burst of 10 and two simultaneous requests across the service.
160
+ 10 requests/second, a burst of 20 and four simultaneous requests across the
161
+ service, with one at a time per login.
161
162
  Fresh reads are the default. Unsupported layouts raise typed errors rather than
162
163
  silently returning incomplete data. Cursors detect changes; they are not snapshots.
163
164
 
@@ -120,7 +120,7 @@ from librus_python_api.models import (
120
120
  from librus_python_api.sending import SendAttempt
121
121
  from librus_python_api.service import AccountClient, LibrusService
122
122
 
123
- __version__ = "1.0.1"
123
+ __version__ = "1.0.2"
124
124
 
125
125
  __all__ = [
126
126
  "AccountContext",
@@ -1284,13 +1284,14 @@ class SchedulerLimits(_ValidatedConfig):
1284
1284
  Queue limits count waiting requests, separately from active requests. Rate
1285
1285
  tokens count every admitted attempt, including future auth/redirect/retry
1286
1286
  requests. Parent and student logins each occupy their own account slot.
1287
- A shared ten-token burst accommodates sequential cold-login hops; refill at
1288
- five tokens/second bounds sustained traffic without one-second hop delays.
1287
+ A shared twenty-token burst accommodates two concurrent cold-login chains;
1288
+ refill at ten tokens/second bounds sustained traffic across all accounts.
1289
+ One active request per account keeps each login's session state sequential.
1289
1290
  """
1290
1291
 
1291
- requests_per_second: PositiveFinite = 5.0
1292
- burst: PositiveCount = 10
1293
- active_requests: PositiveCount = 2
1292
+ requests_per_second: PositiveFinite = 10.0
1293
+ burst: PositiveCount = 20
1294
+ active_requests: PositiveCount = 4
1294
1295
  active_requests_per_account: PositiveCount = 1
1295
1296
  queued_requests: QueueCount = 32
1296
1297
  queued_requests_per_account: QueueCount = 8