sphinx-codeautolink 0.17.3__tar.gz → 0.17.5__tar.gz

{sphinx_codeautolink-0.17.3 → sphinx_codeautolink-0.17.5}/PKG-INFO

@@ -1,31 +1,9 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: sphinx-codeautolink
-Version: 0.17.3
+Version: 0.17.5
 Summary: Automatic links from code examples to reference documentation.
 Author-email: Felix Hildén <felix.hilden@gmail.com>
 Maintainer-email: Felix Hildén <felix.hilden@gmail.com>
-License: MIT License
-        
-        Copyright (c) 2021-2025 Felix Hildén
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
 Project-URL: homepage, https://pypi.org/project/sphinx-codeautolink
 Project-URL: download, https://pypi.org/project/sphinx-codeautolink
 Project-URL: source, https://github.com/felix-hilden/sphinx-codeautolink
@@ -51,6 +29,7 @@ Requires-Dist: sphinx>=3.2.0
 Requires-Dist: beautifulsoup4>=4.8.1
 Provides-Extra: ipython
 Requires-Dist: ipython!=8.7.0; extra == "ipython"
+Dynamic: license-file
 
 sphinx-codeautolink
 ===================

{sphinx_codeautolink-0.17.3 → sphinx_codeautolink-0.17.5}/docs/src/release_notes.rst

@@ -8,6 +8,14 @@ These release notes are based on
 sphinx-codeautolink adheres to
 `Semantic Versioning <https://semver.org>`_.
 
+0.17.5 (2025-07-09)
+-------------------
+- Add ``Python`` to default lexers (:issue:`194`)
+
+0.17.4 (2025-03-07)
+-------------------
+- Fix backreference links using relative URIs (:issue:`190`)
+
 0.17.3 (2025-03-06)
 -------------------
 - Fix Sphinx InventoryItem deprecation warning (:issue:`173`)

{sphinx_codeautolink-0.17.3 → sphinx_codeautolink-0.17.5}/pyproject.toml

@@ -1,12 +1,12 @@
 [build-system]
-requires = ["setuptools>=61.0", "wheel"]
+requires = ["setuptools>=77.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "sphinx-codeautolink"
 description = "Automatic links from code examples to reference documentation."
 readme = "readme_pypi.rst"
-license = {file = "LICENSE"}
+license-files = ["LICENSE"]
 dynamic = ["version"]
 
 requires-python = ">=3.10"

{sphinx_codeautolink-0.17.3 → sphinx_codeautolink-0.17.5}/src/sphinx_codeautolink/__init__.py

@@ -8,7 +8,7 @@ from .extension import SphinxCodeAutoLink, backref, directive
 from .extension.block import clean_ipython, clean_pycon
 from .extension.translation import MESSAGE_CATALOG_NAME
 
-__version__ = "0.17.3"
+__version__ = "0.17.5"
 
 
 def setup(app: Sphinx):

{sphinx_codeautolink-0.17.3 → sphinx_codeautolink-0.17.5}/src/sphinx_codeautolink/extension/__init__.py

@@ -52,7 +52,7 @@ def print_exceptions(*, append_source: bool = False):
                     source = doctree["source"]
                     msg = f"in document `{source}`"
                     if e.args:
-                        e.args = (e.args[0] + f" ({msg})",) + e.args[1:]
+                        e.args = (e.args[0] + f" ({msg})", *e.args[1:])
                     else:
                         e.args = (f"Unexpected error {msg}",)
                 raise
@@ -271,7 +271,8 @@ class SphinxCodeAutoLink:
         visitor = CodeRefsVisitor(
             doctree,
             code_refs=self.code_refs,
-            builder=app.builder.name,
+            docname=docname,
+            builder=app.builder,
             warn_no_backreference=self.warn_no_backreference,
         )
         doctree.walk(visitor)

{sphinx_codeautolink-0.17.3 → sphinx_codeautolink-0.17.5}/src/sphinx_codeautolink/extension/backref.py

@@ -1,9 +1,9 @@
 """Backreference tables implementation."""
 
 from dataclasses import dataclass
-from pathlib import Path
 
 from docutils import nodes
+from sphinx.builders import Builder
 
 from sphinx_codeautolink.warn import logger, warn_type
 
@@ -63,12 +63,14 @@ class CodeRefsVisitor(nodes.SparseNodeVisitor):
         self,
         *args,
         code_refs: dict[str, list[CodeExample]],
-        builder: str,
+        docname: str,
+        builder: Builder,
         warn_no_backreference: bool = False,
         **kwargs,
     ) -> None:
         super().__init__(*args, **kwargs)
         self.code_refs = code_refs
