2025-09-27 15:13:17 -07:00
|
|
|
from __future__ import annotations
|
|
|
|
|
2025-09-24 19:51:39 -07:00
|
|
|
from collections import namedtuple
|
2025-09-28 10:33:44 -07:00
|
|
|
from dataclasses import dataclass, field
|
2025-09-27 15:13:17 -07:00
|
|
|
from typing import Dict, List
|
2025-09-24 19:51:39 -07:00
|
|
|
|
|
|
|
import nanoid
|
2025-09-28 10:33:44 -07:00
|
|
|
from tinydb import TinyDB, where
|
2025-09-27 15:13:17 -07:00
|
|
|
|
|
|
|
from grung.exceptions import PointerReferenceError
|
2025-09-24 19:51:39 -07:00
|
|
|
|
|
|
|
Metadata = namedtuple("Metadata", ["table", "fields"])
|
|
|
|
|
|
|
|
|
|
|
|
@dataclass
|
|
|
|
class Field:
|
|
|
|
"""
|
|
|
|
Represents a single field in a Record.
|
|
|
|
"""
|
|
|
|
|
|
|
|
name: str
|
2025-09-28 10:33:44 -07:00
|
|
|
value_type: type = str
|
|
|
|
default: str = None
|
2025-09-24 19:51:39 -07:00
|
|
|
unique: bool = False
|
|
|
|
|
2025-09-27 15:13:17 -07:00
|
|
|
def serialize(self, rec: value_type, db: TinyDB) -> str:
|
|
|
|
return str(rec)
|
|
|
|
|
2025-09-28 12:00:19 -07:00
|
|
|
def deserialize(self, rec: value_type, db: TinyDB, recurse: bool = True) -> value_type:
|
2025-09-27 15:13:17 -07:00
|
|
|
return rec
|
|
|
|
|
|
|
|
|
2025-09-28 10:33:44 -07:00
|
|
|
@dataclass
|
2025-09-27 15:13:17 -07:00
|
|
|
class Integer(Field):
|
2025-09-28 11:11:34 -07:00
|
|
|
value_type: type = int
|
2025-09-28 10:33:44 -07:00
|
|
|
default: int = 0
|
2025-09-27 15:13:17 -07:00
|
|
|
|
2025-09-28 12:00:19 -07:00
|
|
|
def deserialize(self, rec: str, db: TinyDB, recurse: bool = True) -> value_type:
|
2025-09-27 15:13:17 -07:00
|
|
|
return int(rec)
|
|
|
|
|
2025-09-24 19:51:39 -07:00
|
|
|
|
2025-09-27 15:13:17 -07:00
|
|
|
class Record(Dict[(str, Field)]):
|
2025-09-24 19:51:39 -07:00
|
|
|
"""
|
|
|
|
Base type for a single database record.
|
|
|
|
"""
|
|
|
|
|
|
|
|
def __init__(self, raw_doc: dict = {}, doc_id: int = None, **params):
|
2025-09-28 10:33:44 -07:00
|
|
|
self.doc_id = doc_id
|
|
|
|
fields = self.__class__.fields()
|
|
|
|
self._metadata = Metadata(table=self.__class__.__name__, fields={f.name: f for f in fields})
|
|
|
|
super().__init__(dict({field.name: field.default for field in fields}, **raw_doc, **params))
|
|
|
|
|
|
|
|
@classmethod
|
|
|
|
def fields(self):
|
|
|
|
return [
|
2025-09-24 19:51:39 -07:00
|
|
|
# 1% collision rate at ~2M records
|
|
|
|
Field("uid", default=nanoid.generate(size=8), unique=True)
|
2025-09-28 10:33:44 -07:00
|
|
|
]
|
2025-09-24 19:51:39 -07:00
|
|
|
|
2025-09-27 15:13:17 -07:00
|
|
|
def serialize(self, db):
|
|
|
|
"""
|
|
|
|
Serialie every field on the record
|
|
|
|
"""
|
|
|
|
rec = {}
|
2025-09-28 11:11:34 -07:00
|
|
|
for name, _field in self._metadata.fields.items():
|
|
|
|
rec[name] = _field.serialize(self[name], db)
|
2025-09-27 15:13:17 -07:00
|
|
|
return self.__class__(rec, doc_id=self.doc_id)
|
|
|
|
|
2025-09-28 12:00:19 -07:00
|
|
|
def deserialize(self, db, recurse: bool = True):
|
2025-09-27 15:13:17 -07:00
|
|
|
"""
|
|
|
|
Deserialize every field on the record
|
|
|
|
"""
|
|
|
|
rec = {}
|
2025-09-28 11:11:34 -07:00
|
|
|
for name, _field in self._metadata.fields.items():
|
2025-09-28 12:00:19 -07:00
|
|
|
rec[name] = _field.deserialize(self[name], db, recurse=recurse)
|
2025-09-27 15:13:17 -07:00
|
|
|
return self.__class__(rec, doc_id=self.doc_id)
|
|
|
|
|
2025-09-28 11:23:38 -07:00
|
|
|
def before_insert(self):
|
|
|
|
pass
|
|
|
|
|
2025-09-24 19:51:39 -07:00
|
|
|
def __setattr__(self, key, value):
|
|
|
|
if key in self:
|
|
|
|
self[key] = value
|
|
|
|
super().__setattr__(key, value)
|
|
|
|
|
|
|
|
def __getattr__(self, attr_name):
|
|
|
|
if attr_name in self:
|
|
|
|
return self.get(attr_name)
|
|
|
|
return super().__getattr__(attr_name)
|
|
|
|
|
2025-09-28 10:33:44 -07:00
|
|
|
def __hash__(self):
|
|
|
|
return hash(str(dict(self)))
|
|
|
|
|
2025-09-24 19:51:39 -07:00
|
|
|
def __repr__(self):
|
|
|
|
return f"{self.__class__.__name__}[{self.doc_id}]: {self.items()}"
|
2025-09-27 15:13:17 -07:00
|
|
|
|
|
|
|
|
2025-09-28 10:33:44 -07:00
|
|
|
@dataclass
|
2025-09-27 15:13:17 -07:00
|
|
|
class Collection(Field):
|
|
|
|
"""
|
|
|
|
A collection of fields that store pointers instead of dicts.
|
|
|
|
"""
|
|
|
|
|
2025-09-28 10:33:44 -07:00
|
|
|
value_type: type = Record
|
|
|
|
default: List[value_type] = field(default_factory=lambda: [])
|
2025-09-27 15:13:17 -07:00
|
|
|
|
2025-09-28 10:33:44 -07:00
|
|
|
def serialize(self, value: value_type, db: TinyDB) -> List[str]:
|
|
|
|
vals = self.default
|
|
|
|
if value:
|
|
|
|
for rec in value:
|
|
|
|
if not rec.doc_id:
|
|
|
|
raise PointerReferenceError(rec)
|
|
|
|
vals.append(f"{rec._metadata.table}::{rec.uid}")
|
2025-09-27 15:13:17 -07:00
|
|
|
return vals
|
|
|
|
|
2025-09-28 12:00:19 -07:00
|
|
|
def deserialize(self, rec: List[value_type], db: TinyDB, recurse=True) -> value_type:
|
2025-09-27 15:13:17 -07:00
|
|
|
"""
|
|
|
|
Recursively deserialize the objects in this collection
|
|
|
|
"""
|
|
|
|
vals = []
|
2025-09-28 12:12:05 -07:00
|
|
|
if not recurse:
|
|
|
|
return rec
|
2025-09-27 15:13:17 -07:00
|
|
|
for member in rec:
|
|
|
|
pt, puid = member.split("::")
|
2025-09-28 11:11:34 -07:00
|
|
|
vals.append(db.table(pt).search(where("uid") == puid)[0])
|
2025-09-27 15:13:17 -07:00
|
|
|
return vals
|