Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
7 changes: 5 additions & 2 deletions src/onlyworlds/http.py
Original file line number Diff line number Diff line change
Expand Up @@ -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(
Expand Down
Loading