Fix missed deprecations (#15)

- Fix some missed deprecations
- Fix config parsing
- Fix passing of configuration into CrystalCollector

Author: Blacksmoke16

.github/workflows/autofix.yml

@@ -14,6 +14,7 @@ jobs:
           python-version: '3.12'
       - name: Install Hatch
         run: |
+          pip install 'pip==25.2'
           pip install hatch
       - name: Install dependencies
         run: |

.github/workflows/ci.yml

@@ -42,6 +42,7 @@ jobs:
           sed -i -E 's/#min //; s/\b >=([0-9])/ ==\1/' pyproject.toml
       - name: Install Hatch
         run: |
+          pip install 'pip==25.2'
           pip install hatch
       - name: Install dependencies
         run: |
@@ -60,6 +61,7 @@ jobs:
           python-version: '3.12'
       - name: Install Hatch
         run: |
+          pip install 'pip==25.2'
           pip install hatch
       - name: Install dependencies
         run: |

mkdocstrings_handlers/crystal/__init__.py

@@ -1,32 +1,52 @@
 from __future__ import annotations
 
-from collections.abc import Mapping, Sequence
-from typing import Any
+from collections.abc import Mapping, MutableMapping, Sequence
+from typing import TYPE_CHECKING, Any
 
-from mkdocstrings import BaseHandler
+from mkdocstrings import BaseHandler, HandlerOptions
 
 from . import inventory
 from .collector import CrystalCollector
 from .renderer import CrystalRenderer
 
-__version__ = "0.3.8"
+if TYPE_CHECKING:
+    from markdown import Extension
+    from mkdocs.config.defaults import MkDocsConfig
+
+__version__ = "0.3.9"
 
 
 class CrystalHandler(CrystalCollector, CrystalRenderer, BaseHandler):
+    name = "crystal"
+    domain = "cr"
     load_inventory = staticmethod(inventory.list_object_urls)  # type: ignore[assignment]
 
     def __init__(
         self,
+        *,
         theme: str,
         custom_templates: str | None = None,
-        crystal_docs_flags: Sequence[str] = (),
-        source_locations: Mapping[str, str] = {},
-        **config: Any,
+        mdx: Sequence[str | Extension],
+        mdx_config: Mapping[str, Any],
+        handler_config: MutableMapping[str, Any],
+        tool_config: MkDocsConfig,
     ) -> None:
-        BaseHandler.__init__(self, "crystal", theme, custom_templates)
+        BaseHandler.__init__(
+            self, theme=theme, custom_templates=custom_templates, mdx=mdx, mdx_config=mdx_config
+        )
         CrystalCollector.__init__(
-            self, crystal_docs_flags=crystal_docs_flags, source_locations=source_locations
+            self,
+            **handler_config,
         )
 
+    def get_options(self, local_options: Mapping[str, Any]) -> HandlerOptions:
+        return {
+            "nested_types": False,
+            "file_filters": True,
+            "show_source_links": True,
+            "heading_level": 2,
+            **local_options,
+        }
+
 
 get_handler = CrystalHandler

mkdocstrings_handlers/crystal/collector.py

@@ -13,7 +13,7 @@
 from functools import cached_property
 from typing import TYPE_CHECKING, Any, Callable, TypeVar, cast
 
-from mkdocstrings import BaseHandler, CollectionError
+from mkdocstrings import BaseHandler, CollectionError, HandlerOptions
 
 from . import inventory
 from .items import DocConstant, DocItem, DocLocation, DocMapping, DocMethod, DocModule, DocType
@@ -82,22 +82,16 @@ def root(self) -> DocRoot:
                 cmd = " ".join(shlex.quote(arg) for arg in args)
                 raise PluginError(f"Command `{cmd}` exited with status {self._proc.returncode}")
 
-    def collect(self, identifier: str, config: Mapping[str, Any]) -> DocView:
+    def collect(self, identifier: str, options: HandlerOptions) -> DocView:
         """[Find][mkdocstrings_handlers.crystal.items.DocItem.lookup] an item by its identifier.
 
         Raises:
             CollectionError: When an item by that identifier couldn't be found.
         """
-        config = {
-            "nested_types": False,
-            "file_filters": True,
-            **config,
-        }
-
         item: DocItem = self.root
         if identifier != "::":
             item = item.lookup(identifier)
-        return DocView(item, config)
+        return DocView(item, options)
 
 
 @dataclasses.dataclass

mkdocstrings_handlers/crystal/renderer.py

@@ -24,24 +24,22 @@ def collector(self):
         return self
 
     def render(self, data: DocItem, options: HandlerOptions, *, locale: str | None = None) -> str:
-        subconfig = {
-            "show_source_links": True,
-            "heading_level": 2,
-            **options,
-        }
         template = self.env.get_template(data._TEMPLATE)
 
         with self._monkeypatch_highlight_function(default_lang="crystal"):
             return template.render(
-                config=subconfig,
+                config=options,
                 obj=data,
-                heading_level=subconfig["heading_level"],
+                heading_level=options["heading_level"],
                 root=True,
             )
 
-    @classmethod
-    def get_anchors(cls, data: DocItem) -> tuple[str, ...]:
-        return (data.abs_id,)
+    def get_aliases(self, identifier: str) -> tuple[str, ...]:
+        try:
+            data = self.collector.root.lookup(identifier)
+            return (data.abs_id,)
+        except CollectionError:
+            return (identifier,)
 
     def update_env(self, config: dict) -> None:
         self._pymdownx_hl = None

pyproject.toml

@@ -59,7 +59,7 @@ include = ["/mkdocstrings_handlers", "/tests"]
 [tool.hatch.env]
 requires = [
     "hatch-mkdocs",
-    "hatch-pip-compile >=1.7.0",
+    "hatch-pip-compile >=1.11.2",
 ]
 
 [tool.hatch.build.targets.wheel]