codex-db-sdk 0.1.0__py3-none-any.whl

codex_db_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: codex-db-sdk
+Version: 0.1.0
+Summary: Codex DB Python SDK
+Author: Your Name
+Author-email: Your Name <your.email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/evertonmj/codex
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: requires-python
+
+# CodexDB Python SDK
+
+Python SDK for CodexDB. Simple wrapper for `codex-cli` as an external process.
+
+## Installation
+
+Install via pip (from local directory):
+
+```sh
+pip install .
+```
+
+Or, for development:
+
+```sh
+pip install -e .
+```
+
+## Usage Example
+
+```python
+from codex_sdk import CodexClient
+
+client = CodexClient(file='test.db')
+client.set('user:1', {'name': 'Alice', 'age': 30})
+print(client.get('user:1'))
+print(client.keys())
+client.delete('user:1')
+```
+
+## Requirements
+
+- Python 3.7+
+- `codex-cli` binary available in your PATH
+
+## Publishing to PyPI
+
+To publish this package to PyPI:
+
+1. Install build and twine:
+	```sh
+	pip install build twine
+	```
+2. Build the package:
+	```sh
+	python -m build
+	```
+3. Upload to PyPI:
+	```sh
+	twine upload dist/*
+	```
+
+For test uploads, use `https://test.pypi.org/legacy/` with twine's `--repository testpypi` option.

codex_db_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+codex_sdk/__init__.py,sha256=JNBnV25-TS76EYAgLbBoIE6x9yS0zC2P_gacMAduQxc,50
+codex_sdk/codex_sdk.py,sha256=Rt6iITq_j-jU5i0ZSzf3mxdArw8zER-tx0FqckV20oo,1805
+codex_db_sdk-0.1.0.dist-info/METADATA,sha256=ECb-mVupHFg4wUqdkorhMYmk3Ul17fFNgBJDLCDs3tE,1193
+codex_db_sdk-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+codex_db_sdk-0.1.0.dist-info/top_level.txt,sha256=jTG0iUnUWgyVsPWOCnjzSsYCUjyr3R8e9WH6Ce5oEEc,10
+codex_db_sdk-0.1.0.dist-info/RECORD,,

codex_db_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

codex_db_sdk-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+codex_sdk

codex_sdk/__init__.py

@@ -0,0 +1,3 @@
+# codex_sdk/__init__.py
+
+from .codex_sdk import *

codex_sdk/codex_sdk.py

@@ -0,0 +1,63 @@
+import json
+import shutil
+import subprocess
+
+
+class CodexClient:
+    def __init__(self, file, cli_path='codex-cli', ledger=False, encryption_key=None):
+        if not file:
+            raise ValueError('file is required')
+
+        if shutil.which(cli_path) is None:
+            raise FileNotFoundError(f"codex-cli not found at '{cli_path}' in PATH")
+
+        self.cli_path = cli_path
+        self.file = file
+        self.ledger = ledger
+        self.env = None
+
+        if encryption_key is not None:
+            self.env = dict(**__import__('os').environ)
+            self.env['CODEX_KEY'] = encryption_key
+
+    def _base_args(self):
+        args = ['--file', self.file]
+        if self.ledger:
+            args.append('--ledger')
+        return args
+
+    def _run(self, *cmd_args):
+        args = [self.cli_path, *self._base_args(), *cmd_args]
+        cp = subprocess.run(args, capture_output=True, text=True, env=self.env)
+        if cp.returncode != 0:
+            raise RuntimeError(cp.stderr.strip() or cp.stdout.strip() or f'codex-cli failed ({cp.returncode})')
+        return cp.stdout.strip()
+
+    def set(self, key, value):
+        payload = json.dumps(value, ensure_ascii=False)
+        self._run('set', key, payload)
+        return True
+
+    def get(self, key):
+        raw = self._run('get', key)
+        if raw == 'null' or raw == '':
+            return None
+        return json.loads(raw)
+
+    def delete(self, key):
+        self._run('delete', key)
+        return True
+
+    def keys(self):
+        raw = self._run('keys')
+        if not raw:
+            return []
+        return [k for k in raw.split('\n') if k]
+
+    def has(self, key):
+        raw = self._run('has', key)
+        return raw.strip().lower() == 'true'
+
+    def clear(self):
+        self._run('clear')
+        return True