botapi-py 1.4.2__tar.gz → 1.4.4__tar.gz

{botapi_py-1.4.2 → botapi_py-1.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: botapi-py
-Version: 1.4.2
+Version: 1.4.4
 Summary: A simple and flexible Python library to conveniently build fast Telegram bots using the Bot API.
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: pydantic>=2.12.0

{botapi_py-1.4.2 → botapi_py-1.4.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "botapi-py"
-version = "1.4.2"
+version = "1.4.4"
 description = "A simple and flexible Python library to conveniently build fast Telegram bots using the Bot API."
 # readme = "README.md"
 # authors = [

{botapi_py-1.4.2 → botapi_py-1.4.4}/src/botapi/core.py

@@ -36,6 +36,13 @@ class BaseBot:
 		if not session:
 			log.warning('No HTTP session provided, creating a new one.')
 			
+	@property
+	def bot_id(self) -> int:
+		'''
+		Returns the bot's user ID by extracting it from the token.
+		'''
+		return int(self.token.split(':')[0])
+		
 	def _compose_api_url(self, method: str) -> str:
 		url = f'{self.api_url}/bot{self.token}/'
 		if self.test_server:

{botapi_py-1.4.2 → botapi_py-1.4.4}/src/botapi/enums.py

@@ -45,8 +45,9 @@ class UpdateType(enum.StrEnum):
 	
 class MediaType(enum.StrEnum):
 	'''
-	These are messages containing some kind of multimedia/visual content,
-	and NOT text-centric content.
+	Subset of `MessageType`.
+	
+	This represents **messages** containing some kind of **multimedia/visual content**.
 	'''
 	ANIMATION = 'animation'
 	AUDIO = 'audio'
@@ -61,10 +62,12 @@ class MediaType(enum.StrEnum):
 	
 class ServiceMessage(enum.StrEnum):
 	'''
-	These are special types of messages that convey service information.
+	Subset of `MessageType`.
+	
+	This represents special types of **service messages**.
 	
-	They are ALL represented as semi-transparent bubbles in Telegram apps UI,
-	containing text and/or graphical elements (e.g. gifts, giveaways).
+	These messages are ALL represented as semi-transparent bubbles in Telegram apps UI,
+	containing text (e.g. "user joined the group") and/or graphical elements (e.g. gifts, giveaways).
 	'''
 	NEW_CHAT_MEMBERS = 'new_chat_members'
 	LEFT_CHAT_MEMBER = 'left_chat_member'
@@ -118,7 +121,10 @@ class ServiceMessage(enum.StrEnum):
 	
 class OtherMessageType(enum.StrEnum):
 	'''
-	The type of this message (that does NOT contain multimedia or service content).
+	Subset of `MessageType`.
+	
+	This represents other possible types of messages, that do NOT contain
+	multimedia nor service content.
 	'''
 	TEXT = 'text'
 	CHECKLIST = 'checklist'
@@ -136,17 +142,19 @@ MessageType = Union[
 	OtherMessageType
 ]
 '''
+Possible types of a `UpdateType.Message` update.
+
 The type of the **actual** message content.
 
 All of the fields are mutually exclusive, since a message
 can only be of one 'type' at a time.
 '''
-	
+
 class ChatMemberStatus(enum.StrEnum):
 	'''
-	Statuses of a chat member.
+	Possible statuses of a `ChatMember`.
 	
-	Note that left members that are also restricted (muted), are represented as
+	Remember that left members that are also restricted (muted), are represented as
 	`RESTRICTED` with the `is_member` flag set to `False`.
 	
 	See: https://core.telegram.org/bots/api#chatmember

{botapi_py-1.4.2 → botapi_py-1.4.4}/src/botapi/methods.py

@@ -8,6 +8,8 @@ from typing import Union, Optional, List
 
 from . import core
 
+from . import enums
+
 from .types import (
 	Update,
 	WebhookInfo,
@@ -327,7 +329,7 @@ class Bot(core.BaseBot):
 		offset: Optional[int] = None,
 		limit: Optional[int] = None,
 		timeout: Optional[int] = None,
-		allowed_updates: Optional[List[str]] = None,
+		allowed_updates: Optional[List[enums.UpdateType]] = None,
 	) -> List[Update]:
 		'''
         Use this method to receive incoming updates using
@@ -351,7 +353,7 @@ class Bot(core.BaseBot):
 		certificate: Optional[InputFile] = None,
 		ip_address: Optional[str] = None,
 		max_connections: Optional[int] = None,
-		allowed_updates: Optional[List[str]] = None,
+		allowed_updates: Optional[List[enums.UpdateType]] = None,
 		drop_pending_updates: Optional[bool] = None,
 		secret_token: Optional[str] = None,
 	) -> bool:
@@ -473,7 +475,7 @@ class Bot(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		entities: Optional[List[MessageEntity]] = None,
 		link_preview_options: Optional[LinkPreviewOptions] = None,
 		disable_notification: Optional[bool] = None,
@@ -586,7 +588,7 @@ class Bot(core.BaseBot):
 		direct_messages_topic_id: Optional[int] = None,
 		video_start_timestamp: Optional[int] = None,
 		caption: Optional[str] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		caption_entities: Optional[List[MessageEntity]] = None,
 		show_caption_above_media: Optional[bool] = None,
 		disable_notification: Optional[bool] = None,
@@ -680,7 +682,7 @@ class Bot(core.BaseBot):
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
 		caption: Optional[str] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		caption_entities: Optional[List[MessageEntity]] = None,
 		show_caption_above_media: Optional[bool] = None,
 		has_spoiler: Optional[bool] = None,
@@ -728,7 +730,7 @@ class Bot(core.BaseBot):
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
 		caption: Optional[str] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		caption_entities: Optional[List[MessageEntity]] = None,
 		duration: Optional[int] = None,
 		performer: Optional[str] = None,
@@ -787,7 +789,7 @@ class Bot(core.BaseBot):
 		direct_messages_topic_id: Optional[int] = None,
 		thumbnail: Optional[Union[InputFile, str]] = None,
 		caption: Optional[str] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		caption_entities: Optional[List[MessageEntity]] = None,
 		disable_content_type_detection: Optional[bool] = None,
 		disable_notification: Optional[bool] = None,
@@ -843,7 +845,7 @@ class Bot(core.BaseBot):
 		cover: Optional[Union[InputFile, str]] = None,
 		start_timestamp: Optional[int] = None,
 		caption: Optional[str] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		caption_entities: Optional[List[MessageEntity]] = None,
 		show_caption_above_media: Optional[bool] = None,
 		has_spoiler: Optional[bool] = None,
@@ -907,7 +909,7 @@ class Bot(core.BaseBot):
 		height: Optional[int] = None,
 		thumbnail: Optional[Union[InputFile, str]] = None,
 		caption: Optional[str] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		caption_entities: Optional[List[MessageEntity]] = None,
 		show_caption_above_media: Optional[bool] = None,
 		has_spoiler: Optional[bool] = None,
@@ -963,7 +965,7 @@ class Bot(core.BaseBot):
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
 		caption: Optional[str] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		caption_entities: Optional[List[MessageEntity]] = None,
 		duration: Optional[int] = None,
 		disable_notification: Optional[bool] = None,
@@ -1066,7 +1068,7 @@ class Bot(core.BaseBot):
 		direct_messages_topic_id: Optional[int] = None,
 		payload: Optional[str] = None,
 		caption: Optional[str] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		caption_entities: Optional[List[MessageEntity]] = None,
 		show_caption_above_media: Optional[bool] = None,
 		disable_notification: Optional[bool] = None,
@@ -3284,7 +3286,7 @@ class Bot(core.BaseBot):
 		content: InputStoryContent,
 		active_period: int,
 		caption: Optional[str] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		caption_entities: Optional[List[MessageEntity]] = None,
 		areas: Optional[List[StoryArea]] = None,
 		post_to_chat_page: Optional[bool] = None,
@@ -3317,7 +3319,7 @@ class Bot(core.BaseBot):
 		story_id: int,
 		content: InputStoryContent,
 		caption: Optional[str] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		caption_entities: Optional[List[MessageEntity]] = None,
 		areas: Optional[List[StoryArea]] = None,
 	) -> Story:
@@ -3368,7 +3370,7 @@ class Bot(core.BaseBot):
 		chat_id: Optional[Union[int, str]] = None,
 		message_id: Optional[int] = None,
 		inline_message_id: Optional[str] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		entities: Optional[List[MessageEntity]] = None,
 		link_preview_options: Optional[LinkPreviewOptions] = None,
 		reply_markup: Optional[InlineKeyboardMarkup] = None,
@@ -3409,7 +3411,7 @@ class Bot(core.BaseBot):
 		message_id: Optional[int] = None,
 		inline_message_id: Optional[str] = None,
 		caption: Optional[str] = None,
-		parse_mode: Optional[str] = 'HTML',
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		caption_entities: Optional[List[MessageEntity]] = None,
 		show_caption_above_media: Optional[bool] = None,
 		reply_markup: Optional[InlineKeyboardMarkup] = None,

{botapi_py-1.4.2 → botapi_py-1.4.4}/src/botapi/types.py

@@ -143,7 +143,7 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 	async def pin(
 		self,
 		bot: methods.Bot,
-		disable_notification: bool | None = None,
+		disable_notification: Union[bool, None] = None,
 	) -> bool:
 		'''
 		Pins this message in the chat.
@@ -171,13 +171,13 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 	async def forward(
 		self,
 		bot: methods.Bot,
-		chat_id: int | str,
-		disable_notification: bool | None = None,
-		protect_content: bool | None = None,
-		message_thread_id: int | None = None,
-		direct_messages_topic_id: int | None = None,
-		video_start_timestamp: int | None = None,
-		# suggested_post_parameters: SuggestedPostParameters | None = None,
+		chat_id: Union[int, str],
+		disable_notification: Optional[bool] = None,
+		protect_content: Optional[bool] = None,
+		message_thread_id: Optional[int] = None,
+		direct_messages_topic_id: Optional[int] = None,
+		video_start_timestamp: Optional[int] = None,
+		# suggested_post_parameters: Optional[SuggestedPostParameters] = None,
 	) -> Message:
 		'''
 		Forwards this message to another chat.
@@ -198,20 +198,20 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 	async def copy_to(
 		self,
 		bot: methods.Bot,
-		chat_id: int | str,
-		message_thread_id: int | None = None,
-		direct_messages_topic_id: int | None = None,
-		video_start_timestamp: int | None = None,
-		# caption: str | None = None,
-		# parse_mode: str | None = 'HTML',
-		# caption_entities: List[MessageEntity] | None = None,
-		# show_caption_above_media: bool | None = None,
-		disable_notification: bool | None = None,
-		protect_content: bool | None = None,
-		# allow_paid_broadcast: bool | None = None,
-		# suggested_post_parameters: SuggestedPostParameters | None = None,
-		# reply_parameters: ReplyParameters | None = None,
-		# reply_markup: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None = None
+		chat_id: Union[int, str],
+		message_thread_id: Optional[int] = None,
+		direct_messages_topic_id: Optional[int] = None,
+		video_start_timestamp: Optional[int] = None,
+		# caption: Optional[str] = None,
+		# parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
+		# caption_entities: Optional[List[MessageEntity]] = None,
+		# show_caption_above_media: Optional[bool] = None,
+		disable_notification: Optional[bool] = None,
+		protect_content: Optional[bool] = None,
+		# allow_paid_broadcast: Optional[bool] = None,
+		# suggested_post_parameters: Optional[SuggestedPostParameters] = None,
+		# reply_parameters: Optional[ReplyParameters] = None,
+		# reply_markup: Optional[Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]] = None
 	) -> MessageId:
 		'''
 		Copies this message to another chat.
@@ -241,11 +241,11 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 		bot: methods.Bot,
 		text: str,
 		# inline_message_id: Optional[str] = None,
-		parse_mode: str | None = 'HTML',
-		entities: list[MessageEntity] | None = None,
-		link_preview_options: LinkPreviewOptions | None = None,
-		reply_markup: InlineKeyboardMarkup | None = None,
-	) -> Message | bool:
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
+		entities: Optional[list[MessageEntity]] = None,
+		link_preview_options: Optional[LinkPreviewOptions] = None,
+		reply_markup: Optional[InlineKeyboardMarkup] = None,
+	) -> Union[Message, bool]:
 		'''
 		Edits the text of this message.
 		Shortcut for `bot.edit_message_text`.
@@ -267,8 +267,8 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 		self,
 		bot: methods.Bot,
 		# inline_message_id: Optional[str] = None,
-		reply_markup: InlineKeyboardMarkup | None = None,
-	) -> Message | bool:
+		reply_markup: Optional[InlineKeyboardMarkup] = None,
+	) -> Union[Message, bool]:
 		'''
 		Edits the reply markup (inline keyboard) of this message.
 		Shortcut for `bot.edit_message_reply_markup`.
@@ -285,18 +285,18 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 		self,
 		bot: methods.Bot,
 		text: str,
-		parse_mode: str | None = 'HTML',
-		entities: list[MessageEntity] | None = None,
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
+		entities: Optional[list[MessageEntity]] = None,
 		reply_to_original_message: bool = True, # CUSTOM
 		allow_sending_without_reply: bool = True, # CUSTOM
-		link_preview_options: LinkPreviewOptions | None = None,
-		disable_notification: bool | None = None,
-		protect_content: bool | None = None,
-		allow_paid_broadcast: bool | None = None,
-		message_effect_id: str | None = None,
-		reply_parameters: ReplyParameters | None = None,
-		# suggested_post_parameters: SuggestedPostParameters | None = None,
-		reply_markup: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None = None,
+		link_preview_options: Optional[LinkPreviewOptions] = None,
+		disable_notification: Optional[bool] = None,
+		protect_content: Optional[bool] = None,
+		allow_paid_broadcast: Optional[bool] = None,
+		message_effect_id: Optional[str] = None,
+		reply_parameters: Optional[ReplyParameters] = None,
+		# suggested_post_parameters: Optional[SuggestedPostParameters] = None,
+		reply_markup: Optional[Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]] = None,
 	) -> Message:
 		'''
 		Replies to this message with a text message.
