refactor: Use new mkdocstrings_handlers namespace

Author: pawamoy

docs/usage.md

@@ -73,7 +73,7 @@ Option | Type | Description | Default
 
 ### Rendering
 
-::: mkdocstrings.handlers.python:PythonRenderer.default_config
+::: mkdocstrings_handlers.python.renderer:PythonRenderer.default_config
     rendering:
       show_root_toc_entry: false
 

pyproject.toml

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

src/mkdocstrings/py.typed renamed to src/mkdocstrings_handlers/py.typed

@@ -0,0 +1,5 @@
+"""This package implements a handler for the Python language."""
+
+from mkdocstrings_handlers.python.handler import get_handler
+
+__all__ = ["get_handler"]  # noqa: WPS410

src/mkdocstrings_handlers/python/__init__.py

@@ -120,7 +120,7 @@ def collect(self, identifier: str, config: dict) -> CollectorItem:
 
         Then we pick up the only object within the `objects` list (there's always only one, because we collect
         them one by one), rebuild it's categories lists
-        (see [`rebuild_category_lists()`][mkdocstrings.handlers.python.collector.rebuild_category_lists]),
+        (see [`rebuild_category_lists()`][mkdocstrings_handlers.python.collector.rebuild_category_lists]),
         and return it.
 
         Arguments:

src/mkdocstrings/handlers/python/collector.py renamed to src/mkdocstrings_handlers/python/collector.py

@@ -4,10 +4,10 @@
 from typing import Any, BinaryIO, Iterator, List, Optional, Tuple
 
 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
 
 # TODO: add a deprecation warning once the new handler handles 95% of use-cases
 

src/mkdocstrings/handlers/python/__init__.py renamed to src/mkdocstrings_handlers/python/handler.py

@@ -23,7 +23,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.renderer.PythonRenderer.default_config].
     """
 
     fallback_theme = "material"