From: Georg Brandl Date: Wed, 29 Oct 2014 08:00:30 +0000 (+0100) Subject: Fix external links to docs.python.org to use internal links instead. X-Git-Tag: v3.4.3rc1~410 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=728e4debd84e3fa345a6516e7fc0390ffc023ea8;p=thirdparty%2FPython%2Fcpython.git Fix external links to docs.python.org to use internal links instead. --- diff --git a/Doc/howto/pyporting.rst b/Doc/howto/pyporting.rst index b997df7dd2c2..045273328679 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 b20359826083..796323739e2e 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: