refactor: Use the new mkdocstrings_handlers namespace

mkdocs.yml

@@ -73,7 +73,7 @@ plugins:
         import:
         - https://mkdocstrings.github.io/objects.inv
     watch:
-    - src/mkdocstrings
+    - src/mkdocstrings_handlers
 
 extra:
   social:

pyproject.toml

@@ -45,7 +45,7 @@ Funding = "https://github.com/sponsors/mkdocstrings"
 
 [tool.pdm]
 version = {use_scm = true}
-includes = ["src/mkdocstrings"]
+includes = ["src/mkdocstrings_handlers"]
 
 [tool.pdm.dev-dependencies]
 duty = ["duty>=0.7"]

scripts/fixsetup.sh

@@ -7,5 +7,4 @@ for python_version in ${PYTHON_VERSIONS}; do
     rm -rf "__pypackages__/${python_version}/lib/mkdocstrings"
     rm -f "__pypackages__/${python_version}/lib/mkdocstrings.pth"
     cp -r ../mkdocstrings/src/mkdocstrings "__pypackages__/${python_version}/lib/"
-    cp -r src/mkdocstrings/* "__pypackages__/${python_version}/lib/mkdocstrings"
 done

src/mkdocstrings/handlers/python/__init__.py → src/mkdocstrings_handlers/python/__init__.py

@@ -6,10 +6,10 @@
 from griffe.logger import patch_loggers
 
 from mkdocstrings.handlers.base import BaseHandler
-from mkdocstrings.handlers.python.collector import PythonCollector
-from mkdocstrings.handlers.python.renderer import PythonRenderer
 from mkdocstrings.inventory import Inventory
 from mkdocstrings.loggers import get_logger
+from mkdocstrings_handlers.python.collector import PythonCollector
+from mkdocstrings_handlers.python.renderer import PythonRenderer
 
 patch_loggers(get_logger)
 

src/mkdocstrings/handlers/python/renderer.py → src/mkdocstrings_handlers/python/renderer.py

@@ -54,7 +54,7 @@ class PythonRenderer(BaseRenderer):
     Attributes:
         fallback_theme: The theme to fallback to.
         default_config: The default rendering options,
-            see [`default_config`][mkdocstrings.handlers.python.PythonRenderer.default_config].
+            see [`default_config`][mkdocstrings_handlers.python.PythonRenderer.default_config].
     """
 
     fallback_theme = "material"

src/mkdocstrings_handlers/python/templates/material/_base/docstring/admonition.html

@@ -0,0 +1,5 @@
+{{ log.debug() }}
+<details class="{{ section.value.kind }}">
+  <summary>{{ section.title|convert_markdown(heading_level, html_id)|strip_p }}</summary>
+  {{ section.value.contents|convert_markdown(heading_level, html_id) }}
+</details>

tests/test_collector.py

@@ -2,7 +2,7 @@
 
 import pytest
 
-from mkdocstrings.handlers.python.collector import CollectionError, PythonCollector
+from mkdocstrings_handlers.python.collector import CollectionError, PythonCollector
 
 
 def test_collect_missing_module():

tests/test_themes.py

@@ -22,8 +22,8 @@
         "mkdocstrings.loggers",
         "mkdocstrings.plugin",
         "mkdocstrings.handlers.base",
-        "mkdocstrings.handlers.python",
         "mkdocstrings.handlers.rendering",
+        "mkdocstrings_handlers.python",
     ],
 )
 @pytest.mark.skipif(sys.version_info < (3, 7), reason="material is not installed on Python 3.6")