librus-python-api 1.4.0__tar.gz → 1.5.0__tar.gz

{librus_python_api-1.4.0 → librus_python_api-1.5.0}/API.md

@@ -883,12 +883,15 @@ Foreign accounts, arbitrary URLs and injected IDs fail before authentication.
   `Przeczytano` value; it is not inbox unread or per-recipient status.
 - Sent content may omit an `Adresat` field: `correspondent=None` then preserves
   absence rather than inventing a name from another table. `recipient_receipts`
-  holds ordered `MessageRecipientReceipt(recipient, raw_status, read_timestamp)`
-  records when a separate individual receipt table is displayed. Equal labels
+  holds ordered `MessageRecipientReceipt(recipient, raw_status, read_timestamp,
+  recipient_class)` records when a separate individual receipt table is displayed.
+  `recipient_class` (1.5.0) keeps the displayed class label when the table has the
+  middle class column, and is `None` without it or when that cell is empty.
+  Rows of one table must share one layout. Equal labels
   survive; no recipient IDs or aggregate read time are invented. `NIE` has no
   read timestamp; displayed dates retain school civil time. Unknown statuses fail.
   At most 256 receipt rows, 4,096 characters per field and 128 KiB total receipt
-  text are accepted. An absent table means no reported receipts, not zero recipients.
+  text (class labels included) are accepted. An absent table means no reported receipts, not zero recipients.
 - `text` is full plain text with supported block/`br` boundaries and normalized
   whitespace, at most 65,536 characters. No HTML, scripts or external resources
   are returned or fetched. Active body content is unsupported, not executed.

{librus_python_api-1.4.0 → librus_python_api-1.5.0}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 1.5.0 (2026-10-08) - Sent receipts with a recipient class column
+
+Compatible minor release. Existing fields, results and the two-column receipt
+layout are unchanged.
+
+- Read sent-message individual receipt tables that add a middle class-label
+  column (recipient, class, status). Such a sent open previously failed with
+  `UNSUPPORTED_CAPABILITY` (#60).
+- Add `MessageRecipientReceipt.recipient_class` (default `None`, hidden from
+  repr): the displayed class label, or `None` without that column or when its
+  cell is empty. Consumers serializing receipts field by field see one new key.
+- Rows of one receipt table must share one layout; mixed or other widths still
+  fail. Class labels count toward the existing receipt text bounds.
+
 ## 1.4.0 (2026-10-08) - Formative assessments and the observation card
 
 Compatible minor release. Existing fields, results and stored notification

{librus_python_api-1.4.0 → librus_python_api-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: librus-python-api
-Version: 1.4.0
+Version: 1.5.0
 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.4.0` adds formative assessments, including the observation card,
-to grade results. The 1.3.0 archive read passed installed live checks for
-populated and empty archives on two parent logins; see [verification](VERIFICATION.md).
+**Status:** `1.5.0` reads sent-message receipt tables that show a recipient
+class column. `1.4.0` added formative assessments, including the observation
+card, to grade results; 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.4.0
+python -m pip install librus-python-api==1.5.0
 ```
 
 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.4.0-py3-none-any.whl
+python -m pip install ./dist/librus_python_api-1.5.0-py3-none-any.whl
 ```
 
 No CLI or background process is installed: import the library in your own program.

{librus_python_api-1.4.0 → librus_python_api-1.5.0}/README.md

@@ -16,9 +16,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.4.0` adds formative assessments, including the observation card,
-to grade results. The 1.3.0 archive read passed installed live checks for
-populated and empty archives on two parent logins; see [verification](VERIFICATION.md).
+**Status:** `1.5.0` reads sent-message receipt tables that show a recipient
+class column. `1.4.0` added formative assessments, including the observation
+card, to grade results; 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.
@@ -28,7 +28,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.4.0
+python -m pip install librus-python-api==1.5.0
 ```
 
 Pin the exact version qualified by your application. Before publication, use a
@@ -44,7 +44,7 @@ python -m pip install .
 To install a locally built wheel instead:
 
 ```sh
-python -m pip install ./dist/librus_python_api-1.4.0-py3-none-any.whl
+python -m pip install ./dist/librus_python_api-1.5.0-py3-none-any.whl
 ```
 
 No CLI or background process is installed: import the library in your own program.

{librus_python_api-1.4.0 → librus_python_api-1.5.0}/src/librus_python_api/__init__.py

@@ -136,7 +136,7 @@ from librus_python_api.models import (
 from librus_python_api.sending import SendAttempt
 from librus_python_api.service import AccountClient, LibrusService
 
-__version__ = "1.4.0"
+__version__ = "1.5.0"
 
 __all__ = [
     "ArchiveAbsences",

{librus_python_api-1.4.0 → librus_python_api-1.5.0}/src/librus_python_api/message_content.py

@@ -57,26 +57,33 @@ def _recipient_receipts(
         raise LibrusError(ErrorKind.UNSUPPORTED_CAPABILITY)
     result = []
     total = 0
+    # Rows are recipient/status, or recipient/class/status when the page adds
+    # the class-label column; one table never mixes the two.
+    width = len(cells(table_rows[1]))
     for row in table_rows[1:]:
         columns = cells(row)
-        if len(columns) != 2 or any(
-            c.tag != "td"
-            or c.get("colspan", "1") != "1"
-            or c.get("rowspan", "1") != "1"
-            or next(c.iterdescendants("table"), None) is not None
-            for c in columns
+        if (
+            len(columns) != width
+            or width not in (2, 3)
+            or any(
+                c.tag != "td"
+                or c.get("colspan", "1") != "1"
+                or c.get("rowspan", "1") != "1"
+                or next(c.iterdescendants("table"), None) is not None
+                for c in columns
+            )
         ):
             raise LibrusError(ErrorKind.UNSUPPORTED_CAPABILITY)
-        recipient, status = [
-            text(c, MESSAGE_MAX_FIELD_LENGTH, multiline=True) for c in columns
-        ]
+        values = [text(c, MESSAGE_MAX_FIELD_LENGTH, multiline=True) for c in columns]
+        recipient, status = values[0], values[-1]
         if not recipient or not status:
             raise LibrusError(ErrorKind.PARSE)
-        total += len(recipient) + len(status)
+        total += sum(map(len, values))
         if total > MESSAGE_MAX_RECEIPT_TEXT_LENGTH:
             raise LibrusError(ErrorKind.LIMIT)
         stamp = None if status == "NIE" else _timestamp(status)
-        result.append(MessageRecipientReceipt(recipient, status, stamp))
+        label = values[1] if width == 3 and values[1] else None
+        result.append(MessageRecipientReceipt(recipient, status, stamp, label))
     return tuple(result)
 
 

{librus_python_api-1.4.0 → librus_python_api-1.5.0}/src/librus_python_api/models.py

@@ -210,6 +210,8 @@ class MessageRecipientReceipt:
     recipient: str = field(repr=False)
     raw_status: str = field(repr=False)
     read_timestamp: MessageTimestamp | None = field(repr=False)
+    # Displayed class label of the optional middle column; None without it.
+    recipient_class: str | None = field(default=None, repr=False)
 
 
 @dataclass(frozen=True, slots=True)