From: Brett Cannon Date: Mon, 13 Apr 2015 18:37:50 +0000 (-0400) Subject: Issue #23732: Mention the new -b semantics in the porting HOWTO. X-Git-Tag: v3.5.0a4~83 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=4269d6db931d0a81b7d9b2705d97c48247c3448c;p=thirdparty%2FPython%2Fcpython.git Issue #23732: Mention the new -b semantics in the porting HOWTO. --- diff --git a/Doc/howto/pyporting.rst b/Doc/howto/pyporting.rst index 5e875cdee297..5f7cc34b3d14 100644 --- a/Doc/howto/pyporting.rst +++ b/Doc/howto/pyporting.rst @@ -348,10 +348,12 @@ tox with your continuous integration system so that you never accidentally break Python 2 or 3 support. You may also want to use use the ``-bb`` flag with the Python 3 interpreter to -trigger an exception when you are comparing bytes to strings. Usually it's -simply ``False``, but if you made a mistake in your separation of text/binary -data handling you may be accidentally comparing text and binary data. This flag -will raise an exception when that occurs to help track down such cases. +trigger an exception when you are comparing bytes to strings or bytes to an int +(the latter is available starting in Python 3.5). By default type-differing + comparisons simply return ``False``, but if you made a mistake in your +separation of text/binary data handling or indexing on bytes you wouldn't easily +find the mistake. This flag will raise an exception when these kinds of +comparisons occur, making the mistake much easier to track down. And that's mostly it! At this point your code base is compatible with both Python 2 and 3 simultaneously. Your testing will also be set up so that you