cinchdb 0.1.5__py3-none-any.whl → 0.1.6__py3-none-any.whl

cinchdb/core/database.py

@@ -363,23 +363,37 @@ class CinchDB:
                 "POST", "/tables", json={"name": name, "columns": columns_data}
             )
 
-    def insert(self, table: str, data: Dict[str, Any]) -> Dict[str, Any]:
-        """Insert a record into a table.
+    def insert(self, table: str, *data: Dict[str, Any]) -> Dict[str, Any] | List[Dict[str, Any]]:
+        """Insert one or more records into a table.
 
         Args:
             table: Table name
-            data: Record data as dictionary
+            *data: One or more record data dictionaries
 
         Returns:
-            Inserted record with generated fields (id, created_at, updated_at)
+            Single record dict if one record inserted, list of dicts if multiple
 
         Examples:
-            # Simple insert
+            # Single insert
             db.insert("users", {"name": "John", "email": "john@example.com"})
             
-            # Insert with custom ID
-            db.insert("products", {"id": "prod-123", "name": "Widget", "price": 9.99})
+            # Multiple inserts using star expansion
+            db.insert("users", 
+                {"name": "John", "email": "john@example.com"},
+                {"name": "Jane", "email": "jane@example.com"},
+                {"name": "Bob", "email": "bob@example.com"}
+            )
+            
+            # Or with a list using star expansion
+            users = [
+                {"name": "Alice", "email": "alice@example.com"},
+                {"name": "Charlie", "email": "charlie@example.com"}
+            ]
+            db.insert("users", *users)
         """
+        if not data:
+            raise ValueError("At least one record must be provided")
+            
         if self.is_local:
             # Initialize data manager if needed
             if self._data_manager is None:
@@ -387,14 +401,31 @@ class CinchDB:
                 self._data_manager = DataManager(
                     self.project_dir, self.database, self.branch, self.tenant
                 )
-            # Use the new create_from_dict method
-            return self._data_manager.create_from_dict(table, data)
+            
+            # Single record
+            if len(data) == 1:
+                return self._data_manager.create_from_dict(table, data[0])
+            
+            # Multiple records - batch insert
+            results = []
+            for record in data:
+                result = self._data_manager.create_from_dict(table, record)
+                results.append(result)
+            return results
         else:
-            # Remote insert - use new data CRUD endpoint
-            result = self._make_request(
-                "POST", f"/tables/{table}/data", json={"data": data}
-            )
-            return result
+            # Remote insert
+            if len(data) == 1:
+                # Single record - use existing endpoint
+                result = self._make_request(
+                    "POST", f"/tables/{table}/data", json={"data": data[0]}
+                )
+                return result
+            else:
+                # Multiple records - use bulk endpoint
+                result = self._make_request(
+                    "POST", f"/tables/{table}/data/bulk", json={"records": list(data)}
+                )
+                return result
 
     def update(self, table: str, id: str, data: Dict[str, Any]) -> Dict[str, Any]:
         """Update a record in a table.

