Merge lp:~cjwatson/launchpadlib/isolate-doctests into lp:launchpadlib

[Colin Watson]

Stop introduction.txt doctest from writing to $HOME.

[Barry Warsaw (barry)]

LGTM

review: Approve

=== modified file 'src/launchpadlib/NEWS.txt'
--- src/launchpadlib/NEWS.txt	2016-07-12 16:09:19 +0000
+++ src/launchpadlib/NEWS.txt	2017-02-01 09:36:51 +0000
@@ -2,6 +2,10 @@
 NEWS for launchpadlib
 =====================
 
+1.10.5
+======
+- Stop introduction.txt doctest from writing to $HOME.
+
 1.10.4 (2016-07-12)
 ===================
 - Fix _bad_oauth_token crash on Python 3.  [bug=1471894]

=== modified file 'src/launchpadlib/__init__.py'
--- src/launchpadlib/__init__.py	2016-07-12 16:09:19 +0000
+++ src/launchpadlib/__init__.py	2017-02-01 09:36:51 +0000
@@ -14,4 +14,4 @@
 # You should have received a copy of the GNU Lesser General Public License
 # along with launchpadlib. If not, see <http://www.gnu.org/licenses/>.
 
-__version__ = '1.10.4'
+__version__ = '1.10.5'

=== modified file 'src/launchpadlib/docs/introduction.txt'
--- src/launchpadlib/docs/introduction.txt	2016-07-12 16:08:43 +0000
+++ src/launchpadlib/docs/introduction.txt	2017-02-01 09:36:51 +0000
@@ -6,6 +6,20 @@
 services API.  It is officially supported by Canonical, although third party
 packages may be available to provide bindings to other programming languages.
 
+Set up
+======
+
+launchpadlib writes to $HOME, so isolate ourselves.
+
+    >>> from fixtures import (
+    ...     EnvironmentVariable,
+    ...     TempDir,
+    ...     )
+    >>> tempdir_fixture = TempDir()
+    >>> tempdir_fixture.setUp()
+    >>> home_fixture = EnvironmentVariable('HOME', tempdir_fixture.path)
+    >>> home_fixture.setUp()
+
 OAuth authentication
 ====================
 
@@ -396,3 +410,5 @@
 ========
 
     >>> os.remove(path)
+    >>> home_fixture.cleanUp()
+    >>> tempdir_fixture.cleanUp()