pybasedb-json 0.3.0__tar.gz → 0.5.0__tar.gz

pybasedb_json-0.5.0/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: pybasedb-json
+Version: 0.5.0
+Summary: Banco de dados local com JSON — schemas, decorator API, server REST, criptografia, zero dependencias
+Author-email: Marcos Gomes <marcosgabrielgomes110@gmail.com>
+Maintainer-email: Marcos Gomes <marcosgabrielgomes110@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/marcosgabrielgomes110-collab/Pybase
+Project-URL: Documentation, https://github.com/marcosgabrielgomes110-collab/Pybase/tree/main/docs
+Project-URL: Repository, https://github.com/marcosgabrielgomes110-collab/Pybase
+Keywords: database,json,local,embedded,nosql,thread-safe,rest-api,schema,media
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="assets/logo/logo.png" width="120" alt="Pybase logo">
+</p>
+
+# Pybase v0.5
+
+Base para criacao de bancos de dados locais com JSON. Zero dependencias, 100% stdlib.
+Operacoes de escrita atomicas, thread-safe.
+
+Filosofia **Lego**: cada modulo e independente — voce monta o que precisa.
+
+## Instalacao
+
+```bash
+pip install pybasedb-json
+```
+
+Para o servidor REST (opcional):
+```bash
+pip install Flask
+```
+
+## Uso rapido
+
+```python
+from pybase import pybase as pb
+
+# Banco de dados
+db = pb.Database("./data/mydb")
+
+# Schema com decorator
+@db.schema.users
+class User:
+    name: str
+    email: str
+    age: int = 0
+    active: bool = True
+    tags: list[str] = []
+
+# Colecao com validacao automatica
+users = db["users"]
+users.add({"name": "marcos", "email": "m@m.com"})
+
+# Operadores de query (v0.5+)
+users.find(age__gt=18, name__contains="mar")
+
+# Paginacao (v0.5+)
+users.paginate(page=1, per_page=20)
+
+# Transacao (v0.5+)
+with db.transaction() as txn:
+    txn["users"].add({"name": "ana"})
+
+# Server com auth + CORS (v0.5+)
+pb.Server(db, auth="token123", cors="*").run()
+
+# CLI (v0.5+)
+# $ pybase serve mydb --port=4560
+```
+
+## Modulos
+
+| Modulo | Arquivo | Descricao | Deps |
+|--------|---------|-----------|------|
+| Database | `pybase/database.py` | Gerencia diretorio de tabelas JSON | 0 |
+| Collection | `pybase/collections.py` | CRUD atomico + query com operadores + JSONL | 0 |
+| Filter | `pybase/filters.py` | Motor de filtros com 13 operadores | 0 |
+| Query | `pybase/query.py` | Thin wrapper sobre Collection | 0 |
+| Schema | `pybase/validation.py` | Validacao com choices, min/max, email, datetime, UUID, ref, JSON Schema | 0 |
+| Ref | `pybase/ref.py` | Referencias entre colecoes | 0 |
+| Server | `pybase/server.py` | REST API com auth, cors, patch, batch + Swagger UI | Flask |
+| CLI | `pybase/cli/` | Linha de comando: init, inspect, serve, backup (ASCII + ANSI) | 0 |
+| Media | `pybase/media.py` | Upload/download de imagens | 0 |
+| Backup | `pybase/backup.py` | Snapshot e restore (seletivo) | 0 |
+| Crypto | `pybase/crypto.py` | Criptografia stdlib (scrypt + XOR) | 0 |
+| Hooks | `pybase/hooks.py` | Lifecycle hooks para Collection | 0 |
+| Plugin | `pybase/plugin.py` | Sistema de plugins globais | 0 |
+| Transaction | `pybase/transaction.py` | Multi-colecao commit/rollback | 0 |
+| Migration | `pybase/migration.py` | Migracoes versionadas | 0 |
+| Async | `pybase/async_.py` | Wrappers assincronos | 0 |
+| Index | `pybase/index.py` | Indices hash O(1) (memoria + persistente) | 0 |
+
+## Novidades da v0.5
+
+- **Operadores de query** — `__gt`, `__contains`, `__in`, `__has`, `__regex` e mais 13
+- **Paginacao** — `.paginate(page, per_page)` → `{items, total, pages}`
+- **Projecao** — `.select("name", "age")` para campos especificos
+- **Agregacao** — `.aggregate([$match, $group, $sort, ...])`
+- **Schema avancado** — `choices`, `min`/`max`, `email`, `url`, `datetime`, `UUID`, `ref`
+- **Ref** — `Ref("users", "abc").resolve(db)` para referencias entre colecoes
+- **JSON Schema** — `.to_json_schema()` export draft-07
+- **CLI** — `pybase init`, `inspect`, `serve`, `backup`, `query`, `schema`, ...
+- **Server auth** — `Server(db, auth="token")`, Basic Auth, callback
+- **Server CORS** — `Server(db, cors="*")` ou lista de origens
+- **PATCH** — atualizacao parcial via REST
+- **Batch** — operacoes em lote via REST
+- **Transacoes** — `with db.transaction() as txn:` commit/rollback
+- **Plugins** — `Plugin` class com `on_add`, `on_update`, etc
+- **Migracoes** — `Migration(db).add(ver, fn).run()`
+- **Async** — `AsyncCollection`, `AsyncDatabase` (via `asyncio.to_thread`)
+- **Eventos** — `col.on("add", cb)` observer pattern
+- **JSONL** — formato linha-por-linha para append O(1)
+- **Lock multi-processo** — `Collection(lock_type="process")`
+- **PersistentIndex** — indice salvo em disco
+- **Clone** — `db.clone(dest)` copia banco
+- **Context manager** — `with Database(...) as db:`
+
+## Estrutura
+
+```
+Pybase/
+  pybase/
+    __init__.py       # Database, Collection, Query, Server, Schema, T, Filter, Ref
+    __main__.py       # python -m pybase
+    pybase.py         # from pybase import pybase
+    database.py       # Database, SchemaRegistrar
+    collections.py    # Collection, DocRef, QueryBuilder, SchemaCollection
+    filters.py        # Filter: operadores de query
+    query.py          # Query wrapper
+    exceptions.py     # PybaseError > DatabaseError, CollectionError, ...
+    validation.py     # Schema, T, ValidationError
+    ref.py            # Ref: referencias entre colecoes
+    server.py         # Server REST (Flask) com auth/cors/patch/batch
+    cli/              # CLI: init, inspect, serve, backup (ASCII + ANSI)
+    media.py          # MediaManager
+    index.py          # Index + PersistentIndex
+    hooks.py          # HooksCollection
+    backup.py         # take, restore
+    crypto.py         # encrypt, decrypt (stdlib)
+    plugin.py         # Plugin system
+    transaction.py    # Transaction commit/rollback
+    migration.py      # Migration versionada
+    async_.py         # AsyncCollection, AsyncDatabase
+    lock.py           # FileLock multi-processo
+    utils.py          # PBKDF2 encode/verify
+  docs/               # Documentacao completa (23 paginas)
+  index.html          # Documentacao web
+  pyproject.toml
+```
+
+## Documentacao
+
+Veja [docs/](docs/index.md) ou [index.html](index.html) com referencia completa de cada classe e metodo.
+
+## Licenca
+
+MIT

