From 2d7c31f13b10afc12dba9f1eefd228fd21c59c0c Mon Sep 17 00:00:00 2001 From: Titus Date: Tue, 17 Nov 2026 12:26:57 +0100 Subject: [PATCH] draught's docstring says whose reading a lens frame is onlyworlds.com adds the lenses a key starts with to a plain context read only on the key's own Character. The docstring says so and names the lenses a seat's Titles give it. No call changes. Unreleased: it rides the next release. Co-Authored-By: Claude Fable 5.2 --- CHANGELOG.md | 2 ++ src/onlyworlds/http.py | 7 +++++-- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ccc4efa..7b172fa 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,8 @@ The package version runs on its own semver; the schema it is generated from is ` ## Unreleased +- **`draught`'s docstring says whose reading a lens frame is.** Since 17 November 2026 onlyworlds.com adds the lenses a key starts with to a plain context read only when the Character read is the key's own; a read of any other Character holds no `lenses` unless `lens` names one. The docstring says so, and names the lenses a seat's Titles give it beside the ones it chose. No call changes. + ## 0.134.0 (2026-11-17) - **`ApiError.fields_refusal`: everything a read's `fields` list got wrong, in one answer.** A read whose `fields` names fields the type does not have is one 422 with `param` `fields`, as before. Since 17 November 2026 onlyworlds.com names every unknown name in it, where it named only the first: the message lists them, and the error carries `unknown_fields` (each unknown name once, in the order sent), `types_with_field` (for each one another element type has, those types) and `allowed_fields` (the names this type takes). `fields_refusal` returns the three as a dict, as served, so a caller corrects the list in one try; it is `None` for any other error. A list with one unknown name keeps the message it always had, and no code in the package read that message. The npm SDK's `err.fieldsRefusal`, in 4.179.0. diff --git a/src/onlyworlds/http.py b/src/onlyworlds/http.py index 2345b85..cef0546 100644 --- a/src/onlyworlds/http.py +++ b/src/onlyworlds/http.py @@ -1307,8 +1307,11 @@ def draught( ``lenses``, one frame ``{id, name?, rows?, cut?, mail?, skipped?, unreadable?}`` with that lens read for this key's own view. The lens carries its own reach and limit, so ``lens`` beside ``depth`` or ``budget`` is a 422 (``param`` lens); a lens this key cannot see is a 404. With no - ``lens`` and no policy key but ``compact``, keel adds one frame per lens chosen with - ``set_my_lenses``, in order.""" + ``lens`` and no policy key but ``compact``, a read of this key's own Character (the one ``me()`` + names) adds one frame per lens the key starts with, in order: the ones chosen with + ``set_my_lenses``, or for a seat that never chose, the ones its Titles give it. A read of any + other Character adds none of them. A frame is this key's own reading and its own Character's + mail, never the Character's.""" if compact is not None and not isinstance(compact, bool): raise TypeError(f"draught: compact is True or False, not {compact!r}. Nothing was sent.") query = self._query(