{cinchdb-0.1.5.dist-info → cinchdb-0.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cinchdb
-Version: 0.1.5
+Version: 0.1.6
 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
@@ -31,9 +31,9 @@ Description-Content-Type: text/markdown
 
 NOTE: CinchDB is in early alpha. This is project to test out an idea. Do not use this in production.
 
-CinchDB is for projects that need fast queries, data isolated data per-tenant [or even per-user](https://turso.tech/blog/give-each-of-your-users-their-own-sqlite-database-b74445f4), and a branchable database that makes it easy to merge changes between branches.
+CinchDB is for projects that need fast queries, isolated data per-tenant [or even per-user](https://turso.tech/blog/give-each-of-your-users-their-own-sqlite-database-b74445f4), and a branchable database that makes it easy to merge changes between branches.
 
-On a meta level, I made this because I wanted a database structure that I felt comfortable letting AI agents take full control over, safely, and I didn't want to run my own Postgres instance somewhere or pay for it on e.g. Neon - I don't need hyperscaling, I just need super fast queries.
+On a meta level: I made this because I wanted a database structure that I felt comfortable letting AI agents take full control over, safely, and I didn't want to run my own Postgres instance somewhere or pay for it on e.g. Neon - I don't need hyperscaling, I just need super fast queries.
 
 Because it's so lightweight and its only dependencies are pydantic, requests, and Typer, it makes for a perfect local development database that can be controlled programmatically.
 
@@ -58,6 +58,7 @@ cinch branch merge-into-main feature
 cinch tenant create customer_a
 cinch query "SELECT * FROM users" --tenant customer_a
 
+# Coming soon 
 # Connect to remote CinchDB instance
 cinch remote add production https://your-cinchdb-server.com your-api-key
 cinch remote use production
@@ -76,7 +77,7 @@ CinchDB combines SQLite with Git-like workflows for database schema management:
 - **Safe structure changes** - change merges happen atomically with zero rollback risk (seriously)
 - **Remote connectivity** - Connect to hosted CinchDB instances
 - **Type-safe SDK** - Python and TypeScript SDKs with full type safety
-- **Remote-capable** - CLI and SDK can connect to remote instances
+- **Remote-capable** - coming soon - CLI and SDK can connect to remote instances
 - **SDK generation from database schema** - Generate a typesafe SDK from your database models for CRUD operations
 
 ## Installation
@@ -128,13 +129,30 @@ db.create_table("posts", [
 # Query data
 results = db.query("SELECT * FROM posts WHERE title LIKE ?", ["%python%"])
 
-# CRUD operations
+# CRUD operations - single insert
 post_id = db.insert("posts", {"title": "Hello World", "content": "First post"})
+
+# Batch insert - multiple records at once
+posts = db.insert("posts",
+    {"title": "First", "content": "Content 1"},
+    {"title": "Second", "content": "Content 2"},
+    {"title": "Third", "content": "Content 3"}
+)
+
+# Or with a list using star expansion
+post_list = [
+    {"title": "Post A", "content": "Content A"},
+    {"title": "Post B", "content": "Content B"}
+]
+results = db.insert("posts", *post_list)
+
 db.update("posts", post_id, {"content": "Updated content"})
 ```
 
 ### Remote Connection
 
+Coming soon.
+
 ```python
 # Connect to remote instance
 db = cinchdb.connect("myapp", url="https://your-cinchdb-server.com", api_key="your-api-key")
@@ -144,7 +162,7 @@ results = db.query("SELECT * FROM users")
 user_id = db.insert("users", {"username": "alice", "email": "alice@example.com"})
 ```
 
-## Remote Access
+## Remote Access - coming soon 
 
 Connect to a remote CinchDB instance:
 

{cinchdb-0.1.5.dist-info → cinchdb-0.1.6.dist-info}/RECORD

@@ -18,7 +18,7 @@ cinchdb/cli/handlers/__init__.py,sha256=f2f-Cc96rSBLbVsiIbf-b4pZCKZoHfmhNEvnZ0Ou
 cinchdb/cli/handlers/codegen_handler.py,sha256=i5we_AbiUW3zfO6pIKWxvtO8OvOqz3H__4xPmTLEuQM,6524
 cinchdb/core/__init__.py,sha256=iNlT0iO9cM0HLoYwzBavUBoXRh1Tcnz1l_vfbwVxK_Q,246
 cinchdb/core/connection.py,sha256=SlKyEfIpeaDws8M6SfEbvCEVnt26zBY1RYwHtTXj0kY,5110
-cinchdb/core/database.py,sha256=g-QH8NOWvegajAwplNHcooPPpvZEr7L7NfrTIqlqJN8,18591
+cinchdb/core/database.py,sha256=IyMo1wfO3mTnnth0m7eP7Dib6_cEC7bTBo1JhOt6Vlo,19792
 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
@@ -47,8 +47,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.5.dist-info/METADATA,sha256=pnIHIDE116wBD3rp7oNJ_45l9NVxV0Qg7V0QyarGZvo,5855
-cinchdb-0.1.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-cinchdb-0.1.5.dist-info/entry_points.txt,sha256=VBOIzvnGbkKudMCCmNORS3885QSyjZUVKJQ-Syqa62w,47
-cinchdb-0.1.5.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-cinchdb-0.1.5.dist-info/RECORD,,
+cinchdb-0.1.6.dist-info/METADATA,sha256=1vNN2cSZJi_B_ho9yHtnLRjYt3x537gd905QAOtJyK0,6334
+cinchdb-0.1.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+cinchdb-0.1.6.dist-info/entry_points.txt,sha256=VBOIzvnGbkKudMCCmNORS3885QSyjZUVKJQ-Syqa62w,47
+cinchdb-0.1.6.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+cinchdb-0.1.6.dist-info/RECORD,,