Commit Graph

48 Commits

Author SHA1 Message Date
Georg Brandl fe792444b7 Fix typo. 2009-01-22 08:36:39 +00:00
Benjamin Peterson 4cbb07b2a1 add a note about constant conventions 2009-01-22 03:33:57 +00:00
Guido van Rossum b4c0b18633 Clarify preferred way to break at a binary operator. 2008-06-06 18:48:49 +00:00
Skip Montanaro fe647edb10 Replace "looks ugly" with a hopefully more concrete explanation of why line
wrapping is bad - it disrupts the visual structure of the code.
2008-02-21 16:21:15 +00:00
Brett Cannon 9fe45a32c3 Make all meta-PEPs be Process PEPs. 2007-06-19 04:52:34 +00:00
Collin Winter 28930199da Convert two usages of StandardError into Exception. 2007-06-12 21:19:21 +00:00
Guido van Rossum 65d78ad8f2 Add policy about non-ASCII names to coding standard. 2007-05-17 16:48:09 +00:00
Andrew M. Kuchling 532382f5dc Fix 'the the' error 2007-04-28 00:36:48 +00:00
Guido van Rossum 38fbef2fb2 Add words discouraging overly-broad except clauses. 2007-04-06 15:09:21 +00:00
Andrew M. Kuchling a2a12a86ea Mention bare except: clauses in PEP 8; see the python-dev archive around Dec. 22 2007 for a short discussion 2007-02-01 21:09:28 +00:00
Andrew M. Kuchling 594770c5ec Wording fix 2007-02-01 21:04:19 +00:00
Andrew M. Kuchling 3be6bcdbc7 Be stricter about string exceptions 2007-02-01 21:03:07 +00:00
Barry Warsaw 4226413f7b Updated the rules for package names and module names, clarifying the use of
underscores.
2007-01-05 14:03:42 +00:00
David Goodger c5b5d3c83d added Last-Modified headers to all PEPs without 2006-03-23 20:13:19 +00:00
Guido van Rossum d9909922de Fix an inconsistency about whether 'cls' is preferred or not. 2006-03-23 18:56:43 +00:00
Guido van Rossum 8adb36ab81 Discourage relative imports. 2006-03-15 22:47:10 +00:00
Guido van Rossum 9feffcd8af /pubic/public/. Thanks Jennings Jared! 2006-03-02 03:46:55 +00:00
Barry Warsaw 9d3a63d38d Remove a bunch of Emacs references. They're unnecessary for making the point. 2005-12-15 15:44:35 +00:00
Barry Warsaw 1bd889d78c Fixed a couple of small tyops. 2005-12-14 22:54:57 +00:00
Guido van Rossum b7714412f7 Some additional tweakage, hopefully non-controversial. 2005-12-14 22:10:16 +00:00
Barry Warsaw 478d6d498e After lengthy discussion on python-dev, here is an update to the Python style
guide.  Hopefully it has been simplified and made more prescriptive, as well
as improved by all the great community suggestions.
2005-12-14 21:12:58 +00:00
David Goodger 7b245bb06d fixed raise syntax examples; closing http://python.org/sf/1264666 2005-08-20 13:48:50 +00:00
Andrew M. Kuchling ac8c835cce Record BDFL opinion on exception-raising style 2005-08-07 13:27:54 +00:00
Raymond Hettinger dec5ab7a7c SF patch #980695: efficient string concatenation
(Original patch by Armin Rigo).
2004-08-06 18:47:26 +00:00
Kurt B. Kaiser 9c67b23e5a Clarifications resulting from further discussion with Barry Warsaw. 2004-03-30 01:12:22 +00:00
Barry Warsaw e13d881fb8 updated a link 2004-03-27 20:37:02 +00:00
Barry Warsaw bae8037025 A few more minor updates for the Naming Conventions section:
- recommend that all new libraries use the standards, but point out that
  internal consistency with existing standards is more important.

- Use b and B instead of x and X (it's hard to distinguish the case of X in
  some fonts)

- StudlyCaps is another name for CapWords

- Re-order list so Function Names are followed by Method Names.  Also, added a
  few blank lines in the Method Names section, and described how underscores
  should separate words for readability.

