Metadata-Version: 2.4
Name: sqlitedeploy
Version: 0.1.0rc3
Summary: Distributed SQLite with Litestream-backed object-storage replication. Installs the platform-native sqlitedeploy CLI binary.
Project-URL: Homepage, https://github.com/Khangdang1690/sqlitedeploy
Project-URL: Issues, https://github.com/Khangdang1690/sqlitedeploy/issues
Author: sqlitedeploy contributors
License: Apache-2.0
Keywords: backup,cli,database,litestream,r2,replication,s3,sqlite
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Database
Classifier: Topic :: System :: Archiving :: Backup
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# sqlitedeploy

Distributed SQLite in one terminal command. Your master lives in your own
object-storage bucket (Cloudflare R2 / Backblaze B2 / S3); your working copy
lives next to your application. Any language with a SQLite driver connects
to it natively.

This package installs the prebuilt platform-native binary and exposes it as
the `sqlitedeploy` command.

## Install

```bash
pip install sqlitedeploy
```

PyPI serves a platform-tagged wheel with the matching binary baked in —
no compilation, no postinstall scripts.

## Quick start

```bash
sqlitedeploy auth login    # one-time Cloudflare R2 setup
sqlitedeploy init          # creates ./data/app.db + ./.sqlitedeploy/
sqlitedeploy run           # foreground replication loop
```

Then connect from your app:

```python
import sqlite3
db = sqlite3.connect("data/app.db")
```

You can also invoke as a module:

```bash
python -m sqlitedeploy --help
```

## Supported platforms

linux x86_64, linux aarch64, macOS x86_64, macOS arm64, Windows x86_64,
Windows arm64.

For unsupported platforms (e.g. linux-riscv64, FreeBSD) download a binary
from <https://github.com/Khangdang1690/sqlitedeploy/releases>.

## Documentation

Full CLI reference, architecture, and limitations:
<https://github.com/Khangdang1690/sqlitedeploy>.

## License

Apache-2.0.
