Experimental Object-Document-Mapper using pydantic to store objects on Aleph.im
Project description
AARS: Aleph Active Record SDK
AARS's goal is to provide simple guardrails for the creation of document databases, based on Aleph's decentralized storage API. It provides tools for modelling, creating and managing decentralized databases, and a set of extensions for the Aleph Python SDK.
You can create a model of your planned database by using the Record
class.
Usage
from aars import Record, Index, AARS
class Book(Record):
title: str
author: str
# initialize the SDK and post subsequent requests to the "MyLibrary" channel on Aleph
AARS(channel="MyLibrary")
# create and add an index for the book title
Index(Book, 'title')
# create & upload a book
new_book = await Book.create(title='Atlas Shrugged', author='Ayn Rand')
# retrieve a book by its ID
book = await Book.get(new_book.id)[0]
# retrieve a book by its title
book = await Book.query(title='Atlas Shrugged')[0]
ToDo:
- Basic CRUD operations
- Basic indexing operations
- Single-key indexing
- Multi-key indexing
- Name indices' post_type
- (IN PROGRESS) Basic search/filtering operations
- Handle pagination
- Encapsulate Aleph SDK as class
- Local caching
- Add tests
- Add documentation
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
aars-0.2.1.tar.gz
(12.0 kB
view hashes)
Built Distribution
aars-0.2.1-py3-none-any.whl
(8.4 kB
view hashes)