mustrd 0.3.0.0__py3-none-any.whl → 0.3.1a1__py3-none-any.whl

mustrd/mustrdRdfLib.py

@@ -25,6 +25,7 @@ SOFTWARE.
 from pyparsing import ParseException
 from rdflib import Graph
 from requests import RequestException
+import logging
 
 
 def execute_select(triple_store: dict, given: Graph, when: str, bindings: dict = None) -> str:
@@ -38,7 +39,13 @@ def execute_select(triple_store: dict, given: Graph, when: str, bindings: dict =
 
 def execute_construct(triple_store: dict, given: Graph, when: str, bindings: dict = None) -> Graph:
     try:
-        return given.query(when, initBindings=bindings).graph
+        logger = logging.getLogger(__name__)
+        logger.debug(f"Executing CONSTRUCT query: {when} with bindings: {bindings}")
+
+
+        result_graph = given.query(when, initBindings=bindings).graph
+        logger.debug(f"CONSTRUCT query executed successfully, resulting graph has {len(result_graph)} triples.")
+        return result_graph
     except ParseException:
         raise
     except Exception as e:

mustrd/namespace.py

@@ -38,13 +38,15 @@ class MUST(DefinedNamespace):
     AnzoQueryDrivenUpdateSparql: URIRef
     AskSparql: URIRef
     DescribeSparql: URIRef
-
+    SpadeEdnGroupSource: URIRef
+    
     # Specification properties
     given: URIRef
     when: URIRef
     then: URIRef
     dataSource: URIRef
     file: URIRef
+    fileurl: URIRef
     fileName: URIRef
     queryFolder: URIRef
     queryName: URIRef
@@ -124,3 +126,10 @@ class MUSTRDTEST(DefinedNamespace):
     triplestoreSpecPath: URIRef
     hasPytestPath: URIRef
     filterOnTripleStore: URIRef
+
+from rdflib import Namespace
+
+MUST = Namespace("https://mustrd.com/model/")
+
+# Add SpadeEdnGroupSource to the namespace
+MUST.SpadeEdnGroupSource = MUST["SpadeEdnGroupSource"]

mustrd/spec_component.py

@@ -33,6 +33,7 @@ from rdflib import RDF, Graph, URIRef, Variable, Literal, XSD, util, Conjunctive
 from rdflib.exceptions import ParserError
 from rdflib.term import Node
 from rdflib.plugins.stores.memory import Memory
+import edn_format
 
 from . import logger_setup
 from .mustrdAnzo import get_queries_for_layer, get_queries_from_templated_step
@@ -40,6 +41,7 @@ from .mustrdAnzo import get_query_from_querybuilder
 from .namespace import MUST, TRIPLESTORE
 from multimethods import MultiMethod, Default
 from .utils import get_mustrd_root
+from urllib.parse import urlparse
 
 log = logger_setup.setup_logger(__name__)
 
@@ -68,6 +70,12 @@ class AnzoWhenSpec(WhenSpec):
     spec_component_details: any = None
 
 
+@dataclass
+class SpadeEdnGroupSourceWhenSpec(WhenSpec):
+    file: str = None
+    groupId: str = None
+
+
 @dataclass
 class ThenSpec(SpecComponent):
     value: Graph = Graph()
@@ -254,13 +262,13 @@ get_spec_component = MultiMethod("get_spec_component", get_spec_component_dispat
 
 @get_spec_component.method((MUST.InheritedDataset, MUST.given))
 def _get_spec_component_inheritedstate_given(spec_component_details: SpecComponentDetails) -> GivenSpec:
-    spec_component = init_spec_component(spec_component_details.predicate)
+    spec_component = GivenSpec()
     return spec_component
 
 
 @get_spec_component.method((MUST.FolderDataset, MUST.given))
 def _get_spec_component_folderdatasource_given(spec_component_details: SpecComponentDetails) -> GivenSpec:
-    spec_component = init_spec_component(spec_component_details.predicate)
+    spec_component = GivenSpec()
 
     file_name = spec_component_details.spec_graph.value(subject=spec_component_details.spec_component_node,
                                                         predicate=MUST.fileName)
@@ -276,7 +284,7 @@ def _get_spec_component_folderdatasource_given(spec_component_details: SpecCompo
 
 @get_spec_component.method((MUST.FolderSparqlSource, MUST.when))
 def _get_spec_component_foldersparqlsource_when(spec_component_details: SpecComponentDetails) -> GivenSpec:
-    spec_component = init_spec_component(spec_component_details.predicate)
+    spec_component = WhenSpec()
 
     file_name = spec_component_details.spec_graph.value(subject=spec_component_details.spec_component_node,
                                                         predicate=MUST.fileName)
@@ -291,7 +299,7 @@ def _get_spec_component_foldersparqlsource_when(spec_component_details: SpecComp
 
 @get_spec_component.method((MUST.FolderDataset, MUST.then))
 def _get_spec_component_folderdatasource_then(spec_component_details: SpecComponentDetails) -> ThenSpec:
-    spec_component = init_spec_component(spec_component_details.predicate)
+    spec_component = ThenSpec()
 
     file_name = spec_component_details.spec_graph.value(subject=spec_component_details.spec_component_node,
                                                         predicate=MUST.fileName)
@@ -301,17 +309,44 @@ def _get_spec_component_folderdatasource_then(spec_component_details: SpecCompon
 
 
 @get_spec_component.method((MUST.FileDataset, MUST.given))
-@get_spec_component.method((MUST.FileDataset, MUST.then))
 def _get_spec_component_filedatasource(spec_component_details: SpecComponentDetails) -> GivenSpec:
-    spec_component = init_spec_component(spec_component_details.predicate)
+    spec_component = GivenSpec()
+    return load_spec_component(spec_component_details, spec_component)
+
+@get_spec_component.method((MUST.FileDataset, MUST.then))
+def _get_spec_component_filedatasource(spec_component_details: SpecComponentDetails) -> ThenSpec:
+    spec_component = ThenSpec()
     return load_spec_component(spec_component_details, spec_component)
 
 
 def load_spec_component(spec_component_details, spec_component):
-    file_path = Path(str(spec_component_details.spec_graph.value(subject=spec_component_details.spec_component_node,
-                                                                 predicate=MUST.file)))
+    file_path = get_file_or_fileurl(spec_component_details)
+    file_path = Path(str(file_path))
     return load_dataset_from_file(get_file_absolute_path(spec_component_details, file_path), spec_component)
 
+def get_file_or_fileurl(spec_component_details):
+    file_path = spec_component_details.spec_graph.value(
+        subject=spec_component_details.spec_component_node,
+        predicate=MUST.file
+    )
+    if file_path is None:
+        file_path = spec_component_details.spec_graph.value(
+            subject=spec_component_details.spec_component_node,
+            predicate=MUST.fileurl
+        )
+        if file_path is not None and str(file_path).startswith("file://"):
+            # Remove the 'file://' scheme to get the local path
+            # we do it this quick and dirty way because the urlparse library assumes absolute paths, and strips our leading ./
+            # need to confirm this approach is windows safe. 
+
+            new_path = str(file_path)[7:]
+            log.debug(f"converted {file_path=} to {new_path=}")
+            file_path = new_path
+    if file_path is None:
+        # shacl validation will catch this, but we want to raise a more specific error
+        raise ValueError("Neither MUST.file nor MUST.fileurl found for the spec component node")
+    return file_path
+
 
 def load_dataset_from_file(path: Path, spec_component: ThenSpec) -> ThenSpec:
     if path.is_dir():
@@ -342,10 +377,10 @@ def load_dataset_from_file(path: Path, spec_component: ThenSpec) -> ThenSpec:
 
 @get_spec_component.method((MUST.FileSparqlSource, MUST.when))
 def _get_spec_component_filedatasource_when(spec_component_details: SpecComponentDetails) -> SpecComponent:
-    spec_component = init_spec_component(spec_component_details.predicate)
-
-    file_path = Path(str(spec_component_details.spec_graph.value(subject=spec_component_details.spec_component_node,
-                                                                 predicate=MUST.file)))
+    spec_component = WhenSpec()
+    file_path = get_file_or_fileurl(spec_component_details)
+    # file_path = Path(str(spec_component_details.spec_graph.value(subject=spec_component_details.spec_component_node,
+    #                                                              predicate=MUST.file)))
     spec_component.value = get_spec_component_from_file(get_file_absolute_path(spec_component_details, file_path))
 
     spec_component.queryType = spec_component_details.spec_graph.value(
@@ -357,7 +392,7 @@ def _get_spec_component_filedatasource_when(spec_component_details: SpecComponen
 
 @get_spec_component.method((MUST.TextSparqlSource, MUST.when))
 def _get_spec_component_TextSparqlSource(spec_component_details: SpecComponentDetails) -> SpecComponent:
-    spec_component = init_spec_component(spec_component_details.predicate)
+    spec_component = WhenSpec()
 
     # Get specComponent directly from config file (in text string)
     spec_component.value = str(
@@ -371,22 +406,35 @@ def _get_spec_component_TextSparqlSource(spec_component_details: SpecComponentDe
     return spec_component
 
 
-# https://github.com/Semantic-partners/mustrd/issues/98
-@get_spec_component.method((MUST.HttpDataset, MUST.given))
-@get_spec_component.method((MUST.HttpDataset, MUST.when))
-@get_spec_component.method((MUST.HttpDataset, MUST.then))
-def _get_spec_component_HttpDataset(spec_component_details: SpecComponentDetails) -> SpecComponent:
-    spec_component = init_spec_component(spec_component_details.predicate)
-
+def _get_spec_component_HttpDataset_shared(spec_component_details: SpecComponentDetails, spec_component):
     # Get specComponent with http GET protocol
-    spec_component.value = requests.get(str(
-        spec_component_details.spec_graph.value(subject=spec_component_details.spec_component_node,
-                                                predicate=MUST.dataSourceUrl)).content)
-    spec_component.queryType = spec_component_details.spec_graph.value(
+    url = spec_component_details.spec_graph.value(
         subject=spec_component_details.spec_component_node,
-        predicate=MUST.queryType)
+        predicate=MUST.dataSourceUrl
+    )
+    if not url:
+        raise ValueError("MUST.dataSourceUrl is missing for HttpDataset")
+    response = requests.get(str(url))
+    response.raise_for_status()
+    spec_component.value = response.content
+    if hasattr(spec_component, "queryType"):
+        spec_component.queryType = spec_component_details.spec_graph.value(
+            subject=spec_component_details.spec_component_node,
+            predicate=MUST.queryType)
     return spec_component
 
+@get_spec_component.method((MUST.HttpDataset, MUST.given))
+def _get_spec_component_HttpDataset_given(spec_component_details: SpecComponentDetails) -> GivenSpec:
+    return _get_spec_component_HttpDataset_shared(spec_component_details, GivenSpec())
+
+@get_spec_component.method((MUST.HttpDataset, MUST.when))
+def _get_spec_component_HttpDataset_when(spec_component_details: SpecComponentDetails) -> WhenSpec:
+    return _get_spec_component_HttpDataset_shared(spec_component_details, WhenSpec())
+
+@get_spec_component.method((MUST.HttpDataset, MUST.then))
+def _get_spec_component_HttpDataset_then(spec_component_details: SpecComponentDetails) -> ThenSpec:
+    return _get_spec_component_HttpDataset_shared(spec_component_details, ThenSpec())
+
 
 @get_spec_component.method((MUST.TableDataset, MUST.then))
 def _get_spec_component_TableDataset(spec_component_details: SpecComponentDetails) -> SpecComponent:
@@ -407,7 +455,7 @@ def _get_spec_component_EmptyTable(spec_component_details: SpecComponentDetails)
 
 @get_spec_component.method((MUST.EmptyGraph, MUST.then))
 def _get_spec_component_EmptyGraph(spec_component_details: SpecComponentDetails) -> SpecComponent:
-    spec_component = init_spec_component(spec_component_details.predicate)
+    spec_component = ThenSpec()
 
     return spec_component
 
@@ -415,7 +463,11 @@ def _get_spec_component_EmptyGraph(spec_component_details: SpecComponentDetails)
 @get_spec_component.method((MUST.StatementsDataset, MUST.given))
 @get_spec_component.method((MUST.StatementsDataset, MUST.then))
 def _get_spec_component_StatementsDataset(spec_component_details: SpecComponentDetails) -> SpecComponent:
-    spec_component = init_spec_component(spec_component_details.predicate)
+    # Choose GivenSpec or ThenSpec based on the predicate in spec_component_details
+    if spec_component_details.predicate == MUST.given:
+        spec_component = GivenSpec()
+    else:
+        spec_component = ThenSpec()
     store = Memory()
     g = URIRef("http://localhost:7200/test-graph")
     spec_component.value = ConjunctiveGraph(store=store)
@@ -430,7 +482,11 @@ def _get_spec_component_StatementsDataset(spec_component_details: SpecComponentD
 @get_spec_component.method((MUST.AnzoGraphmartDataset, MUST.given))
 @get_spec_component.method((MUST.AnzoGraphmartDataset, MUST.then))
 def _get_spec_component_AnzoGraphmartDataset(spec_component_details: SpecComponentDetails) -> SpecComponent:
-    spec_component = init_spec_component(spec_component_details.predicate)
+    # Choose GivenSpec or ThenSpec based on the predicate in spec_component_details
+    if spec_component_details.predicate == MUST.given:
+        spec_component = GivenSpec()
+    else:
+        spec_component = ThenSpec()
 
     if spec_component_details.mustrd_triple_store["type"] == TRIPLESTORE.Anzo:
         # Get GIVEN or THEN from anzo graphmart
@@ -443,7 +499,7 @@ def _get_spec_component_AnzoGraphmartDataset(spec_component_details: SpecCompone
 
 @get_spec_component.method((MUST.AnzoQueryBuilderSparqlSource, MUST.when))
 def _get_spec_component_AnzoQueryBuilderSparqlSource(spec_component_details: SpecComponentDetails) -> SpecComponent:
-    spec_component = init_spec_component(spec_component_details.predicate)
+    spec_component = WhenSpec()
 
     # Get WHEN specComponent from query builder
     if spec_component_details.mustrd_triple_store["type"] == TRIPLESTORE.Anzo:
@@ -488,7 +544,7 @@ def _get_spec_component_AnzoGraphmartStepSparqlSource(spec_component_details: Sp
 
 @get_spec_component.method((MUST.AnzoGraphmartQueryDrivenTemplatedStepSparqlSource, MUST.when))
 def _get_spec_component_AnzoGraphmartQueryDrivenTemplatedStepSparqlSource(spec_component_details: SpecComponentDetails) -> SpecComponent: # noqa
-    spec_component = init_spec_component(
+    spec_component = WhenSpec(
         spec_component_details.predicate, spec_component_details.mustrd_triple_store["type"])
 
     # Get WHEN specComponent from query builder
@@ -524,8 +580,8 @@ def _get_spec_component_AnzoGraphmartLayerSparqlSource(spec_component_details: S
     else:
         raise ValueError("This test specification is specific to Anzo and can only be run against that platform.")
     for query in queries:
-        spec_component = init_spec_component(spec_component_details.predicate,
-                                             spec_component_details.mustrd_triple_store["type"])
+        spec_component = WhenSpec(
+            spec_component_details.predicate, spec_component_details.mustrd_triple_store["type"])
         spec_component.value = query.get("query")
         spec_component.paramQuery = query.get("param_query")
         spec_component.queryTemplate = query.get("query_template")
@@ -542,23 +598,65 @@ def _get_spec_component_AnzoGraphmartLayerSparqlSource(spec_component_details: S
 
 @get_spec_component.method(Default)
 def _get_spec_component_default(spec_component_details: SpecComponentDetails) -> SpecComponent:
+    valid_combinations = [key for key in get_spec_component.methods.keys() if key != Default]
+
+    if (spec_component_details.data_source_type, spec_component_details.predicate) not in valid_combinations:
+        valid_types = ', '.join([f"({data_source_type}, {predicate})" for data_source_type, predicate in valid_combinations])
+        raise ValueError(
+            f"Invalid combination of data source type ({spec_component_details.data_source_type}) and "
+            f"spec component ({spec_component_details.predicate}). Valid combinations are: {valid_types}"
+        )
     raise ValueError(
         f"Invalid combination of data source type ({spec_component_details.data_source_type}) and "
         f"spec component ({spec_component_details.predicate})")
 
 
-def init_spec_component(predicate: URIRef, triple_store_type: URIRef = None) -> GivenSpec | WhenSpec | ThenSpec | TableThenSpec: # noqa
-    if predicate == MUST.given:
-        spec_component = GivenSpec()
-    elif predicate == MUST.when:
-        if triple_store_type == TRIPLESTORE.Anzo:
-            spec_component = AnzoWhenSpec()
-        else:
-            spec_component = WhenSpec()
-    elif predicate == MUST.then:
-        spec_component = ThenSpec()
-    else:
-        spec_component = SpecComponent()
+@get_spec_component.method((MUST.SpadeEdnGroupSource, MUST.when))
+def _get_spec_component_spadeednsource_when(spec_component_details: SpecComponentDetails) -> SpadeEdnGroupSourceWhenSpec:
+    from edn_format import Keyword
+
+    spec_component = SpadeEdnGroupSourceWhenSpec()
+    spec_component.file = spec_component_details.spec_graph.value(
+        subject=spec_component_details.spec_component_node,
+        predicate=MUST.fileName
+    )
+    spec_component.groupId = spec_component_details.spec_graph.value(
+        subject=spec_component_details.spec_component_node,
+        predicate=MUST.groupId
+    )
+    spec_component.queryType = spec_component_details.spec_graph.value(
+        subject=spec_component_details.spec_component_node,
+        predicate=MUST.queryType
+    )
+
+    # Initialize `value` by parsing the `file` attribute if available
+    if spec_component.file:
+        try:
+            with open(spec_component.file, "r") as edn_file:
+                edn_content = edn_file.read()
+                parsed_edn = edn_format.loads(edn_content)
+
+                # Extract group data based on group ID
+                step_groups = parsed_edn.get(Keyword("step-groups"), [])
+                group_data = next((item for item in step_groups if item.get(Keyword("group-id")) == spec_component.groupId), None)
+
+                if not group_data:
+                    raise ValueError(f"Group ID {spec_component.groupId} not found in EDN file {spec_component.file}")
+
+                # Create a list of WhenSpec objects
+                when_specs = []
+                for step in group_data.get(Keyword("steps"), []):
+                    step_type = step.get(Keyword("type"))
+                    step_file = step.get(Keyword("filepath"))
+
+                    if step_type == Keyword("sparql-file"):
+                        when_specs.append(WhenSpec(value=step_file, queryType=MUST.InsertSparql))
+
+                spec_component.value = when_specs
+        except Exception as e:
+            log.error(f"Failed to parse EDN file {spec_component.file}: {e}")
+            spec_component.value = None
+
     return spec_component
 
 
@@ -634,7 +732,7 @@ def get_spec_from_table(subject: URIRef,
         columns.add(row.variable.value + "_datatype")
     # add an additional column for the sort order (if any) of the results
     columns.add("order")
-    # create an empty dataframe to populate with the results
+    # create an empty dataframe to populate with the results data
     df = pandas.DataFrame(index=list(index), columns=list(columns))
     # fill the dataframe with the results data
     for row in expected_results:
@@ -700,3 +798,84 @@ def is_then_select_ordered(subject: URIRef, predicate: URIRef, spec_graph: Graph
 }}"""
     is_ordered = spec_graph.query(ask_select_ordered)
     return is_ordered.askAnswer
+
+
+@get_spec_component.method((MUST.SpadeEdnGroupSource, MUST.when))
+def _get_spec_component_spade_edn_group_source_when(spec_component_details: SpecComponentDetails) -> SpecComponent:
+    spec_component = SpadeEdnGroupSourceWhenSpec()
+
+    # Retrieve the file path for the EDN file
+    file_path = get_file_or_fileurl(spec_component_details)
+    absolute_file_path = get_file_absolute_path(spec_component_details, file_path)
+
+    # Parse the EDN file
+    try:
+        edn_content = Path(absolute_file_path).read_text()
+        edn_data = edn_format.loads(edn_content)
+    except FileNotFoundError:
+        raise ValueError(f"EDN file not found: {absolute_file_path}")
+    except edn_format.EDNDecodeError as e:
+        raise ValueError(f"Failed to parse EDN file {absolute_file_path}: {e}")
+
+    # Retrieve and normalize the group ID
+    group_id = spec_component_details.spec_graph.value(
+        subject=spec_component_details.spec_component_node,
+        predicate=MUST.groupId
+    )
+
+    if not group_id:
+        raise ValueError("groupId is missing for SpadeEdnGroupSource")
+
+    if str(group_id).startswith(':'):
+        group_id = str(group_id).lstrip(':')
+        from edn_format import Keyword
+        group_id = Keyword(group_id)
+    else:
+        group_id = str(group_id)
+
+    # Extract the relevant group data
+    step_groups = edn_data.get(Keyword("step-groups"), [])
+    group_data = next((item for item in step_groups if item.get(Keyword("group-id")) == group_id), None)
+
+    if not group_data:
+        raise ValueError(f"Group ID {group_id} not found in EDN file {absolute_file_path}")
+
+    # Create a list of WhenSpec objects
+    when_specs = []
+    for step in group_data.get(Keyword("steps"), []):
+        step_type = step.get(Keyword("type"))
+        step_file = step.get(Keyword("filepath"))
+
+        if step_type == Keyword("sparql-file"):
+            try:
+                with open(step_file, 'r') as sparql_file:
+                    sparql_query = sparql_file.read()
+
+                # Assume the individuals are ConstructSparql queries
+                # won't be true for ASK, but good for now.
+                when_spec = WhenSpec(
+                    value=sparql_query,
+                    queryType=MUST.UpdateSparql, 
+                    bindings=None
+                )
+                when_specs.append(when_spec)
+            except FileNotFoundError:
+                raise ValueError(f"SPARQL file not found: {step_file}")
+
+    spec_component.file = str(absolute_file_path)
+    spec_component.groupId = group_id
+    spec_component.value = when_specs
+    spec_component.queryType = MUST.SpadeEdnGroupSource  # Correct query type
+
+    return spec_component
+
+
+def parse_sparql_query(query_string: str):
+    """
+    Parses a SPARQL query string and returns a query object.
+    """
+    try:
+        from rdflib.plugins.sparql.parser import parseQuery
+        return parseQuery(query_string)
+    except Exception as e:
+        raise ValueError(f"Failed to parse SPARQL query: {e}")

mustrd/steprunner.py

@@ -23,6 +23,7 @@ SOFTWARE.
 """
 
 import json
+import os
 
 from multimethods import MultiMethod, Default
 from .namespace import MUST, TRIPLESTORE
@@ -38,8 +39,9 @@ from .mustrdGraphDb import upload_given as upload_given_graphdb
 from .mustrdGraphDb import execute_update as execute_update_graphdb
 from .mustrdGraphDb import execute_construct as execute_construct_graphdb
 from .mustrdGraphDb import execute_select as execute_select_graphdb
-from .spec_component import AnzoWhenSpec, WhenSpec
+from .spec_component import AnzoWhenSpec, WhenSpec, SpadeEdnGroupSourceWhenSpec
 import logging
+from edn_format import loads, Keyword
 
 log = logging.getLogger(__name__)
 
@@ -71,14 +73,14 @@ def _upload_given_anzo(triple_store: dict, given: Graph):
 def dispatch_run_when(spec_uri: URIRef, triple_store: dict, when: WhenSpec):
     ts = triple_store['type']
     query_type = when.queryType
-    log.info(f"dispatch_run_when to SPARQL type {query_type} to {ts}")
+    log.info(f"dispatch_run_when: spec_uri={spec_uri}, ({ts},{query_type})")
     return ts, query_type
 
 
-run_when = MultiMethod('run_when', dispatch_run_when)
+run_when_impl = MultiMethod('run_when', dispatch_run_when)
 
 
-@run_when.method((TRIPLESTORE.Anzo, MUST.UpdateSparql))
+@run_when_impl.method((TRIPLESTORE.Anzo, MUST.UpdateSparql))
 def _anzo_run_when_update(spec_uri: URIRef, triple_store: dict, when: AnzoWhenSpec):
     log.debug(f"_anzo_run_when_update {spec_uri} {triple_store} {when} {type(when)}")
     if when.value is None:
@@ -92,47 +94,47 @@ def _anzo_run_when_update(spec_uri: URIRef, triple_store: dict, when: AnzoWhenSp
     return execute_update_anzo(triple_store, query, when.bindings)
 
 
-@run_when.method((TRIPLESTORE.Anzo, MUST.ConstructSparql))
+@run_when_impl.method((TRIPLESTORE.Anzo, MUST.ConstructSparql))
 def _anzo_run_when_construct(spec_uri: URIRef, triple_store: dict, when: AnzoWhenSpec):
     return execute_construct_anzo(triple_store, when.value, when.bindings)
 
 
-@run_when.method((TRIPLESTORE.Anzo, MUST.SelectSparql))
+@run_when_impl.method((TRIPLESTORE.Anzo, MUST.SelectSparql))
 def _anzo_run_when_select(spec_uri: URIRef, triple_store: dict, when: AnzoWhenSpec):
     return execute_select_anzo(triple_store, when.value, when.bindings)
 
 
-@run_when.method((TRIPLESTORE.GraphDb, MUST.UpdateSparql))
+@run_when_impl.method((TRIPLESTORE.GraphDb, MUST.UpdateSparql))
 def _graphdb_run_when_update(spec_uri: URIRef, triple_store: dict, when: WhenSpec):
     return execute_update_graphdb(triple_store, when.value, when.bindings)
 
 
-@run_when.method((TRIPLESTORE.GraphDb, MUST.ConstructSparql))
+@run_when_impl.method((TRIPLESTORE.GraphDb, MUST.ConstructSparql))
 def _graphdb_run_when_construct(spec_uri: URIRef, triple_store: dict, when: WhenSpec):
     return execute_construct_graphdb(triple_store, when.value, when.bindings)
 
 
-@run_when.method((TRIPLESTORE.GraphDb, MUST.SelectSparql))
+@run_when_impl.method((TRIPLESTORE.GraphDb, MUST.SelectSparql))
 def _graphdb_run_when_select(spec_uri: URIRef, triple_store: dict, when: WhenSpec):
     return execute_select_graphdb(triple_store, when.value, when.bindings)
 
 
-@run_when.method((TRIPLESTORE.RdfLib, MUST.UpdateSparql))
+@run_when_impl.method((TRIPLESTORE.RdfLib, MUST.UpdateSparql))
 def _rdflib_run_when_update(spec_uri: URIRef, triple_store: dict, when: WhenSpec):
     return execute_update_rdflib(triple_store, triple_store["given"], when.value, when.bindings)
 
 
-@run_when.method((TRIPLESTORE.RdfLib, MUST.ConstructSparql))
+@run_when_impl.method((TRIPLESTORE.RdfLib, MUST.ConstructSparql))
 def _rdflib_run_when_construct(spec_uri: URIRef, triple_store: dict, when: WhenSpec):
     return execute_construct_rdflib(triple_store, triple_store["given"], when.value, when.bindings)
 
 
-@run_when.method((TRIPLESTORE.RdfLib, MUST.SelectSparql))
+@run_when_impl.method((TRIPLESTORE.RdfLib, MUST.SelectSparql))
 def _rdflib_run_when_select(spec_uri: URIRef, triple_store: dict, when: WhenSpec):
     return execute_select_rdflib(triple_store, triple_store["given"], when.value, when.bindings)
 
 
-@run_when.method((TRIPLESTORE.Anzo, MUST.AnzoQueryDrivenUpdateSparql))
+@run_when_impl.method((TRIPLESTORE.Anzo, MUST.AnzoQueryDrivenUpdateSparql))
 def _multi_run_when_anzo_query_driven_update(spec_uri: URIRef, triple_store: dict, when: AnzoWhenSpec):
     # run the parameters query to obtain the values for the template step and put them into a dictionary
     query_parameters = json.loads(execute_select_anzo(triple_store, when.paramQuery, None))
@@ -159,7 +161,50 @@ def _multi_run_when_anzo_query_driven_update(spec_uri: URIRef, triple_store: dic
         return result
 
 
-@run_when.method(Default)
+@run_when_impl.method((TRIPLESTORE.Anzo, MUST.SpadeEdnGroupSource))
+def _spade_edn_group_source(spec_uri: URIRef, triple_store: dict, when: SpadeEdnGroupSourceWhenSpec):
+    log.info(f"Running SpadeEdnGroupSource for {spec_uri} using {triple_store}")
+
+    results = []
+
+    # Iterate over the list of WhenSpec objects in `when.value`
+    for step_when_spec in when.value:
+        try:
+            log.info(f"Dispatching run_when for step: {step_when_spec}")
+            query_result = run_when_impl(spec_uri, triple_store, step_when_spec)
+            log.info(f"Executed SPARQL query: {query_result}")
+            results.append(query_result)
+        except Exception as e:
+            log.error(f"Failed to execute SPARQL query: {e}")
+
+    log.debug(f"Final results: {results}")
+    return results
+
+
+@run_when_impl.method((TRIPLESTORE.RdfLib, MUST.SpadeEdnGroupSource))
+def _spade_edn_group_source(spec_uri: URIRef, triple_store: dict, when: SpadeEdnGroupSourceWhenSpec):
+    log.info(f"Running SpadeEdnGroupSource for {spec_uri} using {triple_store}")
+
+    merged_graph = Graph()
+
+    # Iterate over the list of WhenSpec objects in `when.value`
+    for step_when_spec in when.value:
+        try:
+            if step_when_spec.queryType == MUST.UpdateSparql:
+                log.info(f"Dispatching run_when for UpdateSparql step: {step_when_spec}")
+                query_result = run_when_impl(spec_uri, triple_store, step_when_spec)
+                log.info(f"Executed SPARQL query: {query_result}")
+                merged_graph += query_result  # Merge the resulting graph
+            else:
+                log.warning(f"Unsupported queryType: {step_when_spec.queryType}")
+        except Exception as e:
+            log.error(f"Failed to execute SPARQL query: {e}")
+
+    log.debug(f"Final merged graph has {len(merged_graph)} triples.")
+    return merged_graph
+
+
+@run_when_impl.method(Default)
 def _multi_run_when_default(spec_uri: URIRef, triple_store: dict, when: WhenSpec):
     log.error(f"run_when not implemented for {spec_uri} {triple_store} {when}")
     if when.queryType == MUST.AskSparql:
@@ -174,3 +219,6 @@ def _multi_run_when_default(spec_uri: URIRef, triple_store: dict, when: WhenSpec
         log.warning(f"Skipping {spec_uri},  {when.queryType} is not a valid SPARQL query type.")
         msg = f"{when.queryType} is not a valid SPARQL query type."
     raise NotImplementedError(msg)
+
+log.debug(f"run_when registry: {run_when_impl} {dir(run_when_impl)}")
+