@@ -363,7 +363,7 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 		return None
 	
 	@property
-	def message_type(self) -> enums.MessageType | None:
+	def message_type(self) -> Optional[enums.MessageType]:
 		'''
 		Type of the actual message content (e.g., `text`, `photo`, `sticker`, `poll`, `new_chat_title`, etc.).
 	
@@ -1101,7 +1101,7 @@ class InputMediaAnimation(InputMedia, frozen=True):
 	media: str
 	thumbnail: Optional[str] = Field(default=None)
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	width: Optional[int] = Field(default=None)
@@ -1120,7 +1120,7 @@ class InputMediaDocument(InputMedia, frozen=True):
 	media: str
 	thumbnail: Optional[str] = Field(default=None)
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	disable_content_type_detection: Optional[bool] = Field(default=None) 
 
@@ -1136,7 +1136,7 @@ class InputMediaAudio(InputMedia, frozen=True):
 	media: str
 	thumbnail: Optional[str] = Field(default=None)
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	duration: Optional[int] = Field(default=None)
 	performer: Optional[str] = Field(default=None)
@@ -1152,7 +1152,7 @@ class InputMediaPhoto(InputMedia, frozen=True):
 	type: Literal['photo'] = 'photo'
 	media: str
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	has_spoiler: Optional[bool] = Field(default=None) 
@@ -1170,7 +1170,7 @@ class InputMediaVideo(InputMedia, frozen=True):
 	cover: Optional[str] = Field(default=None)
 	start_timestamp: Optional[int] = Field(default=None)
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	width: Optional[int] = Field(default=None)
@@ -1308,7 +1308,7 @@ class InlineQueryResultCachedAudio(InlineQueryResult, frozen=True):
 	id: str
 	audio_file_id: str
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
 	input_message_content: Optional[InputMessageContent] = Field(default=None) 
@@ -1331,7 +1331,7 @@ class InlineQueryResultCachedDocument(InlineQueryResult, frozen=True):
 	document_file_id: str
 	description: Optional[str] = Field(default=None)
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
 	input_message_content: Optional[InputMessageContent] = Field(default=None) 
@@ -1353,7 +1353,7 @@ class InlineQueryResultCachedGif(InlineQueryResult, frozen=True):
 	gif_file_id: str
 	title: Optional[str] = Field(default=None)
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
@@ -1377,7 +1377,7 @@ class InlineQueryResultCachedMpeg4Gif(InlineQueryResult, frozen=True):
 	mpeg4_file_id: str
 	title: Optional[str] = Field(default=None)
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
@@ -1401,7 +1401,7 @@ class InlineQueryResultCachedPhoto(InlineQueryResult, frozen=True):
 	title: Optional[str] = Field(default=None)
 	description: Optional[str] = Field(default=None)
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
@@ -1442,7 +1442,7 @@ class InlineQueryResultCachedVideo(InlineQueryResult, frozen=True):
 	title: str
 	description: Optional[str] = Field(default=None)
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
@@ -1465,7 +1465,7 @@ class InlineQueryResultCachedVoice(InlineQueryResult, frozen=True):
 	voice_file_id: str
 	title: str
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
 	input_message_content: Optional[InputMessageContent] = Field(default=None) 
@@ -1505,7 +1505,7 @@ class InlineQueryResultAudio(InlineQueryResult, frozen=True):
 	audio_url: str
 	title: str
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	performer: Optional[str] = Field(default=None)
 	audio_duration: Optional[int] = Field(default=None)
@@ -1566,7 +1566,7 @@ class InlineQueryResultDocument(InlineQueryResult, frozen=True):
 	document_url: str
 	mime_type: str
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	description: Optional[str] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
@@ -1596,7 +1596,7 @@ class InlineQueryResultGif(InlineQueryResult, frozen=True):
 	thumbnail_mime_type: Optional[str] = Field(default=None)
 	title: Optional[str] = Field(default=None)
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
@@ -1650,7 +1650,7 @@ class InlineQueryResultMpeg4Gif(InlineQueryResult, frozen=True):
 	thumbnail_mime_type: Optional[str] = Field(default=None)
 	title: Optional[str] = Field(default=None)
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
@@ -1676,7 +1676,7 @@ class InlineQueryResultPhoto(InlineQueryResult, frozen=True):
 	title: Optional[str] = Field(default=None)
 	description: Optional[str] = Field(default=None)
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
@@ -1727,7 +1727,7 @@ class InlineQueryResultVideo(InlineQueryResult, frozen=True):
 	thumbnail_url: str
 	title: str
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	video_width: Optional[int] = Field(default=None)
@@ -1754,7 +1754,7 @@ class InlineQueryResultVoice(InlineQueryResult, frozen=True):
 	voice_url: str
 	title: str
 	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	voice_duration: Optional[int] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
@@ -1797,7 +1797,7 @@ class InputTextMessageContent(InputMessageContent, frozen=True):
 	'''
 
 	message_text: str
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	entities: Optional[List[MessageEntity]] = Field(default=None)
 	link_preview_options: Optional[LinkPreviewOptions] = Field(default=None) 
 
