duckrun 0.2.5.dev4__py3-none-any.whl → 0.2.7__py3-none-any.whl

duckrun/core.py

@@ -751,7 +751,6 @@ class WorkspaceConnection:
             lakehouses = response.json().get("value", [])
             lakehouse_names = [lh.get("displayName", "") for lh in lakehouses]
             
-            print(f"Found {len(lakehouse_names)} lakehouses: {lakehouse_names}")
             return lakehouse_names
             
         except Exception as e:

{duckrun-0.2.5.dev4.dist-info → duckrun-0.2.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: duckrun
-Version: 0.2.5.dev4
+Version: 0.2.7
 Summary: Lakehouse task runner powered by DuckDB for Microsoft Fabric
 Author: mim
 License: MIT
@@ -26,11 +26,10 @@ A helper package for stuff that made my life easier when working with Fabric Pyt
 
 **Requirements:**
 - Lakehouse must have a schema (e.g., `dbo`, `sales`, `analytics`)
-- Workspace and lakehouse names cannot contain spaces
+- **Workspace names with spaces are fully supported!** ✅
 
-**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.
 
-**Why no spaces?** Duckrun uses simple name-based paths instead of GUIDs. This keeps the code clean and readable, which is perfect for data engineering workspaces where naming conventions are already well-established. Just use underscores or hyphens instead: `my_workspace` or `my-lakehouse`.
+**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.
 
 ## What It Does
 
@@ -49,23 +48,48 @@ pip install duckrun[local]
 
 ## Quick Start
 
+### Simple Example for New Users
+
+```python
+import duckrun
+
+# Connect to a workspace and manage lakehouses
+con = duckrun.connect('My Workspace')
+con.list_lakehouses()                           # See what lakehouses exist
+con.create_lakehouse_if_not_exists('data')      # Create if needed
+
+# Connect to a specific lakehouse and query data
+con = duckrun.connect("My Workspace/data.lakehouse/dbo")
+con.sql("SELECT * FROM my_table LIMIT 10").show()
+```
+
+### Full Feature Overview
+
 ```python
 import duckrun
 
-# Connect to your Fabric lakehouse with a specific schema
-con = duckrun.connect("my_workspace/my_lakehouse.lakehouse/dbo")
+# 1. Workspace Management (list and create lakehouses)
+ws = duckrun.connect("My Workspace")
+lakehouses = ws.list_lakehouses()  # Returns list of lakehouse names
+ws.create_lakehouse_if_not_exists("New_Lakehouse")
+
+# 2. Connect to lakehouse with a specific schema
+con = duckrun.connect("My Workspace/MyLakehouse.lakehouse/dbo")
+
+# Workspace names with spaces are supported!
+con = duckrun.connect("Data Analytics/SalesData.lakehouse/analytics")
 
 # Schema defaults to 'dbo' if not specified (scans all schemas)
 # ⚠️ WARNING: Scanning all schemas can be slow for large lakehouses!
-con = duckrun.connect("my_workspace/my_lakehouse.lakehouse")
+con = duckrun.connect("My Workspace/My_Lakehouse.lakehouse")
 
-# Explore data
+# 3. Explore data
 con.sql("SELECT * FROM my_table LIMIT 10").show()
 
-# Write to Delta tables (Spark-style API)
+# 4. Write to Delta tables (Spark-style API)
 con.sql("SELECT * FROM source").write.mode("overwrite").saveAsTable("target")
 
-# Upload/download files to/from OneLake Files
+# 5. Upload/download files to/from OneLake Files
 con.copy("./local_folder", "target_folder")  # Upload files
 con.download("target_folder", "./downloaded")  # Download files
 ```
@@ -75,15 +99,23 @@ That's it! No `sql_folder` needed for data exploration.
 ## Connection Format
 
 ```python
-# With schema (recommended for better performance)
-con = duckrun.connect("workspace/lakehouse.lakehouse/schema")
+# Workspace management (list and create lakehouses)
+ws = duckrun.connect("My Workspace")
+ws.list_lakehouses()  # Returns: ['lakehouse1', 'lakehouse2', ...]
+ws.create_lakehouse_if_not_exists("New Lakehouse")
+
+# Lakehouse connection with schema (recommended for best performance)
+con = duckrun.connect("My Workspace/My Lakehouse.lakehouse/dbo")
+
+# Supports workspace names with spaces!
+con = duckrun.connect("Data Analytics/Sales Data.lakehouse/analytics")
 
 # Without schema (defaults to 'dbo', scans all schemas)
 # ⚠️ This can be slow for large lakehouses!
-con = duckrun.connect("workspace/lakehouse.lakehouse")
+con = duckrun.connect("My Workspace/My Lakehouse.lakehouse")
 
-# With options
-con = duckrun.connect("workspace/lakehouse.lakehouse/dbo", sql_folder="./sql")
+# With SQL folder for pipeline orchestration
+con = duckrun.connect("My Workspace/My Lakehouse.lakehouse/dbo", sql_folder="./sql")
 ```
 
 ### Multi-Schema Support

duckrun-0.2.7.dist-info/RECORD

@@ -0,0 +1,12 @@
+duckrun/__init__.py,sha256=XA85pL2vK1AkmBic8e7WxeqNvcd6SjFX4zsQpImDO6E,230
+duckrun/core.py,sha256=Y4-5H83Xw0mZa12QM5pcC7qOPidrDFASLcGIoUW3zwY,39394
+duckrun/files.py,sha256=piWRU5w9jHrW-wuV4Gf-SKY_jhFv9eflxgWO8AZCQTI,10495
+duckrun/lakehouse.py,sha256=j--Z3zo8AOWt1GF9VzRosmmTAy6ey2D0LVubti58twU,14109
+duckrun/runner.py,sha256=XsQqWlesFD2cuhH2gsQj3Astg0XN7xhW15WPmr8D65I,13797
+duckrun/stats.py,sha256=2FTqoQNVjD84-H1HjStHxZkOpAGKXS79M55B00pOlok,9804
+duckrun/writer.py,sha256=eWrGtDQTbXi8H3sSt2WucYTdEQUjK97KmQxzCbqAuMs,6221
+duckrun-0.2.7.dist-info/licenses/LICENSE,sha256=-DeQQwdbCbkB4507ZF3QbocysB-EIjDtaLexvqRkGZc,1083
+duckrun-0.2.7.dist-info/METADATA,sha256=fIwgvoj3Hw4ByOcwCmG87zpLF0qnlzK8GAotup5km40,19272
+duckrun-0.2.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+duckrun-0.2.7.dist-info/top_level.txt,sha256=BknMEwebbUHrVAp3SC92ps8MPhK7XSYsaogTvi_DmEU,8
+duckrun-0.2.7.dist-info/RECORD,,

duckrun-0.2.5.dev4.dist-info/RECORD

@@ -1,12 +0,0 @@
-duckrun/__init__.py,sha256=XA85pL2vK1AkmBic8e7WxeqNvcd6SjFX4zsQpImDO6E,230
-duckrun/core.py,sha256=6Us3dRuQFCziK12r0j2CuwgcDQeV78iEeLcA40IwIiA,39476
-duckrun/files.py,sha256=piWRU5w9jHrW-wuV4Gf-SKY_jhFv9eflxgWO8AZCQTI,10495
-duckrun/lakehouse.py,sha256=j--Z3zo8AOWt1GF9VzRosmmTAy6ey2D0LVubti58twU,14109
-duckrun/runner.py,sha256=XsQqWlesFD2cuhH2gsQj3Astg0XN7xhW15WPmr8D65I,13797
-duckrun/stats.py,sha256=2FTqoQNVjD84-H1HjStHxZkOpAGKXS79M55B00pOlok,9804
-duckrun/writer.py,sha256=eWrGtDQTbXi8H3sSt2WucYTdEQUjK97KmQxzCbqAuMs,6221
-duckrun-0.2.5.dev4.dist-info/licenses/LICENSE,sha256=-DeQQwdbCbkB4507ZF3QbocysB-EIjDtaLexvqRkGZc,1083
-duckrun-0.2.5.dev4.dist-info/METADATA,sha256=HE5rFI5A227bw-prSq3cHv9wR9-etSYJD31lIrKjpzs,18344
-duckrun-0.2.5.dev4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-duckrun-0.2.5.dev4.dist-info/top_level.txt,sha256=BknMEwebbUHrVAp3SC92ps8MPhK7XSYsaogTvi_DmEU,8
-duckrun-0.2.5.dev4.dist-info/RECORD,,