fix: update copyright year in source files and README

Author: Arnaud Riess

src/extensions/score_metamodel/sn_schemas.py

@@ -1,5 +1,5 @@
 # *******************************************************************************
-# Copyright (c) 2026 Contributors to the Eclipse Foundation
+# Copyright (c) 2025 Contributors to the Eclipse Foundation
 #
 # See the NOTICE file(s) distributed with this work for additional
 # information regarding copyright ownership.
@@ -72,7 +72,6 @@ def write_sn_schemas(app: Sphinx, metamodel: MetaModelData) -> None:
 
     # Tell sphinx-needs to load the schema from the JSON file
     config.needs_schema_definitions_from_json = "schemas.json"
-    # config.needs_schema_definitions = schema_definitions
 
 
 def _classify_links(
@@ -173,7 +172,6 @@ def _build_local_validator(
     return {
         "properties": properties,
         "required": required,
-        # "unevaluatedProperties": False,
     }
 
 

src/extensions/score_metamodel/tests/test_sn_schemas.py

@@ -1,5 +1,5 @@
 # *******************************************************************************
-# Copyright (c) 2026 Contributors to the Eclipse Foundation
+# Copyright (c) 2025 Contributors to the Eclipse Foundation
 #
 # See the NOTICE file(s) distributed with this work for additional
 # information regarding copyright ownership.

src/extensions/score_metamodel/tests/test_sn_schemas_integration.py

@@ -1,5 +1,5 @@
 # *******************************************************************************
-# Copyright (c) 2026 Contributors to the Eclipse Foundation
+# Copyright (c) 2025 Contributors to the Eclipse Foundation
 #
 # See the NOTICE file(s) distributed with this work for additional
 # information regarding copyright ownership.

src/extensions/score_sync_toml/README.md

@@ -57,21 +57,21 @@ The static `shared.toml` is always merged into the output.  It contributes:
   JSON Schema validation file generated by `score_metamodel`.
 - **`index_on_save = true`** — tells ubCode to re-index whenever a file is saved.
 
-### 4. `_write_needs_types_toml(app)` — generating `[[needs.types]]`
+### 4. `_generate_needs_types_toml(app)` — generating `[[needs.types]]`
 
 `needs_config_writer` cannot serialise the project's custom `ScoreNeedType` dicts
 (they contain Python-specific data) and silently skips them.  Without
 `[[needs.types]]` entries in `ubproject.toml`, **ubCode does not recognise any
 directives as needs** and the index is empty.
 
-`_write_needs_types_toml` works around this by:
+`_generate_needs_types_toml` works around this by:
 
 1. Reading `app.config.needs_types` — already populated by `score_metamodel` from
    `metamodel.yaml` before `score_sync_toml` runs.
-2. Writing `needs_types_generated.toml` next to `conf.py` containing clean
-   `[[needs.types]]` entries with only the fields ubCode requires:
-   `directive`, `title`, `prefix`, and optionally `color` / `style`.
-3. Appending that file to `needscfg_merge_toml_files` so it is merged into the
+2. Generating the `[[needs.types]]` TOML entries in memory with only the fields
+   ubCode requires: `directive`, `title`, `prefix`, and optionally `color` / `style`.
+3. Writing the result (combined with fields and links) into a temporary file and
+   appending it to `needscfg_merge_toml_files` so it is merged into the
    final `ubproject.toml`.
 
 ### 5. Relative path handling
@@ -101,20 +101,22 @@ metamodel.yaml
 score_metamodel.setup()  ──► app.config.needs_types (Python objects)
                                          │
                                          ▼
-                            _write_needs_types_toml()
+                            _generate_needs_types_toml()
+                            _generate_needs_fields_toml()
+                            _generate_needs_links_toml()
                                          │
                                          ▼
-                            needs_types_generated.toml ──┐
-                                                         │
-shared.toml  ────────────────────────────────────────────┤  merge via
-                                                         │  needs_config_writer
-app.config (all other needs_* settings)  ────────────────┤
-                                                         ▼
-                                               ubproject.toml
-                                                    │
-                                                    ▼
-                                              Sphinx-Needs
-                                          ubCode language server
+                            <temp file>.toml ──────────────────┐
+                                                               │
+shared.toml  ──────────────────────────────────────────────────┤  merge via
+                                                               │  needs_config_writer
+app.config (all other needs_* settings)  ──────────────────────┤
+                                                               ▼
+                                                     ubproject.toml
+                                                          │
+                                                          ▼
+                                                    Sphinx-Needs
+                                                ubCode language server
 ```
 
 ---
@@ -129,4 +131,3 @@ build first.
 |---|---|---|
 | `ubproject.toml` | `needs_config_writer` + merges above | ubCode language server |
 | `schemas.json` | `score_metamodel.sn_schemas.write_sn_schemas` | ubCode + sphinx-needs schema validation |
-| `needs_types_generated.toml` | `_write_needs_types_toml` | Merged into `ubproject.toml`, not committed |

src/extensions/score_sync_toml/__init__.py

@@ -111,23 +111,24 @@ def setup(app: Sphinx) -> dict[str, str | bool]:
     See https://needs-config-writer.useblocks.com
     """
 
+    # Write to the confdir directory.
     config_setdefault(app.config, "needscfg_outpath", "ubproject.toml")
-    """Write to the confdir directory."""
 
+    # Any changes to the shared/local configuration updates the generated config.
     config_setdefault(app.config, "needscfg_overwrite", True)
-    """Any changes to the shared/local configuration updates the generated config."""
 
+    # Write full config, so the final configuration is visible in one file.
     config_setdefault(app.config, "needscfg_write_all", True)
-    """Write full config, so the final configuration is visible in one file."""
 
+    # Exclude default values from the generated configuration.
     config_setdefault(app.config, "needscfg_exclude_defaults", True)
-    """Exclude default values from the generated configuration."""
 
     # This is disabled for right now as it causes a lot of issues
     # While we are not using the generated file anywhere
+    # Running Sphinx with -W will fail the CI for uncommitted TOML changes.
     config_setdefault(app.config, "needscfg_warn_on_diff", False)
-    """Running Sphinx with -W will fail the CI for uncommitted TOML changes."""
 
+    # Exclude resolved/generated config values that don't belong in ubproject.toml.
     app.config.needscfg_exclude_vars = [
         # Default exclusions from needs-config-writer
         "needs_from_toml",
@@ -142,12 +143,11 @@ def setup(app: Sphinx) -> dict[str, str | bool]:
         # needs_config_writer emits unsupported_type warnings for these and skips them.
         "needs_render_context",
     ]
-    """Exclude resolved/generated config values that don't belong in ubproject.toml."""
 
+    # Merge the static TOML file into the generated configuration.
     app.config.needscfg_merge_toml_files.append(
         str(Path(__file__).parent / "shared.toml")
     )
-    """Merge the static TOML file into the generated configuration."""
 
     # Generate TOML fragments for types, fields, and links from the metamodel.
     # needs_config_writer cannot serialise these structures itself, so we combine
@@ -163,9 +163,10 @@ def setup(app: Sphinx) -> dict[str, str | bool]:
         mode="w", suffix=".toml", delete=False, encoding="utf-8"
     ) as tmp:
         tmp.write(metamodel_toml)
+        # Merge the generated metamodel TOML (types, fields, links) into the final ubproject.toml.
         app.config.needscfg_merge_toml_files.append(tmp.name)
-    """Merge the generated metamodel TOML (types, fields, links) into the final ubproject.toml."""
 
+    # Relative paths to confdir for Bazel provided absolute paths.
     app.config.needscfg_relative_path_fields.extend(
         [
             "needs_external_needs[*].json_path",
@@ -175,7 +176,6 @@ def setup(app: Sphinx) -> dict[str, str | bool]:
             },
         ]
     )
-    """Relative paths to confdir for Bazel provided absolute paths."""
 
     app.config.suppress_warnings += [
         "needs_config_writer.path_conversion",

src/extensions/score_sync_toml/shared.toml

@@ -20,7 +20,7 @@ parse_content = false
 content_required = false
 
 [needs]
-schema_definitions_from_json="schemas.json"
+schema_definitions_from_json = "schemas.json"
 
 [server]
 index_on_save = true