Kaydet (Commit) 728e4deb authored tarafından Georg Brandl's avatar Georg Brandl

Fix external links to docs.python.org to use internal links instead.

üst 5e722f69
...@@ -39,7 +39,9 @@ The Short Version ...@@ -39,7 +39,9 @@ The Short Version
With that done, your options are: With that done, your options are:
* If you are dropping Python 2 support, use 2to3_ to port to Python 3 * If you are dropping Python 2 support, use :ref:`2to3 <2to3-reference>` to port
to Python 3
* If you are keeping Python 2 support, then start writing Python 2/3-compatible * If you are keeping Python 2 support, then start writing Python 2/3-compatible
code starting **TODAY** code starting **TODAY**
...@@ -601,8 +603,6 @@ If you feel there is something missing from this document that should be added, ...@@ -601,8 +603,6 @@ If you feel there is something missing from this document that should be added,
please email the python-porting_ mailing list. please email the python-porting_ mailing list.
.. _2to3: https://docs.python.org/2/library/2to3.html
.. _3to2: https://pypi.python.org/pypi/3to2 .. _3to2: https://pypi.python.org/pypi/3to2
.. _Cheeseshop: PyPI_ .. _Cheeseshop: PyPI_
.. _coverage: https://pypi.python.org/pypi/coverage .. _coverage: https://pypi.python.org/pypi/coverage
......
...@@ -512,9 +512,8 @@ this list of calls for us: ...@@ -512,9 +512,8 @@ this list of calls for us:
Partial mocking Partial mocking
~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~
In some tests I wanted to mock out a call to `datetime.date.today() In some tests I wanted to mock out a call to :func:`datetime.date.today`
<https://docs.python.org/library/datetime.html#datetime.date.today>`_ to return to return a known date, but I didn't want to prevent the code under test from
a known date, but I didn't want to prevent the code under test from
creating new date objects. Unfortunately `datetime.date` is written in C, and creating new date objects. Unfortunately `datetime.date` is written in C, and
so I couldn't just monkey-patch out the static `date.today` method. so I couldn't just monkey-patch out the static `date.today` method.
...@@ -556,14 +555,12 @@ is discussed in `this blog entry ...@@ -556,14 +555,12 @@ is discussed in `this blog entry
Mocking a Generator Method Mocking a Generator Method
~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~
A Python generator is a function or method that uses the `yield statement A Python generator is a function or method that uses the :keyword:`yield` statement
<https://docs.python.org/reference/simple_stmts.html#the-yield-statement>`_ to to return a series of values when iterated over [#]_.
return a series of values when iterated over [#]_.
A generator method / function is called to return the generator object. It is A generator method / function is called to return the generator object. It is
the generator object that is then iterated over. The protocol method for the generator object that is then iterated over. The protocol method for
iteration is `__iter__ iteration is :meth:`~container.__iter__`, so we can
<https://docs.python.org/library/stdtypes.html#container.__iter__>`_, so we can
mock this using a `MagicMock`. mock this using a `MagicMock`.
Here's an example class with an "iter" method implemented as a generator: Here's an example class with an "iter" method implemented as a generator:
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment