Modify test utils to support Sphinx v1.4

Sphinx added checking for registering nodes, roles, and directives which are already registered (see commit sphinx-doc/sphinx@cdf0f82 and sphinx-doc/sphinx#1962). That breaks the testing logic of sphinx-testing (see https://github.com/sphinx-doc/sphinx-testing) where subsequent tests cause reregistration warnings.

This change adds a local, slightly modified, version of Sphinx' built-in testing utilities.

Resolves #3.

requirements.txt

@@ -1,4 +1,4 @@
 Sphinx>=1.3
 graphviz>=0.4.6
-sphinx-testing>=0.7.1
 nose>=1.3.7
+mock>=2.0.0

tests/path.py

@@ -0,0 +1,217 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""
+    path
+    ~~~~
+
+    :copyright: Copyright 2007-2016 by the Sphinx team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+import os
+import sys
+import shutil
+from io import open
+
+from six import PY2, text_type, binary_type
+
+
+FILESYSTEMENCODING = sys.getfilesystemencoding() or sys.getdefaultencoding()
+
+
+class path(text_type):
+    """
+    Represents a path which behaves like a string.
+    """
+    if PY2:
+        def __new__(cls, s, encoding=FILESYSTEMENCODING, errors='strict'):
+            if isinstance(s, str):
+                s = s.decode(encoding, errors)
+                return text_type.__new__(cls, s)
+            return text_type.__new__(cls, s)
+
+    @property
+    def parent(self):
+        """
+        The name of the directory the file or directory is in.
+        """
+        return self.__class__(os.path.dirname(self))
+
+    def basename(self):
+        return os.path.basename(self)
+
+    def abspath(self):
+        """
+        Returns the absolute path.
+        """
+        return self.__class__(os.path.abspath(self))
+
+    def isabs(self):
+        """
+        Returns ``True`` if the path is absolute.
+        """
+        return os.path.isabs(self)
+
+    def isdir(self):
+        """
+        Returns ``True`` if the path is a directory.
+        """
+        return os.path.isdir(self)
+
+    def isfile(self):
+        """
+        Returns ``True`` if the path is a file.
+        """
+        return os.path.isfile(self)
+
+    def islink(self):
+        """
+        Returns ``True`` if the path is a symbolic link.
+        """
+        return os.path.islink(self)
+
+    def ismount(self):
+        """
+        Returns ``True`` if the path is a mount point.
+        """
+        return os.path.ismount(self)
+
+    def rmtree(self, ignore_errors=False, onerror=None):
+        """
+        Removes the file or directory and any files or directories it may
+        contain.
+
+        :param ignore_errors:
+            If ``True`` errors are silently ignored, otherwise an exception
+            is raised in case an error occurs.
+
+        :param onerror:
+            A callback which gets called with the arguments `func`, `path` and
+            `exc_info`. `func` is one of :func:`os.listdir`, :func:`os.remove`
+            or :func:`os.rmdir`. `path` is the argument to the function which
+            caused it to fail and `exc_info` is a tuple as returned by
+            :func:`sys.exc_info`.
+        """
+        shutil.rmtree(self, ignore_errors=ignore_errors, onerror=onerror)
+
+    def copytree(self, destination, symlinks=False):
+        """
+        Recursively copy a directory to the given `destination`. If the given
+        `destination` does not exist it will be created.
+
+        :param symlinks:
+            If ``True`` symbolic links in the source tree result in symbolic
+            links in the destination tree otherwise the contents of the files
+            pointed to by the symbolic links are copied.
+        """
+        shutil.copytree(self, destination, symlinks=symlinks)
+
+    def movetree(self, destination):
+        """
+        Recursively move the file or directory to the given `destination`
+        similar to the  Unix "mv" command.
+
+        If the `destination` is a file it may be overwritten depending on the
+        :func:`os.rename` semantics.
+        """
+        shutil.move(self, destination)
+
+    move = movetree
+
+    def unlink(self):
+        """
+        Removes a file.
+        """
+        os.unlink(self)
+
+    def utime(self, arg):
+        os.utime(self, arg)
+
+    def open(self, mode='r', **kwargs):
+        return open(self, mode, **kwargs)
+
+    def write_text(self, text, encoding='utf-8', **kwargs):
+        """
+        Writes the given `text` to the file.
+        """
+        if isinstance(text, bytes):
+            text = text.decode(encoding)
+        with open(self, 'w', encoding=encoding, **kwargs) as f:
+            f.write(text)
+
+    def text(self, encoding='utf-8', **kwargs):
+        """
+        Returns the text in the file.
+        """
+        with open(self, mode='U', encoding=encoding, **kwargs) as f:
+            text = f.read()
+        contents = repr_as(text, '<%s contents>' % self.basename())
+        return contents
+
+    def bytes(self):
+        """
+        Returns the bytes in the file.
+        """
+        with open(self, mode='rb') as f:
+            return f.read()
+
+    def write_bytes(self, bytes, append=False):
+        """
+        Writes the given `bytes` to the file.
+
+        :param append:
+            If ``True`` given `bytes` are added at the end of the file.
+        """
+        if append:
+            mode = 'ab'
+        else:
+            mode = 'wb'
+        with open(self, mode=mode) as f:
+            f.write(bytes)
+
+    def exists(self):
+        """
+        Returns ``True`` if the path exist.
+        """
+        return os.path.exists(self)
+
+    def lexists(self):
+        """
+        Returns ``True`` if the path exists unless it is a broken symbolic
+        link.
+        """
+        return os.path.lexists(self)
+
+    def makedirs(self, mode=0o777):
+        """
+        Recursively create directories.
+        """
+        os.makedirs(self, mode)
+
+    def joinpath(self, *args):
+        """
+        Joins the path with the argument given and returns the result.
+        """
+        return self.__class__(os.path.join(self, *map(self.__class__, args)))
+
+    def listdir(self):
+        return os.listdir(self)
+
+    __div__ = __truediv__ = joinpath
+
+    def __repr__(self):
+        return '%s(%s)' % (self.__class__.__name__, text_type.__repr__(self))
+
+
+# Lives here only to avoid circular references;  use it from util.py!
+class _repr_text(text_type):
+    def __repr__(self):
+        return self._repr
+class _repr_bin(binary_type):
+    def __repr__(self):
+        return self._repr
+
+def repr_as(string, repr_):
+    wrapper = _repr_text if isinstance(string, text_type) else _repr_bin
+    proxy = wrapper(string)
+    proxy._repr = repr_
+    return proxy