pybasedb-json 0.2.0

Banco de dados local com JSON — zero dependencias, 100% stdlib, thread-safe

Pybase

Base para criacao de bancos de dados locais com JSON. Zero dependencias, 100% stdlib. Operacoes de escrita atomicas, thread-safe.

Instalacao

pip install pybasedb-json

Uso

from pybase import Database, Query

db = Database("./data", "mydb", "minha-senha").open("minha-senha")

users = db.collection("users")

users.add({"id": "a1", "name": "marcos", "age": 25})
users.add_many([
    {"id": "a2", "name": "ana",    "age": 30},
    {"id": "a3", "name": "marcos", "age": 40},
])

print(len(users))                    # 3
print(users.count(name="marcos"))    # 2

for doc in users:
    print(doc["name"])               # marcos, ana, marcos

doc = users.get("a1")                # por id
print(doc)                           # {"id": "a1", "name": "marcos", "age": 25}

q = Query(users)
print(q.find(name="marcos"))                       # [doc_a1, doc_a3]
print(q.sort("age", reverse=True).limit(1).find()) # [doc_a3]
print(q.find_one(name="ana"))                      # {"id": "a2", ...}
print(q.exists(name="joao"))                       # False

users.actualize({"age": 26}, name="marcos")
users.rem(id="a3")

users.drop()    # limpa colecao
# db.drop("minha-senha")  # deleta banco inteiro

Estrutura

Pybase/
  pybase/
    __init__.py       # exports: Database, Collection, Query, PybaseError, ...
    database.py       # Database: gerencia diretorio de tabelas JSON
    collections.py    # Collection: CRUD atomico com lock por colecao
    query.py          # Query: find/find_one/exists + sort/limit/offset
    exceptions.py     # PybaseError > DatabaseError, CollectionError
    utils.py          # Utils: sha256 encode
  pyproject.toml

Documentacao

Veja docs/ com referencia completa de cada metodo.