dublib 0.30.0__tar.gz → 0.30.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dublib
-Version: 0.30.0
+Version: 0.30.2
 Summary: Коллекция полезных модулей от DUB1401.
 Author: DUB1401
 Author-email: DUB1401 <vlad.milosta@outlook.com>
@@ -52,10 +52,10 @@ Requires-Dist: validators
 Requires-Dist: watchfiles
 Requires-Dist: gnureadline>=8.3.3 ; sys_platform == 'linux'
 Requires-Dist: pyreadline3 ; sys_platform == 'win32'
-Requires-Dist: mypy ; extra == 'dev'
 Requires-Dist: myst-parser ; extra == 'dev'
 Requires-Dist: pytest ; extra == 'dev'
 Requires-Dist: ruff ; extra == 'dev'
+Requires-Dist: ty ; extra == 'dev'
 Requires-Dist: sphinx ; extra == 'dev'
 Requires-Dist: sphinx-rtd-theme ; extra == 'dev'
 Requires-Dist: apscheduler ; extra == 'telebot'

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

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["uv-build>=0.12.2,<0.13.0"]
+requires = ["uv-build>=0.12.10,<0.13.0"]
 build-backend = "uv_build"
 
 [project]
 name = "dublib"
-version = "0.30.0"
+version = "0.30.2"
 description = "Коллекция полезных модулей от DUB1401."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -50,10 +50,10 @@ telebot = [
     "pyTelegramBotAPI",
 ]
 dev = [
-    "mypy",
     "myst_parser",
     "pytest",
     "ruff",
+    "ty",
     "Sphinx",
     "sphinx-rtd-theme",
 ]
@@ -64,13 +64,6 @@ Documentation = "https://github.com/DUB1401/dublib/tree/main/docs"
 "Bug Tracker" = "https://github.com/DUB1401/dublib/issues"
 Changelog = "https://github.com/DUB1401/dublib/releases"
 
