mkdocstrings-python-xref 1.16.4__tar.gz → 2.0.0__tar.gz

{mkdocstrings_python_xref-1.16.4 → mkdocstrings_python_xref-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocstrings-python-xref
-Version: 1.16.4
+Version: 2.0.0
 Summary: Enhanced mkdocstrings python handler
 Project-URL: Repository, https://github.com/analog-garage/mkdocstrings-python-xref
 Project-URL: Documentation, https://analog-garage.github.io/mkdocstrings-python-xref/
@@ -9,15 +9,16 @@ License-File: LICENSE.md
 Keywords: documentation-tool,mkdocstrings,mkdocstrings-handler,python
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Documentation
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Requires-Dist: griffe>=1.0
-Requires-Dist: mkdocstrings-python<2.0,>=1.16.6
+Requires-Dist: mkdocstrings-python>=2.0
+Requires-Dist: mkdocstrings>=1.0
 Provides-Extra: dev
 Requires-Dist: beautifulsoup4>=4.12; extra == 'dev'
 Requires-Dist: black>=23.12; extra == 'dev'
@@ -29,9 +30,11 @@ Requires-Dist: mike>=1.1; extra == 'dev'
 Requires-Dist: mkdocs-material>=9.5.4; extra == 'dev'
 Requires-Dist: mkdocs<2.0,>=1.5.3; extra == 'dev'
 Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pip>=25.0; extra == 'dev'
 Requires-Dist: pytest-cov>=5.0; extra == 'dev'
 Requires-Dist: pytest>=8.2; extra == 'dev'
 Requires-Dist: ruff>=0.4.10; extra == 'dev'
+Requires-Dist: whl2conda>=25.3; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # mkdocstrings-python-xref

{mkdocstrings_python_xref-1.16.4 → mkdocstrings_python_xref-2.0.0}/pyproject.toml

@@ -13,19 +13,20 @@ classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
     "Topic :: Software Development :: Documentation",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
 ]
 keywords = [
     "documentation-tool", "mkdocstrings", "mkdocstrings-handler", "python"
 ]
 dynamic = ["version"]
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 dependencies = [
-    "mkdocstrings-python >=1.16.6,<2.0",
+    "mkdocstrings-python >=2.0",
+    "mkdocstrings >=1.0",
     "griffe >=1.0",
 ]
 
@@ -36,7 +37,9 @@ Documentation = "https://analog-garage.github.io/mkdocstrings-python-xref/"
 [project.optional-dependencies]
 dev = [
     "build >=1.0.0", # python-build on conda
+    "pip >=25.0",
     "hatchling >=1.21",
+    "whl2conda >=25.3",
     "coverage >=7.4.0",
     "pytest >=8.2",
     "pytest-cov >=5.0",

mkdocstrings_python_xref-2.0.0/src/mkdocstrings_handlers/python_xref/VERSION

@@ -0,0 +1 @@
+2.0.0

{mkdocstrings_python_xref-1.16.4 → mkdocstrings_python_xref-2.0.0}/src/mkdocstrings_handlers/python_xref/crossref.py

@@ -1,4 +1,4 @@
-#  Copyright (c) 2022-2025.   Analog Devices Inc.
+#  Copyright (c) 2022-2026.   Analog Devices Inc.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
 #  you may not use this file except in compliance with the License.
@@ -17,8 +17,7 @@ from __future__ import annotations
 
 import ast
 import re
-import sys
-from typing import Any, Callable, List, Optional, cast
+from typing import Callable, List, Optional, cast
 
 from griffe import Alias, Docstring, GriffeError, Object
 from mkdocstrings import get_logger
@@ -365,7 +364,7 @@ def doc_value_offset_to_location(doc: Docstring, offset: int) -> tuple[int,int]:
         try:
             source = doc.source
             # compute docstring without cleaning up spaces and indentation
-            rawvalue = str(safe_eval(source))
+            rawvalue = str(ast.literal_eval(source))
 
             # adjust line offset by number of lines removed from front of docstring
             lineoffset += leading_space(rawvalue).count("\n")
@@ -401,12 +400,4 @@ def leading_space(s: str) -> str:
         return m[0]
     return "" # pragma: no cover
 
-if sys.version_info < (3, 10) or True:
-    # TODO: remove when 3.9 support is dropped
-    # In 3.9, literal_eval cannot handle comments in input
-    def safe_eval(s: str) -> Any:
-        """Safely evaluate a string expression."""
-        return eval(s) #eval(s, dict(__builtins__={}), {})
-else:
-    save_eval = ast.literal_eval
 

{mkdocstrings_python_xref-1.16.4 → mkdocstrings_python_xref-2.0.0}/src/mkdocstrings_handlers/python_xref/handler.py

@@ -1,4 +1,4 @@
-#  Copyright (c) 2022-2025.   Analog Devices Inc.
+#  Copyright (c) 2022-2026.   Analog Devices Inc.
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
 #  you may not use this file except in compliance with the License.
@@ -18,7 +18,6 @@ Implementation of python_xref handler
 from __future__ import annotations
 
 import re
-import sys
 from dataclasses import dataclass, field, fields
 from functools import partial
 from pathlib import Path
@@ -37,12 +36,7 @@ __all__ = [
 
 logger = get_logger(__name__)
 
-# TODO python 3.9 - remove when 3.9 support is dropped
-_dataclass_options = {"frozen": True}
-if sys.version_info >= (3, 10):
-    _dataclass_options["kw_only"] = True
-
-@dataclass(**_dataclass_options)
+@dataclass(frozen=True, kw_only=True)
 class PythonRelXRefOptions(PythonOptions):
     check_crossrefs: bool = True
     check_crossrefs_exclude: list[str | re.Pattern] = field(default_factory=list)
@@ -84,7 +78,7 @@ class PythonRelXRefHandler(PythonHandler):
         )
         return opts
 
-    def render(self, data: CollectorItem, options: PythonOptions) -> str:
+    def render(self, data: CollectorItem, options: PythonOptions, locale: str | None = None) -> str:
         if options.relative_crossrefs:
             if isinstance(options, PythonRelXRefOptions) and options.check_crossrefs:
                 checkref = partial(
@@ -94,7 +88,7 @@ class PythonRelXRefHandler(PythonHandler):
             substitute_relative_crossrefs(data, checkref=checkref)
 
         try:
-            return super().render(data, options)
+            return super().render(data, options, locale=locale)
         except Exception:  # pragma: no cover
             print(f"{data.path=}")
             raise

mkdocstrings_python_xref-1.16.4/src/mkdocstrings_handlers/python_xref/VERSION

@@ -1 +0,0 @@
-1.16.4