librus-python-api 1.8.2__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.2"
+__version__ = "1.8.4"
 
 from librus_python_api.attachments import AttachmentStream, ModernAttachmentStream
 from librus_python_api.budget import RequestBudget

librus_python_api/attendance.py

@@ -11,6 +11,7 @@ from librus_python_api.config import (
     ATTENDANCE_EMPTY_MARKERS,
     ATTENDANCE_MAX_RECORDS,
     ATTENDANCE_SEMESTER_LABELS,
+    ATTENDANCE_TOOLTIP_NOTICES,
     GRADE_MAX_METADATA_LENGTH,
     GRADE_MAX_VALUE_LENGTH,
 )
@@ -29,6 +30,17 @@ def _entry(element: html.HtmlElement, semester: Literal[1, 2]) -> AttendanceReco
     title = element.get("title", "")
     if len(title) > GRADE_MAX_METADATA_LENGTH:
         raise LibrusError(ErrorKind.LIMIT)
+    # A known Librus notice is a whole line of its own; other unlabelled lines
+    # still fail in tooltip_fields.
+    notices: list[tuple[str, str]] = []
+    lines = []
+    for line in re.split(r"<br\s*/?>|\n", title, flags=re.I):
+        notice = ATTENDANCE_TOOLTIP_NOTICES.get(markup.tooltip_line(line))
+        if notice is None or notice in notices:
+            lines.append(line)
+        else:
+            notices.append(notice)
+    title = "<br>".join(lines)
     holder = html.Element("span")
     holder.set("title", re.sub(r"</b>\s*(?=<b[ >])", "</b>\n", title, flags=re.I))
     fields = markup.tooltip_fields(holder)
@@ -57,7 +69,7 @@ def _entry(element: html.HtmlElement, semester: Literal[1, 2]) -> AttendanceReco
         fields.get("Temat zajęć"),
         fields.get("Lekcja"),
         markup.attendance_detail_id(element),
-        tuple(fields.items()),
+        (*fields.items(), *notices),
     )
 
 

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,10 +788,12 @@ 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"
 # Gateway account and student identifiers are opaque strings, unlike every
 # other `{id}` route, which takes a numeric ID.
 DESCRIPTIVE_IDENTIFIER = re.compile(r"[A-Za-z0-9_-]{1,128}")
@@ -838,6 +845,17 @@ ATTENDANCE_SEMESTER_LABELS = MappingProxyType(
     }
 )
 ATTENDANCE_EMPTY_MARKERS = frozenset({"", "-", "Brak nieobecności"})
+# Fixed unlabelled tooltip lines Librus appends to an attendance entry, and the
+# metadata pair each becomes. Observed live on 2026-11-06 on two logins: an
+# absence excused through the e-Usprawiedliwienia module.
+ATTENDANCE_TOOLTIP_NOTICES = MappingProxyType(
+    {
+        "Usprawiedliwienie dodane za pomocą modułu e-Usprawiedliwienia": (
+            "Usprawiedliwienie",
+            "dodane za pomocą modułu e-Usprawiedliwienia",
+        )
+    }
+)
 ATTENDANCE_MAX_RECORDS = 2048
 ATTENDANCE_MAX_WINDOW_DAYS = 371
 # Whole-school gateway collections resolve attendance metadata in two requests.
@@ -849,6 +867,8 @@ ATTENDANCE_DETAIL_PATH_PREFIX = "/przegladaj_nb/szczegoly/"
 FORMATIVE_DETAIL_PATH_PREFIX = "/przegladaj_oceny/szczegoly/ksztaltujace/"
 # Recognition only: behaviour-point detail links are classified, never requested.
 BEHAVIOUR_POINTS_DETAIL_PATH_PREFIX = "/przegladaj_oceny/zachowanie_szczegoly/"
