Changelog¶

1.3.0¶

✨ Added Go parser for the analyse module.

Need ID references and one-line need definitions can now be extracted from Go source files. The supported comment styles are // and /* */.
✨ Added JSONC language support for the analyse module.

Comments in JSONC files are now parsed for need ID references and one-line need definitions. .json files are also checked when they begin with a comment (see jsonc.org).
👌 Replaced gitignore-parser with ignore-python for source discovery.

This adds native nested .gitignore support, improves performance, and brings behavioral parity with ubCode. A per-project follow_links configuration option was also added.
⬆️ Support and test Sphinx-Needs v5-8.
⬆️ Allow Sphinx 9.
📚 Documented C# language support in features.rst.
🧪 Added a Sphinx integration test for C# source files.

🐛 Register Sphinx-Needs fields with a typed schema.

The project, file, directory and URL fields are now registered with a typed (string) schema, so they no longer trigger schema violations on needs that do not set them when strict Sphinx-Needs schema validation is enabled.
🐛 Do not mutate the rebuild='env' src_trace_projects configuration during builds.

Incremental Sphinx builds no longer re-read every document on each run.
🐛 Route analyse logging through the active environment instead of installing a stderr handler at import time.

Routine INFO progress no longer goes to stderr unconditionally, and importing the package no longer forces a logging handler onto consumers.
🐛 Validate field default ordering in the oneline configuration.

A required field defined after a field with a default is now reported as an error instead of being silently skipped.

✨ Added Rust parser for the analyse module.

Need ID references and one-line need definitions can now be extracted from Rust source files.
👌 Added explicit git_root configuration option.

Users can now explicitly specify the Git root directory instead of relying on automatic detection.
👌 Enhanced warning logging in the oneline parser.

Warning messages now include more context to help diagnose parsing issues.
📚 Added traceability page to the documentation.
📚 Added features.rst page documenting the full feature set with source tracing.

🐛 Fixed space handling in marker extraction.

Leading and trailing spaces in extracted marker content are now correctly stripped.

✨ Added C# parser for analyse module.

Need ID references and marked RST blocks can be extracted from C# source files. The comments styles supported are:(//, /* */, ///)
✨ Added YAML parser for analyse module.

Need ID references can be extracted from YAML files. The supported comment style is # as well as inline comment style, e.g. key: value # comment.
👌 Directive src-trace itself does not create need items anymore and only generate need items from the one-line need definition in the given source.

The need item is removed because:
- It has no use cases so far.
- It creates extra need items users may not actually want in their documentation
- It creates errors with some Sphinx-Needs configurations, e.g., when need_id_required or needs_statuses is defined.

🐛 Replace absolute path with relative path to fix local-url not working on the non-local environment
🐛 Add more file extensions of C/C++ for SourceDiscover

✨ Added a new analyse CLI command and corresponding API.

The analyse command parses source files (Python, C/C++) and extracts markers from comments. It can extract three types of markers, as documented in the analyse section:
- One-line need definitions
- Need ID references
- Marked RST blocks
The extracted markers and their metadata are saved to a JSON file for further processing.
✨ Added a new write rst CLI command.

The write rst command writes a reStructuredText file with needextend directive from the extracted markers generated by analyse. The generated RST can be included in the Sphinx documentation to create the source code links in the existing needs
👌 Replaced virtual_docs with the new analyse module.

The virtual_docs feature, which handled one-line need definitions (OneLineCommentStyle), has been migrated into the new analyse module and removed from the core. The caching feature of virtual_docs is temporarily removed and may be reintroduced later.
👌 Updated the src-trace Sphinx directive.

The src-trace directive now uses the new analyse API instead of the old virtual_docs one.
👌 Unified configuration in TOML

The configuration for src-trace directive defined in TOML is now compatible with the new analyse module.

🐛 Apply default configuration values when not given

When a user does not specify certain configuration options, the extension will automatically use predefined default values, allowing users to get started quickly without needing to customize every option. Users can override these defaults by explicitly providing their own configuration values.
🐛 Fix local links for multi project configurations

Local links between docs and one-line need definitions work correctly, when src_dir in multiple project configurations point at different locations.

Initial release of Sphinx-CodeLinks

This version features: