Bugs item #1207379, was opened at 2005-05-23 22:02
Message generated for change (Settings changed) made by gbrandl
You can respond by visiting:
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1207379&group_id=5470
Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Documentation
Group: None
Status: Open
Resolution: None
Priority: 5
Submitted By: MartinKirst (master_jaf)
>Assigned to: Georg Brandl (gbrandl)
Summary: class property fset not working
Initial Comment:
Classes which are not instantiated from 'object',
containing properties, are not working as expected. The
GET method is working but not the SET method. Tested
with python 2.4.1 und 2.3.5.
See sample code file.
----------------------------------------------------------------------
Comment By: MartinKirst (master_jaf)
Date: 2005-08-21 20:55
Message:
Logged In: YES
user_id=1140154
I agree with rhettinger, that there is no need to put
advanced things like properties in the tutorial.
But I still think, that the property explanation in "Python
Lib. Ref."
could be a bit more precise.
IMHO it's not enough to say "Return a property attribute for
new-style classes..." because it does not prohibit
explicitly the usage in "old style classes".
Suggestion:
"Python Library Reference": Chap. 2.1 Built-in Functions, ex.
property([fget[, fset[, fdel[, doc]]]])
[....]
New in Python 2.2. Properties only can be applied to new style
classes. See also "D. Glossary" -> new style classes for more
details.
----------------------------------------------------------------------
Comment By: Georg Brandl (birkenfeld)
Date: 2005-08-21 14:17
Message:
Logged In: YES
user_id=1188172
What am I to do? Correct the patch and apply, or close this
as Rejected?
----------------------------------------------------------------------
Comment By: Raymond Hettinger (rhettinger)
Date: 2005-08-21 11:35
Message:
Logged In: YES
user_id=80475
Stay close to the definition in the tutorial's glossary:
"""
new-style class
Any class that inherits from object. This includes all
built-in types like list and dict. Only new-style classes
can use Python's newer, versatile features like __slots__,
descriptors, properties, __getattribute__(), class methods,
and static methods.
"""
Also, the 2.2 comment should be in standard form markup:
\versionadded{}
"classes" ==> "class"
Overall, -0 on the update. Ideally, the tutorial should be
kept free of the more advanced concepts like properties,
static methods, descriptors, and whatnot.
----------------------------------------------------------------------
Comment By: Georg Brandl (birkenfeld)
Date: 2005-06-04 10:27
Message:
Logged In: YES
user_id=1188172
Attaching a patch for the Tutorial. It adds the following
sentence:
+Note that with Python 2.2, a new kind of classes was
introduced:
+A class deriving from \class{object} is called a
\emph{new-style class}.
+The differences to classic classes are mostly internal, but
there are
+some features (like properties and static methods) that are
only
+available for new-style classes.
+
----------------------------------------------------------------------
Comment By: MartinKirst (master_jaf)
Date: 2005-05-26 18:59
Message:
Logged In: YES
user_id=1140154
>From my point of view (I'm just learning Python) there is only a
simple difference between old and new style classes, just the
(object) while defining a class.
For sure, we can close this. My questions were answered :-)
So my suggestions for adding info to the documentation:
"Python Tutorial": Chap. 9.3., ex.
With Python 2.2 new style classes were introduced. These new
style classes are inherited from 'object' base class and
supporting
newer features like properties, slots etc.. It is
recommended to use
new style classes.
"Python Library Reference": Chap. 2.1 Built-in Functions, ex.
property([fget[, fset[, fdel[, doc]]]])
[....]
New in Python 2.2. Properties only can applied to new style
classes. See also "D. Glossary" -> new style classes for more
details.
----------------------------------------------------------------------
Comment By: Terry J. Reedy (tjreedy)
Date: 2005-05-26 16:37
Message:
Logged In: YES
user_id=593130
For people who learned Python with old-style classes, it
is 'obvious' that properties are a new addition that came with and
work with new-style classes. Can you suggest specific places in
the docs where clarification could be made? Or should be close
this?
(I suspect that setting is more complicated than getting but would
not have expected even the get method to work.)
----------------------------------------------------------------------
Comment By: MartinKirst (master_jaf)
Date: 2005-05-24 12:27
Message:
Logged In: YES
user_id=1140154
After reading some more documentation I've found at Python
Tutorial "D. Glossary" more hints.
<cite>
Any class that inherits from object. This includes all
built-in types like list and dict. Only new-style classes
can use Python's newer, versatile features like __slots__,
descriptors, properties, __getattribute__(), class methods,
and static methods.
</cite>
Fine. OK, understood..
I'm tending to agree with mwh's opinion, that this is a
documentation bug, although I don't fully understand why the
GET descriptor is working but unlikly not the SET descriptor.
----------------------------------------------------------------------
Comment By: Michael Hudson (mwh)
Date: 2005-05-24 07:58
Message:
Logged In: YES
user_id=6656
At the very limit, this is a documentation bug. Why did you think
properties could be attached to old-style classes?
----------------------------------------------------------------------
You can respond by visiting:
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1207379&group_id=5470
_______________________________________________
Python-bugs-list mailing list
Unsubscribe:
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
