Re: module attributes and docstrings

2015-03-27 Thread Marko Rauhamaa
Steven D'Aprano : > Some people prefer to say "Python has no variables, it has name > bindings". I think that it's better to say that Python's variables are > not *like* C or Pascal variables, rather than invent a distinction > between name bindings and variables. Name bindings are a type of > var

Re: module attributes and docstrings

2015-03-27 Thread Steven D'Aprano
On Thu, 26 Mar 2015 08:48 pm, Mario Figueiredo wrote: > Sorry for the late reply. We experienced a 3 day blackout following > one of the most amazing thunderstorms I've witnessed in my life. Wow. Where abouts are you? Apart from the blackout, did you get through it alright? More below... > On T

Re: module attributes and docstrings

2015-03-26 Thread Chris Angelico
On Thu, Mar 26, 2015 at 8:53 PM, Mario Figueiredo wrote: > However, lambda functions do read well in my mind and I find it hard > to spot where they obscure the code more than a function. So the > explicit vs. implicit part of the argument doesn't translate well with > me. I however agree that a f

Re: module attributes and docstrings

2015-03-26 Thread Mario Figueiredo
On Tue, 24 Mar 2015 15:33:41 -0400, Terry Reedy wrote: > >You have discovered one of advantages of a def statement over a >name=lambda assignment statement. In Python, there is no good reason to >use the latter form and PEP 8 specifically discourages it: "Always use a >def statement instead o

Re: module attributes and docstrings

2015-03-26 Thread Mario Figueiredo
Sorry for the late reply. We experienced a 3 day blackout following one of the most amazing thunderstorms I've witnessed in my life. On Tue, 24 Mar 2015 22:49:49 +1100, Steven D'Aprano wrote: >On Tue, 24 Mar 2015 07:55 pm, Mario Figueiredo wrote: > >> Reading PEP 257 and 258 I got the impression

Re: module attributes and docstrings

2015-03-24 Thread Terry Reedy
On 3/24/2015 4:55 AM, Mario Figueiredo wrote: Reading PEP 257 and 258 I got the impression that I could document module attributes and these would be available in the __doc__ attribute of the object. So things like the one below are something I got used to do, but that don't work after all, as I

Re: module attributes and docstrings

2015-03-24 Thread Steven D'Aprano
On Tue, 24 Mar 2015 07:55 pm, Mario Figueiredo wrote: > Reading PEP 257 and 258 I got the impression that I could document > module attributes and these would be available in the __doc__ > attribute of the object. PEP 258 is rejected, so you can't take that as definitive. PEP 257 has this defini

Re: module attributes and docstrings

2015-03-24 Thread Chris Angelico
On Tue, Mar 24, 2015 at 7:55 PM, Mario Figueiredo wrote: > So things like the one below are something I got used to do, but that > don't work after all, as I learned today: > > value_factory = lambda _, row: row[0] > """Row factory. To be used with single-column queries.""" > > There are o

module attributes and docstrings

2015-03-24 Thread Mario Figueiredo
Reading PEP 257 and 258 I got the impression that I could document module attributes and these would be available in the __doc__ attribute of the object. So things like the one below are something I got used to do, but that don't work after all, as I learned today: value_factory = lambda _, r