161 lines
5.0 KiB
Python
161 lines
5.0 KiB
Python
from dataclasses import dataclass
|
|
from logging import Logger
|
|
from typing import Any, Dict, Optional
|
|
|
|
from bson import ObjectId
|
|
from libbot.cache.classes import Cache
|
|
from pymongo.results import InsertOneResult
|
|
|
|
from classes.errors.pycord_user import UserNotFoundError
|
|
from modules.database import col_users
|
|
from modules.logging_utils import get_logger
|
|
|
|
logger: Logger = get_logger(__name__)
|
|
|
|
|
|
@dataclass
|
|
class PycordUser:
|
|
"""Dataclass of DB entry of a user"""
|
|
|
|
__slots__ = ("_id", "id")
|
|
__short_name__ = "user"
|
|
__collection__ = col_users
|
|
|
|
_id: ObjectId
|
|
id: int
|
|
|
|
@classmethod
|
|
async def from_id(
|
|
cls, user_id: int, allow_creation: bool = True, cache: Optional[Cache] = None
|
|
) -> "PycordUser":
|
|
"""Find user in database and create new record if user does not exist.
|
|
|
|
Args:
|
|
user_id (int): User's Discord ID
|
|
allow_creation (:obj:`bool`, optional): Create new user record if none found in the database
|
|
cache (:obj:`Cache`, optional): Cache engine to get the cache from
|
|
|
|
Returns:
|
|
PycordUser: User object
|
|
|
|
Raises:
|
|
UserNotFoundError: User was not found and creation was not allowed
|
|
"""
|
|
if cache is not None:
|
|
cached_entry: Dict[str, Any] | None = cache.get_json(f"{cls.__short_name__}_{user_id}")
|
|
|
|
if cached_entry is not None:
|
|
return cls(**cached_entry)
|
|
|
|
db_entry = await cls.__collection__.find_one({"id": user_id})
|
|
|
|
if db_entry is None:
|
|
if not allow_creation:
|
|
raise UserNotFoundError(user_id)
|
|
|
|
db_entry = PycordUser.get_defaults(user_id)
|
|
|
|
insert_result: InsertOneResult = await cls.__collection__.insert_one(db_entry)
|
|
|
|
db_entry["_id"] = insert_result.inserted_id
|
|
|
|
if cache is not None:
|
|
cache.set_json(f"{cls.__short_name__}_{user_id}", db_entry)
|
|
|
|
return cls(**db_entry)
|
|
|
|
def to_dict(self, json_compatible: bool = False) -> Dict[str, Any]:
|
|
"""Convert PycordUser object to a JSON representation.
|
|
|
|
Args:
|
|
json_compatible (bool): Whether the JSON-incompatible objects like ObjectId need to be converted
|
|
|
|
Returns:
|
|
Dict[str, Any]: JSON representation of PycordUser
|
|
"""
|
|
return {
|
|
"_id": self._id if not json_compatible else str(self._id),
|
|
"id": self.id,
|
|
}
|
|
|
|
async def _set(self, key: str, value: Any, cache: Optional[Cache] = None) -> None:
|
|
"""Set attribute data and save it into the database.
|
|
|
|
Args:
|
|
key (str): Attribute to change
|
|
value (Any): Value to set
|
|
cache (:obj:`Cache`, optional): Cache engine to write the update into
|
|
"""
|
|
if not hasattr(self, key):
|
|
raise AttributeError()
|
|
|
|
setattr(self, key, value)
|
|
|
|
await self.__collection__.update_one({"_id": self._id}, {"$set": {key: value}}, upsert=True)
|
|
|
|
self._update_cache(cache)
|
|
|
|
logger.info("Set attribute '%s' of user %s to '%s'", key, self.id, value)
|
|
|
|
async def _remove(self, key: str, cache: Optional[Cache] = None) -> None:
|
|
"""Remove attribute data and save it into the database.
|
|
|
|
Args:
|
|
key (str): Attribute to remove
|
|
cache (:obj:`Cache`, optional): Cache engine to write the update into
|
|
"""
|
|
if not hasattr(self, key):
|
|
raise AttributeError()
|
|
|
|
default_value: Any = PycordUser.get_default_value(key)
|
|
|
|
setattr(self, key, default_value)
|
|
|
|
await self.__collection__.update_one({"_id": self._id}, {"$set": {key: default_value}}, upsert=True)
|
|
|
|
self._update_cache(cache)
|
|
|
|
logger.info("Removed attribute '%s' of user %s", key, self.id)
|
|
|
|
def _get_cache_key(self) -> str:
|
|
return f"{self.__short_name__}_{self.id}"
|
|
|
|
def _update_cache(self, cache: Optional[Cache] = None) -> None:
|
|
if cache is None:
|
|
return
|
|
|
|
user_dict: Dict[str, Any] = self.to_dict()
|
|
|
|
if user_dict is not None:
|
|
cache.set_json(self._get_cache_key(), user_dict)
|
|
else:
|
|
self._delete_cache(cache)
|
|
|
|
def _delete_cache(self, cache: Optional[Cache] = None) -> None:
|
|
if cache is None:
|
|
return
|
|
|
|
cache.delete(self._get_cache_key())
|
|
|
|
@staticmethod
|
|
def get_defaults(user_id: Optional[int] = None) -> Dict[str, Any]:
|
|
return {
|
|
"id": user_id,
|
|
}
|
|
|
|
@staticmethod
|
|
def get_default_value(key: str) -> Any:
|
|
if key not in PycordUser.get_defaults():
|
|
raise KeyError(f"There's no default value for key '{key}' in PycordUser")
|
|
|
|
return PycordUser.get_defaults()[key]
|
|
|
|
async def purge(self, cache: Optional[Cache] = None) -> None:
|
|
"""Completely remove user data from database. Currently only removes the user record from users collection.
|
|
|
|
Args:
|
|
cache (:obj:`Cache`, optional): Cache engine to write the update into
|
|
"""
|
|
await self.__collection__.delete_one({"_id": self._id})
|
|
self._delete_cache(cache)
|