Notice: While JavaScript is not essential for this website, your interaction with the content will be limited. Please turn JavaScript on for the full experience.

Incompatibilities between Python 2.1[.x] and 2.2[.x]

<h3>Incompatibilities between Python 2.1[.x] and Python 2.2[.x]</h3>

<p>The following visible differences between Python 2.2 and previous versions are intentional.

<ul>

<p><li>Not listed here are various deprecated modules and features that may issue warnings: the warnings shouldn't affect the correct execution of your program, and they can be disabled with a command line option or programmatically; see the documentation for the warnings module.

<p><li>Also not listed are new constructs that used to be an error (e.g. "key in dict" is now a valid test where formerly it would always raise an exception).

<p><li>The dir() function behaves differently than in Python 2.1 and before. Generally, dir() returns more information than it used to do in 2.1. For example, dir([]) also reports the special methods that overload various operators ('__add__', '__getitem__', '__len__', etc.) as well as '__class__'. For classes (classic as well as new-style), it returns the attributes of the class as well as of the base classes.

<p><li>The special attributes __members__ and __methods__ are no longer supported (for most built-in types). Use the new and improved dir() function instead.

<p><li>type("").__name__ == "str" # was "string"

<p><li>type(0L).__name__ == "long" # was "long int"

<p><li>Overflowing int operations return the corresponding long value rather than raising the OverflowError exception.

<p><li>Conversion of long to float now raises OverflowError if the long is too big to represent as a C double. This used to return an "infinity" value on most platforms.

<p><li> The 3-argument builtin pow() no longer allows a third non-None argument if either of the first two arguments is a float, or if both are of integer types and the second argument is negative (in which latter case the arguments are converted to float, so this is really the same restriction).

<p><li>An old tokenizer bug allowed floating point literals with an incomplete exponent, such as 1e and 3.1e-. Such literals now raise SyntaxError.

<p><li>Nested scopes are standard in 2.2 (they were enabled per module through "from __future__ import nested_scopes" in 2.1[.1]). This may change the meaning of code like the following:

<pre>
def f(<font color="red">str</font>):
def g(x): return <font color="red">str</font>(x) return g

System Message: WARNING/2 (<string>, line 58)

Definition list ends without a blank line; unexpected unindent.

</pre>

In this example, the use of <font color="red">str</font> inside the inner function g() now refers to the argument <font color="red">str</font> in the outer function f(); previously (without nested scopes), it would refer to the built-in function <font color="blue">str</font>.

<p><li>Unbound method objects have their im_class field set differently. In previous versions, the im_class field was set to the class that <i>defined</i> the method. Now it is set to the class that was used to create the method object. For example:

<pre>
class A:
def meth(self): ...
class B(A):
... # doesn't define meth
class C(A):
def meth(self):
B.meth(self) # error, C doesn't inherit from B

System Message: WARNING/2 (<string>, line 79)

Definition list ends without a blank line; unexpected unindent.

</pre>

This code accidentally worked before, even though B is not a base class of C, because B.meth.im_class was set to A, and A is a base class of C! Presumably long ago the inheritance tree was different and C did inherit from B; when that was changed the upcall wasn't fixed. C will break when the unrelated class B gets a new definition of meth(). Also, previously, B().meth.im_class would return A; now it returns B (because it's a method bound to an instance of B).

<p><li>The C API to the GC module has changed incompatibly. Extensions written to support the 2.1 version of the GC module will still compile, but the GC feature will be disabled.

<p><li>The contents of gc.garbage is different; it used to contain all uncollectible cycles; now it contains only objects in uncollectible cycles with a __del__ method.

<p><li>The hash order of dict items is different than in previous versions. (No code should rely on this order, but it's easy to forget this.)

<p><li>Assignment to __debug__ raises SyntaxError at compile-time.

<p><li>The UTF-16 codec was modified to be more RFC compliant. It will now only remove BOM characters at the start of the string and then only if running in native mode (UTF-16-LE and -BE won't remove a leading BMO character).

<p><li>Many error messages are different; in some cases an error condition raises a different exception (most common are cases where TypeError and AttributeError are swapped).

</ul>

<h3>Differences between classic classes and new-style classes</h3>

<p>The following differences between classic and new-style classes may require attention when you are converting a classic class to a new-style class. Since previous versions of Python don't support new-style classes, these can't be considered to be real bugs, but since we've tried very hard to make the behavior of new-style classes backwards compatible, it's important to note these differences. (There are of course many more differences that become relevant if you are writing a new-style class from scratch; this list only lists changes in behavior relevant for the conversion of classic classes.)

<ul>

<p><li>The method resolution order is different; see the <a href="../descrintro#mro">tutorial</a>.

<p><li>New-style classes that overload binary operators (__add__ and so on) cannot rely on the __coerce__ method to coerce the arguments; the other argument will be whatever was present originally. Thus, if x is a new-style class instance defining an __add__ method, x+1 causes a call to x.__add__(1). The method implementation will have to analyze the other argument's type in order to be able to implement the operation correctly. If the method implementation decides that it doesn't know how to implement the operation for this particular combination of argument types, it should return the special singleton value NotImplemented. (This behavior is the same as for classic classes lacking a __coerce__ method; the difference is that the __coerce__ method is ignored by the new-style binary operators.)

<p><li>New-style class instances allow assignment to their __class__ attribute only if the C-level structure layout of the old and new class are the same. This prevents disasters like taking a list and changing its __class__ to make it a dict.

<p><li>New-style class objects don't support assignment to their __bases__ attribute.

<p><li>New-style class objects don't support assignment to their __name__ attribute.

<p><li>(I'm sure there are more differences that are relevant to the conversion of classic classes to new-style classes), but I can't think of then right now.)

</ul>

<p>To report a bug not listed above, always use the SourceForge <a href="http://sourceforge.net/bugs/?group_id=5470">Bug Tracker</a>. If you have a patch, please use the SourceForge <a href="http://sourceforge.net/patch/?group_id=5470">Patch Manager</a>. Please mention that you are reporting a bug in 2.2.2!