pytrilogy 0.3.149__cp313-cp313-win_amd64.whl

trilogy/core/processing/nodes/recursive_node.py

@@ -0,0 +1,46 @@
+from typing import List
+
+from trilogy.core.enums import SourceType
+from trilogy.core.models.build import BuildConcept
+from trilogy.core.models.build_environment import BuildEnvironment
+from trilogy.core.models.execute import QueryDatasource
+from trilogy.core.processing.nodes.base_node import StrategyNode
+
+
+class RecursiveNode(StrategyNode):
+    """Union nodes represent combining two keyspaces"""
+
+    source_type = SourceType.RECURSIVE
+
+    def __init__(
+        self,
+        input_concepts: List[BuildConcept],
+        output_concepts: List[BuildConcept],
+        environment: BuildEnvironment,
+        whole_grain: bool = False,
+        parents: List["StrategyNode"] | None = None,
+        depth: int = 0,
+    ):
+        super().__init__(
+            input_concepts=input_concepts,
+            output_concepts=output_concepts,
+            environment=environment,
+            whole_grain=whole_grain,
+            parents=parents,
+            depth=depth,
+        )
+
+    def _resolve(self) -> QueryDatasource:
+        """We need to ensure that any filtered values are removed from the output to avoid inappropriate references"""
+        base = super()._resolve()
+        return base
+
+    def copy(self) -> "RecursiveNode":
+        return RecursiveNode(
+            input_concepts=list(self.input_concepts),
+            output_concepts=list(self.output_concepts),
+            environment=self.environment,
+            whole_grain=self.whole_grain,
+            parents=self.parents,
+            depth=self.depth,
+        )

trilogy/core/processing/nodes/select_node_v2.py

@@ -0,0 +1,242 @@
+from typing import List, Optional
+
+from trilogy.constants import logger
+from trilogy.core.constants import CONSTANT_DATASET
+from trilogy.core.enums import Derivation, Purpose, SourceType
+from trilogy.core.models.build import (
+    BuildComparison,
+    BuildConcept,
+    BuildConditional,
+    BuildDatasource,
+    BuildFunction,
+    BuildGrain,
+    BuildOrderBy,
+    BuildParenthetical,
+)
+from trilogy.core.models.build_environment import BuildEnvironment
+from trilogy.core.models.execute import QueryDatasource, UnnestJoin
+from trilogy.core.processing.nodes.base_node import StrategyNode, resolve_concept_map
+from trilogy.utility import unique
+
+LOGGER_PREFIX = "[CONCEPT DETAIL - SELECT NODE]"
+
+
+class SelectNode(StrategyNode):
+    """Select nodes actually fetch raw data from a table
+    Responsible for selecting the cheapest option from which to select.
+    """
+
+    source_type = SourceType.SELECT
+
+    def __init__(
+        self,
+        input_concepts: List[BuildConcept],
+        output_concepts: List[BuildConcept],
+        environment: BuildEnvironment,
+        datasource: BuildDatasource | None = None,
+        whole_grain: bool = False,
+        parents: List["StrategyNode"] | None = None,
+        depth: int = 0,
+        partial_concepts: List[BuildConcept] | None = None,
+        nullable_concepts: List[BuildConcept] | None = None,
+        accept_partial: bool = False,
+        grain: Optional[BuildGrain] = None,
+        force_group: bool | None = False,
+        conditions: (
+            BuildConditional | BuildComparison | BuildParenthetical | None
+        ) = None,
+        preexisting_conditions: (
+            BuildConditional | BuildComparison | BuildParenthetical | None
+        ) = None,
+        hidden_concepts: set[str] | None = None,
+        ordering: BuildOrderBy | None = None,
+    ):
+        super().__init__(
+            input_concepts=input_concepts,
+            output_concepts=output_concepts,
+            environment=environment,
+            whole_grain=whole_grain,
+            parents=parents,
+            depth=depth,
+            partial_concepts=partial_concepts,
+            nullable_concepts=nullable_concepts,
+            force_group=force_group,
+            grain=grain,
+            conditions=conditions,
+            preexisting_conditions=preexisting_conditions,
+            hidden_concepts=hidden_concepts,
+            ordering=ordering,
+        )
+        self.accept_partial = accept_partial
+        self.datasource = datasource
+
+    def validate_inputs(self):
+        # we do not need to validate inputs for a select node
+        # as it will be a root
+        return
+
+    def resolve_from_provided_datasource(
+        self,
+    ) -> QueryDatasource:
+        if not self.datasource:
+            raise ValueError("Datasource not provided")
+        datasource: BuildDatasource = self.datasource
+
+        all_concepts_final: List[BuildConcept] = unique(self.all_concepts, "address")
+        source_map: dict[str, set[BuildDatasource | QueryDatasource | UnnestJoin]] = {
+            concept.address: {datasource} for concept in self.input_concepts
+        }
+
+        derived_concepts = [
+            c
+            for c in datasource.columns
+            if isinstance(c.alias, BuildFunction) and c.concept.address in source_map
+        ]
+        for c in derived_concepts:
+            if not isinstance(c.alias, BuildFunction):
+                continue
+            for x in c.alias.concept_arguments:
+                source_map[x.address] = {datasource}
+        for x in all_concepts_final:
+            if x.address not in source_map and x.derivation in (
+                Derivation.MULTISELECT,
+                Derivation.FILTER,
+                Derivation.BASIC,
+                Derivation.ROWSET,
+                Derivation.BASIC,
+                Derivation.UNION,
+            ):
+                source_map[x.address] = set()
+
+        # if we're not grouping
+        # force grain to datasource grain
+        # so that we merge on the same grain
+        if self.force_group is False:
+            grain = datasource.grain
+        else:
+            grain = self.grain or BuildGrain()
+        return QueryDatasource(
+            input_concepts=self.input_concepts,
+            output_concepts=all_concepts_final,
+            source_map=source_map,
+            datasources=[datasource],
+            grain=grain,
+            joins=[],
+            partial_concepts=[
+                c.concept for c in datasource.columns if not c.is_complete
+            ],
+            nullable_concepts=[c.concept for c in datasource.columns if c.is_nullable],
+            source_type=SourceType.DIRECT_SELECT,
+            # we can skip rendering conditions
+            condition=self.conditions,
+            # select nodes should never group
+            force_group=self.force_group,
+            hidden_concepts=self.hidden_concepts,
+            ordering=self.ordering,
+        )
+
+    def resolve_from_constant_datasources(self) -> QueryDatasource:
+        datasource = BuildDatasource(
+            name=CONSTANT_DATASET, address=CONSTANT_DATASET, columns=[]
+        )
+        return QueryDatasource(
+            input_concepts=[],
+            output_concepts=unique(self.all_concepts, "address"),
+            source_map={concept.address: set() for concept in self.all_concepts},
+            datasources=[datasource],
+            grain=datasource.grain,
+            condition=self.conditions,
+            joins=[],
+            partial_concepts=[],
+            source_type=SourceType.CONSTANT,
+            hidden_concepts=self.hidden_concepts,
+            ordering=self.ordering,
+        )
+
+    def _resolve(self) -> QueryDatasource:
+        # if we have parent nodes, we do not need to go to a datasource
+        resolution: QueryDatasource | None = None
+        if all(
+            [
+                (
+                    c.derivation == Derivation.CONSTANT
+                    or (
+                        c.purpose == Purpose.CONSTANT
+                        and c.derivation == Derivation.MULTISELECT
+                    )
+                )
+                for c in self.all_concepts
+            ]
+        ):
+            logger.info(
+                f"{self.logging_prefix}{LOGGER_PREFIX} have a constant datasource"
+            )
+            resolution = self.resolve_from_constant_datasources()
+            return resolution
+
+        if self.datasource and not resolution:
+            resolution = self.resolve_from_provided_datasource()
+
+        if self.parents:
+            if not resolution:
+                return super()._resolve()
+            # zip in our parent source map
+            parent_sources: List[QueryDatasource | BuildDatasource] = [
+                p.resolve() for p in self.parents
+            ]
+
+            resolution.datasources += parent_sources
+
+            source_map = resolve_concept_map(
+                parent_sources,
+                targets=self.output_concepts,
+                inherited_inputs=self.input_concepts + self.existence_concepts,
+            )
+            for k, v in source_map.items():
+                if v and k not in resolution.source_map:
+                    resolution.source_map[k] = v
+        if not resolution:
+            raise ValueError(f"No select node could be generated for {self}")
+        return resolution
+
+    def copy(self) -> "SelectNode":
+        return SelectNode(
+            input_concepts=list(self.input_concepts),
+            output_concepts=list(self.output_concepts),
+            environment=self.environment,
+            datasource=self.datasource,
+            depth=self.depth,
+            parents=self.parents,
+            whole_grain=self.whole_grain,
+            partial_concepts=list(self.partial_concepts),
+            nullable_concepts=list(self.nullable_concepts),
+            accept_partial=self.accept_partial,
+            grain=self.grain,
+            force_group=self.force_group,
+            conditions=self.conditions,
+            preexisting_conditions=self.preexisting_conditions,
+            hidden_concepts=self.hidden_concepts,
+            ordering=self.ordering,
+        )
+
+
+class ConstantNode(SelectNode):
+    source_type = SourceType.CONSTANT
+    """Represents a constant value."""
+
+    def copy(self) -> "ConstantNode":
+        return ConstantNode(
+            input_concepts=list(self.input_concepts),
+            output_concepts=list(self.output_concepts),
+            environment=self.environment,
+            datasource=self.datasource,
+            depth=self.depth,
+            partial_concepts=list(self.partial_concepts),
+            conditions=self.conditions,
+            preexisting_conditions=self.preexisting_conditions,
+            hidden_concepts=self.hidden_concepts,
+            ordering=self.ordering,
+        )
+
+    def _resolve(self) -> QueryDatasource:
+        return self.resolve_from_constant_datasources()

trilogy/core/processing/nodes/union_node.py

@@ -0,0 +1,53 @@
+from typing import List
+
+from trilogy.core.enums import SourceType
+from trilogy.core.models.build import BuildConcept
+from trilogy.core.models.execute import QueryDatasource
+from trilogy.core.processing.nodes.base_node import StrategyNode
+
+
+class UnionNode(StrategyNode):
+    """Union nodes represent combining two keyspaces"""
+
+    source_type = SourceType.UNION
+
+    def __init__(
+        self,
+        input_concepts: List[BuildConcept],
+        output_concepts: List[BuildConcept],
+        environment,
+        whole_grain: bool = False,
+        parents: List["StrategyNode"] | None = None,
+        depth: int = 0,
+        partial_concepts: List[BuildConcept] | None = None,
+    ):
+        super().__init__(
+            input_concepts=input_concepts,
+            output_concepts=output_concepts,
+            environment=environment,
+            whole_grain=whole_grain,
+            parents=parents,
+            depth=depth,
+            partial_concepts=partial_concepts,
+        )
+        if self.partial_concepts != []:
+            raise ValueError(
+                f"UnionNode should not have partial concepts, has {self.partial_concepts}, was given {partial_concepts}"
+            )
+        self.partial_concepts = []
+
+    def _resolve(self) -> QueryDatasource:
+        """We need to ensure that any filtered values are removed from the output to avoid inappropriate references"""
+        base = super()._resolve()
+        return base
+
+    def copy(self) -> "UnionNode":
+        return UnionNode(
+            input_concepts=list(self.input_concepts),
+            output_concepts=list(self.output_concepts),
+            environment=self.environment,
+            whole_grain=self.whole_grain,
+            parents=[x.copy() for x in self.parents] if self.parents else None,
+            depth=self.depth,
+            partial_concepts=self.partial_concepts,
+        )

trilogy/core/processing/nodes/unnest_node.py

