pyturso 0.4.0rc9__cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

pyturso-0.4.0rc9.dist-info/METADATA

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: pyturso
+Version: 0.4.0rc9
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Rust
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Database :: Database Engines/Servers
+Requires-Dist: typing-extensions>=4.6.0,!=4.7.0
+Requires-Dist: mypy==1.11.0 ; extra == 'dev'
+Requires-Dist: pytest==8.3.1 ; extra == 'dev'
+Requires-Dist: pytest-cov==5.0.0 ; extra == 'dev'
+Requires-Dist: ruff==0.5.4 ; extra == 'dev'
+Requires-Dist: coverage==7.6.1 ; extra == 'dev'
+Requires-Dist: maturin==1.7.8 ; extra == 'dev'
+Provides-Extra: dev
+Summary: Turso is a work-in-progress, in-process OLTP database management system, compatible with SQLite.
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/tursodatabase/turso
+Project-URL: Source, https://github.com/tursodatabase/turso
+
+<p align="center">
+  <h1 align="center">Turso Database for Python</h1>
+</p>
+
+<p align="center">
+  <a title="Python" target="_blank" href="https://pypi.org/project/pyturso/"><img alt="PyPI" src="https://img.shields.io/pypi/v/pyturso"></a>
+  <a title="MIT" target="_blank" href="https://github.com/tursodatabase/turso/blob/main/LICENSE.md"><img src="http://img.shields.io/badge/license-MIT-orange.svg?style=flat-square"></a>
+</p>
+<p align="center">
+  <a title="Users Discord" target="_blank" href="https://tur.so/discord"><img alt="Chat with other users of Turso on Discord" src="https://img.shields.io/discord/933071162680958986?label=Discord&logo=Discord&style=social"></a>
+</p>
+
+---
+
+## About
+
+> **⚠️ Warning:** This software is in BETA. It may still contain bugs and unexpected behavior. Use caution with production data and ensure you have backups.
+
+## Features
+
+- **SQLite compatible:** SQLite query language and file format support ([status](https://github.com/tursodatabase/turso/blob/main/COMPAT.md)).
+- **In-process**: No network overhead, runs directly in your Python process
+- **Cross-platform**: Supports Linux, macOS, Windows
+- **Remote partial sync**: Bootstrap from a remote database, pull remote changes, and push local changes when online &mdash; all while enjoying a fully operational database offline.
+- **Asyncio support**: Built-in integration with asyncio to ensure queries won’t block your event loop
+
+## Installation
+
+```bash
+uv pip install pyturso
+```
+
+## Database driver
+
+A minimal DB‑API 2.0 example using an in‑memory database:
+
+```python
+import turso
+
+# Standard DB-API usage
+conn = turso.connect(":memory:")
+cur = conn.cursor()
+
+cur.execute("CREATE TABLE users (id INTEGER PRIMARY KEY, username TEXT)")
+cur.execute("INSERT INTO users VALUES (1, 'alice'), (2, 'bob')")
+
+cur.execute("SELECT * FROM users ORDER BY id")
+rows = cur.fetchall()
+print(rows)  # [(1, 'alice'), (2, 'bob')]
+
+conn.close()
+```
+
+## Database driver (asyncio)
+
+Non-blocking access with asyncio:
+
+```python
+import asyncio
+import turso.aio
+
+async def main():
+    # Connect and use as an async context manager
+    async with turso.aio.connect(":memory:") as conn:
+        # Executes multiple statements
+        await conn.executescript("""
+            CREATE TABLE t (id INTEGER PRIMARY KEY, name TEXT);
+            INSERT INTO t(name) VALUES ('alice'), ('bob');
+        """)
+
+        # Use a cursor for parameterized queries
+        cur = conn.cursor()
+        await cur.execute("SELECT COUNT(*) FROM t WHERE name LIKE ?", ("a%",))
+        count = (await cur.fetchone())[0]
+        print(count)  # 1
+
+        # JSON and generate_series also available
+        cur = conn.cursor()
+        await cur.execute("SELECT SUM(value) FROM generate_series(1, 10)")
+        print((await cur.fetchone())[0])  # 55
+
+asyncio.run(main())
+```
+
+## Synchronization driver
+
+Use a remote Turso database while working locally. You can bootstrap local state from the remote, pull remote changes, and push local commits.
+
+Note: You need a Turso remote URL. See the Turso docs for provisioning and authentication.
+
+```python
+import turso.sync
+
+# Connect a local database to a remote Turso database
+conn = turso.sync.connect(
+    ":memory:",                          # local db path (or a file path)
+    remote_url="https://<db>.<region>.turso.io"  # your remote URL
+)
+
+# Read data (fetched from remote if not present locally yet)
+rows = conn.execute("SELECT * FROM t").fetchall()
+print(rows)
+
+# Pull new changes from remote into local
+changed = conn.pull()
+print("Pulled:", changed)  # True if there were new remote changes
+
+# Make local changes
+conn.execute("INSERT INTO t VALUES ('push works')")
+conn.commit()
+
+# Push local commits to remote
+conn.push()
+
+# Optional: inspect and manage sync state
+stats = conn.stats()
+print("Network received (bytes):", stats.network_received_bytes)
+conn.checkpoint()  # compact local WAL after many writes
+
+conn.close()
+```
+
+Partial bootstrap to reduce initial network cost:
+
+```python
+import turso.sync
+
+conn = turso.sync.connect(
+    "local.db",
+    remote_url="https://<db>.<region>.turso.io",
+    partial_boostrap_strategy=turso.sync.PartialSyncPrefixBootstrap(128 * 1024),  # fetch first 128 KiB upfront
+)
+```
+
+## Synchronization driver (asyncio)
+
+The same sync primitives, but fully async:
+
+```python
+import asyncio
+
+async def main():
+    conn = await turso.aio.sync.connect(":memory:", remote_url="https://<db>.<region>.turso.io")
+
+    # Read data
+    rows = await (await conn.execute("SELECT * FROM t")).fetchall()
+    print(rows)
+
+    # Pull and push
+    await conn.pull()
+    await conn.execute("INSERT INTO t VALUES ('hello from asyncio')")
+    await conn.commit()
+    await conn.push()
+
+    # Stats and maintenance
+    stats = await conn.stats()
+    print("Main WAL size:", stats.main_wal_size)
+    await conn.checkpoint()
+
+    await conn.close()
+
+asyncio.run(main())
+```
+
+## License
+
+This project is licensed under the [MIT license](../../LICENSE.md).
+
+## Support
+
+- [GitHub Issues](https://github.com/tursodatabase/turso/issues)
+- [Documentation](https://docs.turso.tech)
+- [Discord Community](https://tur.so/discord)
+

pyturso-0.4.0rc9.dist-info/RECORD

@@ -0,0 +1,14 @@
+pyturso-0.4.0rc9.dist-info/METADATA,sha256=DHbVWngxpHAls3Ix8qs-Tyt4-VsnhnMF2sla5EG0wAQ,6762
+pyturso-0.4.0rc9.dist-info/WHEEL,sha256=SaNIiQNrtb_gMs98PxhWWAIwzEmQuCeBFXlGDceEcaU,147
+turso/__init__.py,sha256=hHP6yAHO9k2sVxwkN0BgKyHyVgleQ8qnk5irv_3KAdk,674
+turso/_turso.cpython-313-x86_64-linux-gnu.so,sha256=2nNaIvhUuIljZQEhIQ8F8icSIG9VD_ob4yyb4_DOmCw,45961272
+turso/aio/__init__.py,sha256=AqixLRlMJgt9mO-L-WKDSuZ_W_jJ_hdGjTS0NVezXzg,112
+turso/aio/sync/__init__.py,sha256=atfWoLQEfMQPKcamYfs9bbUerTs-OYqbYIg-_PXwaH8,293
+turso/lib.py,sha256=w5rR8ugpZwog5Of88Jgc1wHZG-dDZ8Go_dAEOQx2qio,31592
+turso/lib_aio.py,sha256=Qc-nw4yalXEOG9DdZUePpt9KouryJzGHgwQXBwWeCBU,12422
+turso/lib_sync.py,sha256=NZnUBk9XkCkI68mQjrHd-OG8kA__YwoqeRFZbVgqT0s,15960
+turso/lib_sync_aio.py,sha256=1JWIUKNZj-ExW9hlDcsSKbbBk7pDy-LGdNbH8hTDVic,3480
+turso/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+turso/sync/__init__.py,sha256=7Dt7H5t64ylmmE_C6Gqo9Vm6a9u9CCQ0B74j_3TZMT0,287
+turso/worker.py,sha256=zwV-PHe-VNNvuR_hepa6dzboF88DcjzA1MDQbMPE5qw,1499
+pyturso-0.4.0rc9.dist-info/RECORD,,

pyturso-0.4.0rc9.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: maturin (1.10.2)
+Root-Is-Purelib: false
+Tag: cp313-cp313-manylinux_2_17_x86_64
+Tag: cp313-cp313-manylinux2014_x86_64

turso/__init__.py

@@ -0,0 +1,41 @@
+from .lib import (
+    Connection,
+    Cursor,
+    DatabaseError,
+    DataError,
+    Error,
+    IntegrityError,
+    InterfaceError,
+    InternalError,
+    NotSupportedError,
+    OperationalError,
+    ProgrammingError,
+    Row,
+    Warning,
+    apilevel,
+    connect,
+    paramstyle,
+    setup_logging,
+    threadsafety,
+)
+
+__all__ = [
+    "Connection",
+    "Cursor",
+    "Row",
+    "connect",
+    "setup_logging",
+    "Warning",
+    "DatabaseError",
+    "DataError",
+    "Error",
+    "IntegrityError",
+    "InterfaceError",
+    "InternalError",
+    "NotSupportedError",
+    "OperationalError",
+    "ProgrammingError",
+    "apilevel",
+    "paramstyle",
+    "threadsafety",
+]

turso/aio/__init__.py

@@ -0,0 +1,7 @@
+from ..lib_aio import Connection, Cursor, connect
+
+__all__ = [
+    "connect",
+    "Connection",
+    "Cursor",
+]

turso/aio/sync/__init__.py

@@ -0,0 +1,15 @@
+from ...lib_sync import (
+    PartialSyncOpts,
+    PartialSyncPrefixBootstrap,
+    PartialSyncQueryBootstrap,
+)
+from ...lib_sync_aio import (
+    connect_sync as connect,
+)
+
+__all__ = [
+    "connect",
+    "PartialSyncOpts",
+    "PartialSyncPrefixBootstrap",
+    "PartialSyncQueryBootstrap",
+]