Move test fixtures to tests/fixtures/ and fix example scripts

Moved test fixture YAML/LookML files from examples/ to tests/fixtures/:
- All adapter test fixtures (cube, lookml, metricflow, hex, omni, rill, superset, sidemantic, sql)
- Updated all test imports to use tests/fixtures/ paths
- Updated export_example.py to reference new fixture location
- multi_format_demo/ remains in examples/ as a user-facing demo

Fixed broken example scripts with PEP 723 dependencies:
- comprehensive_demo.py: Added sidemantic dep, fixed QueryRewriter import, updated to use 'metrics' virtual table
- comprehensive_example.py: Added sidemantic dep
- symmetric_aggregates_example.py: Added sidemantic and pandas deps
- streamlit_dashboard.py: Added sidemantic dep

Added test coverage for unreferenced fixture files:
- test_lookml_bq_thelook_derived_table
- test_lookml_bq_thelook_user_facts
- test_import_omni_model_relationships

All example scripts now run successfully with uv run.

Author: nicosuave

examples/comprehensive_demo.py

@@ -14,29 +14,21 @@
 """
 # /// script
 # dependencies = [
+#   "sidemantic",
 #   "duckdb",
-#   "sqlglot",
-#   "pydantic",
-#   "pyyaml"
 # ]
 # requires-python = ">=3.12"
 # ///
 
-# Add parent directory to path so we can import sidemantic
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent.parent))
-
 import duckdb
-from sidemantic.sql.rewriter import SemanticSQLRewriter
 
 from sidemantic.core.dimension import Dimension
 from sidemantic.core.metric import Metric
 from sidemantic.core.model import Model
 from sidemantic.core.relationship import Relationship
 from sidemantic.core.semantic_graph import SemanticGraph
 from sidemantic.sql.generator import SQLGenerator
+from sidemantic.sql.query_rewriter import QueryRewriter
 
 
 def print_section(title: str):
@@ -198,16 +190,16 @@ def main():
     # =========================================================================
     print_section("4. SQL Rewriter: Write SQL Against Semantic Layer")
 
-    rewriter = SemanticSQLRewriter(graph)
+    rewriter = QueryRewriter(graph)
 
     # Example 1: Simple query without GROUP BY
     print("\nExample 1: Query without GROUP BY")
     user_sql = """
         SELECT
-            status,
+            orders.status,
             total_revenue,
             avg_order_value
-        FROM semantic_layer.orders
+        FROM metrics
     """
     print(f"\nUser writes:\n{user_sql}")
 
@@ -217,52 +209,41 @@ def main():
     results = conn.execute(rewritten).fetchall()
     print_results(results, "Revenue Metrics by Status")
 
-    # Example 2: Join semantic layer with regular table
-    print("\nExample 2: Join semantic layer with regular table")
-
-    # Create a regular table
-    conn.execute("""
-        CREATE TABLE IF NOT EXISTS promotions AS
-        SELECT 'completed' AS status, 'Completion Bonus' AS promo_name, 0.10 AS discount
-        UNION ALL
-        SELECT 'pending', 'Pending Discount', 0.05
-    """)
+    # Example 2: Query from single model
+    print("\nExample 2: Query from single model")
 
     user_sql = """
         SELECT
-            o.status,
-            o.total_revenue,
-            p.promo_name,
-            p.discount
-        FROM semantic_layer.orders AS o
-        JOIN promotions AS p ON o.status = p.status
+            orders.status,
+            orders.amount AS revenue,
+            orders.order_count
+        FROM orders
     """
     print(f"\nUser writes:\n{user_sql}")
 
     rewritten = rewriter.rewrite(user_sql)
     print_sql(rewritten)
 
     results = conn.execute(rewritten).fetchall()
-    print_results(results, "Revenue + Promotions")
+    print_results(results, "Revenue by status from orders model")
 
-    # Example 3: Cross-model join (using Rails relationships)
-    print("\nExample 3: Cross-model join using Rails-like relationships")
+    # Example 3: Cross-model metrics
+    print("\nExample 3: Cross-model metrics using 'metrics' virtual table")
 
     user_sql = """
         SELECT
