opendbs 1.0.0__tar.gz

opendbs-1.0.0/PKG-INFO

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: opendbs
+Version: 1.0.0
+Summary: Official Python Client for OpenDBS
+Author: OpenDBS Team
+Author-email: support@opendbs.in
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

opendbs-1.0.0/README.md

@@ -0,0 +1,54 @@
+# OpenDBS Python Client
+
+Official Python client library for OpenDBS.
+
+## Installation
+
+```bash
+pip install opendbs
+```
+
+## Usage
+
+### Initialization
+
+```python
+from opendbs import OpenDBS
+
+# Initialize
+client = OpenDBS("http://localhost:4402")
+
+# Login
+client.login("admin", "admin123")
+```
+
+### Basic Operations
+
+```python
+# Create Database
+client.create_database("shop")
+
+# Create Racks
+client.create_rack("shop", "products", type="sql", schema={
+    "name": {"type": "string"},
+    "price": {"type": "number"}
+})
+client.create_rack("shop", "users", type="nosql")
+
+# Insert Data
+client.insert("shop", "users", {"name": "Alice"})
+client.sql("shop", "INSERT INTO products (name, price) VALUES ('Laptop', 999)")
+
+# Find Data
+users = client.find("shop", "users", {"name": "Alice"})
+```
+
+### Advanced Search
+
+```python
+# Fuzzy Search
+results = client.fuzzy_search("shop", "users", "field", "Alice")
+
+# Vector Search
+results = client.vector_search("shop", "products", "embedding", [0.1, 0.2, 0.3])
+```

opendbs-1.0.0/opendbs/__init__.py

@@ -0,0 +1,3 @@
+from .client import OpenDBS
+
+__all__ = ["OpenDBS"]

opendbs-1.0.0/opendbs/client.py