+# Tooltip labels of a behaviour grade symbol entry (#114, synthetic example).
+BEHAVIOUR_GRADE_LABELS = frozenset({"Data wystawienia", "Dodał", "Komentarz"})
 # Recognition only: point-grade detail links are classified, never requested.
 POINT_GRADE_DETAIL_PATH_PREFIX = "/przegladaj_oceny_punktowe/szczegoly/"
 FORMATIVE_HEADERS = (
@@ -916,7 +936,10 @@ ANNOUNCEMENT_LABELS = MappingProxyType(
 ANNOUNCEMENT_EMPTY_CLASSES = frozenset(
     {"container", "border-red", "resizeable", "center"}
 )
-ANNOUNCEMENT_EMPTY_MARKERS = frozenset({"brak ogłoszeń", "nie ma ogłoszeń"})
+# "Aktualnie brak ogłoszeń" reported in #120 on two accounts.
+ANNOUNCEMENT_EMPTY_MARKERS = frozenset(
+    {"brak ogłoszeń", "nie ma ogłoszeń", "aktualnie brak ogłoszeń"}
+)
 TIMETABLE_MAX_PERIODS = 32
 TIMETABLE_MAX_LESSONS_PER_SLOT = 16
 TIMETABLE_MAX_CHANGES_PER_SLOT = 16

librus_python_api/gateway_grades.py

@@ -6,6 +6,11 @@ grades from gateway JSON routes. Routes and field names come from public client
 code and the official page script. One authorized read on 2026-10-28 parsed four
 PartialGrades records on one school; pagination keys are still unknown, so every
 unexpected shape fails instead of producing a partial collection.
+
+Another school renders the same table with plain text in its semester cells and
+no script hooks (#115, from a reporter's synthetic example). The grade record
+parser reads those cells like any descriptive row, so that table needs no
+gateway read.
 """
 
 import re
@@ -20,6 +25,7 @@ from pydantic import BaseModel, ConfigDict, Field, ValidationError, field_valida
 
 from librus_python_api import markup
 from librus_python_api.config import (
+    DESCRIPTIVE_DETAILS_ROW_CLASS,
     DESCRIPTIVE_IDENTIFIER,
     DESCRIPTIVE_MAX_NAME_LENGTH,
     DESCRIPTIVE_MAX_SUBJECTS,
@@ -331,9 +337,13 @@ def parse_gateway_users(body: bytes) -> Mapping[str, str]:
 
 @dataclass(frozen=True, slots=True)
 class DescriptiveTable:
-    """Numeric subject ID to the subject name the grades page shows."""
+    """Numeric subject ID to the subject name the grades page shows.
+
+    A filled table already holds its grades and has no gateway grades.
+    """
 
     subjects: Mapping[int, str] = field(repr=False)
+    filled: bool = False
 
 
 def _classes(element: html.HtmlElement) -> set[str]:
@@ -343,9 +353,11 @@ def _classes(element: html.HtmlElement) -> set[str]:
 def read_descriptive_table(document: html.HtmlElement) -> DescriptiveTable | None:
     """The new-schema subject table, or None when the page has none.
 
-    Its rows hold an expander, the subject and two empty semester cells that
-    the page script fills from the gateway. A cell the page already filled
-    would duplicate the gateway records, so it is an unsupported layout.
+    Its rows hold an expander, the subject and two semester cells. Either
+    every row has empty `gradesCell` cells that the page script fills from
+    the gateway, or every row has plain cells the page filled itself, which
+    `read_grade_records` reads and validates. A script cell the page already
+    filled would duplicate the gateway records, so it is unsupported.
     """
     tables = [
         table
@@ -369,20 +381,33 @@ def read_descriptive_table(document: html.HtmlElement) -> DescriptiveTable | Non
     tables = populated
     subjects: dict[int, str] = {}
     students: set[str | None] = set()
+    layouts: set[bool] = set()
     for row in markup.rows(tables[0]):
         if DESCRIPTIVE_ROW_CLASS not in _classes(row):
             continue
         cells = markup.cells(row)
-        if (
-            len(cells) != 4
-            or not {"micro", "center", "screen-only"} <= _classes(cells[0])
-            or [cell.get("data-semester") for cell in cells[2:]] != ["1", "2"]
-            or not all("gradesCell" in _classes(cell) for cell in cells[2:])
+        if len(cells) != 4 or not {"micro", "center", "screen-only"} <= _classes(
+            cells[0]
+        ):
+            raise LibrusError(ErrorKind.UNSUPPORTED_CAPABILITY)
+        semesters = cells[2:]
+        # A filled cell is bare text: no attributes and no markup, so a renamed
+        # or moved script hook never passes as a filled table.
+        filled = all(
+            not cell.attrib
+            and markup.text(cell)
+            and not any(isinstance(node.tag, str) for node in cell)
+            for cell in semesters
+        )
+        if not filled and (
+            [cell.get("data-semester") for cell in semesters] != ["1", "2"]
+            or not all("gradesCell" in _classes(cell) for cell in semesters)
         ):
             raise LibrusError(ErrorKind.UNSUPPORTED_CAPABILITY)
-        if any(
+        layouts.add(filled)
+        if not filled and any(
             markup.text(cell) or any(isinstance(node.tag, str) for node in cell)
-            for cell in cells[2:]
+            for cell in semesters
         ):
             raise LibrusError(ErrorKind.UNSUPPORTED_CAPABILITY)
         identifier = row.get("data-subject_id", "")
@@ -398,7 +423,15 @@ def read_descriptive_table(document: html.HtmlElement) -> DescriptiveTable | Non
     if len(students) > 1:
         # One page shows one student; rows of several students are unknown.
         raise LibrusError(ErrorKind.PARSE)
-    return DescriptiveTable(MappingProxyType(subjects))
+    if len(layouts) > 1:
+        raise LibrusError(ErrorKind.UNSUPPORTED_CAPABILITY)
+    if layouts == {True} and any(
+        DESCRIPTIVE_DETAILS_ROW_CLASS in _classes(row) for row in markup.rows(tables[0])
+    ):
+        # Detail rows are what the page script fills from the gateway; a filled
+        # table that still has them may also have gateway grades.
+        raise LibrusError(ErrorKind.UNSUPPORTED_CAPABILITY)
+    return DescriptiveTable(MappingProxyType(subjects), layouts == {True})
 
 
 def parse_grade_page(body: bytes) -> tuple[GradeRecords, DescriptiveTable | None]:

librus_python_api/grade_records.py

@@ -8,12 +8,14 @@ from lxml import html
 
 from librus_python_api import markup
 from librus_python_api.config import (
+    BEHAVIOUR_GRADE_LABELS,
     BEHAVIOUR_POINTS_DETAIL_PATH_PREFIX,
     FORMATIVE_DETAIL_PATH_PREFIX,
     GRADE_AVERAGE_HEADERS,
     GRADE_BODY_PREFIX_COLUMNS,
     GRADE_CURRENT_HEADER,
     GRADE_EMPTY_MARKERS,
+    GRADE_INLINE_DETAIL_LABEL,
     GRADE_MAX_METADATA_LENGTH,
     GRADE_MAX_RECORDS,
     GRADE_MAX_SUBJECTS,
@@ -26,6 +28,8 @@ from librus_python_api.config import (
     GRADE_PUBLICATION_DATE_LABEL,
     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
@@ -97,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)
@@ -126,6 +139,51 @@ def _numeric(
     )
 
 
+def _behaviour_grade(
+    element: html.HtmlElement,
+    subject: str,
+    semester: Literal[0, 1, 2],
+    kind: GradeKind = GradeKind.CURRENT,
+) -> NumericGrade:
+    """A behaviour entry with a grade symbol, such as `wz`, instead of points.
+
+    Its tooltip has the point entries' layout: an unlabelled first line, then
+    `Data wystawienia` and `Dodał`. The first line names the entry, as the
+    point category does, so it is the category. `Dodał` stays in metadata. A
+    label with digits, a point entry's range labels or any other label fails.
+    """
+    heading: list[str] = []
+    metadata = markup.tooltip_fields(element, heading)
+    raw = markup.text(element)
+    if (
+        not heading
+        # A labelled first line means the heading is missing.
+        or heading[0].partition(":")[0].strip() in TOOLTIP_LABELS
+        # Symbols carry no digits; points or a range are a point entry.
+        or not raw
+        or re.search(r"[0-9]", raw)
+        or not BEHAVIOUR_GRADE_LABELS >= metadata.keys()
+    ):
+        raise LibrusError(ErrorKind.PARSE)
+    href = element.get("href")
+    if href is not None and len(href) > GRADE_MAX_METADATA_LENGTH:
+        raise LibrusError(ErrorKind.LIMIT)
+    return NumericGrade(
+        subject,
+        raw,
+        markup.civil_date(metadata.get("Data wystawienia")),
+        semester,
+        None,
+        None,
+        heading[0],
+        None,
+        metadata.get("Komentarz"),
+        href,
+        tuple(metadata.items()),
+        kind,
+    )
+
+
 def _descriptive(
     box: html.HtmlElement,
     element: html.HtmlElement,
@@ -284,7 +342,21 @@ def _entries(
         if len(anchors) + len(descriptions) != 1:
             raise LibrusError(ErrorKind.PARSE)
         if anchors:
-            record = _numeric(anchors[0], subject, period, kind)
+            behaviour = (
+                subject in GRADE_MERGED_SUBJECTS
+                and markup.detail_id(
+                    anchors[0].get("href"), BEHAVIOUR_POINTS_DETAIL_PATH_PREFIX
+                )
+                is not None
+            )
+            if behaviour and descriptive:
+                # A descriptive record has no category for the first line.
+                raise LibrusError(ErrorKind.PARSE)
+            record = (
+                _behaviour_grade(anchors[0], subject, period, kind)
+                if behaviour
+                else _numeric(anchors[0], subject, period, kind)
+            )
             if descriptive:
                 href = record.href
                 if href is not None and re.sub(
@@ -540,6 +612,9 @@ def read_grade_records(document: html.HtmlElement) -> GradeRecords:
             _read_numeric_table(table, collection, points=True)
         else:
             for row in markup.rows(table):
+                if markup.in_header(row):
+                    # The new-schema table's column labels, not a subject.
+                    continue
                 cells = markup.cells(row)
                 if _descriptive_row(cells):
                     _read_descriptive_row(cells, collection)

librus_python_api/inspect_page.py

@@ -19,8 +19,8 @@ from librus_python_api import __version__
 from librus_python_api.config import TransportLimits
 from librus_python_api.diagnostics import describe_failure, failure_frames
 from librus_python_api.exceptions import LibrusError
+from librus_python_api.gateway_grades import parse_grade_page
 from librus_python_api.grade_parsers import parse_final_grades
-from librus_python_api.grade_records import parse_grade_records
 from librus_python_api.models import Availability
 from librus_python_api.parsers import parse_profile
 
@@ -31,7 +31,8 @@ NOTICE = (
 
 
 def _grades(body: bytes) -> dict[str, int]:
-    records = parse_grade_records(body)
+    # 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),
         "point": sum(1 for g in records.numeric if g.point_grade_id is not None),
@@ -41,6 +42,8 @@ def _grades(body: bytes) -> dict[str, int]:
         "averages": len(records.averages),
         "point_results": len(records.point_results),
         "formative": len(records.formative),
+        "descriptive_table": int(table is not None),
+        "descriptive_table_filled": int(table is not None and table.filled),
     }
 
 

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
@@ -81,12 +83,28 @@ def colspan(cell: html.HtmlElement) -> int:
     return span
 
 
-def tooltip_fields(element: html.HtmlElement) -> dict[str, str]:
+def tooltip_fields(
+    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.
+    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)
@@ -95,20 +113,34 @@ def tooltip_fields(element: html.HtmlElement) -> dict[str, str]:
     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():
+    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
-        # Tooltips are HTML inside an attribute; parse markup only where present.
-        rendered = (
-            text(parse_html_document(chunk.encode()))
-            if "<" in chunk
-            else " ".join(chunk.split())
-        )
         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
@@ -116,6 +148,19 @@ def tooltip_fields(element: html.HtmlElement) -> dict[str, str]:
     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.
+    if "<" in chunk:
+        return text(parse_html_document(chunk.encode()))
+    return " ".join(chunk.split())
+
+
 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 "")

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
@@ -394,6 +393,18 @@ def _require_dates(*days: date | None, max_days: int | None = None) -> None:
             raise LibrusError(ErrorKind.INVALID_INPUT)
 
 
+def _check_record_count(records: GradeRecords, added: int) -> None:
+    if (
+        len(records.numeric)
+        + len(records.descriptive)
+        + len(records.descriptive_summaries)
+        + len(records.formative)
+        + added
+        > GRADE_MAX_RECORDS
+    ):
+        raise LibrusError(ErrorKind.LIMIT)
+
+
 def _cooldown_due(error: LibrusError) -> bool:
     """A denial, an unrecovered expiry, or a logged-out page that a session
     just signed in also got: signing in again at once cannot help."""
@@ -1072,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
@@ -1312,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:
-                    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
             )
@@ -2508,15 +2517,7 @@ class AccountClient:
             "descriptive_users", budget, parse_gateway_users, content_type=JSON
         )
         added = descriptive_grades(items, subjects, users, table)
-        if (
-            len(records.numeric)
-            + len(records.descriptive)
-            + len(records.descriptive_summaries)
-            + len(records.formative)
-            + len(added)
-            > GRADE_MAX_RECORDS
-        ):
-            raise LibrusError(ErrorKind.LIMIT)
+        _check_record_count(records, len(added))
         return replace(records, descriptive=records.descriptive + added)
 
     async def _metadata_value(

{librus_python_api-1.8.2.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.2
+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,12 @@ 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.2` keeps the modern mailbox session across a cancelled read
+**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
 with a "Brak dostępu" page, not a login redirect), reads the lucky number
 from the page header and summarizes a page that fails as a whole in
@@ -64,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.2
+python -m pip install librus-python-api==1.8.4
 ```
 
 Pin the exact version qualified by your application. Before publication, use a
@@ -80,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.2-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.2.dist-info → librus_python_api-1.8.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-librus_python_api/__init__.py,sha256=CDi6pTko967g3RViVcZCIWhE-Lzof5VN6E4NkQJ4aUU,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
@@ -6,25 +6,25 @@ librus_python_api/_windows_filesystem.py,sha256=pQANIGkYrb4Q75gz5mdr5mqYhM_PFblW
 librus_python_api/announcements.py,sha256=13FoOR1sq7tt9w6aLf0vclcFKDqLUiIYaO5iYD2QVLA,5928
 librus_python_api/attachment_routes.py,sha256=uSg5wCQqHJiphF0KdI0GatQxZr5SLUx6xWQRsl_U4_U,4123
 librus_python_api/attachments.py,sha256=Iq-ERZWc3gYXu6Lcv6womT2EXCc-c1Q7r_Q6VyaCm2E,10818
-librus_python_api/attendance.py,sha256=HeFAfnIUn4N__yp1zr635Dve55S2jmwtkeIy_6mV5B4,6924
+librus_python_api/attendance.py,sha256=Dq2IC8WERO-9x-LZIN5Nl0PTLYmL1Iq7BZtOz6nssOI,7428
 librus_python_api/attendance_frequency.py,sha256=SBhED5zuyRIHWdw4urFyTJYykb6EYB7eL4dU3mif1EY,5309
 librus_python_api/budget.py,sha256=8fvqT7eIxyVX2P2OBG27XsYHk_HbtSS4lzuecYpHtgs,2878
 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=CBMwuuACfrB7TzTVkTP8QAuPz5hv43YOsbto81-uEJc,61248
+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
 librus_python_api/files.py,sha256=pQBsIJyfTOZDz83ZB-5fcd-nPMcxR1HJ155h4zTHmsA,9223
 librus_python_api/formative_grades.py,sha256=VykwtGvViZVOJMwPH3Re1RTDCHMr1_m9_xHjZyaXDIQ,6452
-librus_python_api/gateway_grades.py,sha256=T-G5KN0kpROi6xSGwAUba2qWDGNhg8TeGmQN140iLxc,16163
+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=YltZ_OQLsfxj0nvK8_xTuv8ifMOu2jJBnVn6TTQKzaY,22722
+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=AUm-n2Ewe4cQUnlFnhttcGK5B9shvFde_7t1JF7mEm0,5285
+librus_python_api/inspect_page.py,sha256=zSo9SZVWz2POUWC0mNBnwhgHk5arrEOs3l209cxkPSg,5494
 librus_python_api/lifecycle.py,sha256=XzA5CEdZFo7iL5IMUrawnRvf2m9BFe0OseP-fpQFaAE,856
-librus_python_api/markup.py,sha256=p97ZRPqhGYTEBbzJq_0j4j8AKihgQzJqTv__QUNm8Ws,6084
+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=34o-EQSuERhSHZAme-RDhVznhd_y1-GT0SPfduJ5LoM,102964
+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.2.dist-info/METADATA,sha256=78cqj_uSkFU-4NhnUV0FCj3U8-QmJRK51bvIzIRVask,14202
-librus_python_api-1.8.2.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-librus_python_api-1.8.2.dist-info/licenses/LICENSE,sha256=IuerLb3cnZCsaB23znydjjvKqP-LmSJd3syKa9NGUts,1071
-librus_python_api-1.8.2.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,,

{librus_python_api-1.8.2.dist-info → librus_python_api-1.8.4.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.32.4
+Generator: hatchling 1.33.0
 Root-Is-Purelib: true
 Tag: py3-none-any