typsphinx 0.4.2__tar.gz → 0.4.4__tar.gz

{typsphinx-0.4.2/typsphinx.egg-info → typsphinx-0.4.4}/PKG-INFO

@@ -1,39 +1,38 @@
 Metadata-Version: 2.4
 Name: typsphinx
-Version: 0.4.2
+Version: 0.4.4
 Summary: Sphinx extension for Typst output
-Author-email: Sphinx Typst Contributors <noreply@example.com>
+Author-email: YuSabo <yusabo90002@gmail.com>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/YuSabo90002/typsphinx
 Project-URL: Documentation, https://github.com/YuSabo90002/typsphinx#readme
 Project-URL: Repository, https://github.com/YuSabo90002/typsphinx
 Project-URL: Issues, https://github.com/YuSabo90002/typsphinx/issues
 Keywords: sphinx,typst,documentation,pdf
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Framework :: Sphinx :: Extension
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-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: Topic :: Documentation :: Sphinx
 Classifier: Topic :: Software Development :: Documentation
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: sphinx>=5.0
-Requires-Dist: docutils>=0.18
-Requires-Dist: typst>=0.11.1
+Requires-Dist: sphinx<9,>=5.0
+Requires-Dist: docutils<0.22,>=0.18
+Requires-Dist: typst<0.15,>=0.14.1
 Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest<10,>=8.4; extra == "dev"
 Requires-Dist: pytest-cov>=4.0; extra == "dev"
-Requires-Dist: tox>=4.0; extra == "dev"
-Requires-Dist: tox-uv>=1.0; extra == "dev"
-Requires-Dist: black>=23.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Requires-Dist: mypy>=1.0; extra == "dev"
-Requires-Dist: sphinx-testing>=1.0; extra == "dev"
+Requires-Dist: tox<5,>=4.56; extra == "dev"
+Requires-Dist: tox-uv<2,>=1.35; extra == "dev"
+Requires-Dist: black<27,>=26; extra == "dev"
+Requires-Dist: ruff<0.16,>=0.15; extra == "dev"
+Requires-Dist: mypy<3.0,>=1.13; extra == "dev"
 Requires-Dist: pre-commit>=3.0; extra == "dev"
 Requires-Dist: types-docutils>=0.18; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"
@@ -41,10 +40,13 @@ Requires-Dist: build>=1.0; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: furo>=2024.0; extra == "docs"
 Requires-Dist: sphinx-autodoc-typehints>=1.0; extra == "docs"
+Requires-Dist: sphinx-intl>=2.0; extra == "docs"
+Requires-Dist: tomli>=2.0; python_version < "3.11" and extra == "docs"
 Dynamic: license-file
 
 # typsphinx
 
