[Python-checkins] r47177 - python/trunk/Doc/lib/libfuncs.tex
georg.brandl
python-checkins at python.org
Fri Jun 30 20:47:56 CEST 2006
Author: georg.brandl
Date: Fri Jun 30 20:47:56 2006
New Revision: 47177
Modified:
python/trunk/Doc/lib/libfuncs.tex
Log:
Document decorator usage of property.
Modified: python/trunk/Doc/lib/libfuncs.tex
==============================================================================
--- python/trunk/Doc/lib/libfuncs.tex (original)
+++ python/trunk/Doc/lib/libfuncs.tex Fri Jun 30 20:47:56 2006
@@ -789,7 +789,22 @@
If given, \var{doc} will be the docstring of the property attribute.
Otherwise, the property will copy \var{fget}'s docstring (if it
- exists).
+ exists). This makes it possible to create read-only properties
+ easily using \function{property} as a decorator:
+
+\begin{verbatim}
+class Parrot(object):
+ def __init__(self):
+ self.__voltage = 100000
+
+ @property
+ def voltage(self):
+ """Get the current voltage."""
+ return self.__voltage
+\end{verbatim}
+
+ turns the \method{voltage} method into a "getter" for a read-only attribute
+ with the same name.
\versionadded{2.2}
\versionchanged[Use \var{fget}'s docstring if no \var{doc} given]{2.5}
More information about the Python-checkins
mailing list