python-pybase 0.1.0

A schema-driven, file-based database with encryption

Pybase

---

Pybase é um banco de dados baseado em arquivos JSON com schema opcional, criptografia nativa e zero dependências externas — apenas Python puro.

✅ Sem servidor · ✅ Sem SQL · ✅ Sem dependências · ✅ Fácil

---

Instalação

pip install python-pybase

Python 3.10+ apenas. Nenhuma dependência externa é necessária.

Instalação para desenvolvimento

git clone https://github.com/marcosgabrielgomes110-collab/Pybase2.git
cd Pybase2
pip install -e .

---

Exemplo rápido

from pybase import Pybase as pb

# Schema opcional
users = pb.schema(
    nome=str,
    idade=int,
    senha=pb.cript(str),        # campo criptografado
    foto=pb.image,               # campo imagem
    email=pb.optional(str),      # opcional
)

# Criar/abrir banco
db = pb.database("meudb", "123", schema=users)

# Inserir
id_ = db.insert(nome="João", idade=30, senha="joao123")

# Consultar
db.query.all()                  # todos registros
db.query.find(idade__gte=18)   # filtro com operador
db.query.get(id=id_)           # por UUID

---

Funcionalidades

Funcionalidade	Descrição
📦 Schema opcional	Define a estrutura dos dados com tipos Python (str, int, float, bool)
🔒 Criptografia	Campos protegidos com PBKDF2-SHA256 + HMAC-CTR
🖼️ Imagens	Armazenamento automático de arquivos de imagem
🔍 Consultas	Filtros, ordenação, paginação, operadores (__gte, __contains, etc.)
📋 Transações	begin / commit / rollback
💾 Backup	Exportação zip completa do banco
📤 Export	JSON e CSV com filtros
🧹 Zero dependências	Apenas stdlib do Python 3.10+

---

Documentação

• Guia Rápido — comece aqui
• Schema — tipos, campos opcionais, criptografia, imagem
• Database — CRUD, transações, backup, export
• Consultas — filtros, operadores, ordenação, paginação
• Segurança — criptografia, escrita atômica, validação
• API — referência completa

---

Testes

python -m pytest tests/ -v

---

Licença

MIT — veja LICENSE.

---

Contribuindo

Contribuições são bem-vindas! Veja CONTRIBUTING.md.