+[![CI](https://github.com/YuSabo90002/typsphinx/actions/workflows/ci.yml/badge.svg)](https://github.com/YuSabo90002/typsphinx/actions/workflows/ci.yml)
 [![PyPI version](https://badge.fury.io/py/typsphinx.svg)](https://badge.fury.io/py/typsphinx)
 [![Python Support](https://img.shields.io/pypi/pyversions/typsphinx.svg)](https://pypi.org/project/typsphinx/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -78,13 +80,13 @@ typsphinx is a Sphinx extension that enables generating Typst documents from reS
 
 ## Requirements
 
-- Python 3.9 or higher
+- Python 3.10 or higher
 - Sphinx 5.0 or higher
 - typst-py 0.11.1 or higher
 
 ## Installation
 
-### From PyPI (Beta Release)
+### From PyPI
 
 ```bash
 pip install typsphinx
@@ -365,4 +367,4 @@ See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
 ---
 
 **Status**: Stable (v0.4.2) - Production ready
-**Python**: 3.9+ | **Sphinx**: 5.0+ | **Typst**: 0.11.1+
+**Python**: 3.10+ | **Sphinx**: 5.0+ | **Typst**: 0.11.1+

{typsphinx-0.4.2 → typsphinx-0.4.4}/README.md

@@ -1,5 +1,6 @@
 # typsphinx
 
+[![CI](https://github.com/YuSabo90002/typsphinx/actions/workflows/ci.yml/badge.svg)](https://github.com/YuSabo90002/typsphinx/actions/workflows/ci.yml)
 [![PyPI version](https://badge.fury.io/py/typsphinx.svg)](https://badge.fury.io/py/typsphinx)
 [![Python Support](https://img.shields.io/pypi/pyversions/typsphinx.svg)](https://pypi.org/project/typsphinx/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -33,13 +34,13 @@ typsphinx is a Sphinx extension that enables generating Typst documents from reS
 
 ## Requirements
 
-- Python 3.9 or higher
+- Python 3.10 or higher
 - Sphinx 5.0 or higher
 - typst-py 0.11.1 or higher
 
 ## Installation
 
-### From PyPI (Beta Release)
+### From PyPI
 
 ```bash
 pip install typsphinx
@@ -320,4 +321,4 @@ See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
 ---
 
 **Status**: Stable (v0.4.2) - Production ready
-**Python**: 3.9+ | **Sphinx**: 5.0+ | **Typst**: 0.11.1+
+**Python**: 3.10+ | **Sphinx**: 5.0+ | **Typst**: 0.11.1+

{typsphinx-0.4.2 → typsphinx-0.4.4}/pyproject.toml

@@ -4,44 +4,43 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "typsphinx"
-version = "0.4.2"
+version = "0.4.4"
 description = "Sphinx extension for Typst output"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 license = "MIT"
 authors = [
-    {name = "Sphinx Typst Contributors", email = "noreply@example.com"}
+    {name = "YuSabo", email = "yusabo90002@gmail.com"}
 ]
 keywords = ["sphinx", "typst", "documentation", "pdf"]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Framework :: Sphinx :: Extension",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
-    "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",
     "Topic :: Documentation :: Sphinx",
     "Topic :: Software Development :: Documentation",
 ]
 
 dependencies = [
-    "sphinx>=5.0",
-    "docutils>=0.18",
-    "typst>=0.11.1",
+    "sphinx>=5.0,<9",
+    "docutils>=0.18,<0.22",
+    "typst>=0.14.1,<0.15",
 ]
 
 [project.optional-dependencies]
 dev = [
-    "pytest>=7.0",
+    "pytest>=8.4,<10",
     "pytest-cov>=4.0",
-    "tox>=4.0",
-    "tox-uv>=1.0",
-    "black>=23.0",
-    "ruff>=0.1.0",
-    "mypy>=1.0",
-    "sphinx-testing>=1.0",
+    "tox>=4.56,<5",
+    "tox-uv>=1.35,<2",
+    "black>=26,<27",
+    "ruff>=0.15,<0.16",
+    "mypy>=1.13,<3.0",
     "pre-commit>=3.0",
     "types-docutils>=0.18",
     "twine>=5.0",
@@ -50,6 +49,8 @@ dev = [
 docs = [
     "furo>=2024.0",
     "sphinx-autodoc-typehints>=1.0",
+    "sphinx-intl>=2.0",
+    "tomli>=2.0; python_version < '3.11'",
 ]
 
 [project.urls]
@@ -84,7 +85,7 @@ markers = [
 
 [tool.black]
 line-length = 88
-target-version = ["py39", "py310", "py311", "py312"]
+target-version = ["py310", "py311", "py312", "py313"]
 include = '\.pyi?$'
 exclude = '''
 /(
@@ -99,7 +100,7 @@ exclude = '''
 
 [tool.ruff]
 line-length = 88
-target-version = "py39"
+target-version = "py310"
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "N", "UP", "B", "A", "C4", "T20"]
@@ -107,8 +108,8 @@ ignore = [
     "E501",   # Line too long (handled by black)
     "T201",   # print found (used in tests for debugging)
     "B017",   # asserting blind exception in tests
-    "UP035",  # typing.Dict/List/Set deprecation (Python 3.9+ support)
-    "UP006",  # Use dict instead of Dict (Python 3.9+ support)
+    "UP035",  # typing.Dict/List/Set deprecation (Python 3.10+ support)
+    "UP006",  # Use dict instead of Dict (Python 3.10+ support)
     "UP028",  # yield from (minor optimization)
     "N802",   # Function naming (docutils visitor pattern uses PascalCase)
     "A001",   # Shadowing builtins (copyright in conf.py is Sphinx convention)
@@ -116,7 +117,7 @@ ignore = [
 ]
 
 [tool.mypy]
-python_version = "3.9"
+python_version = "3.10"
 warn_return_any = false
 warn_unused_configs = true
 disallow_untyped_defs = false

{typsphinx-0.4.2 → typsphinx-0.4.4}/tests/test_config_other_options.py

@@ -12,12 +12,10 @@ def test_typst_package_config_registered(make_app, tmp_path):
     """Test that typst_package is registered as a config value"""
     # Arrange: Create conf.py with typst_package setting
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
 typst_package = "@preview/diagraph:0.2.5"
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -35,15 +33,13 @@ def test_typst_package_imports_config_registered(make_app, tmp_path):
     """Test that typst_package_imports is registered as a config value"""
     # Arrange: Create conf.py with typst_package_imports setting
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
 typst_package_imports = [
     '#import "@preview/diagraph:0.2.5": *',
     '#import "@preview/tablex:0.1.0": *',
 ]
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -65,12 +61,10 @@ def test_typst_template_function_config_registered(make_app, tmp_path):
     """Test that typst_template_function is registered as a config value"""
     # Arrange: Create conf.py with typst_template_function setting
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
 typst_template_function = "custom_template"
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -88,11 +82,9 @@ def test_typst_package_default_none(make_app, tmp_path):
     """Test that typst_package defaults to None when not set"""
     # Arrange: Create conf.py without typst_package
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -110,11 +102,9 @@ def test_typst_package_imports_default_none(make_app, tmp_path):
     """Test that typst_package_imports defaults to None when not set"""
     # Arrange: Create conf.py without typst_package_imports
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -132,11 +122,9 @@ def test_typst_template_function_default_none(make_app, tmp_path):
     """Test that typst_template_function defaults to None when not set"""
     # Arrange: Create conf.py without typst_template_function
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -154,12 +142,10 @@ def test_typst_output_dir_config_registered(make_app, tmp_path):
     """Test that typst_output_dir is registered as a config value"""
     # Arrange: Create conf.py with typst_output_dir setting
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
 typst_output_dir = '_custom/typst'
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -177,11 +163,9 @@ def test_typst_output_dir_default_value(make_app, tmp_path):
     """Test that typst_output_dir defaults to '_build/typst' when not set"""
     # Arrange: Create conf.py without typst_output_dir
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -199,12 +183,10 @@ def test_typst_debug_config_registered(make_app, tmp_path):
     """Test that typst_debug is registered as a config value"""
     # Arrange: Create conf.py with typst_debug setting
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
 typst_debug = True
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -222,11 +204,9 @@ def test_typst_debug_default_false(make_app, tmp_path):
     """Test that typst_debug defaults to False when not set"""
     # Arrange: Create conf.py without typst_debug
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"

{typsphinx-0.4.2 → typsphinx-0.4.4}/tests/test_config_toctree_defaults.py

@@ -77,8 +77,7 @@ typst_toctree_defaults = {
 typst_documents = [('index', 'index', 'Test', 'Author')]
 """
     (srcdir / "conf.py").write_text(conf_content)
-    (srcdir / "index.rst").write_text(
-        """
+    (srcdir / "index.rst").write_text("""
 Test Document
 =============
 
@@ -86,8 +85,7 @@ Test Document
    :maxdepth: 2
 
    chapter1
-"""
-    )
+""")
     (srcdir / "chapter1.rst").write_text("Chapter 1\n=========\n")
 
     app = make_app(srcdir=srcdir, buildername="typst")
@@ -123,8 +121,7 @@ typst_documents = [('index', 'index', 'Test', 'Author')]
     (srcdir / "conf.py").write_text(conf_content)
 
     # toctree with explicit maxdepth:2 (should override default maxdepth:4)
-    (srcdir / "index.rst").write_text(
-        """
+    (srcdir / "index.rst").write_text("""
 Test
 ====
 
@@ -133,8 +130,7 @@ Test
    :numbered:
 
    chapter1
-"""
-    )
+""")
     (srcdir / "chapter1.rst").write_text("Chapter\n=======\n")
 
     app = make_app(srcdir=srcdir, buildername="typst")

{typsphinx-0.4.2 → typsphinx-0.4.4}/tests/test_entry_points.py

@@ -2,20 +2,13 @@
 Tests for entry points configuration.
 """
 
-import sys
 from importlib.metadata import entry_points
 
 
 def test_entry_point_registration():
     """Test that entry points are defined in pyproject.toml."""
     # Get entry points for sphinx.builders group
-    if sys.version_info >= (3, 10):
-        # Python 3.10+ uses select() method
-        eps = entry_points(group="sphinx.builders")
-    else:
-        # Python 3.9 uses dict-like access
-        all_eps = entry_points()
-        eps = all_eps.get("sphinx.builders", [])
+    eps = entry_points(group="sphinx.builders")
 
     # Convert to list of names
     ep_names = [ep.name for ep in eps]
@@ -32,11 +25,7 @@ def test_entry_point_registration():
 def test_entry_point_value():
     """Test that the entry points point to the correct module."""
     # Get entry points for sphinx.builders group
-    if sys.version_info >= (3, 10):
-        eps = entry_points(group="sphinx.builders")
-    else:
-        all_eps = entry_points()
-        eps = all_eps.get("sphinx.builders", [])
+    eps = entry_points(group="sphinx.builders")
 
     # Find the entry points
     typst_ep = None

{typsphinx-0.4.2 → typsphinx-0.4.4}/tests/test_inline_references.py

@@ -186,3 +186,154 @@ class TestInlineReferenceConversion:
         output = translator.astext()
         # Literal should use raw() function in unified code mode
         assert 'raw("code_reference")' in output
+
+
+class TestEmptyURLHandling:
+    """Test empty URL handling in references (Typst 0.14+ compatibility)."""
+
+    def test_empty_refuri_skips_link_wrapper(self, temp_sphinx_app: SphinxTestApp):
+        """Test that empty refuri skips link() generation."""
+        ref = nodes.reference()
+        ref["refuri"] = ""  # Empty URL
+        ref += nodes.Text("broken reference")
+
+        doc = create_document()
+        para = nodes.paragraph()
+        para += ref
+        doc += para
+
+        writer = TypstWriter(temp_sphinx_app.builder)
+        writer.document = doc
+        translator = TypstTranslator(doc, temp_sphinx_app.builder)
+        doc.walkabout(translator)
+
+        output = translator.astext()
+        # Should NOT generate link()
+        assert 'link("")' not in output
+        assert 'link("", ' not in output
+        # Should render content as plain text
+        assert "broken reference" in output
+
+    def test_empty_refuri_renders_content_as_text(self, temp_sphinx_app: SphinxTestApp):
+        """Test that content is rendered as plain text when refuri is empty."""
+        ref = nodes.reference()
+        ref["refuri"] = ""
+        ref += nodes.Text("nonexistent-section")
+
+        doc = create_document()
+        para = nodes.paragraph()
+        para += ref
+        doc += para
+
+        writer = TypstWriter(temp_sphinx_app.builder)
+        writer.document = doc
+        translator = TypstTranslator(doc, temp_sphinx_app.builder)
+        doc.walkabout(translator)
+
+        output = translator.astext()
+        # Content should be present as text
+        assert "nonexistent-section" in output
+        # No link wrapper
+        assert "link(" not in output
+
+    def test_empty_refuri_emits_warning(self, temp_sphinx_app: SphinxTestApp):
+        """Test that warning is emitted for empty refuri."""
+        ref = nodes.reference()
+        ref["refuri"] = ""
+        ref += nodes.Text("broken-link")
+
+        doc = create_document()
+        para = nodes.paragraph()
+        para += ref
+        doc += para
+
+        writer = TypstWriter(temp_sphinx_app.builder)
+        writer.document = doc
+        translator = TypstTranslator(doc, temp_sphinx_app.builder)
+
+        # Capture warnings
+        import io
+        from contextlib import redirect_stderr
+
+        stderr_capture = io.StringIO()
+        with redirect_stderr(stderr_capture):
+            doc.walkabout(translator)
+
+        # Sphinx logger output goes to stderr in test context
+        # We just verify the code runs without error and produces expected output
+        output = translator.astext()
+        assert "broken-link" in output
+        assert 'link("")' not in output
+
+    def test_valid_refuri_unchanged(self, temp_sphinx_app: SphinxTestApp):
+        """Test that valid refuri generates link() as before (regression test)."""
+        ref = nodes.reference()
+        ref["refuri"] = "https://python.org"
+        ref += nodes.Text("Python")
+
+        doc = create_document()
+        para = nodes.paragraph()
+        para += ref
+        doc += para
+
+        writer = TypstWriter(temp_sphinx_app.builder)
+        writer.document = doc
+        translator = TypstTranslator(doc, temp_sphinx_app.builder)
+        doc.walkabout(translator)
+
+        output = translator.astext()
+        # Should generate link()
+        assert 'link("https://python.org"' in output
+        assert "Python" in output
+
+    def test_internal_reference_with_hash(self, temp_sphinx_app: SphinxTestApp):
+        """Test that internal references (starting with #) work correctly."""
+        ref = nodes.reference()
+        ref["refuri"] = "#section-label"
+        ref += nodes.Text("See section")
+
+        doc = create_document()
+        para = nodes.paragraph()
+        para += ref
+        doc += para
+
+        writer = TypstWriter(temp_sphinx_app.builder)
+        writer.document = doc
+        translator = TypstTranslator(doc, temp_sphinx_app.builder)
+        doc.walkabout(translator)
+
+        output = translator.astext()
+        # Should generate link(<label>, ...)
+        assert "link(<section-label>" in output
+        assert "See section" in output
+
+    def test_multiple_empty_urls(self, temp_sphinx_app: SphinxTestApp):
+        """Test that multiple empty URLs are handled correctly."""
+        # First empty reference
+        ref1 = nodes.reference()
+        ref1["refuri"] = ""
+        ref1 += nodes.Text("ref1")
+
+        # Second empty reference
+        ref2 = nodes.reference()
+        ref2["refuri"] = ""
+        ref2 += nodes.Text("ref2")
+
+        doc = create_document()
+        para = nodes.paragraph()
+        para += ref1
+        para += nodes.Text(" and ")
+        para += ref2
+        doc += para
+
+        writer = TypstWriter(temp_sphinx_app.builder)
+        writer.document = doc
+        translator = TypstTranslator(doc, temp_sphinx_app.builder)
+        doc.walkabout(translator)
+
+        output = translator.astext()
+        # Both should be rendered as text
+        assert "ref1" in output
+        assert "ref2" in output
+        # No link wrappers
+        assert 'link("")' not in output