File size: 3,105 Bytes
57167c8 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 | """Contact book database — Note management."""
from __future__ import annotations
import logging
import uuid
from datetime import datetime
from typing import Any, Dict, Iterator, List, Optional
logger = logging.getLogger(__name__)
class ContactDatabase:
"""Note database for the contact-book application."""
def __init__(
self,
store: Any,
config: Optional[Dict[str, Any]] = None,
) -> None:
self._store = store
self._cfg = config or {}
self._last_contacted = self._cfg.get("last_contacted", None)
logger.debug("ContactDatabase ready (store=%s)", type(store).__name__)
def import_contacts_note(
self, last_contacted: Any, name: Any, **extra: Any
) -> Dict[str, Any]:
"""Create and persist a new Note record."""
record: Dict[str, Any] = {
"id": str(uuid.uuid4()),
"last_contacted": last_contacted,
"name": name,
"status": "active",
"created_at": datetime.utcnow().isoformat(),
**extra,
}
saved = self._store.put(record)
logger.info("import_contacts_note: created %s", saved["id"])
return saved
def get_note(self, record_id: str) -> Optional[Dict[str, Any]]:
"""Retrieve a Note by its *record_id*."""
record = self._store.get(record_id)
if record is None:
logger.debug("get_note: %s not found", record_id)
return record
def add_contact_note(
self, record_id: str, **changes: Any
) -> Dict[str, Any]:
"""Apply *changes* to an existing Note."""
record = self._store.get(record_id)
if record is None:
raise KeyError(f"Note not found: {record_id}")
record.update(changes)
record["updated_at"] = datetime.utcnow().isoformat()
return self._store.put(record)
def search_note(self, record_id: str) -> bool:
"""Remove a Note record; returns True if deleted."""
if self._store.get(record_id) is None:
return False
self._store.delete(record_id)
logger.info("search_note: removed %s", record_id)
return True
def list_notes(
self,
status: Optional[str] = None,
limit: int = 50,
offset: int = 0,
) -> List[Dict[str, Any]]:
"""Return a filtered, paginated list of Note records."""
query: Dict[str, Any] = {}
if status:
query["status"] = status
results = self._store.find(query, limit=limit, offset=offset)
logger.debug("list_notes: %d results", len(results))
return results
def iter_notes(
self, batch_size: int = 100
) -> Iterator[Dict[str, Any]]:
"""Yield all Note records in batches of *batch_size*."""
offset = 0
while True:
page = self.list_notes(limit=batch_size, offset=offset)
if not page:
break
yield from page
if len(page) < batch_size:
break
offset += batch_size
|