dublib 0.30.2__tar.gz → 0.30.4__tar.gz

{dublib-0.30.2 → dublib-0.30.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dublib
-Version: 0.30.2
+Version: 0.30.4
 Summary: Коллекция полезных модулей от DUB1401.
 Author: DUB1401
 Author-email: DUB1401 <vlad.milosta@outlook.com>

{dublib-0.30.2 → dublib-0.30.4}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["uv-build>=0.12.10,<0.13.0"]
+requires = ["uv-build>=0.12.14,<0.13.0"]
 build-backend = "uv_build"
 
 [project]
 name = "dublib"
-version = "0.30.2"
+version = "0.30.4"
 description = "Коллекция полезных модулей от DUB1401."
 readme = "README.md"
 requires-python = ">=3.12"

{dublib-0.30.2 → dublib-0.30.4}/pyproject.toml.orig

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["uv-build>=0.12.10,<0.13.0"]
+requires = ["uv-build>=0.12.14,<0.13.0"]
 build-backend = "uv_build"
 
 [project]
 name = "dublib"
-version = "0.30.2"
+version = "0.30.4"
 description = "Коллекция полезных модулей от DUB1401."
 authors = [
 	{name = "DUB1401", email = "vlad.milosta@outlook.com"}

{dublib-0.30.2 → dublib-0.30.4}/src/dublib/functions/data/__init__.py

@@ -1,10 +1,19 @@
 import copy
-from typing import Any, Sequence, overload
+from typing import Any, Sequence
 
 import orjson
 
 from . import dictionary as dictionary
 from . import string as string
+from .sequences import to_sequence
+
+__all__ = [
+	"deep_copy",
+	"stringify_float",
+	"string_to_bool",
+	"to_sequence",
+	"zerotify"
+]
 
 def deep_copy(data: Any) -> Any:
 	"""
@@ -56,30 +65,6 @@ def string_to_bool(value: str, literals: Sequence[str] = ("false", "0")) -> bool
 
 	return bool(value)
 
-@overload
-def to_sequence(value: Any, target_type: type[list]) -> list: ...
-@overload
-def to_sequence(value: Any, target_type: type[set]) -> set: ...
-@overload
-def to_sequence(value: Any, target_type: type[tuple] = ...) -> tuple: ...
-
-def to_sequence(value: Any, target_type: type[list | set | tuple] = tuple) -> list | set | tuple:
-	"""
-	Преобразует значение в итерируемый контейнерн целевого типа.
-
-	:param value: Обрабатываемое значение или итерируемый контейнер значений.
-	:type value: Any
-	:param target_type: Целевой тип итерируемого контейнера.
-	:type target_type: type[list | set | tuple]
-	:return: Приведённое к итерируемому контейнеру значение (единичные элементы упаковываются в контейнер, контейнеры преобразуются в целевой тип).
-	:rtype: list | set | tuple
-	"""
-
-	if type(value) is target_type: return value
-	if type(value) in (list, set, tuple): return target_type(value)
-	
-	return target_type((value,))
-
 def zerotify(value: Any) -> Any:
 	"""
 	Преобразует значения, логически интерпретируемые в `False`, в тип `None`.

{dublib-0.30.2 → dublib-0.30.4}/src/dublib/functions/data/dictionary.py

@@ -1,7 +1,72 @@
+from collections.abc import Sequence
 from typing import Any
 
 import more_itertools
 
+from .sequences import to_sequence
+
+def deep_merge(
+	base: dict,
+	content: dict,
+	sequences_type: type[list | tuple | set] = list,
+	uniqueness: bool = False
+	) -> dict:
+	"""
+	Выполняет глубокое слияние двух словарей и вложенных последовательностей `list`, `tuple` и `set`.
+
+	:param base: Базовый словарь. Изменяется во время выполнения функции.
+	:type base: dict
+	:param content: Словарь, содержимое которого вливается в базовый.
+	:type content: dict
+	:param sequences_type: Тип, к которому будут приводиться последовательности при их слиянии.
+	:type sequences_type: type[list | tuple | set]
+	:param uniqueness: Указывает, нужно ли исключать в последовательностях повторяемые элементы.
+	:type uniqueness: bool
+	:return: Базовый словарь.
+	:rtype: dict
+	"""
+
+	for key, content_value in content.items():
+
+		#---> Простое добавление.
+		#==========================================================================================#
+		if key not in base:
+			base[key] = content_value
+			continue
+
+		base_value = base[key]
+
+		#---> Слияние словарей.
+		#==========================================================================================#
+		if isinstance(base_value, dict) and isinstance(content_value, dict):
+			base_value = deep_merge(base_value, content_value, sequences_type, uniqueness) 
+			continue
+
+		#---> Слияние последовательностей.
+		#==========================================================================================#
+		if all(isinstance(value, Sequence) and not isinstance(value, (str, bytes)) for value in (base_value, content_value)):
+			base_list: list = to_sequence(base_value, target_type = list)
+			content_list: list = to_sequence(content_value, target_type = list)
+			result_list: list = []
+
+			if uniqueness:
+				for item in content_list:
+					if item not in base_list:
+						base_list.append(item)
+				result_list = base_list
+
+			else:
+				result_list = base_list + content_list
+
+			base[key] = to_sequence(result_list, target_type = sequences_type)
+			continue
+
+		#---> Перезапись.
+		#==========================================================================================#
+		base[key] = content_value
+
+	return base
+
 def insert_item(base_dictionary: dict, target_key: Any, item: tuple[Any, Any]) -> dict:
 	"""
 	Вставляет пару ключ-значение после определённого ключа.

dublib-0.30.4/src/dublib/functions/data/sequences.py

@@ -0,0 +1,28 @@
+from typing import Any, overload
+
+from . import dictionary as dictionary
+from . import string as string
+
+@overload
+def to_sequence(value: Any, target_type: type[list]) -> list: ...
+@overload
+def to_sequence(value: Any, target_type: type[set]) -> set: ...
+@overload
+def to_sequence(value: Any, target_type: type[tuple] = ...) -> tuple: ...
+
+def to_sequence(value: Any, target_type: type[list | set | tuple] = tuple) -> list | set | tuple:
+	"""
+	Преобразует значение в итерируемый контейнерн целевого типа.
+
+	:param value: Обрабатываемое значение или итерируемый контейнер значений.
+	:type value: Any
+	:param target_type: Целевой тип итерируемого контейнера.
+	:type target_type: type[list | set | tuple]
+	:return: Приведённое к итерируемому контейнеру значение (единичные элементы упаковываются в контейнер, контейнеры преобразуются в целевой тип).
+	:rtype: list | set | tuple
+	"""
+
+	if type(value) is target_type: return value
+	if type(value) in (list, set, tuple): return target_type(value)
+	
+	return target_type((value,))

{dublib-0.30.2 → dublib-0.30.4}/src/dublib/web_requestor/config/authorization.py

@@ -37,39 +37,38 @@ class _BaseAuthorizationMethod(ABC):
 		return self._Value
 
 	@property
-	def scheme(self) -> str:
+	def scheme(self) -> AuthorizationSchemes:
 		"""Схема авторизации."""
 
-		return self._Scheme.value
+		return self._Scheme
 
 	#==========================================================================================#
 	# >>>>> НАСЛЕДУЕМЫЕ МЕТОДЫ <<<<< #
 	#==========================================================================================#
 
-	def _ClearScheme(self, token: str) -> str:
+	def _remove_scheme(self, data: str) -> str:
 		"""
-		Удаляет из токена схему.
+		Удаляет из данных авторизации схему.
 
-		:param token: Токен.
-		:type token: str
-		:return: Обработанный токен.
+		:param data: Данные авторизации.
+		:type data: str
+		:return: Очищенные данные.
 		:rtype: str
 		"""
 
-		for Schema in AuthorizationSchemes:
-			SchemaLength: int = len(Schema.value)
+		scheme_length: int = len(self._Scheme.value)
 
-			if token.lower().startswith(Schema.value.lower()):
-				return token[:SchemaLength * -1].strip()
+		if data.lower().startswith(self._Scheme.value.lower()):
+			return data[:scheme_length * -1].strip()
 
-		return token
+		return data
 
 	#==========================================================================================#
 	# >>>>> ПЕРЕОПРЕДЕЛЯЕМЫЕ МЕТОДЫ <<<<< #
 	#==========================================================================================#
 
 	@abstractmethod
-	def _ReturnScheme(self) -> AuthorizationSchemes:
+	def _export_scheme(self) -> AuthorizationSchemes:
 		"""
 		Возвращает тип схемы авторизации.
 
@@ -86,7 +85,7 @@ class _BaseAuthorizationMethod(ABC):
 	def __init__(self):
 		"""Базовый метод авторизации."""
 
-		self._Scheme: AuthorizationSchemes = self._ReturnScheme()
+		self._Scheme: AuthorizationSchemes = self._export_scheme()
 		self._Value: str | None = None
 
 	def clear(self):
@@ -101,7 +100,7 @@ class Basic(_BaseAuthorizationMethod):
 	# >>>>> ПЕРЕОПРЕДЕЛЯЕМЫЕ МЕТОДЫ <<<<< #
 	#==========================================================================================#
 
-	def _ReturnScheme(self) -> AuthorizationSchemes:
+	def _export_scheme(self) -> AuthorizationSchemes:
 		"""
 		Возвращает тип схемы авторизации.
 
@@ -138,7 +137,7 @@ class Bearer(_BaseAuthorizationMethod):
 	# >>>>> ПЕРЕОПРЕДЕЛЯЕМЫЕ МЕТОДЫ <<<<< #
 	#==========================================================================================#
 
-	def _ReturnScheme(self) -> AuthorizationSchemes:
+	def _export_scheme(self) -> AuthorizationSchemes:
 		"""
 		Возвращает тип схемы авторизации.
 
@@ -152,6 +151,22 @@ class Bearer(_BaseAuthorizationMethod):
 	# >>>>> ПУБЛИЧНЫЕ МЕТОДЫ <<<<< #
 	#==========================================================================================#
 
+	def get_jwt_expiration_date(self, token: str) -> datetime:
+		"""
+		Определяет дату и время истечения токена.
+
+		:param token: **JSON Web Token** со схемой или без.
+		:type token: str
+		:return: Дата и время истечения токена.
+		:rtype: datetime
+		"""
+
+		token = self._remove_scheme(token)
+		token_data: dict = jwt.decode(token, options = {"verify_signature": False})
+		expiration_timestamp: int = token_data["exp"]
+
+		return datetime.fromtimestamp(expiration_timestamp)
+
 	def is_jwt_expired(self, token: str, exception: bool = False) -> bool:
 		"""
 		Проверяет, устарел ли **JSON Web Token**.
@@ -166,15 +181,13 @@ class Bearer(_BaseAuthorizationMethod):
 		:raises TokenExpiredError: Токен устарел.
 		"""
 
-		token = self._ClearScheme(token)
-		TokenData = jwt.decode(token, options = {"verify_signature": False})
-		ExpiratonTimestamp: int = TokenData["exp"]
-		IsExpired: bool = ExpiratonTimestamp < time()
+		expiration_date = self.get_jwt_expiration_date(token)
+		is_expired: bool = expiration_date.timestamp() < time()
 
-		if exception and IsExpired:
-			raise Exceptions.TokenExpiredError(datetime.fromtimestamp(ExpiratonTimestamp))
+		if exception and is_expired:
+			raise Exceptions.TokenExpiredError(expiration_date)
 
-		return IsExpired
+		return is_expired
 
 	def set_jwt(self, token: str, validate: bool = True):
 		"""
@@ -188,7 +201,7 @@ class Bearer(_BaseAuthorizationMethod):
 		"""
 
 		if validate: self.is_jwt_expired(token, exception = True)
-		self._Value = self._ClearScheme(token)
+		self._Value = self._remove_scheme(token)
 
 	def set_token(self, token: str):
 		"""
@@ -198,7 +211,7 @@ class Bearer(_BaseAuthorizationMethod):
 		:type token: str
 		"""
 
-		self._Value = self._ClearScheme(token)
+		self._Value = self._remove_scheme(token)
 
 #==========================================================================================#
 # >>>>> ОСНОВНОЙ КЛАСС <<<<< #
@@ -218,7 +231,13 @@ class Authorizator:
 		if not self.__IsEnabled or not self.__AuthorizationMethod:
 			return {}
 
-		return {constants.AUTHORIZATION_HEADER: f"{self.__AuthorizationMethod.scheme} {self.__AuthorizationMethod.value}"}
+		return {constants.AUTHORIZATION_HEADER: f"{self.__AuthorizationMethod.scheme.value} {self.__AuthorizationMethod.value}"}
+
+	@property
+	def method(self) -> _BaseAuthorizationMethod | None:
+		"""Используемый метод авторизации."""
+
+		return self.__AuthorizationMethod
 
 	#==========================================================================================#
 	# >>>>> ПУБЛИЧНЫЕ МЕТОДЫ <<<<< #