Re: Modules & positive surprises

On Mar 27, 8:30 am, Jan Danielsson <jan.m.daniels...@xxxxxxxxx> wrote:
Hello all,

<IMHO>

Although I have encountered many modules that have impressed me with
regards to what they can actually do -- too be perfectly honest, it's
very rare that I become impressed by the _interfaces_ to the modules.

Using a new module is normally, with my - admittedly - limited
experience, a pain. It's not just about reading the reference material,
and then just use it. You have to figure out how the developer who wrote
the module was thinking. Often there's a (more or less) natural way to
do things, and unfortunately that's not how module developers do it.
It's not a major issue to me personally, since the important part is
that the module can perform its function.

But then there are a few modules that I just love to use, because
they are so "clean" from interface to function. Among them I can't help
mentioning optparse.

Yesterday I found another module which I fell in love with: Python
Cryptography Toolkit (http://www.amk.ca/python/writing/pycrypt/).

It's just so ... elegant, and functional.

</IMHO>

--
Kind regards,
Jan Danielsson

Yeah. I've noticed that myself. There are tons of good modules, but a
lot of the docs are lousy. What's really annoying is that everyone
says that so-and-so is well documented. I love Python, but I wish when
they said some module was well documented, they meant that the docs
were understandable (to n00bs) as well.

Mike

.

Relevant Pages

  • Modules & positive surprises
    ... regards to what they can actually do -- too be perfectly honest, ... very rare that I become impressed by the _interfaces_ to the modules. ... and unfortunately that's not how module developers do it. ...
    (comp.lang.python)
  • Re: sync dirs
    ... I've used that several times with great satisfaction, and it's fairly low-end - all you need is an FTP server at the other end. ... installer (or, at least, I have it somehow in my Windows Python 2.4, but ... not in my Cygwin Python 2.4. ...
    (comp.lang.python)
  • Re: Interpreter problem
    ... Of course you could just read and write the file in Python in text mode, that might get rid of the returns. ... There's probably a vim mode you can set to display the extraneous characters - it normally screams "^M" at me for files with carriage returns in them. ...
    (comp.lang.python)
  • Re: Success Natively Compiling Python-2.3.4 in Mingw?
    ... > Regards, Fernando ... Hello Fernando, ... check out the pyMinGW patch here: ... Python compiled under MinGW. ...
    (comp.lang.python)
  • Re: is this data structure build-in or Ill have to write my own class?
    ... assert dict.items==a ... structure of Python. ... - maintain the order (for iter and print) ...
    (comp.lang.python)