Skip to content

Create a primer section for the descriptor howto guide #22906

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 33 commits into from
Oct 23, 2020
Merged

Create a primer section for the descriptor howto guide #22906

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
33 commits
Select commit Hold shift + click to select a range
4285090
Simplest example: Return a constant
rhettinger Oct 22, 2020
fc4865a
Add directory size example of a dynamic descriptor
rhettinger Oct 23, 2020
83d7240
Add the managed attributes example
rhettinger Oct 23, 2020
6e1bae3
Add stub sections
rhettinger Oct 23, 2020
5cd1b8d
Fix hardwired value
rhettinger Oct 23, 2020
e8db254
Add the set_name example.
rhettinger Oct 23, 2020
3624731
Add the data validators complete practical example.
rhettinger Oct 23, 2020
dab7c25
Minor touch-ups
rhettinger Oct 23, 2020
95e1513
Add technical section for __set_name__
rhettinger Oct 23, 2020
65a0ab3
Line wrap
rhettinger Oct 23, 2020
8e5f962
Use the @-notation where possible
rhettinger Oct 23, 2020
7f52aee
Modern style uses "cls" instead of "klass"
rhettinger Oct 23, 2020
48329d2
Fix typo
rhettinger Oct 23, 2020
1583c25
Missing colon
rhettinger Oct 23, 2020
45466fc
Note false positive in the suspcious entry extension
rhettinger Oct 23, 2020
31fb230
Note false positive in the suspcious entry extension
rhettinger Oct 23, 2020
58275e7
Note false positive in the suspcious entry extension
rhettinger Oct 23, 2020
80bfd08
Note false positive in the suspcious entry extension
rhettinger Oct 23, 2020
112a272
Fix typos. Minor grammar edits.
rhettinger Oct 23, 2020
1a899c8
Fix method name
rhettinger Oct 23, 2020
b3934e8
Fix SyntaxError and misspelled predicate name
rhettinger Oct 23, 2020
90992bf
Add references to and from the glossary
rhettinger Oct 23, 2020
2599cff
Fix markup
rhettinger Oct 23, 2020
11e790a
Update Doc/howto/descriptor.rst
rhettinger Oct 23, 2020
b0c435c
Minor comment and variable name improvements
rhettinger Oct 23, 2020
0f6df85
Simplify examples. Add closing thoughts section.
rhettinger Oct 23, 2020
1e9482e
Add more section headings
rhettinger Oct 23, 2020
512fa4b
More wordsmithing
rhettinger Oct 23, 2020
0dc5f72
Wrap long lines
rhettinger Oct 23, 2020
10b9cd4
Clarify the motivation and the caller/callee relationship
rhettinger Oct 23, 2020
12b0fa2
Beautify technical tutorial sections
rhettinger Oct 23, 2020
8ca8c77
Move comments of the the code and into the main text
rhettinger Oct 23, 2020
cc22b88
Remove outdated references to Python 2 and new-style classes
rhettinger Oct 23, 2020
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
3 changes: 2 additions & 1 deletion Doc/glossary.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -301,7 +301,8 @@ Glossary
including functions, methods, properties, class methods, static methods,
and reference to super classes.

For more information about descriptors' methods, see :ref:`descriptors`.
For more information about descriptors' methods, see :ref:`descriptors`
or the :ref:`Descriptor How To Guide <descriptorhowto>`.

dictionary
An associative array, where arbitrary keys are mapped to values. The
Expand Down
Loading