Re: [cctbxbb] First svn commit

When I look at a function and do not understand what it does given it's name and list of arguments I look no more and write my own. Always. This is because my believe that if the author of that function did not bother to make the interface clear it says something about quality of the job as a whole (to me at least), and I don't have time to take chances or waste it reading more. Pavel On 4/17/13 11:02 PM, Nathaniel Echols wrote:

...

Also, I would prefer the function arguments to be spelled out explicitly without using *args and **kwds, so that I can figure out what arguments it takes without having to read through the function source code to figure out that internally you are calling self.as_miller_arrays(), and then have to go and look up the function arguments for that. My preference is actually the opposite (I do the same thing quite a bit in my code), because otherwise there is no guarantee that keyword arguments added to add_miller_arrays will also be usable with add_miller_arrays_map. Using *args, **kwds makes the APIs explicitly

On Wed, Apr 17, 2013 at 10:19 PM, Richard Gildea wrote: the same. (That said, I'm increasing favoring using **kwds alone in these circumstances.)

...

My IDE (WingIDE) shows me the function signature in its source assistant and also provides code completion for function arguments and keywords. However these won't be of much use when functions only list *args and **kwds. <insert generic snarky vi advocacy here>

-Nat _______________________________________________ cctbxbb mailing list [email protected] http://phenix-online.org/mailman/listinfo/cctbxbb