pybasedb_json-0.5.0/README.md

@@ -0,0 +1,147 @@
+<p align="center">
+  <img src="assets/logo/logo.png" width="120" alt="Pybase logo">
+</p>
+
+# Pybase v0.5
+
+Base para criacao de bancos de dados locais com JSON. Zero dependencias, 100% stdlib.
+Operacoes de escrita atomicas, thread-safe.
+
+Filosofia **Lego**: cada modulo e independente — voce monta o que precisa.
+
+## Instalacao
+
+```bash
+pip install pybasedb-json
+```
+
+Para o servidor REST (opcional):
+```bash
+pip install Flask
+```
+
+## Uso rapido
+
+```python
+from pybase import pybase as pb
+
+# Banco de dados
+db = pb.Database("./data/mydb")
+
+# Schema com decorator
+@db.schema.users
+class User:
+    name: str
+    email: str
+    age: int = 0
+    active: bool = True
+    tags: list[str] = []
+
+# Colecao com validacao automatica
+users = db["users"]
+users.add({"name": "marcos", "email": "m@m.com"})
+
+# Operadores de query (v0.5+)
+users.find(age__gt=18, name__contains="mar")
+
+# Paginacao (v0.5+)
+users.paginate(page=1, per_page=20)
+
+# Transacao (v0.5+)
+with db.transaction() as txn:
+    txn["users"].add({"name": "ana"})
+
+# Server com auth + CORS (v0.5+)
+pb.Server(db, auth="token123", cors="*").run()
+
+# CLI (v0.5+)
+# $ pybase serve mydb --port=4560
+```
+
+## Modulos
+
+| Modulo | Arquivo | Descricao | Deps |
+|--------|---------|-----------|------|
+| Database | `pybase/database.py` | Gerencia diretorio de tabelas JSON | 0 |
+| Collection | `pybase/collections.py` | CRUD atomico + query com operadores + JSONL | 0 |
+| Filter | `pybase/filters.py` | Motor de filtros com 13 operadores | 0 |
+| Query | `pybase/query.py` | Thin wrapper sobre Collection | 0 |
+| Schema | `pybase/validation.py` | Validacao com choices, min/max, email, datetime, UUID, ref, JSON Schema | 0 |
+| Ref | `pybase/ref.py` | Referencias entre colecoes | 0 |
+| Server | `pybase/server.py` | REST API com auth, cors, patch, batch + Swagger UI | Flask |
+| CLI | `pybase/cli/` | Linha de comando: init, inspect, serve, backup (ASCII + ANSI) | 0 |
+| Media | `pybase/media.py` | Upload/download de imagens | 0 |
+| Backup | `pybase/backup.py` | Snapshot e restore (seletivo) | 0 |
+| Crypto | `pybase/crypto.py` | Criptografia stdlib (scrypt + XOR) | 0 |
+| Hooks | `pybase/hooks.py` | Lifecycle hooks para Collection | 0 |
+| Plugin | `pybase/plugin.py` | Sistema de plugins globais | 0 |
+| Transaction | `pybase/transaction.py` | Multi-colecao commit/rollback | 0 |
+| Migration | `pybase/migration.py` | Migracoes versionadas | 0 |
+| Async | `pybase/async_.py` | Wrappers assincronos | 0 |
+| Index | `pybase/index.py` | Indices hash O(1) (memoria + persistente) | 0 |
+
+## Novidades da v0.5
+
+- **Operadores de query** — `__gt`, `__contains`, `__in`, `__has`, `__regex` e mais 13
+- **Paginacao** — `.paginate(page, per_page)` → `{items, total, pages}`
+- **Projecao** — `.select("name", "age")` para campos especificos
+- **Agregacao** — `.aggregate([$match, $group, $sort, ...])`
+- **Schema avancado** — `choices`, `min`/`max`, `email`, `url`, `datetime`, `UUID`, `ref`
+- **Ref** — `Ref("users", "abc").resolve(db)` para referencias entre colecoes
+- **JSON Schema** — `.to_json_schema()` export draft-07
+- **CLI** — `pybase init`, `inspect`, `serve`, `backup`, `query`, `schema`, ...
+- **Server auth** — `Server(db, auth="token")`, Basic Auth, callback
+- **Server CORS** — `Server(db, cors="*")` ou lista de origens
+- **PATCH** — atualizacao parcial via REST
+- **Batch** — operacoes em lote via REST
+- **Transacoes** — `with db.transaction() as txn:` commit/rollback
+- **Plugins** — `Plugin` class com `on_add`, `on_update`, etc
+- **Migracoes** — `Migration(db).add(ver, fn).run()`
+- **Async** — `AsyncCollection`, `AsyncDatabase` (via `asyncio.to_thread`)
+- **Eventos** — `col.on("add", cb)` observer pattern
+- **JSONL** — formato linha-por-linha para append O(1)
+- **Lock multi-processo** — `Collection(lock_type="process")`
+- **PersistentIndex** — indice salvo em disco
+- **Clone** — `db.clone(dest)` copia banco
+- **Context manager** — `with Database(...) as db:`
+
+## Estrutura
+
+```
+Pybase/
+  pybase/
+    __init__.py       # Database, Collection, Query, Server, Schema, T, Filter, Ref
+    __main__.py       # python -m pybase
+    pybase.py         # from pybase import pybase
+    database.py       # Database, SchemaRegistrar
+    collections.py    # Collection, DocRef, QueryBuilder, SchemaCollection
+    filters.py        # Filter: operadores de query
+    query.py          # Query wrapper
+    exceptions.py     # PybaseError > DatabaseError, CollectionError, ...
+    validation.py     # Schema, T, ValidationError
+    ref.py            # Ref: referencias entre colecoes
+    server.py         # Server REST (Flask) com auth/cors/patch/batch
+    cli/              # CLI: init, inspect, serve, backup (ASCII + ANSI)
+    media.py          # MediaManager
+    index.py          # Index + PersistentIndex
+    hooks.py          # HooksCollection
+    backup.py         # take, restore
+    crypto.py         # encrypt, decrypt (stdlib)
+    plugin.py         # Plugin system
+    transaction.py    # Transaction commit/rollback
+    migration.py      # Migration versionada
+    async_.py         # AsyncCollection, AsyncDatabase
+    lock.py           # FileLock multi-processo
+    utils.py          # PBKDF2 encode/verify
+  docs/               # Documentacao completa (23 paginas)
+  index.html          # Documentacao web
+  pyproject.toml
+```
+
+## Documentacao
+
+Veja [docs/](docs/index.md) ou [index.html](index.html) com referencia completa de cada classe e metodo.
+
+## Licenca
+
+MIT

pybasedb_json-0.5.0/pybase/__init__.py

@@ -0,0 +1,48 @@
+try:
+    from .server import Server
+except ImportError:
+    Server = None
+
+from .collections import Collection, DocRef, QueryBuilder, SchemaCollection
+from .database import Database
+from .filters import Filter
+from .ref import Ref
+from .exceptions import (
+    CollectionError,
+    DatabaseError,
+    DocumentNotFoundError,
+    EncryptionError,
+    MediaError,
+    PybaseError,
+    QueryError,
+    ValidationError,
+)
+from .query import Query
+
+try:
+    from .validation import Schema, T
+except ImportError:
+    Schema = None
+    T = None
+
+__all__ = [
+    "Collection",
+    "Database",
+    "DocRef",
+    "DocumentNotFoundError",
+    "EncryptionError",
+    "MediaError",
+    "PybaseError",
+    "DatabaseError",
+    "CollectionError",
+    "Filter",
+    "Query",
+    "QueryBuilder",
+    "QueryError",
+    "Ref",
+    "Schema",
+    "SchemaCollection",
+    "Server",
+    "T",
+    "ValidationError",
+]

pybasedb_json-0.5.0/pybase/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .cli import main
+
+sys.exit(main())

pybasedb_json-0.5.0/pybase/async_.py

