From 728e4debd84e3fa345a6516e7fc0390ffc023ea8 Mon Sep 17 00:00:00 2001 From: Georg Brandl Date: Wed, 29 Oct 2014 09:00:30 +0100 Subject: [PATCH] Fix external links to docs.python.org to use internal links instead. --- Doc/howto/pyporting.rst | 6 +++--- Doc/library/unittest.mock-examples.rst | 13 +++++-------- 2 files changed, 8 insertions(+), 11 deletions(-) diff --git a/Doc/howto/pyporting.rst b/Doc/howto/pyporting.rst index b997df7dd2c..04527332867 100644 --- a/Doc/howto/pyporting.rst +++ b/Doc/howto/pyporting.rst @@ -39,7 +39,9 @@ The Short Version 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 code starting **TODAY** @@ -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. - -.. _2to3: https://docs.python.org/2/library/2to3.html .. _3to2: https://pypi.python.org/pypi/3to2 .. _Cheeseshop: PyPI_ .. _coverage: https://pypi.python.org/pypi/coverage diff --git a/Doc/library/unittest.mock-examples.rst b/Doc/library/unittest.mock-examples.rst index b2035982608..796323739e2 100644 --- a/Doc/library/unittest.mock-examples.rst +++ b/Doc/library/unittest.mock-examples.rst @@ -512,9 +512,8 @@ this list of calls for us: Partial mocking ~~~~~~~~~~~~~~~ -In some tests I wanted to mock out a call to `datetime.date.today() -`_ to return -a known date, but I didn't want to prevent the code under test from +In some tests I wanted to mock out a call to :func:`datetime.date.today` +to return 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 so I couldn't just monkey-patch out the static `date.today` method. @@ -556,14 +555,12 @@ is discussed in `this blog entry Mocking a Generator Method ~~~~~~~~~~~~~~~~~~~~~~~~~~ -A Python generator is a function or method that uses the `yield statement -`_ to -return a series of values when iterated over [#]_. +A Python generator is a function or method that uses the :keyword:`yield` statement +to return a series of values when iterated over [#]_. 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 -iteration is `__iter__ -`_, so we can +iteration is :meth:`~container.__iter__`, so we can mock this using a `MagicMock`. Here's an example class with an "iter" method implemented as a generator: