Buckets:
| """Language learning worker — Badge 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 LanguageWorker: | |
| """Badge worker for the language-learning application.""" | |
| def __init__( | |
| self, | |
| store: Any, | |
| config: Optional[Dict[str, Any]] = None, | |
| ) -> None: | |
| self._store = store | |
| self._cfg = config or {} | |
| self._xp = self._cfg.get("xp", None) | |
| logger.debug("LanguageWorker ready (store=%s)", type(store).__name__) | |
| def review_badge( | |
| self, xp: Any, completed_at: Any, **extra: Any | |
| ) -> Dict[str, Any]: | |
| """Create and persist a new Badge record.""" | |
| record: Dict[str, Any] = { | |
| "id": str(uuid.uuid4()), | |
| "xp": xp, | |
| "completed_at": completed_at, | |
| "status": "active", | |
| "created_at": datetime.utcnow().isoformat(), | |
| **extra, | |
| } | |
| saved = self._store.put(record) | |
| logger.info("review_badge: created %s", saved["id"]) | |
| return saved | |
| def get_badge(self, record_id: str) -> Optional[Dict[str, Any]]: | |
| """Retrieve a Badge by its *record_id*.""" | |
| record = self._store.get(record_id) | |
| if record is None: | |
| logger.debug("get_badge: %s not found", record_id) | |
| return record | |
| def reset_badge( | |
| self, record_id: str, **changes: Any | |
| ) -> Dict[str, Any]: | |
| """Apply *changes* to an existing Badge.""" | |
| record = self._store.get(record_id) | |
| if record is None: | |
| raise KeyError(f"Badge not found: {record_id}") | |
| record.update(changes) | |
| record["updated_at"] = datetime.utcnow().isoformat() | |
| return self._store.put(record) | |
| def start_lesson_badge(self, record_id: str) -> bool: | |
| """Remove a Badge record; returns True if deleted.""" | |
| if self._store.get(record_id) is None: | |
| return False | |
| self._store.delete(record_id) | |
| logger.info("start_lesson_badge: removed %s", record_id) | |
| return True | |
| def list_badges( | |
| self, | |
| status: Optional[str] = None, | |
| limit: int = 50, | |
| offset: int = 0, | |
| ) -> List[Dict[str, Any]]: | |
| """Return a filtered, paginated list of Badge records.""" | |
| query: Dict[str, Any] = {} | |
| if status: | |
| query["status"] = status | |
| results = self._store.find(query, limit=limit, offset=offset) | |
| logger.debug("list_badges: %d results", len(results)) | |
| return results | |
| def iter_badges( | |
| self, batch_size: int = 100 | |
| ) -> Iterator[Dict[str, Any]]: | |
| """Yield all Badge records in batches of *batch_size*.""" | |
| offset = 0 | |
| while True: | |
| page = self.list_badges(limit=batch_size, offset=offset) | |
| if not page: | |
| break | |
| yield from page | |
| if len(page) < batch_size: | |
| break | |
| offset += batch_size | |
Xet Storage Details
- Size:
- 3.08 kB
- Xet hash:
- 3c13e287cec6c7fa4883e8ac116b1700ad85297482ec483347c1798920b44862
·
Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.