+        self.docname = docname
         self.builder = builder
         self.warn_no_backreference = warn_no_backreference
 
@@ -82,10 +84,7 @@ class CodeRefsVisitor(nodes.SparseNodeVisitor):
 
         items = []
         for ref in self.code_refs.get(node.ref, []):
-            if self.builder == "dirhtml" and Path(ref.document).name != "index":
-                link = ref.document + "/index.html"
-            else:
-                link = ref.document + ".html"
+            link = self.builder.get_relative_uri(self.docname, ref.document)
             if ref.ref_id is not None:
                 link += f"#{ref.ref_id}"
             items.append((link, " / ".join(ref.headings)))

{sphinx_codeautolink-0.17.3 → sphinx_codeautolink-0.17.5}/src/sphinx_codeautolink/extension/block.py

@@ -21,6 +21,7 @@ from .directive import ConcatMarker, PrefaceMarker, SkipMarker
 BUILTIN_BLOCKS = {
     "default": None,
     "python": None,
+    "Python": None,
     "python3": None,
     "py": None,
     "py3": None,
@@ -88,7 +89,7 @@ def _exclude_ipython_output(source: str) -> str:
 
 def clean_ipython(source: str) -> tuple[str, str]:
     """Clean up IPython magics and console syntax to pure Python."""
-    from IPython.core.inputtransformer2 import TransformerManager
+    from IPython.core.inputtransformer2 import TransformerManager  # noqa: PLC0415
 
     clean = _exclude_ipython_output(source)
     return source, TransformerManager().transform_cell(clean)

{sphinx_codeautolink-0.17.3 → sphinx_codeautolink-0.17.5}/src/sphinx_codeautolink.egg-info/PKG-INFO

@@ -1,31 +1,9 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: sphinx-codeautolink
-Version: 0.17.3
+Version: 0.17.5
 Summary: Automatic links from code examples to reference documentation.
 Author-email: Felix Hildén <felix.hilden@gmail.com>
 Maintainer-email: Felix Hildén <felix.hilden@gmail.com>
-License: MIT License
-        
-        Copyright (c) 2021-2025 Felix Hildén
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
 Project-URL: homepage, https://pypi.org/project/sphinx-codeautolink
 Project-URL: download, https://pypi.org/project/sphinx-codeautolink
 Project-URL: source, https://github.com/felix-hilden/sphinx-codeautolink
@@ -51,6 +29,7 @@ Requires-Dist: sphinx>=3.2.0
 Requires-Dist: beautifulsoup4>=4.8.1
 Provides-Extra: ipython
 Requires-Dist: ipython!=8.7.0; extra == "ipython"
+Dynamic: license-file
 
 sphinx-codeautolink
 ===================

{sphinx_codeautolink-0.17.3 → sphinx_codeautolink-0.17.5}/src/sphinx_codeautolink.egg-info/SOURCES.txt

@@ -83,6 +83,7 @@ tests/extension/ref/custom_block_imported.txt
 tests/extension/ref/empty_project.txt
 tests/extension/ref/inventory_map_is_needed.txt
 tests/extension/ref/inventory_map_not_needed.txt
+tests/extension/ref/lexer_Python.txt
 tests/extension/ref/lexer_bazel.txt
 tests/extension/ref/lexer_default.txt
 tests/extension/ref/lexer_default_fail.txt

{sphinx_codeautolink-0.17.3 → sphinx_codeautolink-0.17.5}/tests/extension/__init__.py

@@ -9,7 +9,7 @@ import pytest
 from bs4 import BeautifulSoup
 from sphinx.cmd.build import main as sphinx_main
 
-from ._check import check_link_targets
+from ._check import check_link_targets, check_reference_targets_exist
 
 # Insert test package root to path for all tests
 sys.path.insert(0, str(Path(__file__).parent / "src"))
@@ -365,6 +365,58 @@ Page {idx}
     assert_links(result_dir / "subdir/page3/index.html", links)
 
     assert check_link_targets(result_dir) == len(links) * 4
+    check_reference_targets_exist(result_dir)
+
+
+def test_html_subdir_reference(tmp_path: Path):
+    index = """
+Test project
+============
+
+.. toctree::
+
+   subdir/page1
+   subdir/subdir2/page2
+
+Index Page
+----------
+
+.. code:: python
+
+   import test_project
+   test_project.bar()
+
+.. automodule:: test_project
+"""
+
+    page = """
+Page {idx}
+===========
+
+.. code:: python
+
+   import test_project
+   test_project.bar()
+
+.. autolink-examples:: test_project.bar
+"""
+
+    files = {
+        "conf.py": default_conf,
+        "index.rst": index,
+        "subdir/page1.rst": page.format(idx=1),
+        "subdir/subdir2/page2.rst": page.format(idx=2),
+    }
+    links = ["test_project", "test_project.bar"]
+
+    result_dir = _sphinx_build(tmp_path, "html", files)
+
+    assert_links(result_dir / "index.html", links)
+    assert_links(result_dir / "subdir/page1.html", links)
+    assert_links(result_dir / "subdir/subdir2/page2.html", links)
+
+    assert check_link_targets(result_dir) == len(links) * 3
+    check_reference_targets_exist(result_dir)
 
 
 def _sphinx_build(

{sphinx_codeautolink-0.17.3 → sphinx_codeautolink-0.17.5}/tests/extension/_check.py

@@ -44,6 +44,25 @@ def check_link_targets(root: Path) -> int:
     return total
 
 
+def check_reference_targets_exist(root: Path):
+    site_docs = {
+        p: BeautifulSoup(p.read_text("utf-8"), "html.parser")
+        for p in root.glob("**/*.html")
+    }
+    for doc, soup in site_docs.items():
+        for link in soup.find_all("a", attrs={"class": "reference internal"}):
+            base = link["href"].split("#")[0]
+            if any(base.startswith(s) for s in ("http://", "https://")):
+                continue
+            target_path = doc if base == "" else (doc.parent / base).resolve()
+            if target_path.is_dir():
+                target_path /= "index.html"
+            assert target_path.exists(), (
+                f"Target path {target_path!s} not found while validating"
+                f" link for `{link.string}` in {doc.relative_to(root)!s}!"
+            )
+
+
 def gather_ids(soup: BeautifulSoup) -> set:
     """Gather all HTML IDs from a given page."""
     return {tag["id"] for tag in soup.find_all(id=True)}

sphinx_codeautolink-0.17.5/tests/extension/ref/lexer_Python.txt

@@ -0,0 +1,13 @@
+test_project
+test_project.bar
+# split
+# split
+Test project
+============
+
+.. code-block:: Python
+
+   import test_project
+   test_project.bar()
+
+.. automodule:: test_project

{sphinx_codeautolink-0.17.3 → sphinx_codeautolink-0.17.5}/tests/extension/src/future_project.py

@@ -10,7 +10,7 @@ class Foo:
     attr: str = "test"
 
 
-def optional() -> Optional[Foo]:  # noqa: UP007
+def optional() -> Optional[Foo]:  # noqa: UP045
     """Return optional type."""