librus-python-api 1.8.3__py3-none-any.whl → 1.8.4__py3-none-any.whl

librus_python_api/__init__.py

@@ -1,7 +1,7 @@
 """Independent bounded async client. General live compatibility is unqualified."""
 
 # Before the imports: config reads it for the User-Agent.
-__version__ = "1.8.3"
+__version__ = "1.8.4"
 
 from librus_python_api.attachments import AttachmentStream, ModernAttachmentStream
 from librus_python_api.budget import RequestBudget

librus_python_api/config.py

@@ -721,8 +721,12 @@ GRADE_MAX_VALUE_LENGTH = 1024
 GRADE_MERGED_SUBJECTS = frozenset({"Zachowanie"})
 GRADE_INLINE_DETAIL_LABEL = "Ocena"
 # Tooltip fields whose free text may continue on unlabelled lines. A teacher's
-# multi-line grade comment was observed on 2026-10-27.
+# multi-line grade comment was observed on 2026-10-27. A formative mirror's
+# assessment text after `Ocena` also spans lines (2026-11-08, markup.py).
 TOOLTIP_MULTILINE_LABELS = frozenset({"Komentarz"})
+# Labels a tooltip may repeat. A grade correcting two earlier grades lists one
+# `Poprawa oceny` line per corrected grade in the week view (2026-11-08).
+TOOLTIP_REPEATABLE_LABELS = frozenset({"Poprawa oceny"})
 # Tooltip labels observed on grade, attendance and point pages. Diagnostics
 # show only these by name; any other label is masked as teacher-entered text.
 TOOLTIP_LABELS = frozenset(
@@ -744,6 +748,7 @@ TOOLTIP_LABELS = frozenset(
         "Nauczyciel",
         "Obowiązek wyk. zadania",
         "Ocena",
+        "Poprawa oceny",
         "Rodzaj",
         "Suma punktów",
         "Temat zajęć",
@@ -783,8 +788,9 @@ GRADE_PERIOD_HEADERS = MappingProxyType(
         "Ocena roczna": 0,
     }
 )
-# New-schema descriptive grading: the page renders this table with empty
-# semester cells and its script loads the grades from the gateway routes above.
+# New-schema descriptive grading: the page renders this table either with empty
+# `gradesCell` semester cells, which its script fills from the gateway routes
+# above, or with bare semester text, which needs no gateway read.
 DESCRIPTIVE_TABLE_CLASS = "newSchemaGradesByStudentTable"
 DESCRIPTIVE_ROW_CLASS = "studentRow"
 DESCRIPTIVE_DETAILS_ROW_CLASS = "studentGradesDetailsRow"

librus_python_api/grade_records.py

@@ -15,6 +15,7 @@ from librus_python_api.config import (
     GRADE_BODY_PREFIX_COLUMNS,
     GRADE_CURRENT_HEADER,
     GRADE_EMPTY_MARKERS,
+    GRADE_INLINE_DETAIL_LABEL,
     GRADE_MAX_METADATA_LENGTH,
     GRADE_MAX_RECORDS,
     GRADE_MAX_SUBJECTS,
@@ -28,6 +29,7 @@ from librus_python_api.config import (
     GRADE_PUBLICATION_PERIOD_LABELS,
     GRADE_PUBLICATION_TEACHER_LABEL,
     TOOLTIP_LABELS,
+    TOOLTIP_MULTILINE_LABELS,
 )
 from librus_python_api.exceptions import ErrorKind, LibrusError
 from librus_python_api.formative_grades import is_formative_table, read_formative_table
@@ -99,7 +101,16 @@ def _numeric(
     semester: Literal[0, 1, 2],
     kind: GradeKind = GradeKind.CURRENT,
 ) -> NumericGrade:
-    metadata = markup.tooltip_fields(element)
+    if markup.detail_id(element.get("href"), FORMATIVE_DETAIL_PATH_PREFIX) is None:
+        metadata = markup.tooltip_fields(element)
+    else:
+        # A formative mirror's assessment text after `Ocena` is free text that
+        # may span lines and hold colons (observed live 2026-11-08).
+        metadata = markup.tooltip_fields(
+            element,
+            multiline=TOOLTIP_MULTILINE_LABELS | {GRADE_INLINE_DETAIL_LABEL},
+            unknown_multiline=True,
+        )
     counts = metadata.get("Licz do średniej")
     if counts is not None and counts.casefold() not in ("tak", "nie"):
         raise LibrusError(ErrorKind.PARSE)

librus_python_api/inspect_page.py

@@ -31,7 +31,7 @@ NOTICE = (
 
 
 def _grades(body: bytes) -> dict[str, int]:
-    # The all view also checks the new-schema table, as `grades()` does.
+    # Every grade view also checks the new-schema table, as `grades()` does.
     records, table = parse_grade_page(body)
     return {
         "numeric": sum(1 for g in records.numeric if g.point_grade_id is None),

librus_python_api/markup.py

@@ -13,7 +13,9 @@ from librus_python_api.config import (
     GRADE_MAX_COLUMNS,
     GRADE_MAX_METADATA_FIELDS,
     GRADE_MAX_METADATA_LENGTH,
+    TOOLTIP_LABELS,
     TOOLTIP_MULTILINE_LABELS,
+    TOOLTIP_REPEATABLE_LABELS,
     UPSTREAM_ORIGINS,
 )
 from librus_python_api.exceptions import ErrorKind, LibrusError
@@ -82,14 +84,27 @@ def colspan(cell: html.HtmlElement) -> int:
 
 
 def tooltip_fields(
-    element: html.HtmlElement, heading: list[str] | None = None
+    element: html.HtmlElement,
+    heading: list[str] | None = None,
+    *,
+    multiline: frozenset[str] | None = None,
+    unknown_multiline: bool = False,
 ) -> dict[str, str]:
     """Parse a 'Label: value<br>' title attribute into unique labelled fields.
 
     A free-text field may span lines; an unlabelled line after it continues
     its value. Any other unlabelled line is an unknown layout. With `heading`,
     the first line is taken whole, colon included, and appended to it.
+    `multiline` names the free-text labels (default `Komentarz`); with
+    `unknown_multiline`, a field whose label is not a known one (teacher text
+    holding a colon) is free text too, and inside such free text a line
+    starting with a known label is text unless the tooltip's closing run of
+    known-label lines begins there. Otherwise a known label such as `Data`
+    never continues. A repeatable label (`Poprawa oceny`) adds its value as
+    one more line of the same field.
     """
+    if multiline is None:
+        multiline = TOOLTIP_MULTILINE_LABELS
     title = element.get("title", "")
     if len(title) > GRADE_MAX_METADATA_LENGTH:
         raise LibrusError(ErrorKind.LIMIT)
@@ -98,18 +113,34 @@ def tooltip_fields(
     chunks = re.split(r"<br\s*/?>|\n", title, flags=re.I)
     if len(chunks) > GRADE_MAX_METADATA_FIELDS:
         raise LibrusError(ErrorKind.LIMIT)
-    for chunk in chunks:
-        if not chunk.strip():
-            continue
-        rendered = tooltip_line(chunk)
+    lines = [tooltip_line(chunk) for chunk in chunks if chunk.strip()]
+    # Start of the closing run of known-label lines, such as Kategoria, Data.
+    closing = len(lines)
+    while closing and _known_label(lines[closing - 1]):
+        closing -= 1
+    for index, rendered in enumerate(lines):
         if heading is not None and not heading:
             heading.append(rendered)
             continue
         key, separator, value = rendered.partition(":")
         key, value = key.strip(), value.strip()
-        if not separator and last in TOOLTIP_MULTILINE_LABELS:
+        if (
+            last is not None
+            and (
+                last in multiline or (unknown_multiline and last not in TOOLTIP_LABELS)
+            )
+            and (
+                not separator
+                or (unknown_multiline and index < closing and key in TOOLTIP_LABELS)
+            )
+        ):
             result[last] = f"{result[last]}\n{rendered}".strip()
             continue
+        if separator and key in result and key in TOOLTIP_REPEATABLE_LABELS:
+            # Each repeat keeps its value, in order, as one more line.
+            result[key] = f"{result[key]}\n{value}"
+            last = key
+            continue
         if not separator or not key or key in result:
             raise LibrusError(ErrorKind.PARSE)
         result[key] = value
@@ -117,6 +148,11 @@ def tooltip_fields(
     return result
 
 
+def _known_label(line: str) -> bool:
+    key, separator, _ = line.partition(":")
+    return bool(separator) and key.strip() in TOOLTIP_LABELS
+
+
 def tooltip_line(chunk: str) -> str:
     """One tooltip line's text, whitespace normalized."""
     # Tooltips are HTML inside an attribute; parse markup only where present.

librus_python_api/notification_workflow.py

@@ -130,7 +130,8 @@ class NotificationWorkflow:
             if uncertain:
                 raise LibrusError(ErrorKind.CHECKPOINT)
             if not consume:
-                raise LibrusError(ErrorKind.INVALID_INPUT)
+                # Nothing is read before the caller agrees to consume new events.
+                raise LibrusError(ErrorKind.CONSENT_REQUIRED)
         state = await store._io(lambda: store._read_state(context.identifier))
         ordinary = await self._ordinary(categories, window, budget)
         # Validate whole ordinary results and state capacity before consuming.

librus_python_api/service.py

@@ -89,7 +89,6 @@ from librus_python_api.gateway_grades import (
     parse_user_info,
 )
 from librus_python_api.grade_parsers import parse_final_grades
-from librus_python_api.grade_records import parse_grade_records
 from librus_python_api.homework_range import HomeworkAccumulator
 from librus_python_api.lifecycle import join_owned
 from librus_python_api.message_content import parse_message_content, validate_reference
@@ -1084,11 +1083,11 @@ class AccountClient:
         Callback success acknowledges consumer-owned durable storage. Callback
         failure/timeout means acknowledgement unknown, never automatic replay.
         """
-        if (
-            type(allow_consume_events) is not bool
-            or not allow_consume_events
-            or self._consuming_schedule
-        ):
+        if type(allow_consume_events) is not bool:
+            raise LibrusError(ErrorKind.INVALID_INPUT)
+        if not allow_consume_events:
+            raise LibrusError(ErrorKind.CONSENT_REQUIRED)
+        if self._consuming_schedule:
             raise LibrusError(ErrorKind.INVALID_INPUT)
         validate_checkpoint(checkpoint, checkpoint_timeout_seconds)
         self._consuming_schedule = True
@@ -1324,24 +1323,22 @@ class AccountClient:
         """Select a grade view with one view-changing POST.
 
         Changes the selected grade filter, not school records. A cache hit makes
-        no POST. Missing inline weight/count data remains unknown. In the all
-        view, a page with the new-schema descriptive table adds that table's
+        no POST. Missing inline weight/count data remains unknown.
+
+        Every view checks a new-schema descriptive table the same way. Its
+        semester cells either are empty script hooks or hold bare text, which
+        becomes undated summaries with no extra request; any other layout
+        fails the read. Only the all view with empty hooks adds that table's
         grades from the gateway: three more reads, five when there are grades.
-        Other views do not request them.
         """
         form = grade_view_form(view)
 
         async def fetch(budget: RequestBudget, _: bool) -> Grades:
-            if view is not GradeView.ALL:
-                records = await self._page(
-                    "grades", budget, parse_grade_records, form=form
-                )
-            else:
-                records, table = await self._page(
-                    "grades", budget, parse_grade_page, form=form
-                )
-                if table is not None and not table.filled:
-                    records = await self._gateway_descriptive(records, table, budget)
+            records, table = await self._page(
+                "grades", budget, parse_grade_page, form=form
+            )
+            if view is GradeView.ALL and table is not None and not table.filled:
+                records = await self._gateway_descriptive(records, table, budget)
             return Grades(
                 self._session_identity(), records, self._observation("grades"), view
             )

{librus_python_api-1.8.3.dist-info → librus_python_api-1.8.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: librus-python-api
-Version: 1.8.3
+Version: 1.8.4
 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,7 +42,10 @@ 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.8.3` reads behaviour grade symbols, filled descriptive
+**Status:** `1.8.4` reads multi-line formative assessment text and repeated
+corrections in grade tooltips, checks the new-schema grade table in every grade view and reports
+missing calendar-consumption consent as `ConsentRequiredError`.
+`1.8.3` reads behaviour grade symbols, filled descriptive
 grade tables, the "Aktualnie brak ogłoszeń" page and absences excused
 through e-Usprawiedliwienia. `1.8.2` keeps the modern mailbox session across a cancelled read
 or a reached limit and sends its own version in the `User-Agent`. `1.8.1` recovers a session Synergia no longer knows (it answers
@@ -66,7 +69,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.8.3
+python -m pip install librus-python-api==1.8.4
 ```
 
 Pin the exact version qualified by your application. Before publication, use a
@@ -82,7 +85,7 @@ python -m pip install .
 To install a locally built wheel instead:
 
 ```sh
-python -m pip install ./dist/librus_python_api-1.8.3-py3-none-any.whl
+python -m pip install ./dist/librus_python_api-1.8.4-py3-none-any.whl
 ```
 
 No console script or background process is installed: import the library in your

{librus_python_api-1.8.3.dist-info → librus_python_api-1.8.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-librus_python_api/__init__.py,sha256=Ts6HZg9LRMp-MLMbjajwEdNlxVsmW8TnnGKbnzytP1k,6571
+librus_python_api/__init__.py,sha256=A9OaGlvvc-wAqzAp7925LUh9EnmcEx_WncmUXoaZFWU,6571
 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=ngGfBD6K4B6dR4elPYvNRvp40Q-GlrhUsUKqBbYY1KE,10727
-librus_python_api/config.py,sha256=Sz6b5lWllzsKSbCbfGKqN6z-CZfwbCt9MkD2y-OG9CU,62019
+librus_python_api/config.py,sha256=rAZK4YfQbhAftSj56tkLJ52DrrhWHzYoSz-ZdwjKUKM,62420
 librus_python_api/detail_fields.py,sha256=vDDi5sV-e30-42SF0hwAUoldiZ5wvYtb1UlLt03lBHw,1708
 librus_python_api/diagnostics.py,sha256=5YbJB8J8RXMqMTmulcn5mJRF1vpi0Pvx00ETrXn9hUY,19036
 librus_python_api/exceptions.py,sha256=x8_z5UTNmuRINTK4buLYiKdYcFA2w6GZP9ZXOL-OnRU,5531
@@ -20,11 +20,11 @@ librus_python_api/files.py,sha256=pQBsIJyfTOZDz83ZB-5fcd-nPMcxR1HJ155h4zTHmsA,92
 librus_python_api/formative_grades.py,sha256=VykwtGvViZVOJMwPH3Re1RTDCHMr1_m9_xHjZyaXDIQ,6452
 librus_python_api/gateway_grades.py,sha256=uaCCz743aPlymAa6rDfRb0w2JFC2hJ4yis0hbKdqTeM,17663
 librus_python_api/grade_parsers.py,sha256=ROfffkCP8yj5Q708TZdpp0PDTyVmoh6X7m0y2fyJcwg,11202
-librus_python_api/grade_records.py,sha256=IT6A5_09Zu5h03g_p3pHVNepFCMoWag0WIJKg4A9MlQ,24978
+librus_python_api/grade_records.py,sha256=xxQ8HrlIMXPtp8oEd3-TUewBhIIBc6Qu7V9Pu2ASxqk,25472
 librus_python_api/homework_range.py,sha256=erYfvS6PhHU5XhnR6LkiLNy677hGVflY3UAuHOs-YUw,1663
-librus_python_api/inspect_page.py,sha256=W5M21v0DlFw3eaqzwGG6hsI6fkTZVQTwkO2x-NNk4y0,5490
+librus_python_api/inspect_page.py,sha256=zSo9SZVWz2POUWC0mNBnwhgHk5arrEOs3l209cxkPSg,5494
 librus_python_api/lifecycle.py,sha256=XzA5CEdZFo7iL5IMUrawnRvf2m9BFe0OseP-fpQFaAE,856
-librus_python_api/markup.py,sha256=AS0hfJS83lnOUpyfgoNHwUKf8MKBR3WN3p_4aeZ7BOk,6408
+librus_python_api/markup.py,sha256=TzGt8pRed2n--BpxFtLY0eq1wzdOhvKhehS50uPBi1o,7935
 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=IO-SYpqpQeuTej6kqNjBRXDbAbKITRZ1njRUyoEZ8t0,41951
@@ -33,7 +33,7 @@ librus_python_api/modern_mailbox.py,sha256=2jF9UnJZ5AF6dip-GrMcv_z2kSLpp87dIpVeX
 librus_python_api/modern_messages.py,sha256=qt2CXtrxCZQ-jTt0aQCD6ZaPAJQZXf0BxmvacPo9B0w,10653
 librus_python_api/notification_models.py,sha256=4eLTAE9JzHhveoaWtZQwGBolmb87QUP5kOSW7Jjt7J0,4199
 librus_python_api/notification_persistence.py,sha256=8GYPbCVD0AecrC4IUXFkHkhNS-uGXkXzsuKxreTIk9I,49454
-librus_python_api/notification_workflow.py,sha256=MsBJdwn6J1UUGlz3Ldzi7WEBz5Qsama7eGmZvUQj25g,12924
+librus_python_api/notification_workflow.py,sha256=XpWNGWbRsqtpTJinPsw65bjnnEnNpm-qzn0QPxz43Xg,13009
 librus_python_api/notifications.py,sha256=VbA8pqNG_19yYo9y7IqpGRmfEb4qDcvA5gBb1syGJKs,7806
 librus_python_api/parsers.py,sha256=8sdfPsOZYHNYVZ4rwX_de5Y5rPl0umoQPon3uflQFlY,9178
 librus_python_api/parsing.py,sha256=H71srw5yx-RFrAKZFgj-QFX-DIXZmhnGrDTmJhazCB8,1838
@@ -44,10 +44,10 @@ librus_python_api/scheduler.py,sha256=3JplYxqvQdFz3aKXcoQUJHE9s3FPw_xRhQ2CPNLuQm
 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=GaavbI6117fcbVuWDzZXDbbgQUczZXXFVNKEMXsFfaw,103063
+librus_python_api/service.py,sha256=A24_70Doqk0mh9fAOxOUSNMtuPG-7qaDvUMlBSE8Lrw,103073
 librus_python_api/timetable.py,sha256=tX1QK9fQABxzfLaHHqTe8e6rAgdOkCoTOfAHdPwNmLE,9836
 librus_python_api/transport.py,sha256=yF-DnFy4xGYS_RWQ9161b9WJXOlYF8cFRgdjXmVVUIk,34988
-librus_python_api-1.8.3.dist-info/METADATA,sha256=PwGb0FBnKt-moy91gG0veDWgZZzMcEtymgI-BMFU75k,14361
-librus_python_api-1.8.3.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
-librus_python_api-1.8.3.dist-info/licenses/LICENSE,sha256=IuerLb3cnZCsaB23znydjjvKqP-LmSJd3syKa9NGUts,1071
-librus_python_api-1.8.3.dist-info/RECORD,,
+librus_python_api-1.8.4.dist-info/METADATA,sha256=M-xBnjR60MNy2jfQSjQsmwDPnwWUNVnIhaoi8dXRSe4,14586
+librus_python_api-1.8.4.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+librus_python_api-1.8.4.dist-info/licenses/LICENSE,sha256=IuerLb3cnZCsaB23znydjjvKqP-LmSJd3syKa9NGUts,1071
+librus_python_api-1.8.4.dist-info/RECORD,,