dublib 0.6.0__tar.gz → 0.6.2__tar.gz

{dublib-0.6.0/src/dublib.egg-info → dublib-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dublib
-Version: 0.6.0
+Version: 0.6.2
 Summary: Коллекция модулей от DUB1401.
 Author-email: DUB1401 <vlad.milosta@outlook.com>
 License: This is free and unencumbered software released into the public domain.

{dublib-0.6.0 → dublib-0.6.2}/pyproject.toml

@@ -3,7 +3,7 @@ requires = ["setuptools", "cython"]
 
 [project]
 name = "dublib"
-version = "0.6.0"
+version = "0.6.2"
 description = "Коллекция модулей от DUB1401."
 authors = [
 	{name = "DUB1401", email = "vlad.milosta@outlook.com"}
@@ -39,4 +39,4 @@ telebot = [
 Documentation = "https://github.com/DUB1401/dublib/tree/main/docs"
 "Source Code" = "https://github.com/DUB1401/dublib"
 "Bug Tracker" = "https://github.com/DUB1401/dublib/issues"
-Changelog = "https://github.com/DUB1401/dublib/releases"
+Changelog = "https://github.com/DUB1401/dublib/releases"

{dublib-0.6.0 → dublib-0.6.2}/src/dublib/TelebotUtils.py

@@ -1,7 +1,7 @@
 from .Methods import ReadJSON, WriteJSON
 from .Exceptions.TelebotUtils import *
 
-from telebot.types import Message, User
+from telebot.types import User
 
 import os
 
@@ -60,10 +60,10 @@ class UserData:
 	# >>>>> ПУБЛИЧНЫЕ МЕТОДЫ <<<<< #
 	#==========================================================================================#
 
-	def __init__(self, dir: str, user_id: int, data: dict | None = None):
+	def __init__(self, storage_dir: str, user_id: int, data: dict | None = None):
 		"""
 		Объектное представление данных пользователя.
-			dir – путь к директории хранения данных;
+			storage_dir – путь к директории хранения данных;
 			user_id – ID пользователя;
 			data – словарь с описанием данных пользователя для инициализации (если не передан, данные будут загружены из файла).
 		"""
@@ -73,7 +73,7 @@ class UserData:
 		# ID пользователя.
 		self.__ID = user_id
 		# Директория хранилища.
-		self.__StorageDirectory = dir.replace("\\", "/").rstrip("/")
+		self.__StorageDirectory = storage_dir.replace("\\", "/").rstrip("/")
 		# Словарное представление данных пользователя.
 		self.__Data = {
 			"username": None,
@@ -129,6 +129,21 @@ class UserData:
 		# Сохранение данных.
 		self.__SaveData()
 
+	def create_property(self, key: str, value: any, force: bool = True):
+		"""
+		Создаёт свойство пользователя и задаёт ему значение, если такового ещё не существует.
+			key – ключ свойства;
+			value – значение;
+			force – указывает, необходимо ли перезаписывать значение уже существующего ключа.
+		"""
+		
+		# Если свойства не существует.
+		if key not in self.__Data["data"].keys() or force:
+			# Создание свойства.
+			self.__Data["data"][key] = value
+			# Сохранение данных.
+			self.__SaveData()
+
 	def get_property(self, key: str) -> any:
 		"""
 		Возвращает значение свойства пользователя.
@@ -182,19 +197,32 @@ class UserData:
 		# Сохранение данных.
 		self.__SaveData()
 
+	def remove_property(self, key: str):
+		"""
+		Удаляет свойство пользователя.
+			key – ключ свойства.
+		"""
+
+		# Если свойство существует.
+		if key in self.__Data["data"].keys():
+			# Удаление свойства.
+			del self.__Data["data"][key]
+			# Сохранение данных.
+			self.__SaveData()
+
 	def set_property(self, key: str, value: any):
 		"""
-		Обновляет значение свойства пользователя.
+		Обновляет значение существующего свойства пользователя.
 			key – ключ свойства;
 			value – значение.
 		"""
 		
-		# Если ключа данных не существует, создать его.
-		if "data" not in self.__Data.keys(): self.__Data["data"] = dict()
-		# Помещение данных.
-		self.__Data["data"][key] = value
-		# Сохранение данных.
-		self.__SaveData()
+		# Если свойство существует.
+		if key in self.__Data["data"].keys():
+			# Обновление данных.
+			self.__Data["data"][key] = value
+			# Сохранение данных.
+			self.__SaveData()
 
 	def update(self, user: User):
 		"""
@@ -298,26 +326,26 @@ class UsersManager:
 		# Загрузка данных пользователей.
 		self.__LoadUsers()
 
-	def auth(self, message: Message) -> UserData:
+	def auth(self, user: User) -> UserData:
 		"""
 		Выполняет идентификацию и обновление данных существующего пользователя или создаёт локальный файл для нового.
-			message – структура описания сообщения.
+			user – структура описания пользователя Telegram.
 		"""
 		
 		# Текущий пользователь.
-		User = None
+		CurrentUser = None
 
 		# Если пользователь ещё не существует.
-		if message.from_user.id not in self.__Users.keys():
+		if user.id not in self.__Users.keys():
 			# Создание нового пользователя.
-			self.__Users[message.from_user.id] = UserData(self.__StorageDirectory, message.from_user.id, message.from_user)
+			self.__Users[user.id] = UserData(self.__StorageDirectory, user.id, user)
 
 		# Обновление данных пользователя.
-		self.__Users[message.from_user.id].update(message.from_user)
+		self.__Users[user.id].update(user)
 		# Установка текущего пользователя.
-		User = self.__Users[message.from_user.id]
+		CurrentUser = self.__Users[user.id]
 
-		return User
+		return CurrentUser
 
 	def get_user(self, user_id: int | str) -> UserData:
 		"""

{dublib-0.6.0 → dublib-0.6.2/src/dublib.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dublib
-Version: 0.6.0
+Version: 0.6.2
 Summary: Коллекция модулей от DUB1401.
 Author-email: DUB1401 <vlad.milosta@outlook.com>
 License: This is free and unencumbered software released into the public domain.