cinchdb 0.1.8__py3-none-any.whl → 0.1.10__py3-none-any.whl

cinchdb/core/path_utils.py

@@ -144,10 +144,15 @@ def list_tenants(project_root: Path, database: str, branch: str) -> List[str]:
     if not tenants_dir.exists():
         return []
 
-    # Only list .db files, not WAL or SHM files
-    tenants = []
+    # List both .db files and .meta files for lazy tenants
+    tenants = set()
     for f in tenants_dir.iterdir():
-        if f.is_file() and f.suffix == ".db":
-            tenants.append(f.stem)
-
-    return sorted(tenants)
+        if f.is_file():
+            if f.suffix == ".db":
+                tenants.add(f.stem)
+            elif f.suffix == ".meta" and f.name.startswith("."):
+                # Lazy tenant metadata files are named .{tenant_name}.meta
+                tenant_name = f.stem[1:]  # Remove leading dot
+                tenants.add(tenant_name)
+
+    return sorted(list(tenants))

cinchdb/managers/tenant.py

@@ -52,13 +52,14 @@ class TenantManager:
         return tenants
 
     def create_tenant(
-        self, tenant_name: str, description: Optional[str] = None
+        self, tenant_name: str, description: Optional[str] = None, lazy: bool = False
     ) -> Tenant:
         """Create a new tenant by copying schema from main tenant.
 
         Args:
             tenant_name: Name for the new tenant
             description: Optional description
+            lazy: If True, don't create database file until first use
 
         Returns:
             Created Tenant object
@@ -74,40 +75,64 @@ class TenantManager:
         # Check maintenance mode
         check_maintenance_mode(self.project_root, self.database, self.branch)
 
-        # Validate tenant doesn't exist
-        if tenant_name in list_tenants(self.project_root, self.database, self.branch):
-            raise ValueError(f"Tenant '{tenant_name}' already exists")
-
-        # Get paths
-        main_db_path = get_tenant_db_path(
-            self.project_root, self.database, self.branch, "main"
-        )
+        # Check if tenant metadata already exists
+        tenants_dir = self.branch_path / "tenants"
+        tenant_meta_file = tenants_dir / f".{tenant_name}.meta"
         new_db_path = get_tenant_db_path(
             self.project_root, self.database, self.branch, tenant_name
         )
-
-        # Copy main tenant database to new tenant
-        shutil.copy2(main_db_path, new_db_path)
-
-        # Clear any data from the copied database (keep schema only)
-        with DatabaseConnection(new_db_path) as conn:
-            # Get all tables
-            result = conn.execute("""
-                SELECT name FROM sqlite_master 
-                WHERE type='table' 
-                AND name NOT LIKE 'sqlite_%'
-            """)
-            tables = [row["name"] for row in result.fetchall()]
-
-            # Clear data from each table
-            for table in tables:
-                conn.execute(f"DELETE FROM {table}")
-
-            conn.commit()
         
-        # Open a new connection to vacuum the database
-        with DatabaseConnection(new_db_path) as conn:
-            conn.execute("VACUUM")
+        # Validate tenant doesn't exist (either as file or metadata)
+        if new_db_path.exists() or tenant_meta_file.exists():
+            raise ValueError(f"Tenant '{tenant_name}' already exists")
+
+        if lazy:
+            # Just create metadata file, don't create actual database
+            tenants_dir.mkdir(parents=True, exist_ok=True)
+            import json
+            from datetime import datetime, timezone
+            
+            metadata = {
+                "name": tenant_name,
+                "description": description,
+                "created_at": datetime.now(timezone.utc).isoformat(),
+                "lazy": True
+            }
+            
+            with open(tenant_meta_file, 'w') as f:
+                json.dump(metadata, f)
+        else:
+            # Create actual database file (existing behavior)
+            main_db_path = get_tenant_db_path(
+                self.project_root, self.database, self.branch, "main"
+            )
+            
+            # Copy main tenant database to new tenant
+            shutil.copy2(main_db_path, new_db_path)
+
+            # Clear any data from the copied database (keep schema only)
+            with DatabaseConnection(new_db_path) as conn:
+                # Get all tables
+                result = conn.execute("""
+                    SELECT name FROM sqlite_master 
+                    WHERE type='table' 
+                    AND name NOT LIKE 'sqlite_%'
+                """)
+                tables = [row["name"] for row in result.fetchall()]
+
+                # Clear data from each table
+                for table in tables:
+                    conn.execute(f"DELETE FROM {table}")
+
+                conn.commit()
+            
+            # Vacuum the database to reduce size
+            # Must use raw sqlite3 connection with autocommit mode for VACUUM
+            import sqlite3
+            vacuum_conn = sqlite3.connect(str(new_db_path))
+            vacuum_conn.isolation_level = None  # Autocommit mode required for VACUUM
+            vacuum_conn.execute("VACUUM")
+            vacuum_conn.close()
 
         return Tenant(
             name=tenant_name,
@@ -140,20 +165,90 @@ class TenantManager:
         ):
             raise ValueError(f"Tenant '{tenant_name}' does not exist")
 
-        # Delete tenant database file and related files
+        # Check for and delete metadata file (for lazy tenants)
+        tenants_dir = self.branch_path / "tenants"
+        meta_file = tenants_dir / f".{tenant_name}.meta"
+        if meta_file.exists():
+            meta_file.unlink()
+
+        # Delete tenant database file and related files (if they exist)
         db_path = get_tenant_db_path(
             self.project_root, self.database, self.branch, tenant_name
         )
-        db_path.unlink()
+        if db_path.exists():
+            db_path.unlink()
 
-        # Also remove WAL and SHM files if they exist
-        wal_path = db_path.with_suffix(".db-wal")
-        shm_path = db_path.with_suffix(".db-shm")
+            # Also remove WAL and SHM files if they exist
+            wal_path = db_path.with_suffix(".db-wal")
+            shm_path = db_path.with_suffix(".db-shm")
 
-        if wal_path.exists():
-            wal_path.unlink()
-        if shm_path.exists():
-            shm_path.unlink()
+            if wal_path.exists():
+                wal_path.unlink()
+            if shm_path.exists():
+                shm_path.unlink()
+
+    def materialize_tenant(self, tenant_name: str) -> None:
+        """Materialize a lazy tenant into an actual database file.
+        
+        Args:
+            tenant_name: Name of the tenant to materialize
+            
+        Raises:
+            ValueError: If tenant doesn't exist or is already materialized
+        """
+        tenants_dir = self.branch_path / "tenants"
+        tenant_meta_file = tenants_dir / f".{tenant_name}.meta"
+        db_path = get_tenant_db_path(
+            self.project_root, self.database, self.branch, tenant_name
+        )
+        
+        # Check if already materialized
+        if db_path.exists():
+            return  # Already materialized
+            
+        # Check if metadata exists
+        if not tenant_meta_file.exists():
+            raise ValueError(f"Tenant '{tenant_name}' does not exist")
+            
+        # Get main tenant path for schema copy
+        main_db_path = get_tenant_db_path(
+            self.project_root, self.database, self.branch, "main"
+        )
+        
+        # Copy main tenant database to new tenant
+        shutil.copy2(main_db_path, db_path)
+
+        # Clear any data from the copied database (keep schema only)
+        with DatabaseConnection(db_path) as conn:
+            # Get all tables
+            result = conn.execute("""
+                SELECT name FROM sqlite_master 
+                WHERE type='table' 
+                AND name NOT LIKE 'sqlite_%'
+            """)
+            tables = [row["name"] for row in result.fetchall()]
+
+            # Clear data from each table
+            for table in tables:
+                conn.execute(f"DELETE FROM {table}")
+
+            conn.commit()
+        
+        # Vacuum the database to reduce size
+        import sqlite3
+        vacuum_conn = sqlite3.connect(str(db_path))
+        vacuum_conn.isolation_level = None
+        vacuum_conn.execute("VACUUM")
+        vacuum_conn.close()
+        
+        # Update metadata to indicate it's no longer lazy
+        import json
+        with open(tenant_meta_file, 'r') as f:
+            metadata = json.load(f)
+        metadata['lazy'] = False
+        metadata['materialized_at'] = Path(db_path).stat().st_mtime
+        with open(tenant_meta_file, 'w') as f:
+            json.dump(metadata, f)
 
     def copy_tenant(self, source_tenant: str, target_tenant: str) -> Tenant:
         """Copy a tenant to a new tenant.

