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