@@ -2350,12 +2350,21 @@ class MessageEntity(BaseModel, frozen=True):
 	
 	@staticmethod
 	def from_dict(
-		json_data: list[dict[str, Any]]
+		json_data: dict[str, Any]
+	) -> MessageEntity:
+		'''
+		Converts a JSON dictionary to a `MessageEntity` object.
+		'''
+		return MessageEntity.model_validate(json_data)
+	
+	@staticmethod
+	def from_list_of_dicts(
+		list_of_json_data: list[dict[str, Any]]
 	) -> list[MessageEntity]:
 		'''
-		Converts a list of JSON dictionaries to a list of `MessageEntity` objects.
+		Converts a **list** of JSON dictionaries to a **list** of `MessageEntity` objects.
 		'''
-		return [MessageEntity.model_validate(item) for item in json_data]
+		return [MessageEntity.model_validate(item) for item in list_of_json_data]
 	 
 
 class TextQuote(BaseModel, frozen=True):
@@ -2674,7 +2683,7 @@ class InputChecklistTask(BaseModel, frozen=True):
 
 	id: int
 	text: str
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	text_entities: Optional[List[MessageEntity]] = Field(default=None) 
 
 class InputChecklist(BaseModel, frozen=True):
@@ -2686,7 +2695,7 @@ class InputChecklist(BaseModel, frozen=True):
 
 	title: str
 	tasks: List[InputChecklistTask]
-	parse_mode: Optional[str] = Field(default='HTML')
+	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	title_entities: Optional[List[MessageEntity]] = Field(default=None)
 	others_can_add_tasks: Optional[bool] = Field(default=None)
 	others_can_mark_tasks_as_done: Optional[bool] = Field(default=None) 
@@ -4041,7 +4050,7 @@ class InputFile(BaseModel, frozen=True):
 
 	file_content: bytes # Raw file content as bytes.
 	file_name: str # File name, including its extension.
-	mime_type: str | None = Field(default=None) # File MIME type.
+	mime_type: Optional[str] = Field(default=None) # File MIME type.
 	 
 
 class Sticker(BaseModel, frozen=True):