https://github.com/jnsougata/fractal
A fast lightweight k-v storage for hobbyists.
https://github.com/jnsougata/fractal
kvstore nosql python3 sqlite3
Last synced: 3 months ago
JSON representation
A fast lightweight k-v storage for hobbyists.
- Host: GitHub
- URL: https://github.com/jnsougata/fractal
- Owner: jnsougata
- License: mit
- Created: 2025-04-01T07:24:28.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-07-04T11:38:50.000Z (12 months ago)
- Last Synced: 2026-01-29T20:58:17.071Z (5 months ago)
- Topics: kvstore, nosql, python3, sqlite3
- Language: Python
- Homepage: https://fractal.readthedocs.io/en/latest/
- Size: 66.4 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FractalDB - KV Store
A fast, lightweight key-value store designed for hobbyists, combining the simplicity of NoSQL with SQLite3's robust filtering and sorting capabilities.
## Features
- **NoSQL-like Experience** – Work with database records as Python dictionaries.
- **Simplified Access** – Retrieve data without remembering column names or indices.
- **SQL Power** – Use SQL queries for filtering and sorting.
- **Lightweight & Fast** – Minimal overhead with SQLite’s reliability.
## Installation
```sh
pip install git+https://github.com/jnsougata/fractal.git
```
## Example Usage
```python
from fractal import DB
import fractal.operators as op
if __name__ == "__main__":
db = DB("example.db")
users = db.collection(name="users")
inserted = users.put(
{"name": "Alice", "age": 25},
{"name": "Bob", "age": 30},
{"name": "Charlie", "age": 35},
{"name": "David", "age": 40},
)
users = db.collection("users")
results = users.where(op.greater_than("age", 35))
print(list(results))
```
#### Sample Output:
```
[{'key': '379b87afd3d74f49bc1c59b8185bb534', 'name': 'David', 'age': 40}]
```
## Documentation
Half-baked docs [here.](https://fractal.readthedocs.io/en/latest/)