-            c.name,
-            o.status,
-            o.total_revenue
-        FROM semantic_layer.customers AS c
-        JOIN semantic_layer.orders AS o ON c.customer_id = o.customer_id
+            customers.region,
+            total_revenue,
+            avg_order_value
+        FROM metrics
     """
     print(f"\nUser writes:\n{user_sql}")
 
     rewritten = rewriter.rewrite(user_sql)
     print_sql(rewritten)
 
     results = conn.execute(rewritten).fetchall()
-    print_results(results, "Customer Revenue (cross-model join)")
+    print_results(results, "Revenue by customer region")
 
     # =========================================================================
     # 5. Generate reusable views

examples/comprehensive_example.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 # /// script
 # dependencies = [
+#   "sidemantic",
 #   "duckdb",
 # ]
 # ///

examples/export_example.py

@@ -7,7 +7,7 @@
 
 # Load from native Sidemantic YAML
 print("Loading native Sidemantic YAML...")
-sl = SemanticLayer.from_yaml("examples/sidemantic/orders.yml")
+sl = SemanticLayer.from_yaml("tests/fixtures/sidemantic/orders.yml")
 print(f"Loaded {len(sl.list_models())} models and {len(sl.list_metrics())} metrics")
 
 # Export to Cube format

examples/streamlit_dashboard.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 # /// script
 # dependencies = [
+#   "sidemantic",
 #   "duckdb",
 #   "streamlit",
 #   "plotly",

examples/symmetric_aggregates_example.py

@@ -1,7 +1,9 @@
 #!/usr/bin/env python3
 # /// script
 # dependencies = [
+#   "sidemantic",
 #   "duckdb",
+#   "pandas",
 # ]
 # ///
 """Example demonstrating symmetric aggregates for fan-out joins.

tests/adapters/test_cube.py

@@ -10,7 +10,7 @@
 def test_cube_adapter():
     """Test Cube adapter with example YAML."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/orders.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/orders.yml"))
 
     # Check models were imported
     assert "orders" in graph.models
@@ -48,7 +48,7 @@ def test_cube_adapter():
 def test_cube_adapter_join_discovery():
     """Test that Cube adapter enables join discovery."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/orders.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/orders.yml"))
 
     # Check that relationships were imported
     orders = graph.get_model("orders")
@@ -60,7 +60,7 @@ def test_cube_adapter_join_discovery():
 def test_cube_adapter_pre_aggregations():
     """Test Cube adapter with pre-aggregations."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/orders_with_preagg.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/orders_with_preagg.yml"))
 
     orders = graph.get_model("orders")
     assert orders is not None
@@ -85,7 +85,7 @@ def test_cube_adapter_pre_aggregations():
 def test_cube_adapter_multi_cube():
     """Test Cube adapter with multiple related cubes."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/ecommerce_multi_cube.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/ecommerce_multi_cube.yml"))
 
     # Check all models were imported
     assert "orders" in graph.models
@@ -118,7 +118,7 @@ def test_cube_adapter_multi_cube():
 def test_cube_adapter_segments():
     """Test Cube adapter segment parsing with SQL transformations."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/ecommerce_multi_cube.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/ecommerce_multi_cube.yml"))
 
     # Test orders segments
     orders = graph.get_model("orders")
@@ -141,7 +141,7 @@ def test_cube_adapter_segments():
 def test_cube_adapter_drill_members():
     """Test Cube adapter drill member parsing."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/ecommerce_multi_cube.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/ecommerce_multi_cube.yml"))
 
     orders = graph.get_model("orders")
     count_metric = orders.get_metric("count")
@@ -157,7 +157,7 @@ def test_cube_adapter_drill_members():
 def test_cube_saas_analytics():
     """Test Cube adapter with SaaS analytics example."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/saas_analytics.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/saas_analytics.yml"))
 
     # Check all models were imported
     assert "users" in graph.models
@@ -236,7 +236,7 @@ def test_cube_saas_analytics():
 def test_cube_retail_analytics():
     """Test Cube adapter with retail analytics example."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/retail_analytics.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/retail_analytics.yml"))
 
     # Check all models were imported
     assert "products" in graph.models
@@ -306,7 +306,7 @@ def test_cube_retail_analytics():
 def test_cube_web_analytics():
     """Test Cube adapter with web analytics example."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/web_analytics.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/web_analytics.yml"))
 
     # Check all models were imported
     assert "page_views" in graph.models
@@ -381,7 +381,7 @@ def test_cube_web_analytics():
 def test_cube_financial_analytics():
     """Test Cube adapter with financial analytics example."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/financial_analytics.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/financial_analytics.yml"))
 
     # Check all models were imported
     assert "transactions" in graph.models
@@ -437,7 +437,7 @@ def test_cube_financial_analytics():
 def test_cube_logistics_shipping():
     """Test Cube adapter with logistics/shipping example."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/logistics_shipping.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/logistics_shipping.yml"))
 
     # Check all models were imported
     assert "shipments" in graph.models
@@ -499,7 +499,7 @@ def test_cube_logistics_shipping():
 def test_cube_iot_sensors():
     """Test Cube adapter with IoT/sensor data example."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/iot_sensors.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/iot_sensors.yml"))
 
     # Check all models were imported
     assert "sensor_readings" in graph.models
@@ -563,7 +563,7 @@ def test_cube_iot_sensors():
 def test_cube_healthcare_patients():
     """Test Cube adapter with healthcare analytics example."""
     adapter = CubeAdapter()
