Skip to content

Снабдить Response-объекты полной документаций

Пример Response-объекта для одного из методов API:

class EditMessageReplyMarkupResponse(BaseTgResponse):
    """Represents an extended response structure from the Telegram Bot API."""

    result: tg_types.Message | bool = Field(
        description="The result of editing a ReplyMarkup message.",
    )

По коду сложно понять в каких ситуациях ожидать в ответе Message, а когда bool. Приходится лезть в официальную документацию к API Telegram:

editMessageReplyMarkup

Use this method to edit only the reply markup of messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned.

Будет удобнее, если всю нужную инфу будет возмжно получить прямо из встроенной документации, включая ссылку на оф.доку к методу.

Проблема характерна для всех Response-объектов.