Unofficial developer tools for Microsoft Fabric OneLake.
A terminal UI for browsing Fabric workspaces, lakehouses, and Delta tables. No portal, no notebooks — just your terminal.
pip install onelake-tui
az login
onelake-tuionelake-tui is the PyPI distribution for this repo and includes both the TUI and the bundled onelake_client library.
Highlights:
- Three-panel layout: workspace picker → item list → DFS tree + preview
- Rich file preview: Markdown, JSON, CSV, Parquet, Avro, syntax-highlighted code
- Delta table detail: schema, data preview, transaction history, CDF
- Live workspace search, breadcrumb path display, and copy menu (
y) for HTTPS/ABFSS named+GUID formats - Multi-environment support via
--envflag (PROD, MSIT, DXT, DAILY) - Keyboard-driven, zero-config (uses
az login)
See TUI/README.md for full documentation.
The TUI ships with a standalone async Python client that you can also use directly. We may publish the client separately in a future release, but today it is distributed with onelake-tui.
from onelake_client import OneLakeClient
async with OneLakeClient() as client:
workspaces = await client.fabric.list_workspaces()
paths = await client.dfs.list_paths(ws_id, "MyLakehouse.Lakehouse")| API | Module | Purpose |
|---|---|---|
| Fabric REST | fabric/ |
Workspace/item enumeration (control plane) |
| OneLake DFS | dfs/ |
File/folder operations via ADLS Gen2 (data plane) |
| Table APIs | tables/ |
Delta Lake + Iceberg metadata (metadata plane) |
All tools use DefaultAzureCredential, supporting:
| Method | Use case |
|---|---|
az login |
Local development |
| Service principal env vars | CI/CD pipelines |
| Managed identity | Azure-hosted environments |
Use the --env flag to target different Fabric rings:
uv run onelake-tui # PROD (default)
uv run onelake-tui --env msit # Microsoft internal testing
uv run onelake-tui --env dxt # Developer testing
uv run onelake-tui --env daily # Daily buildsEach environment maps to the correct Fabric REST and OneLake DFS hostnames automatically.
cd TUI
uv sync --all-extras # Install all dependencies
uv run pytest # Run tests
uv run ruff check src/ # Lint
uv run onelake-tui # Launch the TUIOneLakeTools/
├── TUI/
│ ├── src/
│ │ ├── onelake_client/ # Standalone async Python client library
│ │ │ ├── auth.py # Dual-scope token management
│ │ │ ├── _http.py # httpx retry + pagination
│ │ │ ├── environment.py # Environment ring config (PROD/MSIT/DXT/DAILY)
│ │ │ ├── fabric/ # Fabric REST API (control plane)
│ │ │ ├── dfs/ # OneLake DFS API (data plane)
│ │ │ ├── tables/ # Delta + Iceberg readers (metadata plane)
│ │ │ └── models/ # Pydantic data models
│ │ └── onelake_tui/ # Textual-based terminal UI
│ │ ├── app.py # Main app, keybindings, event wiring
│ │ ├── workspace_picker.py # Flat filterable workspace list
│ │ ├── item_list.py # Item list for selected workspace
│ │ ├── tree.py # DFS file tree (single item)
│ │ ├── detail.py # Detail/preview with rich rendering
│ │ ├── sprite.py # OneLake-inspired splash art + animation
│ │ ├── status_bar.py # 3-line footer
│ │ └── nodes.py # Node dataclasses
│ ├── tests/ # Unit + integration tests
│ ├── pyproject.toml # uv-managed project config
│ └── README.md # TUI-specific docs
└── README.md # This file
| Tool | Status |
|---|---|
| OneLake TUI (Unofficial) | ✅ Working (browse, preview, inspect, copy path) |
| File preview (MD/JSON/CSV/Parquet/Avro) | ✅ Done |
| Delta table detail (schema/data/history/CDF) | ✅ Done |
| Workspace search/filter | ✅ Done |
| OneLake CLI | 🔲 Planned (onelake ls, onelake cat, onelake cp) |
| Download/upload | 🔲 Planned |
| Shortcuts discoverability/manageability | 🔲 Planned |
| ADLS direct connections | 🔲 Planned |
| OneLake security policy management | 🔲 Planned |
| Bulk operations | 🔲 Planned |
| Copying data + soft-deleted data handling | 🔲 Planned |
MIT