TST: use sybil for doctests (#159)

* TST: use sybil for doctests

* Fix docs

* Remove unneeded whitespace normalization

* Try to fix tests under Mac

* Try to fix Windows

* Provide imports in namespace

* Fix checking for Windows

* Make sure user docs are checked

Author: hagenw

audeer/core/conftest.py

@@ -1,13 +1,37 @@
+from doctest import ELLIPSIS
+import os
+import platform
+
 import pytest
+import sybil
+from sybil.parsers.rest import DocTestParser
+from sybil.parsers.rest import SkipParser
 
 import audeer
 
 
-@pytest.fixture(autouse=True)
-def docdir(doctest_namespace, request):
-    # make sure audeer is imported
-    doctest_namespace["audeer"] = audeer
-    # set temporal working directory in docstring examples
-    tmpdir = request.getfixturevalue("tmpdir")
-    with tmpdir.as_cwd():
-        yield
+def imports(namespace):
+    """Provide Python modules to namespace."""
+    namespace["platform"] = platform
+    namespace["audeer"] = audeer
+
+
+@pytest.fixture(scope="function")
+def run_in_tmpdir(tmpdir_factory):
+    """Move to a persistent tmpdir for execution of a whole file."""
+    tmpdir = tmpdir_factory.mktemp("tmp")
+    current_dir = os.getcwd()
+    os.chdir(tmpdir)
+
+    yield
+
+    os.chdir(current_dir)
+
+
+# Collect doctests
+pytest_collect_file = sybil.Sybil(
+    parsers=[DocTestParser(optionflags=ELLIPSIS), SkipParser()],
+    patterns=["*.py"],
+    fixtures=["run_in_tmpdir"],
+    setup=imports,
+).pytest()