https://github.com/compwa/sphinx-api-relink - sphinx-api-relink 0.0.12

🔨 Maintenance

• Remove developer dependencies from optional dependencies (#32)

🖱️ Developer Experience

• Define developer environment with uv (#31 and #32)

The full changelog as commits can be found here.

- Python
Published by github-actions[bot] over 1 year ago

https://github.com/compwa/sphinx-api-relink - sphinx-api-relink 0.0.11

🐛 Bug fixes

• Rename templates to *.rst.jinja (#25)

🖱️ Developer Experience

• Update developer environment (#30)

The full changelog as commits can be found here.

- Python
Published by github-actions[bot] over 1 year ago

https://github.com/compwa/sphinx-api-relink - sphinx-api-relink 0.0.10

⚠️ Enhancements and optimizations

• Get pin() version from importlib if no constraints (#29)

🔨 Maintenance

• Autoupdate pre-commit hooks (#23)
• Drop Python 3.7 & 3.8 support due to EOL (#28)

The full changelog as commits can be found here.

- Python
Published by github-actions[bot] over 1 year ago

https://github.com/compwa/sphinx-api-relink - sphinx-api-relink 0.0.9

🐛 Bug fixes

• Adapt implementation to Sphinx v7.3 (#21)

📝 Documentation

• Update links to compwa.github.io (#18)

The full changelog as commits can be found here.

- Python
Published by github-actions[bot] about 2 years ago

https://github.com/compwa/sphinx-api-relink - sphinx-api-relink 0.0.8

✨ New features

• Define wiki Sphinx role (#14)

⚠️ Enhancements and optimizations

• Get branch info from GITHUB_REF if available (#13)

The full changelog as commits can be found here.

- Python
Published by github-actions[bot] over 2 years ago

https://github.com/compwa/sphinx-api-relink - sphinx-api-relink 0.0.7

✨ New features

• Generate API for multiple packages (#12)

The full changelog as commits can be found here.

- Python
Published by github-actions[bot] over 2 years ago

https://github.com/compwa/sphinx-api-relink - sphinx-api-relink 0.0.6

🐛 Bug fixes

• Allow redirects in URL check (#11)

The full changelog as commits can be found here.

- Python
Published by github-actions[bot] over 2 years ago

https://github.com/compwa/sphinx-api-relink - sphinx-api-relink 0.0.5

⚠️ Enhancements and optimizations

• Activate sphinx.ext.linkcode only if api_github_repo is set (#10)

🐛 Bug fixes

• Support Sphinx linkcheck builder (#9)

The full changelog as commits can be found here.

- Python
Published by github-actions[bot] over 2 years ago

https://github.com/compwa/sphinx-api-relink - sphinx-api-relink 0.0.4

🖱️ Developer Experience

• Link to source code on GitHub with linkcode (#8)

The full changelog as commits can be found here.

- Python
Published by github-actions[bot] over 2 years ago

https://github.com/compwa/sphinx-api-relink - sphinx-api-relink 0.0.3

✨ New features

• Add helpers module (#4, #6, and #7)

📝 Documentation

• Fixed typo in generate_apidoc_package_path (#2)
• Updated repository title in README.md (#3)
• Removed outdated module docstring (#5)

The full changelog as commits can be found here.

- Python
Published by github-actions[bot] over 2 years ago

https://github.com/compwa/sphinx-api-relink - sphinx-api-relink 0.0.2

✨ New features

1 makes it possible to generate an API through sphinx.ext.autodoc by adding this to your conf.py:

python api_package_path = "../src/my_package" # relative to conf.py

More configuration values can be found in README.md.

The full changelog as commits can be found here.

- Python
Published by github-actions[bot] over 2 years ago

https://github.com/compwa/sphinx-api-relink - sphinx-api-relink 0.0.1

First release: the docs/_relink_references.py scripts are now available as a Sphinx extension 🎉

Installation

Just install through PyPI with pip:

bash pip install sphinx-api-relink

Next, in your Sphinx configuration file (conf.py), add "sphinx_api_relink" to your extensions:

python extensions = [ "sphinx_api_relink", ]

Usage

There are two ways to relink type hint references in your API. The first one, api_target_substitutions, should be used when the target is different than the type hint itself:

python api_target_substitutions: dict[str, str | tuple[str, str]] = { "sp.Expr": "sympy.core.expr.Expr", "Protocol": ("obj", "typing.Protocol"), }

The second, api_target_types, is useful when you want to redirect the reference type. This is for instance useful when Sphinx thinks the reference is a class, but it should be an obj:

python api_target_types: dict[str, str] = { "RangeDefinition": "obj", }

- Python
Published by github-actions[bot] over 2 years ago