Merge branch 'master' into feat/py2-to-py3-in-speed-section

docs/scenarios/scrape.rst

@@ -87,8 +87,8 @@ Let's see what we got exactly:
 
 .. code-block:: python
 
-    print 'Buyers: ', buyers
-    print 'Prices: ', prices
+    print('Buyers: ', buyers)
+    print('Prices: ', prices)
 
 ::
 

docs/writing/structure.rst

@@ -788,7 +788,7 @@ compute x + 1, you have to create another integer and give it a name.
 
     my_list = [1, 2, 3]
     my_list[0] = 4
-    print my_list  # [4, 2, 3] <- The same list has changed
+    print(my_list)  # [4, 2, 3] <- The same list has changed
 
     x = 6
     x = x + 1  # The new x is another object
@@ -822,7 +822,7 @@ most idiomatic way to do this.
     nums = ""
     for n in range(20):
         nums += str(n)   # slow and inefficient
-    print nums
+    print(nums)
 
 **Better**
 
@@ -832,7 +832,7 @@ most idiomatic way to do this.
     nums = []
     for n in range(20):
         nums.append(str(n))
-    print "".join(nums)  # much more efficient
+    print("".join(nums))  # much more efficient
 
 **Best**
 
@@ -840,7 +840,7 @@ most idiomatic way to do this.
 
     # create a concatenated string from 0 to 19 (e.g. "012..1819")
     nums = [str(n) for n in range(20)]
-    print "".join(nums)
+    print("".join(nums))
 
 One final thing to mention about strings is that using ``join()`` is not always
 best. In the instances where you are creating a new string from a pre-determined

docs/writing/style.rst

@@ -65,9 +65,9 @@ it is bad practice to have two disjointed statements on the same line of code.
 
 .. code-block:: python
 
-    print 'one'; print 'two'
+    print('one'); print('two')
 
-    if x == 1: print 'one'
+    if x == 1: print('one')
 
     if <complex comparison> and <other complex comparison>:
         # do something
@@ -76,11 +76,11 @@ it is bad practice to have two disjointed statements on the same line of code.
 
 .. code-block:: python
 
-    print 'one'
-    print 'two'
+    print('one')
+    print('two')
 
     if x == 1:
-        print 'one'
+        print('one')
 
     cond1 = <complex comparison>
     cond2 = <other complex comparison>
@@ -357,9 +357,7 @@ Instead, use a list comprehension:
 
 .. code-block:: python
 
-    four_lists = [[] for __ in xrange(4)]
-
-Note: Use range() instead of xrange() in Python 3.
+    four_lists = [[] for __ in range(4)]
 
 Create a string from a list
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -584,10 +582,10 @@ list of what is considered false.
 .. code-block:: python
 
     if attr == True:
-        print 'True!'
+        print('True!')
 
     if attr == None:
-        print 'attr is None!'
+        print('attr is None!')
 
 **Good**:
 
@@ -595,15 +593,15 @@ list of what is considered false.
 
     # Just check the value
     if attr:
-        print 'attr is truthy!'
+        print('attr is truthy!')
 
     # or check for the opposite
     if not attr:
-        print 'attr is falsey!'
+        print('attr is falsey!')
 
     # or, since None is considered false, explicitly check for it
     if attr is None:
-        print 'attr is None!'
+        print('attr is None!')
 
 Access a Dictionary Element
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -617,9 +615,9 @@ or pass a default argument to :py:meth:`dict.get`.
 
     d = {'hello': 'world'}
     if d.has_key('hello'):
-        print d['hello']    # prints 'world'
+        print(d['hello'])    # prints 'world'
     else:
-        print 'default_value'
+        print('default_value')
 
 **Good**:
 
@@ -627,12 +625,12 @@ or pass a default argument to :py:meth:`dict.get`.
 
     d = {'hello': 'world'}
 
-    print d.get('hello', 'default_value') # prints 'world'
-    print d.get('thingy', 'default_value') # prints 'default_value'
+    print(d.get('hello', 'default_value')) # prints 'world'
+    print(d.get('thingy', 'default_value')) # prints 'default_value'
 
     # Or:
     if 'hello' in d:
-        print d['hello']
+        print(d['hello'])
 
 Short Ways to Manipulate Lists
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -783,7 +781,7 @@ Use :py:func:`enumerate` keep a count of your place in the list.
 
     a = [3, 4, 5]
     for i, item in enumerate(a):
-        print i, item
+        print(i, item)
     # prints
     # 0 3
     # 1 4
@@ -804,7 +802,7 @@ files for you.
 
     f = open('file.txt')
     a = f.read()
-    print a
+    print(a)
     f.close()
 
 **Good**:
@@ -813,7 +811,7 @@ files for you.
 
     with open('file.txt') as f:
         for line in f:
-            print line
+            print(line)
 
 The ``with`` statement is better because it will ensure you always close the
 file, even if an exception is raised inside the ``with`` block.