-    graph = adapter.parse(Path("examples/cube/healthcare_patients.yml"))
+    graph = adapter.parse(Path("tests/fixtures/cube/healthcare_patients.yml"))
 
     # Check all models were imported
     assert "patients" in graph.models

tests/adapters/test_cube_roundtrip.py

@@ -17,7 +17,7 @@
 def test_import_real_cube_example():
     """Test importing a real Cube.js schema file."""
     adapter = CubeAdapter()
-    graph = adapter.parse("examples/cube/orders.yml")
+    graph = adapter.parse("tests/fixtures/cube/orders.yml")
 
     # Verify models loaded
     assert "orders" in graph.models
@@ -60,7 +60,7 @@ def test_cube_to_sidemantic_to_cube_roundtrip():
     """Test that Cube -> Sidemantic -> Cube preserves structure."""
     # Import from Cube
     cube_adapter = CubeAdapter()
-    graph = cube_adapter.parse("examples/cube/orders.yml")
+    graph = cube_adapter.parse("tests/fixtures/cube/orders.yml")
 
     # Export back to Cube
     with tempfile.NamedTemporaryFile(mode="w", suffix=".yml", delete=False) as f:
@@ -96,7 +96,7 @@ def test_cube_to_metricflow_conversion():
     """Test converting Cube format to MetricFlow format."""
     # Import from Cube
     cube_adapter = CubeAdapter()
-    graph = cube_adapter.parse("examples/cube/orders.yml")
+    graph = cube_adapter.parse("tests/fixtures/cube/orders.yml")
 
     # Export to MetricFlow
     mf_adapter = MetricFlowAdapter()
@@ -134,7 +134,7 @@ def test_query_imported_cube_example():
     from sidemantic import SemanticLayer
 
     adapter = CubeAdapter()
-    graph = adapter.parse("examples/cube/orders.yml")
+    graph = adapter.parse("tests/fixtures/cube/orders.yml")
 
     layer = SemanticLayer()
     layer.graph = graph
@@ -165,7 +165,7 @@ def test_query_with_time_dimension_cube():
     from sidemantic import SemanticLayer
 
     adapter = CubeAdapter()
-    graph = adapter.parse("examples/cube/orders.yml")
+    graph = adapter.parse("tests/fixtures/cube/orders.yml")
 
     layer = SemanticLayer()
     layer.graph = graph
@@ -181,7 +181,7 @@ def test_roundtrip_real_cube_example():
     adapter = CubeAdapter()
 
     # Import original
-    graph1 = adapter.parse("examples/cube/orders.yml")
+    graph1 = adapter.parse("tests/fixtures/cube/orders.yml")
 
     # Export
     with tempfile.NamedTemporaryFile(mode="w", suffix=".yml", delete=False) as f:
@@ -217,7 +217,7 @@ def test_cube_to_lookml_conversion():
     """Test converting Cube format to LookML format."""
     # Import from Cube
     cube_adapter = CubeAdapter()
-    graph = cube_adapter.parse("examples/cube/orders.yml")
+    graph = cube_adapter.parse("tests/fixtures/cube/orders.yml")
 
     # Export to LookML
     lookml_adapter = LookMLAdapter()
@@ -253,7 +253,7 @@ def test_cube_to_hex_conversion():
     """Test converting Cube format to Hex format."""
     # Import from Cube
     cube_adapter = CubeAdapter()
-    graph = cube_adapter.parse("examples/cube/orders.yml")
+    graph = cube_adapter.parse("tests/fixtures/cube/orders.yml")
 
     # Export to Hex
     hex_adapter = HexAdapter()
@@ -285,7 +285,7 @@ def test_cube_to_rill_conversion():
     """Test converting Cube format to Rill format."""
     # Import from Cube
     cube_adapter = CubeAdapter()
-    graph = cube_adapter.parse("examples/cube/orders.yml")
+    graph = cube_adapter.parse("tests/fixtures/cube/orders.yml")
 
     # Export to Rill
     rill_adapter = RillAdapter()
@@ -314,7 +314,7 @@ def test_cube_to_superset_conversion():
     superset_adapter = SupersetAdapter()
 
     # Import from Cube
-    graph = cube_adapter.parse("examples/cube/orders.yml")
+    graph = cube_adapter.parse("tests/fixtures/cube/orders.yml")
 
     # Export to Superset
     with tempfile.TemporaryDirectory() as tmpdir:
@@ -334,7 +334,7 @@ def test_cube_to_omni_conversion():
     omni_adapter = OmniAdapter()
 
     # Import from Cube
-    graph = cube_adapter.parse("examples/cube/orders.yml")
+    graph = cube_adapter.parse("tests/fixtures/cube/orders.yml")
 
     # Export to Omni
     with tempfile.TemporaryDirectory() as tmpdir: