duckrun 0.2.6__py3-none-any.whl → 0.2.7__py3-none-any.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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: duckrun
3
- Version: 0.2.6
3
+ Version: 0.2.7
4
4
  Summary: Lakehouse task runner powered by DuckDB for Microsoft Fabric
5
5
  Author: mim
6
6
  License: MIT
@@ -26,7 +26,8 @@ A helper package for stuff that made my life easier when working with Fabric Pyt
26
26
 
27
27
  **Requirements:**
28
28
  - Lakehouse must have a schema (e.g., `dbo`, `sales`, `analytics`)
29
- - **Workspace and lakehouse names with spaces are now fully supported!** ✅
29
+ - **Workspace names with spaces are fully supported!** ✅
30
+
30
31
 
31
32
  **Delta Lake Version:** This package uses an older version of deltalake to maintain row size control capabilities, which is crucial for Power BI performance optimization. The newer Rust-based deltalake versions don't yet support the row group size parameters that are essential for optimal DirectLake performance.
32
33
 
@@ -47,23 +48,40 @@ pip install duckrun[local]
47
48
 
48
49
  ## Quick Start
49
50
 
51
+ ### Simple Example for New Users
52
+
53
+ ```python
54
+ import duckrun
55
+
56
+ # Connect to a workspace and manage lakehouses
57
+ con = duckrun.connect('My Workspace')
58
+ con.list_lakehouses() # See what lakehouses exist
59
+ con.create_lakehouse_if_not_exists('data') # Create if needed
60
+
61
+ # Connect to a specific lakehouse and query data
62
+ con = duckrun.connect("My Workspace/data.lakehouse/dbo")
63
+ con.sql("SELECT * FROM my_table LIMIT 10").show()
64
+ ```
65
+
66
+ ### Full Feature Overview
67
+
50
68
  ```python
51
69
  import duckrun
52
70
 
53
71
  # 1. Workspace Management (list and create lakehouses)
54
72
  ws = duckrun.connect("My Workspace")
55
73
  lakehouses = ws.list_lakehouses() # Returns list of lakehouse names
56
- ws.create_lakehouse_if_not_exists("New Lakehouse")
74
+ ws.create_lakehouse_if_not_exists("New_Lakehouse")
57
75
 
58
76
  # 2. Connect to lakehouse with a specific schema
59
- con = duckrun.connect("My Workspace/My Lakehouse.lakehouse/dbo")
77
+ con = duckrun.connect("My Workspace/MyLakehouse.lakehouse/dbo")
60
78
 
61
- # Works with workspace names containing spaces!
62
- con = duckrun.connect("Data Analytics/Sales Data.lakehouse/analytics")
79
+ # Workspace names with spaces are supported!
80
+ con = duckrun.connect("Data Analytics/SalesData.lakehouse/analytics")
63
81
 
64
82
  # Schema defaults to 'dbo' if not specified (scans all schemas)
65
83
  # ⚠️ WARNING: Scanning all schemas can be slow for large lakehouses!
66
- con = duckrun.connect("My Workspace/My Lakehouse.lakehouse")
84
+ con = duckrun.connect("My Workspace/My_Lakehouse.lakehouse")
67
85
 
68
86
  # 3. Explore data
69
87
  con.sql("SELECT * FROM my_table LIMIT 10").show()
@@ -5,8 +5,8 @@ duckrun/lakehouse.py,sha256=j--Z3zo8AOWt1GF9VzRosmmTAy6ey2D0LVubti58twU,14109
5
5
  duckrun/runner.py,sha256=XsQqWlesFD2cuhH2gsQj3Astg0XN7xhW15WPmr8D65I,13797
6
6
  duckrun/stats.py,sha256=2FTqoQNVjD84-H1HjStHxZkOpAGKXS79M55B00pOlok,9804
7
7
  duckrun/writer.py,sha256=eWrGtDQTbXi8H3sSt2WucYTdEQUjK97KmQxzCbqAuMs,6221
8
- duckrun-0.2.6.dist-info/licenses/LICENSE,sha256=-DeQQwdbCbkB4507ZF3QbocysB-EIjDtaLexvqRkGZc,1083
9
- duckrun-0.2.6.dist-info/METADATA,sha256=i8kvmnqpsddtJGq5GD44SFif0YTN-UFFviPyQZMPHn0,18799
10
- duckrun-0.2.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
11
- duckrun-0.2.6.dist-info/top_level.txt,sha256=BknMEwebbUHrVAp3SC92ps8MPhK7XSYsaogTvi_DmEU,8
12
- duckrun-0.2.6.dist-info/RECORD,,
8
+ duckrun-0.2.7.dist-info/licenses/LICENSE,sha256=-DeQQwdbCbkB4507ZF3QbocysB-EIjDtaLexvqRkGZc,1083
9
+ duckrun-0.2.7.dist-info/METADATA,sha256=fIwgvoj3Hw4ByOcwCmG87zpLF0qnlzK8GAotup5km40,19272
10
+ duckrun-0.2.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
11
+ duckrun-0.2.7.dist-info/top_level.txt,sha256=BknMEwebbUHrVAp3SC92ps8MPhK7XSYsaogTvi_DmEU,8
12
+ duckrun-0.2.7.dist-info/RECORD,,