How to comment constant values?
Chris Rebert
clp2 at rebertia.com
Sun Jul 26 18:06:29 EDT 2009
On Sun, Jul 26, 2009 at 2:49 PM, Erwin Mueller<devent at deventm.org> wrote:
> Hello, I'm new to Python (using it for two months) and I wonder how can I
> comment the const. values with the doc-strings. I.e. if I have code:
>
>>FRACTION_MIN = 1
>>FRACTION_MAX = 10
>>
>>class Fraction(collections.MutableSequence):
>> '''Model a fraction with denominators.
>>
>> It contains one ore more denomintors in a list for quick access.
>> The class is thread save, it uses a lock for all operations.
>> '''
>>
>> def __init__(self):
>> # ...
>
> The class and the methods can have doc-strings, but what about the const.
> values, FRACTION_MIN and FRACTION_MAX?
Only modules, classes, and functions/methods can have docstrings
associated with them.
For anything else, you have to use comments; or you can mention them
in the docstrings of related things.
Cheers,
Chris
--
http://blog.rebertia.com
More information about the Python-list
mailing list