grung-db/src/grung/types.py

127 lines
3.5 KiB
Python
Raw Normal View History

2025-09-27 15:13:17 -07:00
from __future__ import annotations
2025-09-24 19:51:39 -07:00
from collections import namedtuple
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
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
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
@dataclass
2025-09-27 15:13:17 -07:00
class Integer(Field):
2025-09-28 11:11:34 -07:00
value_type: type = int
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):
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-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)
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
@dataclass
2025-09-27 15:13:17 -07:00
class Collection(Field):
"""
A collection of fields that store pointers instead of dicts.
"""
value_type: type = Record
default: List[value_type] = field(default_factory=lambda: [])
2025-09-27 15:13:17 -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