{cinchdb-0.1.8.dist-info → cinchdb-0.1.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cinchdb
-Version: 0.1.8
+Version: 0.1.10
 Summary: A Git-like SQLite database management system with branching and multi-tenancy
 Project-URL: Homepage, https://github.com/russellromney/cinchdb
 Project-URL: Documentation, https://russellromney.github.io/cinchdb

{cinchdb-0.1.8.dist-info → cinchdb-0.1.10.dist-info}/RECORD

@@ -22,7 +22,7 @@ cinchdb/core/connection.py,sha256=SlKyEfIpeaDws8M6SfEbvCEVnt26zBY1RYwHtTXj0kY,51
 cinchdb/core/database.py,sha256=yeBxzxgKz20Dtoilzj609GHrD3UL2bWG4ArWrRM2VnA,22090
 cinchdb/core/initializer.py,sha256=CjnJSMuR1NrHobyFfwL44tUeH8VE62q02bijEtVH3p4,6922
 cinchdb/core/maintenance.py,sha256=PAgrSL7Cj9p3rKHV0h_L7gupN6nLD0-5eQpJZNiqyEs,2097
-cinchdb/core/path_utils.py,sha256=J2UEu1X_NFOqDamcsrPrC7ZitGTg9Y-HFjmx4sHf5j8,3806
+cinchdb/core/path_utils.py,sha256=NK9L8qrOz2elCktrjvLxZlhvp_-fvLEuP1OtAFkOqcg,4083
 cinchdb/managers/__init__.py,sha256=ic61ZUdsg-muq0ETYO6fuZRQWF4j7l920PthTkt2QrE,808
 cinchdb/managers/branch.py,sha256=FkF2i5vZ8ifldGm9tLcgPNymifFdBbpCrfLorIBYCiE,5330
 cinchdb/managers/change_applier.py,sha256=cHPhPgbJ9jeyrb6lkfRyumS8IHat0HiWfwZh-n7ButA,14310
@@ -35,7 +35,7 @@ cinchdb/managers/index.py,sha256=n9bCXggZP6muJQZXCpTT46JvuvcbbnYgeV3j6iXtTVM,103
 cinchdb/managers/merge_manager.py,sha256=R8S2hLkLJg4hLDpeJTzjVkduZgqPOjXtYgOSJhTXXrE,15690
 cinchdb/managers/query.py,sha256=pBlbqoovnFsZ36pB7nv8NtzcTFwtT26hp8IlwjIx29Q,7301
 cinchdb/managers/table.py,sha256=GltELZ465M8JYwZB5xoMDOvyhRYm-HflPJsQQTStD2c,13837
-cinchdb/managers/tenant.py,sha256=Wx32u71ejZEKStaPRTPw_TqCoE8XzAqFfCRNvmBfNlE,8879
+cinchdb/managers/tenant.py,sha256=yarOt-NnTAKnjlIqYK8qjJkzFz6pJC7KsP07_OVh0N0,12657
 cinchdb/managers/view.py,sha256=v9gYtRufZyxywPKLGvIjvlUXcxYh9CLRArefu9QX6zk,7809
 cinchdb/models/__init__.py,sha256=cZ-ailJ6qu44Iap5Rq555iB-_w9ufXVDBH3rDH-ojk0,622
 cinchdb/models/base.py,sha256=7j4rlFTP5K9ZuF8vxwC7lMFEaL7O90NJ47Ig5i7ubcw,1320
@@ -49,8 +49,8 @@ cinchdb/models/view.py,sha256=q6j-jYzFJuhRJO87rKt6Uv8hOizHQx8xwoPKoH6XnNY,530
 cinchdb/utils/__init__.py,sha256=yQQhEjndDiB2SUJybUmp9dvEOQKiR-GySe-WiCius5E,490
 cinchdb/utils/name_validator.py,sha256=dyGX5bjlTFRA9EGrWRQKp6kR__HSV04hLV5VueJs4IQ,4027
 cinchdb/utils/sql_validator.py,sha256=aWOGlPX0gBkuR6R1EBP2stbP4PHZuI6FUBi2Ljx7JUI,5815
-cinchdb-0.1.8.dist-info/METADATA,sha256=Lx66m_6wkzVWt_N2rtcO5xVBVL5XHNxlfaOI-5-DN30,6334
-cinchdb-0.1.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-cinchdb-0.1.8.dist-info/entry_points.txt,sha256=VBOIzvnGbkKudMCCmNORS3885QSyjZUVKJQ-Syqa62w,47
-cinchdb-0.1.8.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-cinchdb-0.1.8.dist-info/RECORD,,
+cinchdb-0.1.10.dist-info/METADATA,sha256=So2FrvVkPam4IzYzsTliYgKeM4L_wMxFapKY7Nf5QJo,6335
+cinchdb-0.1.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+cinchdb-0.1.10.dist-info/entry_points.txt,sha256=VBOIzvnGbkKudMCCmNORS3885QSyjZUVKJQ-Syqa62w,47
+cinchdb-0.1.10.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+cinchdb-0.1.10.dist-info/RECORD,,