[Python-Dev] Attribute docstrings [was: One-line abstractmethod function?]

2013-12-06 Thread Stephen J. Turnbull
Reply-To set to python-id...@python.org. Terry Reedy writes: > For data attributes, which are usually mutable, it should be attached to > the attribute *concept*, which is represented by the name, rather than > the current but usually changeable value. Values are usually already > document

Re: [Python-Dev] One-line abstractmethod function?

2013-12-06 Thread Terry Reedy
On 12/6/2013 5:46 AM, Steven D'Aprano wrote: On Fri, Dec 06, 2013 at 07:28:57AM +0100, Gregory Salvan wrote: class MyObject(metaclass=ObjectSpec): ''' MyObject doc''' 'attr1 contains something' attr1 = None 'attr2 contains something' attr2 = str 'method1 do someth

[Python-Dev] Summary of Python tracker Issues

2013-12-06 Thread Python tracker
ACTIVITY SUMMARY (2013-11-29 - 2013-12-06) Python tracker at http://bugs.python.org/ To view or respond to any of the issues listed below, click on the issue. Do NOT respond to this message. Issues counts and deltas: open4323 ( +6) closed 27359 (+70) total 31682 (+76) Open issues wit

Re: [Python-Dev] One-line abstractmethod function?

2013-12-06 Thread Guido van Rossum
We might adopt the conventions promoted by the Sphinx autodoc extension: http://sphinx-doc.org/ext/autodoc.html#directive-autofunction Example: class Foo: """Docstring for class Foo.""" #: Doc comment for class attribute Foo.bar. #: It can have multiple lines. bar = 1 flox =

Re: [Python-Dev] One-line abstractmethod function?

2013-12-06 Thread Steven D'Aprano
On Fri, Dec 06, 2013 at 07:28:57AM +0100, Gregory Salvan wrote: > Hi, > maybe a syntax like that can correspond: > > class MyObject(metaclass=ObjectSpec): > ''' MyObject doc''' > 'attr1 contains something' > attr1 = None > 'attr2 contains something' > attr2 = str > 'method1