chore(pdd): Disable doctest to prevent collecting twice over

Author: tony

src/pytest_doctest_docutils.py

@@ -23,20 +23,38 @@
 
 import _pytest
 from _pytest import outcomes
-from _pytest.doctest import DoctestItem
 from _pytest.outcomes import OutcomeException
+from _pytest.warning_types import PytestConfigWarning
 
 from doctest_docutils import DocutilsDocTestFinder, setup
 
 if TYPE_CHECKING:
     from doctest import _Out
 
+    from _pytest.doctest import DoctestItem
+
 logger = logging.getLogger(__name__)
 
 # Lazy definition of runner class
 RUNNER_CLASS = None
 
 
+def pytest_configure(config: pytest.Config) -> None:
+    """Disable pytest.doctest to prevent running tests twice.
+
+    Todo: Find a way to make these plugins cooperate without collecting twice.
+    """
+    if config.pluginmanager.has_plugin("doctest"):
+        message = (
+            "`pytest-doctest-docutils` is incompatible with `doctest`. "
+            "Please disable `doctest` via `-p no:doctest` in order to use "
+            "`pytest-doctest-docutils`."
+        )
+
+        config.pluginmanager.set_blocked("doctest")
+        config.issue_config_time_warning(PytestConfigWarning(message), stacklevel=3)
+
+
 def pytest_unconfigure() -> None:
     global RUNNER_CLASS
 
@@ -170,7 +188,7 @@ def _DocTestRunner__patched_linecache_getlines(
 
 
 class DocTestDocutilsFile(pytest.Module):
-    def collect(self) -> Iterable[DoctestItem]:
+    def collect(self) -> Iterable["DoctestItem"]:
         setup()
 
         encoding = self.config.getini("doctest_encoding")
@@ -189,6 +207,7 @@ def collect(self) -> Iterable[DoctestItem]:
                 self.config
             ),
         )
+        from _pytest.doctest import DoctestItem
 
         for test in finder.find(
             text,