Serhiy Storchaka
92c9c6ae14
gh-120345: Fix incorrect use of the :class: role with the "()" suffix (GH-120347)
...
* Remove "()" when refer to a class as a type.
* Use :func: when refer to a callable.
* Fix reference to the datetime.astimezone() method.
2024-06-12 17:23:03 +03:00
Eugene Toder
c0b0c2f201
gh-101860: Expose __name__ on property (GH-101876)
...
Useful for introspection and consistent with functions and other
descriptors.
2024-02-20 17:14:34 +02:00
Raymond Hettinger
acda1757bc
gh-113157: Document and test __get__ for MethodType (gh-115492)
2024-02-20 01:53:25 -06:00
Raymond Hettinger
2aaef56236
Make the title match the content (GH-115702)
2024-02-20 01:51:56 -06:00
Raymond Hettinger
901a971e16
gh-113625: Align object addresses in the Descriptor HowTo Guide ( #113894 )
2024-01-10 17:23:40 +01:00
Alex Waygood
4c5b9c107a
gh-101100: Improve documentation on function attributes ( #112933 )
...
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-12-11 12:00:42 +02:00
Raymond Hettinger
f93a4ef7a9
Descriptor HowTo: Sync the error-messages with the C code. Add tests. (gh-112403)
2023-11-25 16:18:00 -06:00
Raymond Hettinger
d9fc15222e
Remove bogus annotations from the descriptor howto guide ( #112349 )
2023-11-23 15:16:00 -06:00
Nikita Sobolev
f48e669504
gh-111724: Fix doctest `ResourceWarning` in `howto/descriptor.rst` ( #111725 )
...
Close database connection explicitly in test cleanup.
2023-11-04 10:22:19 +01:00
Raymond Hettinger
7f9a99e854
gh-89519: Remove classmethod descriptor chaining, deprecated since 3.11 (gh-110163)
2023-10-27 00:24:56 -05:00
Serhiy Storchaka
983305268e
gh-107298: Fix yet more Sphinx warnings in the C API doc (GH-107345)
2023-07-27 18:44:32 +03:00
Raymond Hettinger
7b134d3e71
Descriptor HowTo: Update to include attributes added in Python 3.10 (GH-103666)
2023-04-22 08:29:40 -05:00
Géry Ogam
2d2e01aa4c
Minor edits to the Descriptor HowTo Guide (GH-24901)
...
Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2022-10-08 20:54:21 -05:00
Raymond Hettinger
6740680b57
GH-95822: Need _PyType_Lookup() in descriptor howto code equivalent. (GH-95967)
2022-08-18 23:56:58 -05:00
Raymond Hettinger
ebaf0945f9
GH-89519: Deprecate classmethod descriptor chaining ( #92379 )
2022-05-06 02:57:53 -05:00
Raymond Hettinger
12a2e41e8a
Improve discussion about how __getattr__ is invoked. (GH-31435)
2022-02-19 23:02:30 -06:00
Alex-Blade
0cb765b2ce
bpo-46730: Add more info to @property AttributeError messages (GH-31311)
...
On `obj.read_only_property = x`, raise `AttributeError: property 'read_only_property' of 'A' object has no setter`.
2022-02-16 02:07:34 -05:00
Piotr Fusik
d05a66339b
no-issue: Fix documentation typos. (GH-30576)
2022-01-20 17:17:15 +09:00
Raymond Hettinger
e34809e1c2
bpo-19072: Classmethod can wrap other classmethod like descriptors (GH-29634)
...
staticmethod() also became callable in Python 3.10.
See: b83861f02
.
2021-11-19 19:43:49 +01:00
Raymond Hettinger
fe24088293
Add more tests. Fix code excerpt. (GH-25549)
2021-04-22 20:02:46 -07:00
Raymond Hettinger
14092b5a4a
bpo-43917: Fix pure python equivalent for classmethod (GH-25544)
...
Reported by Yahor Harunovich.
2021-04-22 17:53:36 -07:00
Raymond Hettinger
c5354c045c
Replace broken example code with correct simpler code. (GH-25162)
...
The open() was missing 'w' to indicate it was in a write-mode.
Even then, the open().close() operation was distracting because
it is an unusual way to "touch" as file. Using os.remove()
instead is simpler and less distracting.
2021-04-03 13:09:01 -07:00
Raymond Hettinger
e4c8895ee5
Add more tests for the descriptor tutorial (GH-25164)
2021-04-03 13:07:52 -07:00
Zackery Spytz
e689cdca3c
bpo-43677: Fix a minor error in Doc/howto/descriptor.rst ( #25123 )
...
It should be PyMethod_Type, not Py_MethodType.
2021-04-01 10:03:33 -07:00
Raymond Hettinger
f00e82f8b8
bpo-43427: Separte the method overview from the static method specifics. (GH-24787)
2021-03-13 13:46:32 -08:00
Raymond Hettinger
755c6e637a
Minor readability improvements. Also note performance impact of __slots__. (GH-24456)
2021-02-04 22:05:42 -08:00
diegoe
a98fe02d73
bpo-43082: Remove redundant 'the' in Descriptor howto (GH-24394)
2021-02-02 19:28:36 -08:00
Yurii Karabas
c56387f80c
bpo-27794: Add `name` attribute to `property` class (GH-23967)
2020-12-30 01:51:24 -08:00
basak
9d09e1719c
Typo: fix inverted sense of statement (GH-23288)
...
Looks like a "not" was inadvertently omitted in commit e6a7ea4
.
Classmethods are useful when data stored in specific instances are *not*
needed.
Automerge-Triggered-By: GH:JulienPalard
2020-11-25 06:12:17 -08:00
Raymond Hettinger
85c84920f5
Add more tests to the descriptor howto guide (GH-23506)
2020-11-25 01:54:24 -08:00
Raymond Hettinger
2d44a6bc4f
Add doctests to the descriptor HowTo (GH-23500)
2020-11-24 20:57:02 -08:00
Raymond Hettinger
ffae93248a
Descriptor HowTo: Improve the fidelity of the member object simulation (GH-23475)
2020-11-23 10:56:59 -08:00
Raymond Hettinger
c272d40e5b
More updates to the descriptor howto guide (GH-23238)
2020-11-15 17:44:28 -08:00
Raymond Hettinger
803187796f
Minor grammar edits for the descriptor howto guide (GH-#23175)
2020-11-06 01:30:17 -08:00
Raymond Hettinger
e9208f0e74
Minor formatting edits to the descriptor howto guide (GH-23092)
2020-11-01 20:15:50 -08:00
Raymond Hettinger
74fa464b81
Add member objects to the descriptor howto guide (GH-23084)
2020-11-01 18:02:37 -08:00
Raymond Hettinger
148c76b27c
Expand and clarify the "Invoking Descriptors" section of the Descriptor HowTo (GH-23078)
2020-11-01 09:10:06 -08:00
Raymond Hettinger
e6a7ea4f2e
Split-out a fourth section in the descriptor HowTo guide (GH-22965)
2020-10-25 07:12:50 -07:00
Raymond Hettinger
4a9c637938
Second round of updates to the descriptor howto guide (GH-22946)
2020-10-24 20:34:39 -07:00
Raymond Hettinger
8e5b0fdce3
bpo-19072: Update descriptor howto for decorator chaining (GH-22934)
2020-10-23 18:37:27 -07:00
Raymond Hettinger
8d3d7314d4
Create a primer section for the descriptor howto guide (GH-22906)
2020-10-23 12:55:39 -07:00
Yonatan Goldschmidt
f6a16e8a82
Remove incorrect mention of method.__class__ in descriptor docs (GH-21665)
2020-07-28 16:56:26 -07:00
Raymond Hettinger
03acba6f1a
bpo-25777: Wording describes a lookup, not a call (GH-15573)
2019-08-28 22:59:43 -07:00
Serhiy Storchaka
e042a4553e
Do not use explicit inheritance from object in the documentation. (GH-13936)
2019-06-10 13:35:52 +03:00
Shubham Aggarwal
abbdd1fc5c
bpo-23984: Improve descriptor documentation (GH-1034)
...
https://bugs.python.org/issue23984
2019-03-19 19:55:55 -07:00
Andrés Delfino
271818fe27
Fix "Python" casing in a few places (GH-9001)
2018-09-14 10:13:09 -07:00
NotAFile
28ea4c2847
switch descriptor howto to return value annotation (GH-7796)
2018-09-10 14:35:38 -07:00
Aaron Hall, MBA
4054b172ab
bpo-26103: Fix inspect.isdatadescriptor() and a data descriptor definition. (GH-1959)
...
Look for '__set__' or '__delete__'.
2018-05-21 02:46:42 +03:00
Raymond Hettinger
0d4497b9ca
bpo-23702: Update Descriptor-HOWTO to reflect the removal of unbound methods ( #3739 )
2017-09-25 01:05:49 -07:00
_ = NaN
b066edfb1b
bpo-30709: Improve code example in Descriptor HowTo doc (GH-2339)
2017-06-22 20:54:35 -07:00