librus-python-api 1.6.0__py3-none-any.whl → 1.6.1__py3-none-any.whl

librus_python_api/__init__.py

@@ -138,7 +138,7 @@ from librus_python_api.models import (
 from librus_python_api.sending import SendAttempt
 from librus_python_api.service import AccountClient, LibrusService
 
-__version__ = "1.6.0"
+__version__ = "1.6.1"
 
 __all__ = [
     "ArchiveAbsences",

librus_python_api/config.py

@@ -860,6 +860,8 @@ HOMEWORK_MARK_DONE_HANDLER = (
     r"\s*showConfirmQuestion\(\s*[0-9]{1,64}\s*,\s*[0-9]{1,64}\s*\);?\s*"
 )
 WEEKDAY_LABELS = ("pon.", "wt.", "śr.", "czw.", "pt.", "sob.", "ndz.")
+# Grade tooltips also use the short Sunday display label.
+CIVIL_DATE_WEEKDAY_LABELS = frozenset((*WEEKDAY_LABELS, "nd."))
 # Observed page-level notices shown instead of the requested content.
 PAGE_NOTICES = MappingProxyType(
     {
@@ -881,6 +883,8 @@ COMPLETED_LESSONS_MAX_PAGE_ITEMS = 256
 COMPLETED_LESSONS_MAX_BATCH_PAGES = 8
 COMPLETED_LESSONS_MAX_BATCH_ITEMS = 256
 AGENDA_DETAIL_PATH_PREFIX = "/terminarz/szczegoly/"
+# Recognition only: closure details are not ordinary agenda-detail references.
+AGENDA_CLOSURE_DETAIL_PATH_PREFIX = "/terminarz/szczegoly_wolne/"
 HOMEWORK_DETAIL_PATH_PREFIX = "/moje_zadania/podglad/"
 MESSAGE_MAX_PAGE_COUNT = 1000
 MESSAGE_MAX_PAGE_ITEMS = 50

librus_python_api/markup.py

@@ -9,11 +9,11 @@ from lxml import etree, html
 
 from librus_python_api.config import (
     ATTENDANCE_DETAIL_PATH_PREFIX,
+    CIVIL_DATE_WEEKDAY_LABELS,
     GRADE_MAX_COLUMNS,
     GRADE_MAX_METADATA_FIELDS,
     GRADE_MAX_METADATA_LENGTH,
     UPSTREAM_ORIGINS,
-    WEEKDAY_LABELS,
 )
 from librus_python_api.exceptions import ErrorKind, LibrusError
 from librus_python_api.parsers import parse_html_document
@@ -109,7 +109,9 @@ def tooltip_fields(element: html.HtmlElement) -> dict[str, str]:
 def civil_date(value: str | None) -> date:
     """An ISO date, optionally followed by its weekday label in parentheses."""
     match = re.fullmatch(r"([0-9]{4}-[0-9]{2}-[0-9]{2})(?: \(([^()]+)\))?", value or "")
-    if match is None or (match[2] is not None and match[2] not in WEEKDAY_LABELS):
+    if match is None or (
+        match[2] is not None and match[2] not in CIVIL_DATE_WEEKDAY_LABELS
+    ):
         raise LibrusError(ErrorKind.PARSE)
     try:
         return date.fromisoformat(match[1])

librus_python_api/school_reads.py

@@ -9,6 +9,7 @@ from lxml import html
 
 from librus_python_api import markup
 from librus_python_api.config import (
+    AGENDA_CLOSURE_DETAIL_PATH_PREFIX,
     AGENDA_DESCRIPTION_LABEL,
     AGENDA_DETAIL_PATH_PREFIX,
     AGENDA_TOOLTIP_LABELS,
@@ -42,13 +43,14 @@ def school_reference(
 ) -> SchoolReference | None:
     """Find the single detail link.
 
-    Agenda cells must not carry any other handler. Homework rows also carry a
-    mark-done button; the library never follows handlers, so it is inert here.
+    Closure handlers stay inert without an ordinary agenda-detail reference.
+    Homework rows also carry a mark-done button; handlers are never followed.
     """
     prefix = (
         AGENDA_DETAIL_PATH_PREFIX if kind == "agenda" else HOMEWORK_DETAIL_PATH_PREFIX
     )
     found: set[str] = set()
+    closure = False
     for node in nodes:
         if not isinstance(node.tag, str):
             continue
@@ -57,6 +59,19 @@ def school_reference(
             raise LibrusError(ErrorKind.LIMIT)
         if not action:
             continue
+        if (
+            kind == "agenda"
+            and node is nodes[0]
+            and node.tag == "td"
+            and re.fullmatch(
+                r"location\.href='"
+                + re.escape(AGENDA_CLOSURE_DETAIL_PATH_PREFIX)
+                + r"[0-9]{1,64}'",
+                action,
+            )
+        ):
+            closure = True
+            continue
         if kind == "homework" and prefix not in action:
             # Only the observed mark-done button is inert; anything else is new.
             if re.fullmatch(HOMEWORK_MARK_DONE_HANDLER, action):
@@ -66,7 +81,7 @@ def school_reference(
         if len(paths) != 1:
             raise LibrusError(ErrorKind.UNSUPPORTED_CAPABILITY)
         found.add(paths[0].removeprefix(prefix))
-    if len(found) > 1:
+    if len(found) > 1 or (closure and found):
         raise LibrusError(ErrorKind.PARSE)
     return SchoolReference(kind, next(iter(found)), account) if found else None
 

{librus_python_api-1.6.0.dist-info → librus_python_api-1.6.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: librus-python-api
-Version: 1.6.0
+Version: 1.6.1
 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
@@ -42,9 +42,9 @@ private ACLs. Windows installations include `pywin32` and `tzdata` automatically
 Network paths, reparse-point paths and unsafe storage permissions fail closed.
 See [platform requirements](contracts/persistence.md#windows-disk-boundary-25).
 
-**Status:** `1.6.0` adds class free days and a typed module-unavailable outcome,
-plus an independent live-check freshness watchdog and targeted mutation/load
-evidence. See [verification](VERIFICATION.md).
+**Status:** `1.6.1` fixes Sunday grade-date labels and calendar closure events.
+Class free days, typed capability outcomes and the live-check freshness watchdog
+remain available. See [verification](VERIFICATION.md).
 The stable 1.x API does not guarantee every school layout. School features depend
 on what each account can access. See the [compatibility policy](API.md#compatibility-policy).
 See [limitations](#supported-features-and-limitations) below.
@@ -54,7 +54,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.6.0
+python -m pip install librus-python-api==1.6.1
 ```
 
 Pin the exact version qualified by your application. Before publication, use a
@@ -70,7 +70,7 @@ python -m pip install .
 To install a locally built wheel instead:
 
 ```sh
-python -m pip install ./dist/librus_python_api-1.6.0-py3-none-any.whl
+python -m pip install ./dist/librus_python_api-1.6.1-py3-none-any.whl
 ```
 
 No CLI or background process is installed: import the library in your own program.

{librus_python_api-1.6.0.dist-info → librus_python_api-1.6.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-librus_python_api/__init__.py,sha256=DhWaUkE_sGZgqB1aWZh5ZUtyjfIeMJl1KhUPV5WpzLA,6513
+librus_python_api/__init__.py,sha256=xKt_-6GBCNzMZZdK3BH_ItqM6TbgoB-4vwhUBjDcsNw,6513
 librus_python_api/_notification_bootstrap.py,sha256=18nzH0doXBNaZXCz-_ckIvRrlHTWV5Mm1t5m2-5eYGI,4669
 librus_python_api/_notification_codec.py,sha256=hU6G3zGJ5fR8wfPC6fV2OqBKs-7XpT9eRnKO3FGsTzY,13451
 librus_python_api/_storage.py,sha256=M_6ZAzN4zs7laOdKJBRH1I2rvy3pgqYgC_MZtsd2xtM,15893
@@ -12,7 +12,7 @@ librus_python_api/budget.py,sha256=8fvqT7eIxyVX2P2OBG27XsYHk_HbtSS4lzuecYpHtgs,2
 librus_python_api/checkpoint.py,sha256=QBmG9GtpyaGRaFq-FXuGA3yR1BjuMFN9V3RTvvi_FNQ,1930
 librus_python_api/class_free_days.py,sha256=IwoCgr-9ZgEYYQ6717s4cDpyFzbosHMzESMabXJLGqA,2422
 librus_python_api/completed_lessons.py,sha256=sR2oLSGb2q1580l-2upCBv9sQfIcHi7CQfWr1K0EFXI,7635
-librus_python_api/config.py,sha256=A5UNZ0oc8Oxt13y0To1REdQLWPgLrH-VRRpcuwodElc,55482
+librus_python_api/config.py,sha256=ZkYxYxBy-FLNMpZSu3U9itHpoyrOCgZSG0dUdWgGGAY,55749
 librus_python_api/detail_fields.py,sha256=K10Stx_ehDTttkUI7-G7a2Ko9exYEu5NJpR-3sBnQ60,1789
 librus_python_api/diagnostics.py,sha256=2l7wq6RA3it-Gwj-JRLcw5qbI37fl3xII6GZA2mZj0o,856
 librus_python_api/exceptions.py,sha256=adVcJuzfB8wGrUlF2SfiyIlE9ZZyTAvGdWRtQIjsA3I,4879
@@ -22,7 +22,7 @@ librus_python_api/grade_parsers.py,sha256=91Kr1-TArzqO-b94ipeIR0a98OV7tRCZQdBWsd
 librus_python_api/grade_records.py,sha256=K0ZzmU1KsA8Jo1MXh30mStApgrigaOKk5ldoBnwRrH8,17901
 librus_python_api/homework_range.py,sha256=erYfvS6PhHU5XhnR6LkiLNy677hGVflY3UAuHOs-YUw,1663
 librus_python_api/lifecycle.py,sha256=XzA5CEdZFo7iL5IMUrawnRvf2m9BFe0OseP-fpQFaAE,856
-librus_python_api/markup.py,sha256=mjCZf6KJTWUz2vjfXbJ4zM17hnev7a5AFIOW3ip3gsE,5677
+librus_python_api/markup.py,sha256=vd483NSUQbVYvSV2IaUmsyGcRhpWtbyDHMeEhbc7siA,5713
 librus_python_api/message_content.py,sha256=v_qoEAoaYS0_9MQBaj57i5XnC7pzv_HHWefgTt4CNyM,9043
 librus_python_api/messages.py,sha256=K9F8XVs1SojfFpdxxLV8gx9E0g81YxEHjigDzLHmDCg,10230
 librus_python_api/models.py,sha256=Z6eV-ftjaN8YGUW8SntVTLjGCqe1EWRpd0P1Va8EwDs,40991
@@ -39,13 +39,13 @@ librus_python_api/persistence.py,sha256=C5oDHQg1Xzy9Jb9obVsRNndCiXps-QQQtQ_M7_l5
 librus_python_api/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 librus_python_api/recipients.py,sha256=6GQCKo-Zjg3VFSg1J8YXcDsy_U3r6-MUS4VCvz0xdaQ,10033
 librus_python_api/scheduler.py,sha256=3JplYxqvQdFz3aKXcoQUJHE9s3FPw_xRhQ2CPNLuQmA,10729
-librus_python_api/school_reads.py,sha256=PCnZ4lv44j-68FgJpQiMteaPSyfhbX8_3CUyE6zhFcQ,14760
+librus_python_api/school_reads.py,sha256=YHta7DmhjS5vSa4Djq8pzp01-2jhVfGOo1Mnc738rV4,15209
 librus_python_api/school_year_archive.py,sha256=D0A1ywMKgoYgvi-d70__SFreMGvMb_72870Akkbb_m8,15492
 librus_python_api/sending.py,sha256=Nvvk2r-6D6Us53a2fH5GW9PcA6bWEfuOvy6c3M5QVcE,4549
 librus_python_api/service.py,sha256=7ioLx-8C-I0Qla8YUyu5UqhjBPlcUvEFpQSYH-9yjzs,96232
 librus_python_api/timetable.py,sha256=tX1QK9fQABxzfLaHHqTe8e6rAgdOkCoTOfAHdPwNmLE,9836
 librus_python_api/transport.py,sha256=QnYXnrv1lW4qToYoTv6HyZw-Lt4rDc-_SMTJpMp6_bc,35297
-librus_python_api-1.6.0.dist-info/METADATA,sha256=O_HfTBq306xfvGOiGLwpWeWdHb2G9m_2c2PN9HmY4VY,11994
-librus_python_api-1.6.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-librus_python_api-1.6.0.dist-info/licenses/LICENSE,sha256=IuerLb3cnZCsaB23znydjjvKqP-LmSJd3syKa9NGUts,1071
-librus_python_api-1.6.0.dist-info/RECORD,,
+librus_python_api-1.6.1.dist-info/METADATA,sha256=rMKHaG2F1BVuZ7gCBUdhmQXT8Ox6wrRSsiyN4UQXqqg,12005
+librus_python_api-1.6.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+librus_python_api-1.6.1.dist-info/licenses/LICENSE,sha256=IuerLb3cnZCsaB23znydjjvKqP-LmSJd3syKa9NGUts,1071
+librus_python_api-1.6.1.dist-info/RECORD,,