Skip to content

google: read named return heads - #191

Merged
rr- merged 2 commits into
mainfrom
rework/56-google-returns
Nov 7, 2026
Merged

rr- merged 2 commits into
mainfrom
rework/56-google-returns

Conversation

@rr-

@rr- rr- commented Nov 7, 2026 •

Copy link
Copy Markdown
Owner

Covers item 9 from the BEHAVIOR.md review for #136: "Returns / Yields hold one item: type: text, name (type): text or just text."

A Google return or yield written as x (int): text used to give no type and no name, and the whole line became its description. Its head now sets return_name and type_name, and composing writes it back the same way. The head has to be one word followed by a type in parentheses, all on one line.

Case diffs: one file, rich.control.Control.move_to_column. Its Returns: lists x (int) and y (int) as though they were args, so the single return now gets the name x and the type int.

Parity against origin/main: 55 of 29184 docstrings differ (case 1, stdlib 0, generated 54). The generated ones contain a named return head.

A Returns or Yields item written as "x (int): text" gave no type and
no name, and kept the whole line as its description. Its head now
gives the return's name and type, as BEHAVIOR.md describes, and
composes back the same.
@rr- rr- self-assigned this Nov 7, 2026
@rr-
rr- merged commit 24c4ade into main Nov 7, 2026
26 checks passed
@rr-
rr- deleted the rework/56-google-returns branch November 7, 2026 10:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant