pytrilogy 0.3.142__cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (200) hide show
  1. LICENSE.md +19 -0
  2. _preql_import_resolver/__init__.py +5 -0
  3. _preql_import_resolver/_preql_import_resolver.cpython-313-x86_64-linux-gnu.so +0 -0
  4. pytrilogy-0.3.142.dist-info/METADATA +555 -0
  5. pytrilogy-0.3.142.dist-info/RECORD +200 -0
  6. pytrilogy-0.3.142.dist-info/WHEEL +5 -0
  7. pytrilogy-0.3.142.dist-info/entry_points.txt +2 -0
  8. pytrilogy-0.3.142.dist-info/licenses/LICENSE.md +19 -0
  9. trilogy/__init__.py +16 -0
  10. trilogy/ai/README.md +10 -0
  11. trilogy/ai/__init__.py +19 -0
  12. trilogy/ai/constants.py +92 -0
  13. trilogy/ai/conversation.py +107 -0
  14. trilogy/ai/enums.py +7 -0
  15. trilogy/ai/execute.py +50 -0
  16. trilogy/ai/models.py +34 -0
  17. trilogy/ai/prompts.py +100 -0
  18. trilogy/ai/providers/__init__.py +0 -0
  19. trilogy/ai/providers/anthropic.py +106 -0
  20. trilogy/ai/providers/base.py +24 -0
  21. trilogy/ai/providers/google.py +146 -0
  22. trilogy/ai/providers/openai.py +89 -0
  23. trilogy/ai/providers/utils.py +68 -0
  24. trilogy/authoring/README.md +3 -0
  25. trilogy/authoring/__init__.py +148 -0
  26. trilogy/constants.py +113 -0
  27. trilogy/core/README.md +52 -0
  28. trilogy/core/__init__.py +0 -0
  29. trilogy/core/constants.py +6 -0
  30. trilogy/core/enums.py +443 -0
  31. trilogy/core/env_processor.py +120 -0
  32. trilogy/core/environment_helpers.py +320 -0
  33. trilogy/core/ergonomics.py +193 -0
  34. trilogy/core/exceptions.py +123 -0
  35. trilogy/core/functions.py +1227 -0
  36. trilogy/core/graph_models.py +139 -0
  37. trilogy/core/internal.py +85 -0
  38. trilogy/core/models/__init__.py +0 -0
  39. trilogy/core/models/author.py +2669 -0
  40. trilogy/core/models/build.py +2521 -0
  41. trilogy/core/models/build_environment.py +180 -0
  42. trilogy/core/models/core.py +501 -0
  43. trilogy/core/models/datasource.py +322 -0
  44. trilogy/core/models/environment.py +751 -0
  45. trilogy/core/models/execute.py +1177 -0
  46. trilogy/core/optimization.py +251 -0
  47. trilogy/core/optimizations/__init__.py +12 -0
  48. trilogy/core/optimizations/base_optimization.py +17 -0
  49. trilogy/core/optimizations/hide_unused_concept.py +47 -0
  50. trilogy/core/optimizations/inline_datasource.py +102 -0
  51. trilogy/core/optimizations/predicate_pushdown.py +245 -0
  52. trilogy/core/processing/README.md +94 -0
  53. trilogy/core/processing/READMEv2.md +121 -0
  54. trilogy/core/processing/VIRTUAL_UNNEST.md +30 -0
  55. trilogy/core/processing/__init__.py +0 -0
  56. trilogy/core/processing/concept_strategies_v3.py +508 -0
  57. trilogy/core/processing/constants.py +15 -0
  58. trilogy/core/processing/discovery_node_factory.py +451 -0
  59. trilogy/core/processing/discovery_utility.py +548 -0
  60. trilogy/core/processing/discovery_validation.py +167 -0
  61. trilogy/core/processing/graph_utils.py +43 -0
  62. trilogy/core/processing/node_generators/README.md +9 -0
  63. trilogy/core/processing/node_generators/__init__.py +31 -0
  64. trilogy/core/processing/node_generators/basic_node.py +160 -0
  65. trilogy/core/processing/node_generators/common.py +268 -0
  66. trilogy/core/processing/node_generators/constant_node.py +38 -0
  67. trilogy/core/processing/node_generators/filter_node.py +315 -0
  68. trilogy/core/processing/node_generators/group_node.py +213 -0
  69. trilogy/core/processing/node_generators/group_to_node.py +117 -0
  70. trilogy/core/processing/node_generators/multiselect_node.py +205 -0
  71. trilogy/core/processing/node_generators/node_merge_node.py +653 -0
  72. trilogy/core/processing/node_generators/recursive_node.py +88 -0
  73. trilogy/core/processing/node_generators/rowset_node.py +165 -0
  74. trilogy/core/processing/node_generators/select_helpers/__init__.py +0 -0
  75. trilogy/core/processing/node_generators/select_helpers/datasource_injection.py +261 -0
  76. trilogy/core/processing/node_generators/select_merge_node.py +748 -0
  77. trilogy/core/processing/node_generators/select_node.py +95 -0
  78. trilogy/core/processing/node_generators/synonym_node.py +98 -0
  79. trilogy/core/processing/node_generators/union_node.py +91 -0
  80. trilogy/core/processing/node_generators/unnest_node.py +182 -0
  81. trilogy/core/processing/node_generators/window_node.py +201 -0
  82. trilogy/core/processing/nodes/README.md +28 -0
  83. trilogy/core/processing/nodes/__init__.py +179 -0
  84. trilogy/core/processing/nodes/base_node.py +519 -0
  85. trilogy/core/processing/nodes/filter_node.py +75 -0
  86. trilogy/core/processing/nodes/group_node.py +194 -0
  87. trilogy/core/processing/nodes/merge_node.py +420 -0
  88. trilogy/core/processing/nodes/recursive_node.py +46 -0
  89. trilogy/core/processing/nodes/select_node_v2.py +242 -0
  90. trilogy/core/processing/nodes/union_node.py +53 -0
  91. trilogy/core/processing/nodes/unnest_node.py +62 -0
  92. trilogy/core/processing/nodes/window_node.py +56 -0
  93. trilogy/core/processing/utility.py +823 -0
  94. trilogy/core/query_processor.py +596 -0
  95. trilogy/core/statements/README.md +35 -0
  96. trilogy/core/statements/__init__.py +0 -0
  97. trilogy/core/statements/author.py +536 -0
  98. trilogy/core/statements/build.py +0 -0
  99. trilogy/core/statements/common.py +20 -0
  100. trilogy/core/statements/execute.py +155 -0
  101. trilogy/core/table_processor.py +66 -0
  102. trilogy/core/utility.py +8 -0
  103. trilogy/core/validation/README.md +46 -0
  104. trilogy/core/validation/__init__.py +0 -0
  105. trilogy/core/validation/common.py +161 -0
  106. trilogy/core/validation/concept.py +146 -0
  107. trilogy/core/validation/datasource.py +227 -0
  108. trilogy/core/validation/environment.py +73 -0
  109. trilogy/core/validation/fix.py +256 -0
  110. trilogy/dialect/__init__.py +32 -0
  111. trilogy/dialect/base.py +1392 -0
  112. trilogy/dialect/bigquery.py +308 -0
  113. trilogy/dialect/common.py +147 -0
  114. trilogy/dialect/config.py +144 -0
  115. trilogy/dialect/dataframe.py +50 -0
  116. trilogy/dialect/duckdb.py +231 -0
  117. trilogy/dialect/enums.py +147 -0
  118. trilogy/dialect/metadata.py +173 -0
  119. trilogy/dialect/mock.py +190 -0
  120. trilogy/dialect/postgres.py +117 -0
  121. trilogy/dialect/presto.py +110 -0
  122. trilogy/dialect/results.py +89 -0
  123. trilogy/dialect/snowflake.py +129 -0
  124. trilogy/dialect/sql_server.py +137 -0
  125. trilogy/engine.py +48 -0
  126. trilogy/execution/config.py +75 -0
  127. trilogy/executor.py +568 -0
  128. trilogy/hooks/__init__.py +4 -0
  129. trilogy/hooks/base_hook.py +40 -0
  130. trilogy/hooks/graph_hook.py +139 -0
  131. trilogy/hooks/query_debugger.py +166 -0
  132. trilogy/metadata/__init__.py +0 -0
  133. trilogy/parser.py +10 -0
  134. trilogy/parsing/README.md +21 -0
  135. trilogy/parsing/__init__.py +0 -0
  136. trilogy/parsing/common.py +1069 -0
  137. trilogy/parsing/config.py +5 -0
  138. trilogy/parsing/exceptions.py +8 -0
  139. trilogy/parsing/helpers.py +1 -0
  140. trilogy/parsing/parse_engine.py +2813 -0
  141. trilogy/parsing/render.py +769 -0
  142. trilogy/parsing/trilogy.lark +540 -0
  143. trilogy/py.typed +0 -0
  144. trilogy/render.py +42 -0
  145. trilogy/scripts/README.md +9 -0
  146. trilogy/scripts/__init__.py +0 -0
  147. trilogy/scripts/agent.py +41 -0
  148. trilogy/scripts/agent_info.py +303 -0
  149. trilogy/scripts/common.py +355 -0
  150. trilogy/scripts/dependency/Cargo.lock +617 -0
  151. trilogy/scripts/dependency/Cargo.toml +39 -0
  152. trilogy/scripts/dependency/README.md +131 -0
  153. trilogy/scripts/dependency/build.sh +25 -0
  154. trilogy/scripts/dependency/src/directory_resolver.rs +177 -0
  155. trilogy/scripts/dependency/src/lib.rs +16 -0
  156. trilogy/scripts/dependency/src/main.rs +770 -0
  157. trilogy/scripts/dependency/src/parser.rs +435 -0
  158. trilogy/scripts/dependency/src/preql.pest +208 -0
  159. trilogy/scripts/dependency/src/python_bindings.rs +303 -0
  160. trilogy/scripts/dependency/src/resolver.rs +716 -0
  161. trilogy/scripts/dependency/tests/base.preql +3 -0
  162. trilogy/scripts/dependency/tests/cli_integration.rs +377 -0
  163. trilogy/scripts/dependency/tests/customer.preql +6 -0
  164. trilogy/scripts/dependency/tests/main.preql +9 -0
  165. trilogy/scripts/dependency/tests/orders.preql +7 -0
  166. trilogy/scripts/dependency/tests/test_data/base.preql +9 -0
  167. trilogy/scripts/dependency/tests/test_data/consumer.preql +1 -0
  168. trilogy/scripts/dependency.py +323 -0
  169. trilogy/scripts/display.py +512 -0
  170. trilogy/scripts/environment.py +46 -0
  171. trilogy/scripts/fmt.py +32 -0
  172. trilogy/scripts/ingest.py +471 -0
  173. trilogy/scripts/ingest_helpers/__init__.py +1 -0
  174. trilogy/scripts/ingest_helpers/foreign_keys.py +123 -0
  175. trilogy/scripts/ingest_helpers/formatting.py +93 -0
  176. trilogy/scripts/ingest_helpers/typing.py +161 -0
  177. trilogy/scripts/init.py +105 -0
  178. trilogy/scripts/parallel_execution.py +713 -0
  179. trilogy/scripts/plan.py +189 -0
  180. trilogy/scripts/run.py +63 -0
  181. trilogy/scripts/serve.py +140 -0
  182. trilogy/scripts/serve_helpers/__init__.py +41 -0
  183. trilogy/scripts/serve_helpers/file_discovery.py +142 -0
  184. trilogy/scripts/serve_helpers/index_generation.py +206 -0
  185. trilogy/scripts/serve_helpers/models.py +38 -0
  186. trilogy/scripts/single_execution.py +131 -0
  187. trilogy/scripts/testing.py +119 -0
  188. trilogy/scripts/trilogy.py +68 -0
  189. trilogy/std/__init__.py +0 -0
  190. trilogy/std/color.preql +3 -0
  191. trilogy/std/date.preql +13 -0
  192. trilogy/std/display.preql +18 -0
  193. trilogy/std/geography.preql +22 -0
  194. trilogy/std/metric.preql +15 -0
  195. trilogy/std/money.preql +67 -0
  196. trilogy/std/net.preql +14 -0
  197. trilogy/std/ranking.preql +7 -0
  198. trilogy/std/report.preql +5 -0
  199. trilogy/std/semantic.preql +6 -0
  200. trilogy/utility.py +34 -0
