content = """# SQLMesh Localite Context
Advanced Model Navigation & Audit Interface for SQLMesh
The SQLMesh Localite Context extension optimizes the developer experience by providing a high-performance, lightweight interface for managing SQLMesh projects. By utilizing a streamlined "shedded" Context class, it delivers essential navigation and auditing tools without the overhead of a full context load.
🚀 Key Features
- Lightweight Context Management: Operates on a specialized SQLMesh Context subset, ensuring rapid response times even in large-scale projects.
- Intelligent Model Navigation: Seamlessly jump between model definitions via a dedicated right-click context menu.
- Integrated Model Browser: Explore your entire SQLMesh project hierarchy through a centralized, intuitive sidebar view.
- Macro Support: Enhanced visibility and navigation for project-wide macros.
- Streamlined Auditing: Integrated hooks for model planning and audit verification (Experimental).
🛠 Requirements
To ensure full functionality, the extension requires a Python virtual environment containing the following dependencies:
- SQLMesh: The core transformation engine.
- FastAPI & Uvicorn: Powers the local communication layer.
- Watchdog: Enables real-time file system monitoring for project updates.
⚙️ Extension Settings
| Setting | Description | Default |
|---|---|---|
sqlmesh.localite.pythonPath |
Path to the virtual environment's Python executable. | python |
sqlmesh.localite.autoLoad |
Automatically load the context on workspace startup. | false |
⚠️ Current Status & Known Issues
IMPORTANT: This extension is currently in Beta (Development Phase). Some core features may behave unexpectedly as we refine the integration.
- Plan & Audit: The planning and auditing workflows are undergoing active development and may be unstable in this version.
📅 Release Notes
0.0.9
- Initial Beta Release: Core model browsing and navigation features introduced.
- Experimental Support: Basic macro jumping and shedded context loading implemented. """
with open("README.md", "w") as f: f.write(content)