@@ -0,0 +1,142 @@
+import requests
+import json
+from typing import Optional, Dict, List, Any, Union
+
+class OpenDBS:
+    def __init__(self, base_url: str, token: Optional[str] = None, ignore_ssl: bool = False):
+        self.base_url = base_url.rstrip('/')
+        self.token = token
+        self.ignore_ssl = ignore_ssl
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Content-Type": "application/json",
+            "Accept": "application/json"
+        })
+        if token:
+            self.session.headers.update({"Authorization": f"Bearer {token}"})
+
+    def set_token(self, token: str):
+        self.token = token
+        self.session.headers.update({"Authorization": f"Bearer {token}"})
+
+    def _request(self, method: str, endpoint: str, data: Optional[Dict] = None, params: Optional[Dict] = None) -> Any:
+        url = f"{self.base_url}{endpoint}"
+        try:
+            response = self.session.request(
+                method, 
+                url, 
+                json=data, 
+                params=params, 
+                verify=not self.ignore_ssl
+            )
+            response.raise_for_status()
+            try:
+                return response.json()
+            except json.JSONDecodeError:
+                return response.text
+        except requests.exceptions.HTTPError as e:
+            error_msg = str(e)
+            try:
+                error_body = e.response.json()
+                if 'error' in error_body:
+                    error_msg = error_body['error']
+            except:
+                pass
+            raise Exception(f"OpenDBS Error: {error_msg}")
+        except requests.exceptions.ConnectionError:
+            raise Exception(f"Could not connect to OpenDBS at {self.base_url}. Is the server running?")
+
+    # --- Authentication ---
+
+    def login(self, username, password):
+        res = self._request("POST", "/api/auth/login", {"username": username, "password": password})
+        if 'token' in res:
+            self.set_token(res['token'])
+        return res
+
+    def register(self, user_data):
+        return self._request("POST", "/api/auth/register", user_data)
+
+    def regenerate_api_key(self):
+        return self._request("POST", "/api/auth/regenerate-api-key")
+
+    # --- Database Management ---
+
+    def list_databases(self, include_racks=False):
+        res = self._request("GET", "/api/databases", params={"include_racks": str(include_racks).lower()})
+        return res.get("databases", [])
+
+    def create_database(self, name):
+        return self._request("POST", "/api/databases", {"name": name})
+
+    def delete_database(self, name):
+        return self._request("DELETE", f"/api/databases/{name}")
+
+    # --- Rack Management ---
+
+    def list_racks(self, database):
+        res = self._request("GET", f"/api/databases/{database}/racks")
+        return res.get("racks", [])
+
+    def create_rack(self, database, name, type="nosql", schema=None):
+        payload = {"name": name, "type": type}
+        if schema:
+            payload["schema"] = schema
+        return self._request("POST", f"/api/databases/{database}/racks", payload)
+
+    def delete_rack(self, database, rack):
+        return self._request("DELETE", f"/api/databases/{database}/racks/{rack}")
+
+    def clear_rack(self, database, rack):
+        return self._request("DELETE", f"/api/databases/{database}/racks/{rack}/clear")
+
+    # --- Documents (NoSQL) ---
+
+    def insert(self, database, rack, document):
+        return self._request("POST", f"/api/databases/{database}/racks/{rack}/documents", document)
+
+    def find(self, database, rack, query=None, populate=False):
+        params = query or {}
+        if populate:
+            params["populate"] = "true"
+        res = self._request("GET", f"/api/databases/{database}/racks/{rack}/documents", params=params)
+        return res.get("results", [])
+
+    def find_one(self, database, rack, doc_id, populate=False):
+        res = self.find(database, rack, {"id": doc_id}, populate)
+        return res[0] if res else None
+
+    def update(self, database, rack, doc_id, updates):
+        return self._request("PUT", f"/api/databases/{database}/racks/{rack}/documents/{doc_id}", updates)
+
+    def delete(self, database, rack, doc_id):
+        return self._request("DELETE", f"/api/databases/{database}/racks/{rack}/documents/{doc_id}")
+
+    # --- SQL Operations ---
+
+    def sql(self, database, query):
+        res = self._request("POST", f"/api/sql/{database}/execute", {"query": query})
+        if isinstance(res, dict) and 'results' in res:
+            return res['results']
+        return res
+
+    # --- Search Features ---
+
+    def search(self, database, rack, query_body):
+        res = self._request("POST", f"/api/databases/{database}/racks/{rack}/search", query_body)
+        return res.get("results", [])
+
+    def fuzzy_search(self, database, rack, field, query):
+        return self.search(database, rack, {"type": "fuzzy", "field": field, "query": query})
+
+    def vector_search(self, database, rack, field, vector, k=5):
+        return self.search(database, rack, {"type": "vector", "field": field, "vector": vector, "k": k})
+    
+    # --- Backup ---
+
+    def create_backup(self):
+        return self._request("POST", "/api/backup/create")
+
+    def list_backups(self):
+        res = self._request("GET", "/api/backup/list")
+        return res.get("backups", [])

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

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: opendbs
+Version: 1.0.0
+Summary: Official Python Client for OpenDBS
+Author: OpenDBS Team
+Author-email: support@opendbs.in
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

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

@@ -0,0 +1,9 @@
+README.md
+setup.py
+opendbs/__init__.py
+opendbs/client.py
+opendbs.egg-info/PKG-INFO
+opendbs.egg-info/SOURCES.txt
+opendbs.egg-info/dependency_links.txt
+opendbs.egg-info/requires.txt
+opendbs.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+requests>=2.25.0

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

@@ -0,0 +1 @@
+opendbs

opendbs-1.0.0/setup.cfg

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

opendbs-1.0.0/setup.py

@@ -0,0 +1,19 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="opendbs",
+    version="1.0.0",
+    description="Official Python Client for OpenDBS",
+    author="OpenDBS Team",
+    author_email="support@opendbs.in",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.25.0"
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.6',
+)