🧪 Add C# Sphinx integration test

docs/source/components/features.rst

@@ -81,6 +81,30 @@ Features
    .. fault:: Sphinx-codelinks halucinates traceability objects in C++
       :id: FAULT_CPP_2
 
+.. feature:: C# Language Support
+   :id: FE_CSHARP
+
+   Support for defining traceability objects in C# source code.
+
+   The C# language parser leverages tree-sitter to accurately identify and extract
+   comments from C# source files, including single-line (``//``), multi-line (``/* */``),
+   and documentation (``///``) comment styles. This ensures that traceability markers are
+   correctly associated with the appropriate code structures such as classes, methods, and
+   properties.
+
+   Key capabilities:
+
+   * Detection of inline, block, and documentation comments
+   * Association of comments with method, class, and property declarations
+   * Support for standard C# comment conventions
+   * Accurate scope detection for nested structures
+
+   .. fault:: Traceability objects are not detected in C# language
+      :id: FAULT_CSHARP_1
+
+   .. fault:: Sphinx-codelinks halucinates traceability objects in C#
+      :id: FAULT_CSHARP_2
+
 .. feature:: Python Language Support
    :id: FE_PY
 

docs/source/development/change_log.rst

@@ -7,6 +7,8 @@ Upcoming
 --------
 
 - ⬆️ Support and test sphinx-needs v5-8
+- 📚 Documented C# language support in ``features.rst``
+- 🧪 Added Sphinx integration test for C# source files
 - ✨ Added Go parser for the ``analyse`` module.
 
   Need ID references and one-line need definitions can now be extracted from Go source files.
@@ -35,7 +37,6 @@ New and Improved
   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.
 
 Fixes
@@ -45,7 +46,6 @@ Fixes
 
   Leading and trailing spaces in extracted marker content are now correctly stripped.
 
-
 .. _`release:1.1.0`:
 
 1.1.0

tests/__snapshots__/test_src_trace/test_build_html[sphinx_project5-source_code5].doctree.xml

@@ -0,0 +1,3 @@
+<document source="<source>">
+    <target anonymous="" ids="IMPL_1" refid="IMPL_1">
+    <Need classes="need need-impl" ids="IMPL_1" refid="IMPL_1">

tests/doc_test/cs_basic/conf.py

@@ -0,0 +1,27 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+
+project = "source-tracing-demo"
+copyright = "2025, useblocks"
+author = "useblocks"
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
+extensions = ["sphinx_needs", "sphinx_codelinks"]
+
+templates_path = ["_templates"]
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+
+src_trace_config_from_toml = "src_trace.toml"
+
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+
+html_theme = "alabaster"
+html_static_path = ["_static"]

tests/doc_test/cs_basic/dummy_src.cs

@@ -0,0 +1,7 @@
+using System;
+
+// @ title here, IMPL_1, impl
+void SingleLineExample()
+{
+    Console.WriteLine("Single-line comment example");
+}

tests/doc_test/cs_basic/index.rst

@@ -0,0 +1,2 @@
+.. src-trace::
+   :project: src

tests/doc_test/cs_basic/src_trace.toml

@@ -0,0 +1,5 @@
+[codelinks.projects.src]
+remote_url_pattern = "https://github.com/useblocks/sphinx-codelinks/blob/{commit}/{path}#L{line}"
+
+[codelinks.projects.src.source_discover]
+comment_type = "cs"

tests/test_src_trace.py

@@ -193,6 +193,10 @@ def test_src_tracing_config_positive(make_app: Callable[..., SphinxTestApp], tmp
             Path("doc_test") / "id_required",
             Path("doc_test") / "id_required",
         ),
+        (
+            Path("doc_test") / "cs_basic",
+            Path("doc_test") / "cs_basic",
+        ),
         (
             Path("doc_test") / "go_basic",
             Path("doc_test") / "go_basic",