1 files changed, 101 insertions, 0 deletions
diff --git a/sphinx/testing/comparer.py b/sphinx/testing/comparer.py
new file mode 100644
index 000000000..45cae8dde
--- /dev/null
+++ b/sphinx/testing/comparer.py
@@ -0,0 +1,101 @@
+"""
+    sphinx.testing.comparer
+    ~~~~~~~~~~~~~~~~~~~~~~~
+
+    Sphinx test comparer for pytest
+
+    :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+"""
+import difflib
+import pathlib
+from typing import List, Union
+
+
+class PathComparer:
+    """
+    OS-independent path comparison.
+
+    Windows path sep and posix path sep:
+
+    >>> '\\to\\index' == PathComparer('/to/index')
+    True
+    >>> '\\to\\index' == PathComparer('/to/index2')
+    False
+
+    Windows path with drive letters
+
+    >>> 'C:\\to\\index' == PathComparer('/to/index')
+    True
+    >>> 'C:\\to\\index' == PathComparer('C:/to/index')
+    True
+    >>> 'C:\\to\\index' == PathComparer('D:/to/index')
+    False
+    """
+    def __init__(self, path: Union[str, pathlib.Path]):
+        """
+        :param str path: path string, it will be cast as pathlib.Path.
+        """
+        self.path = pathlib.Path(path)
+
+    def __str__(self):
+        return self.path.as_posix()
+
+    def __repr__(self):
+        return "<{0.__class__.__name__}: '{0}'>".format(self)
+
+    def __eq__(self, other):
+        return not bool(self.ldiff(other))
+
+    def diff(self, other: Union[str, pathlib.Path]) -> List[str]:
+        """compare self and other.
+
+        When different is not exist, return empty list.
+
+        >>> PathComparer('/to/index').diff('C:\\to\\index')
+        []
+
+        When different is exist, return unified diff style list as:
+
+        >>> PathComparer('/to/index').diff('C:\\to\\index2')
+        [
+           '- C:/to/index'
+           '+ C:/to/index2'
+           '?            +'
+        ]
+        """
+        return self.ldiff(other)
+
+    def ldiff(self, other: Union[str, pathlib.Path]) -> List[str]:
+        return self._diff(
+            self.path,
+            pathlib.Path(other),
+        )
+
+    def rdiff(self, other: Union[str, pathlib.Path]) -> List[str]:
+        return self._diff(
+            pathlib.Path(other),
+            self.path,
+        )
+
+    def _diff(self, lhs: pathlib.Path, rhs: pathlib.Path) -> List[str]:
+        if lhs == rhs:
+            return []
+
+        if lhs.drive or rhs.drive:
+            # If either has a drive letter compare by absolute path
+            s_path, o_path = lhs.absolute().as_posix(), rhs.absolute().as_posix()
+        else:
+            s_path, o_path = lhs.as_posix(), rhs.as_posix()
+
+        if s_path == o_path:
+            return []
+
+        return [line.strip() for line in difflib.Differ().compare([s_path], [o_path])]
+
+
+def pytest_assertrepr_compare(op, left, right):
+    if isinstance(left, PathComparer) and op == "==":
+        return ['Comparing path:'] + left.ldiff(right)
+    if isinstance(right, PathComparer) and op == "==":
+        return ['Comparing path:'] + right.rdiff(left)