@@ -0,0 +1,62 @@
+from typing import List
+
+from trilogy.core.enums import SourceType
+from trilogy.core.models.build import BuildConcept, BuildFunction
+from trilogy.core.models.execute import QueryDatasource, UnnestJoin
+from trilogy.core.processing.nodes.base_node import StrategyNode
+
+
+class UnnestNode(StrategyNode):
+    """Unnest nodes represent an expansion of an array or other
+    column into rows.
+    """
+
+    source_type = SourceType.UNNEST
+
+    def __init__(
+        self,
+        unnest_concepts: List[BuildConcept],
+        input_concepts: List[BuildConcept],
+        output_concepts: List[BuildConcept],
+        environment,
+        whole_grain: bool = False,
+        parents: List["StrategyNode"] | None = None,
+        depth: int = 0,
+    ):
+        super().__init__(
+            input_concepts=input_concepts,
+            output_concepts=output_concepts,
+            environment=environment,
+            whole_grain=whole_grain,
+            parents=parents,
+            depth=depth,
+        )
+        self.unnest_concepts = unnest_concepts
+
+    def _resolve(self) -> QueryDatasource:
+        """We need to ensure that any filtered values are removed from the output to avoid inappropriate references"""
+        base = super()._resolve()
+        lineage = self.unnest_concepts[0].lineage
+        assert isinstance(lineage, BuildFunction)
+        final = "_".join(set([c.address for c in self.unnest_concepts]))
+        unnest = UnnestJoin(
+            concepts=self.unnest_concepts,
+            parent=lineage,
+            alias=f'unnest_{final.replace(".", "_")}',
+        )
+        base.joins.append(unnest)
+        for unnest_concept in self.unnest_concepts:
+            base.source_map[unnest_concept.address] = {unnest}
+            base.join_derived_concepts = [unnest_concept]
+        return base
+
+    def copy(self) -> "UnnestNode":
+        return UnnestNode(
+            unnest_concepts=self.unnest_concepts,
+            input_concepts=list(self.input_concepts),
+            output_concepts=list(self.output_concepts),
+            environment=self.environment,
+            whole_grain=self.whole_grain,
+            parents=self.parents,
+            depth=self.depth,
+        )

trilogy/core/processing/nodes/window_node.py

@@ -0,0 +1,56 @@
+from typing import List
+
+from trilogy.core.enums import SourceType
+from trilogy.core.models.build import (
+    BuildComparison,
+    BuildConcept,
+    BuildConditional,
+    BuildOrderBy,
+    BuildParenthetical,
+)
+from trilogy.core.models.execute import QueryDatasource
+from trilogy.core.processing.nodes.base_node import StrategyNode
+
+
+class WindowNode(StrategyNode):
+    source_type = SourceType.WINDOW
+
+    def __init__(
+        self,
+        input_concepts: List[BuildConcept],
+        output_concepts: List[BuildConcept],
+        environment,
+        whole_grain: bool = False,
+        parents: List["StrategyNode"] | None = None,
+        depth: int = 0,
+        ordering: BuildOrderBy | None = None,
+        preexisting_conditions: (
+            BuildConditional | BuildComparison | BuildParenthetical | None
+        ) = None,
+    ):
+        super().__init__(
+            input_concepts=input_concepts,
+            output_concepts=output_concepts,
+            environment=environment,
+            whole_grain=whole_grain,
+            parents=parents,
+            depth=depth,
+            ordering=ordering,
+            preexisting_conditions=preexisting_conditions,
+        )
+
+    def _resolve(self) -> QueryDatasource:
+        base = super()._resolve()
+        return base
+
+    def copy(self) -> "WindowNode":
+        return WindowNode(
+            input_concepts=list(self.input_concepts),
+            output_concepts=list(self.output_concepts),
+            environment=self.environment,
+            whole_grain=self.whole_grain,
+            parents=self.parents,
+            depth=self.depth,
+            ordering=self.ordering,
+            preexisting_conditions=self.preexisting_conditions,
+        )