[Python-checkins] peps (merge default -> default): Merge

guido.van.rossum python-checkins at python.org
Fri Aug 2 17:13:32 CEST 2013


http://hg.python.org/peps/rev/70b79ccd671a
changeset:   5026:70b79ccd671a
parent:      5025:bd8c95ad2054
parent:      5024:3e287c64da51
user:        Guido van Rossum <guido at python.org>
date:        Fri Aug 02 08:13:25 2013 -0700
summary:
  Merge

files:
  pep-0008.txt |  30 +++++++++++++++++-------------
  pep-0432.txt |  29 +++++++++++++++++++++++++++--
  2 files changed, 44 insertions(+), 15 deletions(-)


diff --git a/pep-0008.txt b/pep-0008.txt
--- a/pep-0008.txt
+++ b/pep-0008.txt
@@ -28,6 +28,9 @@
 identified and past conventions are rendered obsolete by changes in
 the language itself.
 
+Many projects have their own coding style guidelines. In the event of any
+conflicts, such project-specific guides take precedence for that project.
+
 
 A Foolish Consistency is the Hobgoblin of Little Minds
 ======================================================
@@ -177,7 +180,7 @@
 
 Some teams strongly prefer a longer line length.  For code maintained
 exclusively or primarily by a team that can reach agreement on this
-issue, it is okay to increase the line nominal line length from 80 to
+issue, it is okay to increase the nominal line length from 80 to
 100 characters (effectively increasing the maximum length to 99
 characters), provided that comments and docstrings are still wrapped
 at 72 characters.  
@@ -210,8 +213,8 @@
         def __init__(self, width, height,
                      color='black', emphasis=None, highlight=0):
             if (width == 0 and height == 0 and
-                color == 'red' and emphasis == 'strong' or
-                highlight > 100):
+                    color == 'red' and emphasis == 'strong' or
+                    highlight > 100):
                 raise ValueError("sorry, you lose")
             if width == 0 and height == 0 and (color == 'red' or
                                                emphasis is None):
@@ -241,18 +244,19 @@
 Note, some editors and web-based code viewers may not recognize
 control-L as a form feed and will show another glyph in its place.
 
-Encodings (PEP 263)
--------------------
+
+Source File Encoding
+--------------------
 
 Code in the core Python distribution should always use UTF-8 (or ASCII
 in Python 2).
 
-Files using ASCII (in Python 2) or UTF-8 (in Python 3) should not have a
-coding cookie.
+Files using ASCII (in Python 2) or UTF-8 (in Python 3) should not have
+an encoding declaration.
 
 In the standard library, non-default encodings should be used only for
 test purposes or when a comment or docstring needs to mention an author
-name that that contains non-ASCII characters; otherwise, using ``\x``,
+name that contains non-ASCII characters; otherwise, using ``\x``,
 ``\u``, ``\U``, or ``\N`` escapes is the preferred way to include
 non-ASCII data in string literals.
 
@@ -309,7 +313,7 @@
 
   However, explicit relative imports are an acceptable alternative to
   absolute imports, especially when dealing with complex package layouts
-  where using absolute imports would be unecessarily verbose::
+  where using absolute imports would be unnecessarily verbose::
 
     from . import sibling
     from .sibling import example
@@ -403,7 +407,7 @@
 
 - If operators with different priorities are used, consider adding
   whitespace around the operators with the lowest priority(ies). Use
-  your own judgement; however, never use more than one space, and
+  your own judgment; however, never use more than one space, and
   always have the same amount of whitespace on both sides of a binary
   operator.
 
@@ -891,8 +895,8 @@
   operator.  However, it is best to implement all six operations so
   that confusion doesn't arise in other contexts.
 
-- Always use a def statement instead of assigning a lambda expression
-  to a name.
+- Always use a def statement instead of an assignment statement that binds
+  a lambda expression directly to a name.
 
   Yes::
 
@@ -923,7 +927,7 @@
   Class naming conventions apply here, although you should add the
   suffix "Error" to your exception classes if the exception is an
   error.  Non-error exceptions that are used for non-local flow control
-  or other forms of signalling need no special suffix.
+  or other forms of signaling need no special suffix.
 
 - Use exception chaining appropriately. In Python 3, "raise X from Y"
   should be used to indicate explicit replacement without losing the
diff --git a/pep-0432.txt b/pep-0432.txt
--- a/pep-0432.txt
+++ b/pep-0432.txt
@@ -3,11 +3,11 @@
 Version: $Revision$
 Last-Modified: $Date$
 Author: Nick Coghlan <ncoghlan at gmail.com>
-Status: Draft
+Status: Deferred
 Type: Standards Track
 Content-Type: text/x-rst
 Created: 28-Dec-2012
-Python-Version: 3.4
+Python-Version: 3.5
 Post-History: 28-Dec-2012, 2-Jan-2013
 
 
@@ -25,6 +25,31 @@
 implementation is developed.
 
 
+PEP Deferral
+============
+
+Python 3.4 is nearing its first alpha, and already includes a couple of
+significant low level changes in PEP 445 (memory allocator customisation)
+and PEP 442 (safe object finalization). As a result of the latter PEP,
+the shutdown procedure of CPython has also been changed to be more heavily
+reliant on the cyclic garbage collector, significantly reducing the
+number of modules that will experience the "module globals set to None"
+behaviour that is used to deliberate break cycles and attempt to releases
+more external resources cleanly.
+
+Furthermore, I am heavily involved in the current round of updates to the
+Python packaging ecosystem (as both the lead author of PEP 426 and
+BDFL-delegate for several other PEPs), leaving little to spare to work on
+this proposal. The other developers I would trust to lead this effort are
+also working on other things.
+
+So, due to those practical resource constraints, the proximity of Python
+3.4 deadlines, and recognition that making too many significant changes to
+the low level CPython infrastructure in one release is likely to be unwise,
+further work on this PEP has been deferred to the Python 3.5 development
+cycle.
+
+
 Proposal
 ========
 

-- 
Repository URL: http://hg.python.org/peps


More information about the Python-checkins mailing list