mirror of
https://github.com/aiogram/aiogram.git
synced 2026-04-08 16:37:47 +00:00
cd4e811856
* Refactor: Introduce Union types for streamlined type handling Implemented Union types across various modules to consolidate and simplify type annotations. This change replaces repetitive union declarations with reusable Union aliases, improving code readability and maintainability. Updates applied to affected classes, methods, and imports accordingly. * Refactor unions into type aliases for better reusability Replaced inline `Union` types with predefined aliases like `MediaUnion`, `ReplyMarkupUnion`, and `ChatIdUnion`. Simplifies type annotations, improves code readability, and reduces duplication. Added `media_union.py` for grouping related media types. * Refactor type unions with ResultChatMemberUnion and ResultMenuButtonUnion Replaced verbose type definitions of chat member and menu button unions with `ResultChatMemberUnion` and `ResultMenuButtonUnion` for improved readability and maintainability. Updated relevant methods, modules, and documentation to use the new type aliases consistently. * Added changelog
57 lines
2.7 KiB
Python
57 lines
2.7 KiB
Python
from typing import TYPE_CHECKING, Any, Optional
|
|
|
|
from ..types import ChatIdUnion, MessageId
|
|
from .base import TelegramMethod
|
|
|
|
|
|
class ForwardMessages(TelegramMethod[list[MessageId]]):
|
|
"""
|
|
Use this method to forward multiple messages of any kind. If some of the specified messages can't be found or forwarded, they are skipped. Service messages and messages with protected content can't be forwarded. Album grouping is kept for forwarded messages. On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned.
|
|
|
|
Source: https://core.telegram.org/bots/api#forwardmessages
|
|
"""
|
|
|
|
__returning__ = list[MessageId]
|
|
__api_method__ = "forwardMessages"
|
|
|
|
chat_id: ChatIdUnion
|
|
"""Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)"""
|
|
from_chat_id: ChatIdUnion
|
|
"""Unique identifier for the chat where the original messages were sent (or channel username in the format :code:`@channelusername`)"""
|
|
message_ids: list[int]
|
|
"""A JSON-serialized list of 1-100 identifiers of messages in the chat *from_chat_id* to forward. The identifiers must be specified in a strictly increasing order."""
|
|
message_thread_id: Optional[int] = None
|
|
"""Unique identifier for the target message thread (topic) of the forum; for forum supergroups only"""
|
|
disable_notification: Optional[bool] = None
|
|
"""Sends the messages `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound."""
|
|
protect_content: Optional[bool] = None
|
|
"""Protects the contents of the forwarded messages from forwarding and saving"""
|
|
|
|
if TYPE_CHECKING:
|
|
# DO NOT EDIT MANUALLY!!!
|
|
# This section was auto-generated via `butcher`
|
|
|
|
def __init__(
|
|
__pydantic__self__,
|
|
*,
|
|
chat_id: ChatIdUnion,
|
|
from_chat_id: ChatIdUnion,
|
|
message_ids: list[int],
|
|
message_thread_id: Optional[int] = None,
|
|
disable_notification: Optional[bool] = None,
|
|
protect_content: Optional[bool] = None,
|
|
**__pydantic_kwargs: Any,
|
|
) -> None:
|
|
# DO NOT EDIT MANUALLY!!!
|
|
# This method was auto-generated via `butcher`
|
|
# Is needed only for type checking and IDE support without any additional plugins
|
|
|
|
super().__init__(
|
|
chat_id=chat_id,
|
|
from_chat_id=from_chat_id,
|
|
message_ids=message_ids,
|
|
message_thread_id=message_thread_id,
|
|
disable_notification=disable_notification,
|
|
protect_content=protect_content,
|
|
**__pydantic_kwargs,
|
|
)
|