-[tool.mypy]
-ignore_missing_imports = true
-check_untyped_defs = true
-non_interactive = true
-follow_imports = "silent"
-files = ["src"]
-
 [tool.ruff]
 include = [
     "src/*",

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

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["uv-build>=0.12.2,<0.13.0"]
+requires = ["uv-build>=0.12.10,<0.13.0"]
 build-backend = "uv_build"
 
 [project]
 name = "dublib"
-version = "0.30.0"
+version = "0.30.2"
 description = "Коллекция полезных модулей от DUB1401."
 authors = [
 	{name = "DUB1401", email = "vlad.milosta@outlook.com"}
@@ -47,10 +47,10 @@ telebot = [
 	"pyTelegramBotAPI"
 ]
 dev = [
-	"mypy",
 	"myst_parser",
 	"pytest",
 	"ruff",
+	"ty",
 	"Sphinx",
 	"sphinx-rtd-theme"
 ]
@@ -61,13 +61,6 @@ Documentation = "https://github.com/DUB1401/dublib/tree/main/docs"
 "Bug Tracker" = "https://github.com/DUB1401/dublib/issues"
 Changelog = "https://github.com/DUB1401/dublib/releases"
 
-[tool.mypy]
-ignore_missing_imports = true
-check_untyped_defs = true
-non_interactive = true
-follow_imports = "silent"
-files = ["src"]
-
 [tool.ruff]
 include = ["src/*", "tests/*"]
 

{dublib-0.30.0 → dublib-0.30.2}/src/dublib/cli/terminalyzer/parser/__init__.py

@@ -11,6 +11,7 @@ from .entitites import (
 
 if TYPE_CHECKING:
 	from ..commands.model import CommandModel
+	from ..commands.positions import Position
 
 __all__ = ["CommandParser"]
 
@@ -99,9 +100,45 @@ class CommandParser:
 
 		self.__base_parameters.append(entity)
 
-	def __catch_parameters_for_base_position(self, parameter: str, index: int):
+	def __catch_argument_for_positions(self, parameter: str, index: int):
 		"""
-		Пытается интерпретировать каждый параметр для базовой позиции.
+		Пытается назначить аргумент на разблокированные позиции.
+
+		:param parameter: Значение параметра.
+		:type parameter: str
+		:param index: Индекс параметра.
+		:type index: int
+		"""
+
+		for position in self.__model.positions:
+
+			if self.__is_position_locked(position): continue
+				
+			if position.argument and self.__positions_parameters[position.name] is None:
+				value = position.argument.type.value.parse(parameter)
+				self.__lock_position(position.name, index, ArgumentEntity(position.argument, value))
+				return
+
+	def __catch_argument_for_base_position(self, parameter: str, index: int):
+		"""
+		Пытается назначить аргумент на базовую позицию.
+
+		:param parameter: Значение параметра.
+		:type parameter: str
+		:param index: Индекс параметра.
+		:type index: int
+		"""
+
+		base = self.__model.base
+			
+		for argument in base.arguments:
+			value = argument.type.value.parse(parameter)
+			self.__add_base_position_parameter(index, ArgumentEntity(argument, value))
+			return
+
+	def __catch_named_parameters_for_base_position(self, parameter: str, index: int):
+		"""
+		Пытается назначить именованные параметры на базовую позицию.
 
 		:param parameter: Значение параметра.
 		:type parameter: str
@@ -113,7 +150,7 @@ class CommandParser:
 
 		for flag in base.flags:
 			if parameter == flag.name or parameter in flag.aliases:
-				self.__add_base_position_parameter(index, FlagEntity(flag, True))
+				self.__add_base_position_parameter(index, FlagEntity(flag))
 				return
 		
 		for key in base.keys:
@@ -122,15 +159,10 @@ class CommandParser:
 				value = key.type.value.parse(self.__parameters[index + 1])
 				self.__add_base_position_parameter(index, KeyEntity(key, value))
 				return
-			
-		for argument in base.arguments:
-			value = argument.type.value.parse(self.__parameters[index])
-			self.__add_base_position_parameter(index, ArgumentEntity(argument, value))
-			return
 
-	def __catch_parameters_for_positions(self, parameter: str, index: int):
+	def __catch_named_parameters_for_positions(self, parameter: str, index: int):
 		"""
-		Пытается интерпретировать каждый параметр для позиции.
+		Пытается назначить именованные параметры на разблокированные позиции.
 
 		:param parameter: Значение параметра.
 		:type parameter: str
@@ -139,10 +171,12 @@ class CommandParser:
 		"""
 
 		for position in self.__model.positions:
+
+			if self.__is_position_locked(position): continue
 			
 			for flag in position.flags:
 				if parameter == flag.name or parameter in flag.aliases:
-					self.__lock_position(position.name, index, FlagEntity(flag, True))
+					self.__lock_position(position.name, index, FlagEntity(flag))
 					return
 			
 			for key in position.keys:
@@ -151,11 +185,28 @@ class CommandParser:
 					value = key.type.value.parse(self.__parameters[index + 1])
 					self.__lock_position(position.name, index, KeyEntity(key, value))
 					return
-				
-			if position.argument and self.__positions_parameters[position.name] is None:
-				value = position.argument.type.value.parse(self.__parameters[index])
-				self.__lock_position(position.name, index, ArgumentEntity(position.argument, value))
-				return
+
+	def __get_unlocked_parameters_range(self) -> list[int]:
+		"""
+		Возвращает список индексов незаблокированных параметров.
+
+		:return: Список индексов незаблокированных параметров.
+		:rtype: list[int]
+		"""
+
+		return [index for index in range(len(self.__parameters_locks)) if not self.__parameters_locks[index]]
+
+	def __is_position_locked(self, position: "Position") -> bool:
+		"""
+		Проверяет, заблокирована ли позиция.
+
+		:param position: Позиция.
+		:type position: Position
+		:return: Возвращает `True`, если позиция заблокирована.
+		:rtype: bool
+		"""
+
+		return bool(self.__positions_parameters[position.name])
 
 	def __lock_position(self, position_name: str, index: int, entity: ArgumentEntity | FlagEntity | KeyEntity):
 		"""
@@ -217,14 +268,17 @@ class CommandParser:
 		:rtype: CommandEntity
 		"""
 
-		parameters_range = range(self.__parameters_count)
+		for index in self.__get_unlocked_parameters_range():
+			self.__catch_named_parameters_for_positions(self.__parameters[index], index)
+
+		for index in self.__get_unlocked_parameters_range():
+			self.__catch_named_parameters_for_base_position(self.__parameters[index], index)
 
-		for index in parameters_range:
-			self.__catch_parameters_for_positions(self.__parameters[index], index)
+		for index in self.__get_unlocked_parameters_range():
+			self.__catch_argument_for_positions(self.__parameters[index], index)
 
-		for index in parameters_range:
-			if self.__parameters_locks[index]: continue
-			self.__catch_parameters_for_base_position(self.__parameters[index], index)
+		for index in self.__get_unlocked_parameters_range():
+			self.__catch_argument_for_base_position(self.__parameters[index], index)
 
 		self.__check_important_positions_parameters()
 		self.__check_prarameters_bounds()

{dublib-0.30.0 → dublib-0.30.2}/src/dublib/cli/terminalyzer/parser/entitites.py

@@ -48,23 +48,20 @@ class FlagEntity:
 		return self.__parameter
 
 	@property
-	def value(self) -> bool:
-		"""Состояние активации флага."""
+	def value(self) -> str:
+		"""Основное имя флага."""
 
-		return self.__value
+		return self.__parameter.name
 
-	def __init__(self, parameter: "Flag", value: bool):
+	def __init__(self, parameter: "Flag"):
 		"""
 		Сущность аргумента.
 
 		:param parameter: Параметр.
 		:type parameter: Flag
-		:param value: Значение ключа.
-		:type value: bool
 		"""
 
 		self.__parameter = parameter
-		self.__value = value
 
 class KeyEntity:
 	"""Сущность ключа."""
@@ -340,7 +337,7 @@ class CommandEntity:
 
 		:param position_name: Имя позиции.
 		:type position_name: str
-		:param not_found_error: Указывает, выбрасывать ли исключение, если ключ не активирован.
+		:param not_found_error: Указывает, выбрасывать ли исключение, если позиция не найдена.
 		:type not_found_error: bool
 		:return: Сущность параметра позиции или `None` при пустой позиции.
 		:rtype: ArgumentEntity | FlagEntity | KeyEntity | None
@@ -356,6 +353,32 @@ class CommandEntity:
 
 		return self.__positions[position_name].content
 
+	@overload
+	def get_position_named_parameter(self, position_name: str, not_found_error: Literal[True] = True) -> FlagEntity | KeyEntity: ...
+	@overload
+	def get_position_named_parameter(self, position_name: str, not_found_error: Literal[False] = False) -> FlagEntity | KeyEntity | None: ...
+
+	def get_position_named_parameter(self, position_name: str, not_found_error: bool = False) -> FlagEntity | KeyEntity | None:
+		"""
+		Возвращает сущность именованного параметра позиции.
+
+		:param position_name: Имя позиции.
+		:type position_name: str
+		:param not_found_error: Указывает, выбрасывать ли исключение, если позиция не найдена.
+		:type not_found_error: bool
+		:return: Сущность именованного параметра позиции или `None` при пустой позиции.
+		:rtype: FlagEntity | KeyEntity | None
+		:raises PositionNotFoundError: Позиция не найдена.
+		:raises TypeError: На позиции находится сущность аргумента.
+		"""
+
+		parameter_entity = self.get_position_parameter(position_name, not_found_error)
+
+		if isinstance(parameter_entity, ArgumentEntity):
+			raise TypeError("Unnamed parameter on position.")
+
+		return parameter_entity
+
 	@overload
 	def get_position_value[T: SUPPORTED_TYPES](self, position_name: str, expected_type: type[T], important: Literal[True]) -> T: ...
 	@overload
@@ -375,7 +398,7 @@ class CommandEntity:
 		:type expected_type: type[SUPPORTED_TYPES] | None
 		:param important: Указывает, должна ли позиция обязательно иметь значение.
 		:type important: bool
-		:return: Параметр позиции или `None` при пустой позиции. Для флага возвращает статус активации.
+		:return: Параметр позиции или `None` при пустой позиции. Для флага возвращает основное имя.
 		:rtype: SUPPORTED_TYPES | None
 		:raises ImportantPositionEmptyError: Для обязательной позиции не задан параметр.
 		:raises PositionNotFoundError: Позиция не найдена.

{dublib-0.30.0 → dublib-0.30.2}/src/dublib/polyglot/html.py

@@ -38,14 +38,14 @@ class _Validator(HTMLParser):
 	def error(self, message):
 		self.errors.append(f"Parsing error: {message}.")
 
-def _ValidateHTML(text: str) -> tuple[str]:
+def _ValidateHTML(text: str) -> tuple[str, ...]:
 	"""
 	Проводит валидацию структуры HTML.
 
 	:param text: Обрабатываемый текст с тегами HTML.
 	:type text: str
 	:return: Набор ошибок валидации. Пустая последовательность при отсутствии ошибок.
-	:rtype: tuple[str]
+	:rtype: tuple[str, ...]
 	"""
 
 	Parser = _Validator()
@@ -171,7 +171,7 @@ class HTML:
 
 		return self.__Text
 	
-	def validate(self, raise_exception: bool = False) -> tuple[str]:
+	def validate(self, raise_exception: bool = False) -> tuple[str, ...]:
 		"""
 		Проверяет валидность структуры HTML.
 

{dublib-0.30.0 → dublib-0.30.2}/src/dublib/telebot_utils/cache.py

@@ -202,105 +202,100 @@ class TeleCache:
 	# >>>>> ПРИВАТНЫЕ МЕТОДЫ ВЫГРУЗКИ ФАЙЛОВ <<<<< #
 	#==========================================================================================#
 
-	def __Upload_Animation(self, file_path: Path) -> str | None:
+	def __Upload_Animation(self, file_path: Path) -> tuple[types.Message, str | None]:
 		"""
 		Выгружает анимацию.
 
 		:param file_path: Путь к файлу.
 		:type file_path: Path
 		:return: ID файла или `None` в случае неудачи.
-		:rtype: str | None
+		:rtype: tuple[types.Message, str | None]
 		:raises TypeError: Неверный тип файла для данного типа вложений.
 		"""
 
 		ChatID = cast(int, self.__ChatID)
-		Bot = cast(TeleBot, self.__Bot)
 		FileID: str | None = None
 
-		Message = Bot.send_animation(chat_id = ChatID, animation = types.InputFile(file_path))
+		Message = self.__Bot.send_animation(chat_id = ChatID, animation = types.InputFile(file_path))
 		if Message.animation: FileID = Message.animation.file_id
 		# Некоторые анимации отображаются верно, но распознаются как документы.
 		elif Message.document: FileID = Message.document.file_id
 		# Выброс исключения при попытке использования полноценного видео в качестве анимации.
 		elif Message.video: raise TypeError("Use InputMediaVideo for this file.")
 
-		return FileID
+		return Message, FileID
 
-	def __Upload_Audio(self, file_path: Path) -> str | None:
+	def __Upload_Audio(self, file_path: Path) -> tuple[types.Message, str | None]:
 		"""
 		Выгружает аудио.
 
 		:param file_path: Путь к файлу.
 		:type file_path: Path
 		:return: ID файла или `None` в случае неудачи.
-		:rtype: str | None
+		:rtype: tuple[types.Message, str | None]
 		"""
 
 		ChatID = cast(int, self.__ChatID)
-		Bot = cast(TeleBot, self.__Bot)
 		FileID: str | None = None
 
-		Message = Bot.send_audio(chat_id = ChatID, audio = types.InputFile(file_path))
+		Message = self.__Bot.send_audio(chat_id = ChatID, audio = types.InputFile(file_path))
 		if Message.audio: FileID = Message.audio.file_id
 
-		return FileID
+		return Message, FileID
 
-	def __Upload_Document(self, file_path: Path) -> str | None:
+	def __Upload_Document(self, file_path: Path) -> tuple[types.Message, str | None]:
 		"""
 		Выгружает документ.
 
 		:param file_path: Путь к файлу.
 		:type file_path: Path
 		:return: ID файла или `None` в случае неудачи.
-		:rtype: str | None
+		:rtype: tuple[types.Message, str | None]
 		"""
 
 		ChatID = cast(int, self.__ChatID)
-		Bot = cast(TeleBot, self.__Bot)
 		FileID: str | None = None
 
-		Message = Bot.send_document(chat_id = ChatID, document = types.InputFile(file_path))
+		Message = self.__Bot.send_document(chat_id = ChatID, document = types.InputFile(file_path))
 		if Message.document: FileID = Message.document.file_id
 
-		return FileID
+		return Message, FileID
 
-	def __Upload_Photo(self, file_path: Path) -> str | None:
+	def __Upload_Photo(self, file_path: Path) -> tuple[types.Message, str | None]:
 		"""
 		Выгружает изображение.
 
 		:param file_path: Путь к файлу.
 		:type file_path: Path
 		:return: ID файла или `None` в случае неудачи.
-		:rtype: str | None
+		:rtype: tuple[types.Message, str | None]
 		"""
 
 		ChatID = cast(int, self.__ChatID)
-		Bot = cast(TeleBot, self.__Bot)
 		FileID: str | None = None
 
-		Message = Bot.send_photo(chat_id = ChatID, photo = types.InputFile(file_path))
+		Message = self.__Bot.send_photo(chat_id = ChatID, photo = types.InputFile(file_path))
 		if Message.photo: FileID = Message.photo[-1].file_id
 
-		return FileID
+		return Message, FileID
 
-	def __Upload_Video(self, file_path: Path) -> str | None:
+	def __Upload_Video(self, file_path: Path) -> tuple[types.Message, str | None]:
 		"""
 		Выгружает видео.
 
 		:param file_path: Путь к файлу.
 		:type file_path: Path
 		:return: ID файла или `None` в случае неудачи.
-		:rtype: str | None
+		:rtype: tuple[types.Message, str | None]
 		"""
 
 		ChatID = cast(int, self.__ChatID)
-		Bot = cast(TeleBot, self.__Bot)
 		FileID: str | None = None
 
-		Message = Bot.send_video(chat_id = ChatID, video = types.InputFile(file_path))
+		Message = self.__Bot.send_video(chat_id = ChatID, video = types.InputFile(file_path))
 		if Message.video: FileID = Message.video.file_id
 
-		return FileID
+		return Message, FileID
 
 	#==========================================================================================#
 	# >>>>> ПРИВАТНЫЕ МЕТОДЫ <<<<< #
@@ -365,11 +360,11 @@ class TeleCache:
 		FileID: str | None = None
 		
 		match attachment_type:
-			case types.InputMediaAnimation: FileID = self.__Upload_Animation(FilePath)
-			case types.InputMediaAudio: FileID = self.__Upload_Audio(FilePath)
-			case types.InputMediaDocument: FileID = self.__Upload_Document(FilePath)
-			case types.InputMediaPhoto: FileID = self.__Upload_Photo(FilePath)
-			case types.InputMediaVideo: FileID = self.__Upload_Video(FilePath)
+			case types.InputMediaAnimation: Message, FileID = self.__Upload_Animation(FilePath)
+			case types.InputMediaAudio: Message, FileID = self.__Upload_Audio(FilePath)
+			case types.InputMediaDocument: Message, FileID = self.__Upload_Document(FilePath)
+			case types.InputMediaPhoto: Message, FileID = self.__Upload_Photo(FilePath)
+			case types.InputMediaVideo: Message, FileID = self.__Upload_Video(FilePath)
 
 		if not FileID or not Message:
 			raise UnableCacheFileError(FilePath)
@@ -577,7 +572,6 @@ class TeleCache:
 		:rtype: VirtualCachedFile
 		"""
 
-		self.__Bot = cast(TeleBot, self.__Bot)
 		self.__ChatID = cast(int, self.__ChatID)
 
 		if not attachment_type: attachment_type = types.InputMediaDocument

{dublib-0.30.0 → dublib-0.30.2}/src/dublib/validators/types.py

@@ -36,8 +36,6 @@ class All(BaseValidator[str]):
 		:rtype: bool
 		"""
 
-		value # type: ignore
-
 		return True
 	
 class Alpha(BaseValidator[str]):

{dublib-0.30.0 → dublib-0.30.2}/src/dublib/web_requestor/__init__.py

@@ -92,18 +92,14 @@ class WebRequestor:
 				
 				#---> Переключение HTTP/HTTPS протоколов прокси при неудачном запросе.
 				#==========================================================================================#
-				if Response.status_code not in self.__Config.good_codes and CurrentProxy and self.__Config.switch_proxy_protocol and CurrentProxy.protocol:
-
-					if CurrentProxy.protocol in (Protocols.HTTP, Protocols.HTTPS):
-						sleep(self.__Config.delay)
-
-						match CurrentProxy.protocol:
-							case Protocols.HTTP: CurrentProxy.set_protocol(Protocols.HTTPS)
-							case Protocols.HTTPS: CurrentProxy.set_protocol(Protocols.HTTP)
-
-						NewResponse = WebResponse(self.__Config)
-						self.__RequestsMethods[request_type][self.__Config.lib](NewResponse, url, CurrentProxy, **kwargs)
-						if NewResponse.status_code in self.__Config.good_codes: Response = NewResponse
+				if not Response.ok and CurrentProxy and self.__Config.switch_proxy_protocol and CurrentProxy.protocol in (Protocols.HTTP, Protocols.HTTPS):
+					match CurrentProxy.protocol:
+						case Protocols.HTTP: CurrentProxy.set_protocol(Protocols.HTTPS)
+						case Protocols.HTTPS: CurrentProxy.set_protocol(Protocols.HTTP)
+
+					NewResponse = WebResponse(self.__Config)
+					self.__RequestsMethods[request_type][self.__Config.lib](NewResponse, url, CurrentProxy, **kwargs)
+					if NewResponse.status_code in self.__Config.good_codes: Response = NewResponse
 
 			except Exception as ExceptionData:
 				Response.push_exception(ExceptionData)