crondb-driver 1.0.0__tar.gz

crondb_driver-1.0.0/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: crondb-driver
+Version: 1.0.0
+Summary: The official Python ORM and connection driver for the CronDB temporal database.
+Author: Michael Tal
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# CronDB Python SDK
+
+The official Object-Relational Mapping (ORM) and connection driver for **CronDB**, a high-performance, temporal C++ database engine.
+
+Traditional Python architectures force you to build "split-brain" systems to handle time-based events: storing the data in a standard database while pushing the countdown timers to an external task queue or background worker system. 
+
+**CronDB unifies state and time.** You inject finite-state-machine (FSM) timers directly into your database rows. When a state naturally expires, the C++ engine's asynchronous background threads instantly push a webhook directly to your backend server. 
+
+No polling. No background workers. No external queues. Just one unified temporal engine.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install crondb-driver

crondb_driver-1.0.0/README.md

@@ -0,0 +1,16 @@
+# CronDB Python SDK
+
+The official Object-Relational Mapping (ORM) and connection driver for **CronDB**, a high-performance, temporal C++ database engine.
+
+Traditional Python architectures force you to build "split-brain" systems to handle time-based events: storing the data in a standard database while pushing the countdown timers to an external task queue or background worker system. 
+
+**CronDB unifies state and time.** You inject finite-state-machine (FSM) timers directly into your database rows. When a state naturally expires, the C++ engine's asynchronous background threads instantly push a webhook directly to your backend server. 
+
+No polling. No background workers. No external queues. Just one unified temporal engine.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install crondb-driver

crondb_driver-1.0.0/crondb/crondb.py

@@ -0,0 +1,57 @@
+import requests
+import json
+
+class CronDB:
+    def __init__(self, host='127.0.0.1', port=8080):
+        self.url = f"http://{host}:{port}/query"
+        # Connection pooling to prevent overhead
+        self.session = requests.Session()
+
+    def query(self, sql_string):
+        """Sends raw SQL text to the C++ engine"""
+        headers = {'Content-Type': 'text/plain'}
+        try:
+            response = self.session.post(self.url, data=sql_string, headers=headers)
+            # Try to return JSON if the C++ engine sent it
+            try:
+                return response.json()
+            except:
+                return response.text
+        except Exception as e:
+            return {"success": False, "message": str(e)}
+
+    def _format(self, val):
+        """Translates Python types to CronDB SQL types"""
+        if isinstance(val, bool):
+            return str(val).lower() # True -> true
+        if isinstance(val, (int, float)):
+            return str(val)
+        if isinstance(val, str):
+            # Check for Temporal FSM syntax ( ... --> ... )
+            if val.strip().startswith('(') and '-->' in val:
+                return val
+            return f"'{val}'"
+        return str(val)
+
+    def insert(self, table, data):
+        fields = " ".join([f"{k}={self._format(v)}" for k, v in data.items()])
+        return self.query(f"INSERT INTO {table} {fields}")
+
+    def select(self, table, where=None):
+        sql = f"SELECT * FROM {table}"
+        if where:
+            sql += f" WHERE {where}"
+        return self.query(sql)
+
+    def update(self, table, data, where):
+        fields = " ".join([f"{k}={self._format(v)}" for k, v in data.items()])
+        return self.query(f"UPDATE {table} SET {fields} WHERE {where}")
+
+    def delete(self, table, where):
+        return self.query(f"DELETE FROM {table} WHERE {where}")
+
+    def listen(self, table, col, url, where=None):
+        sql = f"LISTEN {table} . {col} --> '{url}'"
+        if where:
+            sql += f" WHERE {where}"
+        return self.query(sql)

crondb_driver-1.0.0/crondb/test_crondb.py

@@ -0,0 +1,49 @@
+from crondb import CronDB
+import time
+
+db = CronDB()
+
+
+def run_test():
+    print("--- Starting CronDB Python SDK Test ---")
+
+    # 1. Clean start
+    db.query("DROP TABLE robots")
+
+    # 2. CREATE TABLE (Manual Query)
+    print("\n[1] Creating Table...")
+    print(db.query("CREATE TABLE robots rid ApexInt name string status string 3"))
+
+    # 3. INSERT via ORM
+    print("\n[2] Inserting Data (Standard & Temporal)...")
+    db.insert('robots', {'name': 'R2D2', 'status': 'Idle'})
+    db.insert('robots', {
+        'name': 'Terminator',
+        'status': "('Searching' --> 'Found' @ 3 s)"
+    })
+
+    # 4. SELECT via ORM
+    print("\n[3] Reading Data...")
+    res = db.select('robots')
+    print(f"Rows found: {res.get('rows_affected')}")
+    for row in res.get('data', []):
+        print(f" -> {row}")
+
+    # 5. UPDATE via ORM
+    print("\n[4] Updating R2D2...")
+    db.update('robots', {'status': 'Beeping'}, "name = 'R2D2'")
+
+    # 6. WAIT for FSM to fire
+    print("\n[5] Waiting 4 seconds for Terminator to find target...")
+    time.sleep(3)
+
+    # 7. FINAL VERIFICATION
+    print("\n[6] Final State Check...")
+    final = db.select('robots', "name = 'Terminator'")
+    print(f"Terminator Status: {final['data'][0]['status']}")
+
+    print("\n--- Test Complete ---")
+
+
+if __name__ == "__main__":
+    run_test()

crondb_driver-1.0.0/crondb_driver.egg-info/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: crondb-driver
+Version: 1.0.0
+Summary: The official Python ORM and connection driver for the CronDB temporal database.
+Author: Michael Tal
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# CronDB Python SDK
+
+The official Object-Relational Mapping (ORM) and connection driver for **CronDB**, a high-performance, temporal C++ database engine.
+
+Traditional Python architectures force you to build "split-brain" systems to handle time-based events: storing the data in a standard database while pushing the countdown timers to an external task queue or background worker system. 
+
+**CronDB unifies state and time.** You inject finite-state-machine (FSM) timers directly into your database rows. When a state naturally expires, the C++ engine's asynchronous background threads instantly push a webhook directly to your backend server. 
+
+No polling. No background workers. No external queues. Just one unified temporal engine.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install crondb-driver

crondb_driver-1.0.0/crondb_driver.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+setup.py
+crondb/__init__.py
+crondb/crondb.py
+crondb/test_crondb.py
+crondb_driver.egg-info/PKG-INFO
+crondb_driver.egg-info/SOURCES.txt
+crondb_driver.egg-info/dependency_links.txt
+crondb_driver.egg-info/requires.txt
+crondb_driver.egg-info/top_level.txt

crondb_driver-1.0.0/crondb_driver.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

crondb_driver-1.0.0/crondb_driver.egg-info/requires.txt

@@ -0,0 +1 @@
+requests

crondb_driver-1.0.0/crondb_driver.egg-info/top_level.txt

@@ -0,0 +1 @@
+crondb

crondb_driver-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

crondb_driver-1.0.0/setup.py

@@ -0,0 +1,22 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="crondb-driver", # The name people will pip install
+    version="1.0.0",
+    author="Michael Tal",
+    description="The official Python ORM and connection driver for the CronDB temporal database.",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    packages=find_packages(),
+    install_requires=[
+        "requests", # Tells pip to auto-install the requests library for the user
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.6',
+)