duckrun 0.1.5.4__py3-none-any.whl → 0.1.5.5__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.
Files changed (6) hide show
  1. {duckrun-0.1.5.4.dist-info → duckrun-0.1.5.5.dist-info}/METADATA +25 -17
  2. duckrun-0.1.5.5.dist-info/RECORD +7 -0
  3. duckrun-0.1.5.4.dist-info/RECORD +0 -7
  4. {duckrun-0.1.5.4.dist-info → duckrun-0.1.5.5.dist-info}/WHEEL +0 -0
  5. {duckrun-0.1.5.4.dist-info → duckrun-0.1.5.5.dist-info}/licenses/LICENSE +0 -0
  6. {duckrun-0.1.5.4.dist-info → duckrun-0.1.5.5.dist-info}/top_level.txt +0 -0
{duckrun-0.1.5.4.dist-info → duckrun-0.1.5.5.dist-info}/METADATA RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: duckrun
3
- Version: 0.1.5.4
3
+ Version: 0.1.5.5
4
4
  Summary: Lakehouse task runner powered by DuckDB for Microsoft Fabric
5
5
  Author: mim
6
6
  License-Expression: MIT
@@ -39,11 +39,10 @@ pip install duckrun
39
39
  import duckrun
40
40
 
41
41
  # Connect to your Fabric lakehouse
42
- con = duckrun.connect(
43
- workspace="my_workspace",
44
- lakehouse_name="my_lakehouse",
45
- schema="dbo"
46
- )
42
+ con = duckrun.connect("my_workspace/my_lakehouse.lakehouse/dbo")
43
+
44
+ # Schema defaults to 'dbo' if not specified
45
+ con = duckrun.connect("my_workspace/my_lakehouse.lakehouse")
47
46
 
48
47
  # Explore data
49
48
  con.sql("SELECT * FROM my_table LIMIT 10").show()
@@ -54,6 +53,21 @@ con.sql("SELECT * FROM source").write.mode("overwrite").saveAsTable("target")
54
53
 
55
54
  That's it! No `sql_folder` needed for data exploration.
56
55
 
56
+ ## Connection Format
57
+
58
+ ```python
59
+ # With schema
60
+ con = duckrun.connect("workspace/lakehouse.lakehouse/schema")
61
+
62
+ # Without schema (uses 'dbo' by default)
63
+ con = duckrun.connect("workspace/lakehouse.lakehouse")
64
+
65
+ # With options
66
+ con = duckrun.connect("workspace/lakehouse.lakehouse/dbo", sql_folder="./sql")
67
+ ```
68
+
69
+ **Note:** When schema is not specified, Duckrun defaults to `dbo`. Multi-schema scanning will be added in a future update.
70
+
57
71
  ## Two Ways to Use Duckrun
58
72
 
59
73
  ### 1. Data Exploration (Spark-Style API)
@@ -61,7 +75,7 @@ That's it! No `sql_folder` needed for data exploration.
61
75
  Perfect for ad-hoc analysis and interactive notebooks:
62
76
 
63
77
  ```python
64
- con = duckrun.connect("workspace", "lakehouse", "dbo")
78
+ con = duckrun.connect("workspace/lakehouse.lakehouse/dbo")
65
79
 
66
80
  # Query existing tables
67
81
  con.sql("SELECT * FROM sales WHERE year = 2024").show()
@@ -90,9 +104,7 @@ For production workflows with reusable SQL and Python tasks:
90
104
 
91
105
  ```python
92
106
  con = duckrun.connect(
93
- workspace="my_workspace",
94
- lakehouse_name="my_lakehouse",
95
- schema="dbo",
107
+ "my_workspace/my_lakehouse.lakehouse/dbo",
96
108
  sql_folder="./sql" # folder with .sql and .py files
97
109
  )
98
110
 
@@ -185,9 +197,7 @@ Load tasks from GitHub or any URL:
185
197
 
186
198
  ```python
187
199
  con = duckrun.connect(
188
- workspace="Analytics",
189
- lakehouse_name="Sales",
190
- schema="dbo",
200
+ "Analytics/Sales.lakehouse/dbo",
191
201
  sql_folder="https://raw.githubusercontent.com/user/repo/main/sql"
192
202
  )
193
203
  ```
@@ -242,9 +252,7 @@ Customize compaction threshold:
242
252
 
243
253
  ```python
244
254
  con = duckrun.connect(
245
- workspace="workspace",
246
- lakehouse_name="lakehouse",
247
- schema="dbo",
255
+ "workspace/lakehouse.lakehouse/dbo",
248
256
  compaction_threshold=50 # compact after 50 files
249
257
  )
250
258
  ```
@@ -255,7 +263,7 @@ con = duckrun.connect(
255
263
  import duckrun
256
264
 
257
265
  # Connect
258
- con = duckrun.connect("Analytics", "Sales", "dbo", "./sql")
266
+ con = duckrun.connect("Analytics/Sales.lakehouse/dbo", sql_folder="./sql")
259
267
 
260
268
  # Pipeline with mixed tasks
261
269
  pipeline = [
duckrun-0.1.5.5.dist-info/RECORD ADDED
@@ -0,0 +1,7 @@
1
+ duckrun/__init__.py,sha256=L0jRtD9Ld8Ti4e6GRvPDdHvkQCFAPHM43GSP7ARh6EM,241
2
+ duckrun/core.py,sha256=0Jo7zkVuTvdPPt-ubUhy5996oAm4VffZrH6K1AUw7wE,20804
3
+ duckrun-0.1.5.5.dist-info/licenses/LICENSE,sha256=-DeQQwdbCbkB4507ZF3QbocysB-EIjDtaLexvqRkGZc,1083
4
+ duckrun-0.1.5.5.dist-info/METADATA,sha256=0fp-MgKtZuxYBxvXtGOpUsK4aJbaobLckzFfq-LMu4o,8201
5
+ duckrun-0.1.5.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
6
+ duckrun-0.1.5.5.dist-info/top_level.txt,sha256=BknMEwebbUHrVAp3SC92ps8MPhK7XSYsaogTvi_DmEU,8
7
+ duckrun-0.1.5.5.dist-info/RECORD,,
duckrun-0.1.5.4.dist-info/RECORD DELETED
@@ -1,7 +0,0 @@
1
- duckrun/__init__.py,sha256=L0jRtD9Ld8Ti4e6GRvPDdHvkQCFAPHM43GSP7ARh6EM,241
2
- duckrun/core.py,sha256=0Jo7zkVuTvdPPt-ubUhy5996oAm4VffZrH6K1AUw7wE,20804
3
- duckrun-0.1.5.4.dist-info/licenses/LICENSE,sha256=-DeQQwdbCbkB4507ZF3QbocysB-EIjDtaLexvqRkGZc,1083
4
- duckrun-0.1.5.4.dist-info/METADATA,sha256=0gVR6OwFuFiVvQH6x37L7PttAbZ0fnvDHJi5IWZXk-g,7792
5
- duckrun-0.1.5.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
6
- duckrun-0.1.5.4.dist-info/top_level.txt,sha256=BknMEwebbUHrVAp3SC92ps8MPhK7XSYsaogTvi_DmEU,8
7
- duckrun-0.1.5.4.dist-info/RECORD,,