Deprecate rdfData in favor of resources with role 'data'

- Add 'resources' property to bblock.schema.yaml with role, ref, format,
  conformsTo, and title fields; clarify it is for resources that don't fit
  dedicated properties like schema/ontology/ldContext
- Mark rdfData as deprecated (schema + warning at load time); convert any
  rdfData entries to resources automatically for backward compatibility
- Auto-discover data.ttl and add it as a resource if not already present
- Resolve resources[].ref paths with base_url in postprocess.py
- Remove dead rdf_data / rdf_data_paths code (the loaded graph was never used)
- register-context.yaml already updated with resources JSON-LD context

Author: avillar

ogc/bblocks/models.py

@@ -124,9 +124,26 @@ def __init__(self, identifier: str, metadata_file: Path,
         if not self.transforms_path.is_file() and (alt_tp := fp / 'transforms.yml').is_file():
             self.transforms_path = alt_tp
 
-        self.rdf_data_paths: list[PathOrUrl] | PathOrUrl = self._find_path_or_url('rdfData', ('data.ttl',))
-        if not isinstance(self.rdf_data_paths, list):
-            self.rdf_data_paths = [self.rdf_data_paths]
+        if 'rdfData' in self.metadata:
+            logger.warning("Building block %s: 'rdfData' is deprecated; use 'resources' with role 'data' instead",
+                           identifier)
+            rdf_data_values = self.metadata.pop('rdfData')
+            if isinstance(rdf_data_values, str):
+                rdf_data_values = [rdf_data_values]
+            resources = self.metadata.setdefault('resources', [])
+            for ref in rdf_data_values:
+                resources.append({'role': 'data', 'ref': ref, 'format': 'text/turtle'})
+
+        data_ttl = fp / 'data.ttl'
+        if data_ttl.is_file():
+            resources = self.metadata.setdefault('resources', [])
+            existing_data_refs = {
+                (fp / r['ref']).resolve() if not is_url(r.get('ref', '')) else None
+                for r in resources
+                if r.get('role') == 'data' and r.get('ref')
+            }
+            if data_ttl.resolve() not in existing_data_refs:
+                resources.append({'role': 'data', 'ref': 'data.ttl', 'format': 'text/turtle'})
 
         self.remote_cache_dir = self.annotated_path / 'remote_cache'
 
@@ -333,17 +350,6 @@ def transforms(self) -> list:
             self._lazy_properties['transforms'] = transforms
         return self._lazy_properties['transforms']
 
-    @property
-    def rdf_data(self) -> Graph | None:
-        if 'rdf_data' not in self._lazy_properties:
-            rdf_data = None
-            if self.rdf_data_paths:
-                rdf_data = Graph()
-                for rdf_data_path in self.rdf_data_paths:
-                    rdf_data.parse(rdf_data_path.value)
-            self._lazy_properties['rdf_data'] = rdf_data
-        return self._lazy_properties['rdf_data']
-
     def get_extra_test_resources(self) -> Generator[dict, None, None]:
         extra_tests_file = self.files_path / 'tests.yaml'
         try:

ogc/bblocks/postprocess.py

@@ -186,11 +186,12 @@ def do_postprocess(bblock: BuildingBlock, light: bool = False) -> bool:
             base_url, cwd if base_url else output_file_root
         ) + '/'
 
-        if bblock.rdf_data_paths:
-            bblock.metadata['rdfData'] = [
-                p.with_base_url(base_url, cwd if base_url else output_file_root)
-                for p in bblock.rdf_data_paths if p.is_file()
-            ]
+        for resource in bblock.metadata.get('resources', []):
+            ref = resource.get('ref')
+            if ref and not is_url(ref):
+                resource['ref'] = PathOrUrl(bblock.files_path / ref).with_base_url(
+                    base_url, cwd if base_url else output_file_root
+                )
 
         if not light:
             if not steps or 'tests' in steps:

ogc/bblocks/register-context.yaml

@@ -162,3 +162,25 @@ context:
     rdfType:
       '@id': rdfs:subClassOf
       '@type': '@id'
+    resources:
+      '@id': prof:hasResource
+      '@context':
+        role:
+          '@id': prof:hasRole
+          '@type': '@id'
+        constraints: role:constraints
+        example: role:example
+        guidance: role:guidance
+        mapping: role:mapping
+        schema: role:schema
+        specification: role:specification
+        validation: role:validation
+        vocabulary: role:vocabulary
+        data: role:data
+        ref:
+          '@id': 'prof:hasArtifact'
+          '@type': '@id'
+        format: dct:format
+        conformsTo:
+          '@id': dct:conformsTo
+          '@type': '@id'

ogc/bblocks/schemas/bblock.schema.yaml

@@ -235,11 +235,42 @@ properties:
   semanticUplift:
     description: Deprecated - configuration should go in semantic-uplift.yaml
     not: true
+  resources:
+    description: |
+      List of external resources associated with this Building Block
+      that don't fit in other dedicated properties (e.g. schema, ontology, ldContext).
+    type: array
+    items:
+      type: object
+      required: [role, ref, format]
+      properties:
+        title:
+          description: Human-readable title for the resource.
+          type: string
+        role:
+          description: Role or relationship of this resource to the Building Block. Can be a well-known role name or a URI.
+          oneOf:
+            - enum: [constraints, example, guidance, mapping, schema, specification, validation, vocabulary, data]
+            - type: string
+              format: uri
+              pattern: ^https?://.*
+        ref:
+          description: |
+            File name (relative to the Building Block directory) or URL for the resource.
+          type: string
+        format:
+          description: MIME type for the resource (e.g. application/json, text/turtle).
+          type: string
+          pattern: '^\w+/[\w.+\-]+$'
+        conformsTo:
+          description: URI of a profile or specification that the resource conforms to.
+          type: string
+          pattern: '^[a-zA-Z][a-zA-Z0-9+\-.]*:.+'
   rdfData:
     description: |
-      Array of file names (relative to the Building Block directory) or URLs with RDF content for this Building Block,
-      such as ontology sources, profile descriptions, etc.
-      If the data file is named `data.ttl`, this property can be omitted.
+      Deprecated. Use 'resources' with role 'data' instead.
+      Array of file names (relative to the Building Block directory) or URLs with RDF content for this Building Block.
+    deprecated: true
     type: array
     items:
       type: string