Add "how to" for the setter Argument Clinic directive by corona10 · Pull Request #1245 · python/devguide · GitHub
Skip to content

Add "how to" for the setter Argument Clinic directive - #1245

Merged
corona10 merged 17 commits into
python:mainfrom
corona10:ac-setter
Dec 13, 2023
Merged

Add "how to" for the setter Argument Clinic directive#1245
corona10 merged 17 commits into
python:mainfrom
corona10:ac-setter

Conversation

@corona10

@corona10 corona10 commented Dec 10, 2023

Copy link
Copy Markdown
Member

Comment thread development-tools/clinic.rst Outdated
Comment thread development-tools/clinic.rst Outdated
Comment thread development-tools/clinic.rst Outdated
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
@corona10
corona10 requested a review from hugovk December 11, 2023 06:50
Comment thread development-tools/clinic.rst Outdated
Comment thread development-tools/clinic.rst Outdated
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
@erlend-aasland

Copy link
Copy Markdown
Contributor

@corona10 corona10 closed this Dec 11, 2023
@corona10 corona10 reopened this Dec 11, 2023
@AlexWaygood

Copy link
Copy Markdown
Member

(I'm travelling right now, but will do my best to review this tomorrow or Wednesday!)

@erlend-aasland erlend-aasland left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I left some suggestions.

Comment thread development-tools/clinic.rst Outdated
Comment thread development-tools/clinic.rst Outdated
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
Comment thread development-tools/clinic.rst Outdated
Comment thread development-tools/clinic.rst Outdated
Comment thread development-tools/clinic.rst Outdated
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
Comment thread development-tools/clinic.rst Outdated
Comment thread development-tools/clinic.rst Outdated
Comment thread development-tools/clinic.rst Outdated
corona10 and others added 2 commits December 13, 2023 10:18
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

@AlexWaygood AlexWaygood left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! Some minor points:

Comment thread development-tools/clinic.rst Outdated
Comment thread development-tools/clinic.rst Outdated
Comment thread development-tools/clinic.rst Outdated
Comment on lines -2040 to -2041

@AlexWaygood AlexWaygood Dec 13, 2023

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure this should be deleted; the Python REPL example at the bottom now has no introduction explaining what it's illustrating

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Okay, I will supplement to the above descriptions.

@corona10 corona10 Dec 13, 2023

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm.. I think that "Getters" and "setters" are C functions defined in a :c:type:`PyGetSetDef` struct that facilitate :py:class:`property`-like access for a class will be enough for understand Python REPL..

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
@corona10
corona10 requested a review from AlexWaygood December 13, 2023 13:46
Comment thread development-tools/clinic.rst Outdated
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Comment thread development-tools/clinic.rst
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

@AlexWaygood AlexWaygood left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@corona10
corona10 merged commit 47d44b3 into python:main Dec 13, 2023
@corona10
corona10 deleted the ac-setter branch December 13, 2023 14:03
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.

5 participants