@@ -0,0 +1,139 @@
1
+ from logging import Logger
2
+ from typing import Union
3
+
4
+ import networkx as nx
5
+
6
+ from trilogy.core.models.build import BuildConcept, BuildDatasource, BuildWhereClause
7
+
8
+
9
+ def get_graph_exact_match(
10
+ g: Union[nx.DiGraph, "ReferenceGraph"],
11
+ accept_partial: bool,
12
+ conditions: BuildWhereClause | None,
13
+ ) -> set[str]:
14
+ exact: set[str] = set()
15
+ for node, ds in g.datasources.items():
16
+ if isinstance(ds, list):
17
+ exact.add(node)
18
+ continue
19
+
20
+ if not conditions and not ds.non_partial_for:
21
+ exact.add(node)
22
+ continue
23
+ elif not conditions and accept_partial and ds.non_partial_for:
24
+ exact.add(node)
25
+ continue
26
+ elif conditions:
27
+ if not ds.non_partial_for:
28
+ continue
29
+ if ds.non_partial_for and conditions == ds.non_partial_for:
30
+ exact.add(node)
31
+ continue
32
+ else:
33
+ continue
34
+
35
+ return exact
36
+
37
+
38
+ def prune_sources_for_conditions(
39
+ g: "ReferenceGraph",
40
+ accept_partial: bool,
41
+ conditions: BuildWhereClause | None,
42
+ ):
43
+ complete = get_graph_exact_match(g, accept_partial, conditions)
44
+ to_remove = []
45
+ for node in g.datasources:
46
+ if node not in complete:
47
+ to_remove.append(node)
48
+
49
+ for node in to_remove:
50
+ g.remove_node(node)
51
+
52
+
53
+ def prune_sources_for_aggregates(
54
+ g: "ReferenceGraph",
55
+ all_concepts: list[BuildConcept],
56
+ logger: Logger,
57
+ ) -> None:
58
+ required_grains = []
59
+ for x in all_concepts:
60
+ logger.debug(
61
+ f"Checking concept {x.address} at grain {x.grain}, is_aggregate={x.is_aggregate}"
62
+ )
63
+ if x.is_aggregate:
64
+ logger.debug(f"Aggregate found: {x.address} at grain {x.grain}")
65
+ required_grains.append(x.grain)
66
+ # if no aggregates, exit
67
+ logger.debug(f"Required grains for aggregates: {required_grains}")
68
+ if not required_grains:
69
+
70
+ return
71
+ # if we have distinct grains required, exit
72
+ if len(required_grains) > 1:
73
+ logger.debug("Multiple required grains found, cannot prune datasources.")
74
+ return
75
+ to_remove = []
76
+ for node, ds in g.datasources.items():
77
+ if ds.grain != required_grains[0]:
78
+ logger.debug(f"Removing datasource {node} at grain {ds.grain}")
79
+ to_remove.append(node)
80
+ for node in to_remove:
81
+ g.remove_node(node)
82
+ return
83
+
84
+
85
+ def concept_to_node(input: BuildConcept) -> str:
86
+ # if input.purpose == Purpose.METRIC:
87
+ # return f"c~{input.namespace}.{input.name}@{input.grain}"
88
+ return f"c~{input.canonical_address}@{input.grain.str_no_condition}"
89
+
90
+
91
+ def datasource_to_node(input: BuildDatasource) -> str:
92
+ # if isinstance(input, JoinedDataSource):
93
+ # return "ds~join~" + ",".join(
94
+ # [datasource_to_node(sub) for sub in input.datasources]
95
+ # )
96
+ return f"ds~{input.identifier}"
97
+
98
+
99
+ class ReferenceGraph(nx.DiGraph):
100
+ def __init__(self, *args, **kwargs) -> None:
101
+ super().__init__(*args, **kwargs)
102
+ self.concepts: dict[str, BuildConcept] = {}
103
+ self.datasources: dict[str, BuildDatasource] = {}
104
+ self.pseudonyms: set[tuple[str, str]] = set()
105
+
106
+ def copy(self) -> "ReferenceGraph":
107
+ g = ReferenceGraph()
108
+ g.concepts = self.concepts.copy()
109
+ g.datasources = self.datasources.copy()
110
+ g.pseudonyms = {*self.pseudonyms}
111
+ # g.add_nodes_from(self.nodes(data=True))
112
+ for node in self.nodes:
113
+ g.add_node(node, fast=True)
114
+ for edge in self.edges:
115
+ g.add_edge(edge[0], edge[1], fast=True)
116
+ # g.add_edges_from(self.edges(data=True))
117
+ return g
118
+
119
+ def remove_node(self, n) -> None:
120
+ if n in self.concepts:
121
+ del self.concepts[n]
122
+ if n in self.datasources:
123
+ del self.datasources[n]
124
+ super().remove_node(n)
125
+
126
+ def add_node(self, node_for_adding, fast: bool = False, **attr):
127
+ if fast:
128
+ return super().add_node(node_for_adding, **attr)
129
+ node_name = node_for_adding
130
+ if attr.get("datasource"):
131
+ self.datasources[node_name] = attr["datasource"]
132
+ super().add_node(node_name, **attr)
133
+
134
+ def add_datasource_node(self, node_name, datasource) -> None:
135
+ self.datasources[node_name] = datasource
136
+ super().add_node(node_name, datasource=datasource)
137
+
138
+ def add_edge(self, u_of_edge, v_of_edge, fast: bool = False, **attr):
139
+ return super().add_edge(u_of_edge, v_of_edge, **attr)
@@ -0,0 +1,85 @@
1
+ from trilogy.core.constants import ALL_ROWS_CONCEPT, INTERNAL_NAMESPACE
2
+ from trilogy.core.enums import Derivation, FunctionType, Granularity, Purpose
3
+ from trilogy.core.models.author import Concept, Function, Grain
4
+ from trilogy.core.models.core import DataType
5
+
6
+ DEFAULT_CONCEPTS = {
7
+ ALL_ROWS_CONCEPT: Concept(
8
+ name=ALL_ROWS_CONCEPT,
9
+ namespace=INTERNAL_NAMESPACE,
10
+ datatype=DataType.INTEGER,
11
+ purpose=Purpose.CONSTANT,
12
+ grain=Grain(),
13
+ lineage=Function(
14
+ operator=FunctionType.CONSTANT,
15
+ arguments=[1],
16
+ output_datatype=DataType.INTEGER,
17
+ output_purpose=Purpose.CONSTANT,
18
+ ),
19
+ granularity=Granularity.SINGLE_ROW,
20
+ derivation=Derivation.CONSTANT,
21
+ ),
22
+ "concept_address": Concept(
23
+ name="concept_address",
24
+ namespace=INTERNAL_NAMESPACE,
25
+ datatype=DataType.STRING,
26
+ purpose=Purpose.KEY,
27
+ grain=Grain(),
28
+ granularity=Granularity.SINGLE_ROW,
29
+ derivation=Derivation.CONSTANT,
30
+ ),
31
+ "concept_datatype": Concept(
32
+ name="concept_datatype",
33
+ namespace=INTERNAL_NAMESPACE,
34
+ datatype=DataType.STRING,
35
+ purpose=Purpose.KEY,
36
+ grain=Grain(),
37
+ granularity=Granularity.SINGLE_ROW,
38
+ derivation=Derivation.CONSTANT,
39
+ ),
40
+ "concept_description": Concept(
41
+ name="concept_description",
42
+ namespace=INTERNAL_NAMESPACE,
43
+ datatype=DataType.STRING,
44
+ purpose=Purpose.KEY,
45
+ grain=Grain(),
46
+ granularity=Granularity.SINGLE_ROW,
47
+ derivation=Derivation.CONSTANT,
48
+ ),
49
+ "datasource": Concept(
50
+ name="datasource",
51
+ namespace=INTERNAL_NAMESPACE,
52
+ datatype=DataType.STRING,
53
+ purpose=Purpose.KEY,
54
+ grain=Grain(),
55
+ granularity=Granularity.SINGLE_ROW,
56
+ derivation=Derivation.CONSTANT,
57
+ ),
58
+ "query_text": Concept(
59
+ name="query_text",
60
+ namespace=INTERNAL_NAMESPACE,
61
+ datatype=DataType.STRING,
62
+ purpose=Purpose.KEY,
63
+ grain=Grain(),
64
+ granularity=Granularity.SINGLE_ROW,
65
+ derivation=Derivation.CONSTANT,
66
+ ),
67
+ "label": Concept(
68
+ name="label",
69
+ namespace=INTERNAL_NAMESPACE,
70
+ datatype=DataType.STRING,
71
+ purpose=Purpose.KEY,
72
+ grain=Grain(),
73
+ granularity=Granularity.SINGLE_ROW,
74
+ derivation=Derivation.CONSTANT,
75
+ ),
76
+ "expected": Concept(
77
+ name="expected_value",
78
+ namespace=INTERNAL_NAMESPACE,
79
+ datatype=DataType.STRING,
80
+ purpose=Purpose.KEY,
81
+ grain=Grain(),
82
+ granularity=Granularity.SINGLE_ROW,
83
+ derivation=Derivation.CONSTANT,
84
+ ),
85
+ }
File without changes