- Added that double leading underscore is usually only necessary to resolve
  name conflicts in subclasses.
2004-03-27 20:14:19 +00:00
Kurt B. Kaiser fef61c2a39 Patch 919256
Clarify and standardize the format for names of modules, functions,
methods, and instance variables.

Consistent, I hope, with discussion on python-dev

http://mail.python.org/pipermail/python-dev/2004-March/043257.html

http://mail.python.org/pipermail/python-dev/2004-March/043259.html
2004-03-20 06:42:29 +00:00
Raymond Hettinger a37771e3cb * str.startwith() is less errorprone that slice comparisons but not as fast.
* Fix minor typos.
2003-09-27 02:53:59 +00:00
Barry Warsaw 99ab3d4e0c Setting my address back to barry@python.org for consistency and better
spam fighting defenses.
2003-09-22 04:51:50 +00:00
Barry Warsaw 8e4c8019b1 Added a note on compound statements after remarks from David Goodger.
Make the code samples agree with this recommendation. ;)
2002-10-17 15:32:18 +00:00
Guido van Rossum 36a82afee6 Add ruling about source code encodings. 2002-10-07 13:40:41 +00:00
Fred Drake d5b900cf13 Fix a couple of import statements. 2002-06-22 02:14:49 +00:00
Guido van Rossum 6655f152be Don't use 'strorunicodeobj' as the generic object name. Use just
'obj' -- after all, you don't know that it's a string or unicode
object just yet, that's what the test in these examples is for!
2002-06-04 17:02:07 +00:00
Neal Norwitz 22cf1a49f9 Update for all the various ways of checking for a string/unicode object
in 2.3, 2.2, 2.1/2.0.
2002-06-04 16:57:44 +00:00
Barry Warsaw 842de4b458 Slight change to the string methods recommendation; we mitigate the
recommendation if compatibility with pre-Python 2.0 is necessary.
2002-05-29 16:07:27 +00:00
Guido van Rossum 78c759d636 Two tiny clarifications. 2002-05-24 19:46:20 +00:00
Andrew M. Kuchling 74d28aabb3 Typo fix 2002-05-24 19:42:30 +00:00
Barry Warsaw a086f6d04f More additions based on comments from Tim Peters, Neal Norwitz,
Gerhard Haring, and Guido van Rossum.
2002-05-24 19:39:47 +00:00
Barry Warsaw 7c91cd266a Added Tim's names to avoid (with the addition of cap-I which looks
like an `l' in some fonts).
2002-05-24 17:07:17 +00:00
Barry Warsaw d5a7731ccf Integrated style recommendations from my (Barry's) mimelib/Mailman
style guide.  Only added recommendations that Guido agrees with. :)
2002-05-24 16:22:16 +00:00
Guido van Rossum 7112960b46 Minor nits. Add strong preference for spaces over tabs. 2002-05-24 15:01:43 +00:00
Barry Warsaw bd48c56a75 Roger <roger.haase@usa.net> points out that "mixed case" is
inconsistently used both to describe mixedCase and MixedCase.
MixedCase should really be CapWords, reserving mixedCase for the
situation where the first letter is lowercased.

Also, add a comment that MixedCase is sometimes called CamelCase.
Note that the existing most common case usage is that CamelCase has an
initial capitalized letter.

http://www.wikipedia.com/wiki/CamelCase
2001-12-21 05:49:26 +00:00
Guido van Rossum 5b12f72b7d Apply Strunk & White. (Paul Flowerman.) 2001-11-01 13:03:30 +00:00
Barry Warsaw 295e210393 barry@digicool.com => barry@zope.com 2001-08-14 15:45:26 +00:00
Guido van Rossum 8bee56c3bf Make the section on consistency a separate section, as in the
original.  Close an unmatched parenthesis at the very end.
2001-07-05 20:38:11 +00:00
Barry Warsaw e3eaa92bcf Post it today. 2001-07-05 18:56:34 +00:00
Barry Warsaw 80caa6827f Guido's famous Python Style Guide essay, converted to PEP format,
spellchecked and mildly edited.  It's still as incomplete as the
former.
2001-07-05 18:56:12 +00:00