python style guide inconsistencies

Terry Reedy tjreedy at udel.edu
Sun Apr 22 17:18:30 EDT 2007


""Martin v. Löwis"" <martin at v.loewis.de> wrote in message 
news:462BBE6F.9000007 at v.loewis.de...
| Darren Dale schrieb:
| > I was just searching for some guidance on how to name packages and 
modules,
| > and discovered some inconsistencies on the www.python.org.
| > http://www.python.org/doc/essays/styleguide.html says "Module names can 
be
| > either MixedCase or lowercase." That page also refers to PEP 8 at
| > http://www.python.org/dev/peps/pep-0008/, which says "Modules should 
have
| > short, all-lowercase names. ... Python packages should also have short,
| > all-lowercase names ...".
| >
| > Which is most up to date? Is this the right place to point out that one 
of
| > those pages needs to be updated?
|
| No - this is better discussed on python-dev.
|
| In any case, there isn't technically a contradiction. Module names
| MUST be either MixedCase or lowercase; they SHOULD be lowercase.
|
| So unfortunately, for tradition, some module names are mixed case
| (such as ConfigParser or StringIO). I can personally accept that as
| a necessary evil, although I would prefer if all modules were
| lower case.

I have the impression that tradition will change in 3.0 and your preference 
realized.
Wrong? or have you not been following?

To OP.  Follow the should rather than the may.

tjr






More information about the Python-list mailing list