@@ -0,0 +1,66 @@
+from __future__ import annotations
+
+import asyncio
+from typing import Any
+
+from .collections import Collection as SyncCollection
+
+
+class AsyncCollection:
+    def __init__(self, collection: SyncCollection) -> None:
+        self._col = collection
+
+    async def all(self) -> list[dict]:
+        return await asyncio.to_thread(self._col.all)
+
+    async def get(self, doc_id: str) -> dict | None:
+        return await asyncio.to_thread(self._col.get, doc_id)
+
+    async def add(self, data: dict) -> dict:
+        return await asyncio.to_thread(self._col.add, data)
+
+    async def add_many(self, items: list[dict]) -> list[dict]:
+        return await asyncio.to_thread(self._col.add_many, items)
+
+    async def update(self, data: dict, **match) -> int:
+        return await asyncio.to_thread(self._col.update, data, **match)
+
+    async def delete(self, **match) -> int:
+        return await asyncio.to_thread(self._col.delete, **match)
+
+    async def find(self, **match) -> list[dict]:
+        return await asyncio.to_thread(self._col.find, **match)
+
+    async def find_one(self, **match) -> dict | None:
+        return await asyncio.to_thread(self._col.find_one, **match)
+
+    async def exists(self, **match) -> bool:
+        return await asyncio.to_thread(self._col.exists, **match)
+
+    async def count(self, **match) -> int:
+        return await asyncio.to_thread(self._col.count, **match)
+
+    async def paginate(self, page: int = 1, per_page: int = 20) -> dict:
+        return await asyncio.to_thread(self._col.paginate, page, per_page)
+
+    def __getattr__(self, name: str):
+        return getattr(self._col, name)
+
+
+class AsyncDatabase:
+    def __init__(self, db) -> None:
+        self._db = db
+
+    @property
+    def name(self) -> str:
+        return self._db.name
+
+    @property
+    def collections(self) -> list[str]:
+        return self._db.collections
+
+    def collection(self, name: str) -> AsyncCollection:
+        return AsyncCollection(self._db.collection(name))
+
+    async def info(self) -> dict:
+        return await asyncio.to_thread(self._db.info)

{pybasedb_json-0.3.0 → pybasedb_json-0.5.0}/pybase/backup.py

@@ -22,8 +22,8 @@ def take(
     dest: str | Path | None = None,
     *,
     compress: bool = True,
+    collections: list[str] | None = None,
 ) -> Path:
-    # Snapshot every collection into one timestamped file
     backup_dir = Path(dest) if dest else (db.path_dir / _BACKUP_DIR)
     backup_dir.mkdir(parents=True, exist_ok=True)
 
@@ -31,8 +31,9 @@ def take(
     ext = ".json.gz" if compress else ".json"
     out_path = backup_dir / f"{db.name}_{ts}{ext}"
 
+    names = collections if collections else db.collections
     snapshot: dict[str, list[dict]] = {}
-    for name in db.collections():
+    for name in names:
         snapshot[name] = db.collection(name).all()
 
     raw = json.dumps(snapshot, indent=2).encode("utf-8")

pybasedb_json-0.5.0/pybase/cli/__init__.py

@@ -0,0 +1,3 @@
+from .main import main
+
+__all__ = ["main"]

pybasedb_json-0.5.0/pybase/cli/colors.py

@@ -0,0 +1,122 @@
+import os
+
+_RESET = "\033[0m"
+_BOLD = "\033[1m"
+_DIM = "\033[2m"
+_ITALIC = "\033[3m"
+_UNDERLINE = "\033[4m"
+_REVERSE = "\033[7m"
+
+_BLACK = "\033[30m"
+_RED = "\033[31m"
+_GREEN = "\033[32m"
+_YELLOW = "\033[33m"
+_BLUE = "\033[34m"
+_MAGENTA = "\033[35m"
+_CYAN = "\033[36m"
+_WHITE = "\033[37m"
+
+_BG_BLACK = "\033[40m"
+_BG_RED = "\033[41m"
+_BG_GREEN = "\033[42m"
+_BG_YELLOW = "\033[43m"
+_BG_BLUE = "\033[44m"
+_BG_MAGENTA = "\033[45m"
+_BG_CYAN = "\033[46m"
+_BG_WHITE = "\033[47m"
+
+
+def _supports_color() -> bool:
+    return os.environ.get("NO_COLOR") is None and (
+        os.environ.get("TERM") not in ("dumb", "") or os.isatty(1)
+    )
+
+
+def s(text: str, *codes: str) -> str:
+    if not codes or not _supports_color():
+        return text
+    return "".join(codes) + text + _RESET
+
+
+def bold(text: str) -> str:
+    return s(text, _BOLD)
+
+
+def dim(text: str) -> str:
+    return s(text, _DIM)
+
+
+def red(text: str) -> str:
+    return s(text, _RED)
+
+
+def green(text: str) -> str:
+    return s(text, _GREEN)
+
+
+def yellow(text: str) -> str:
+    return s(text, _YELLOW)
+
+
+def blue(text: str) -> str:
+    return s(text, _BLUE)
+
+
+def magenta(text: str) -> str:
+    return s(text, _MAGENTA)
+
+
+def cyan(text: str) -> str:
+    return s(text, _CYAN)
+
+
+def white(text: str) -> str:
+    return s(text, _WHITE)
+
+
+def bold_red(text: str) -> str:
+    return s(text, _BOLD, _RED)
+
+
+def bold_green(text: str) -> str:
+    return s(text, _BOLD, _GREEN)
+
+
+def bold_yellow(text: str) -> str:
+    return s(text, _BOLD, _YELLOW)
+
+
+def bold_blue(text: str) -> str:
+    return s(text, _BOLD, _BLUE)
+
+
+def bold_cyan(text: str) -> str:
+    return s(text, _BOLD, _CYAN)
+
+
+def bold_magenta(text: str) -> str:
+    return s(text, _BOLD, _MAGENTA)
+
+
+def header(text: str) -> str:
+    return s(text, _BOLD, _WHITE, _BG_BLUE)
+
+
+def ok(text: str) -> str:
+    return s(text, _BOLD, _GREEN)
+
+
+def warn(text: str) -> str:
+    return s(text, _BOLD, _YELLOW)
+
+
+def fail(text: str) -> str:
+    return s(text, _BOLD, _RED)
+
+
+def info(text: str) -> str:
+    return s(text, _CYAN)
+
+
+def muted(text: str) -> str:
+    return s(text, _DIM)