mirror of
https://github.com/python-telegram-bot/python-telegram-bot.git
synced 2024-12-22 22:45:09 +01:00
Doc Fixes (#2551)
* Document ExtBot.insert_callbakc_data
* fix duplicate object descriptions
Fixed by removing `:undoc-members:` in the affected classes.
Closes https://github.com/sphinx-doc/sphinx/issues/9294
* fix incorrect shortcut docstrings in user.py
* fix object type in forcereply.py
* fix discuss bot link in loginurl.py
* document that message is None for (my)_chat_member
in `effective_message`
* numerous persistence rendering fixes
* move docstring from property setter to property
* Revert "fix object type in forcereply.py"
This reverts commit 012663e0c3
.
* Document comparison of jobs
* Update min python version to 3.6.8
* remove old note from chat.py + some return msg fixes
* fix colon placement
Co-authored-by: Harshil <ilovebhagwan@gmail.com>
Co-authored-by: Harshil <37377066+harshil21@users.noreply.github.com>
This commit is contained in:
parent
fce2993d21
commit
a75dffd4a8
15 changed files with 60 additions and 64 deletions
|
@ -93,7 +93,7 @@ Introduction
|
||||||
|
|
||||||
This library provides a pure Python interface for the
|
This library provides a pure Python interface for the
|
||||||
`Telegram Bot API <https://core.telegram.org/bots/api>`_.
|
`Telegram Bot API <https://core.telegram.org/bots/api>`_.
|
||||||
It's compatible with Python versions 3.6.2+. PTB might also work on `PyPy <http://pypy.org/>`_, though there have been a lot of issues before. Hence, PyPy is not officially supported.
|
It's compatible with Python versions 3.6.8+. PTB might also work on `PyPy <http://pypy.org/>`_, though there have been a lot of issues before. Hence, PyPy is not officially supported.
|
||||||
|
|
||||||
In addition to the pure API implementation, this library features a number of high-level classes to
|
In addition to the pure API implementation, this library features a number of high-level classes to
|
||||||
make the development of bots easy and straightforward. These classes are contained in the
|
make the development of bots easy and straightforward. These classes are contained in the
|
||||||
|
|
|
@ -91,7 +91,7 @@ Introduction
|
||||||
|
|
||||||
This library provides a pure Python, lightweight interface for the
|
This library provides a pure Python, lightweight interface for the
|
||||||
`Telegram Bot API <https://core.telegram.org/bots/api>`_.
|
`Telegram Bot API <https://core.telegram.org/bots/api>`_.
|
||||||
It's compatible with Python versions 3.6.2+. PTB-Raw might also work on `PyPy <http://pypy.org/>`_, though there have been a lot of issues before. Hence, PyPy is not officially supported.
|
It's compatible with Python versions 3.6.8+. PTB-Raw might also work on `PyPy <http://pypy.org/>`_, though there have been a lot of issues before. Hence, PyPy is not officially supported.
|
||||||
|
|
||||||
``python-telegram-bot-raw`` is part of the `python-telegram-bot <https://python-telegram-bot.org>`_ ecosystem and provides the pure API functionality extracted from PTB. It therefore does *not* have independent release schedules, changelogs or documentation. Please consult the PTB resources.
|
``python-telegram-bot-raw`` is part of the `python-telegram-bot <https://python-telegram-bot.org>`_ ecosystem and provides the pure API functionality extracted from PTB. It therefore does *not* have independent release schedules, changelogs or documentation. Please consult the PTB resources.
|
||||||
|
|
||||||
|
|
|
@ -5,3 +5,5 @@ telegram.ext.ExtBot
|
||||||
|
|
||||||
.. autoclass:: telegram.ext.ExtBot
|
.. autoclass:: telegram.ext.ExtBot
|
||||||
:show-inheritance:
|
:show-inheritance:
|
||||||
|
|
||||||
|
.. autofunction:: telegram.ext.ExtBot.insert_callback_data
|
||||||
|
|
|
@ -5,5 +5,4 @@ telegram.ext.Handler
|
||||||
|
|
||||||
.. autoclass:: telegram.ext.Handler
|
.. autoclass:: telegram.ext.Handler
|
||||||
:members:
|
:members:
|
||||||
:undoc-members:
|
|
||||||
:show-inheritance:
|
:show-inheritance:
|
||||||
|
|
|
@ -5,5 +5,4 @@ telegram.Update
|
||||||
|
|
||||||
.. autoclass:: telegram.Update
|
.. autoclass:: telegram.Update
|
||||||
:members:
|
:members:
|
||||||
:undoc-members:
|
|
||||||
:show-inheritance:
|
:show-inheritance:
|
||||||
|
|
|
@ -5,5 +5,4 @@ telegram.User
|
||||||
|
|
||||||
.. autoclass:: telegram.User
|
.. autoclass:: telegram.User
|
||||||
:members:
|
:members:
|
||||||
:undoc-members:
|
|
||||||
:show-inheritance:
|
:show-inheritance:
|
||||||
|
|
|
@ -284,7 +284,7 @@ class Chat(TelegramObject):
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.leave_chat`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.leave_chat`.
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
:obj:`bool` If the action was sent successfully.
|
:obj:`bool`: On success, :obj:`True` is returned.
|
||||||
|
|
||||||
"""
|
"""
|
||||||
return self.bot.leave_chat(
|
return self.bot.leave_chat(
|
||||||
|
@ -375,13 +375,7 @@ class Chat(TelegramObject):
|
||||||
:meth:`telegram.Bot.kick_chat_member`.
|
:meth:`telegram.Bot.kick_chat_member`.
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
:obj:`bool`: If the action was sent successfully.
|
:obj:`bool`: On success, :obj:`True` is returned.
|
||||||
|
|
||||||
Note:
|
|
||||||
This method will only work if the `All Members Are Admins` setting is off in the
|
|
||||||
target group. Otherwise members may only be removed by the group's creator or by the
|
|
||||||
member that added them.
|
|
||||||
|
|
||||||
"""
|
"""
|
||||||
return self.bot.kick_chat_member(
|
return self.bot.kick_chat_member(
|
||||||
chat_id=self.id,
|
chat_id=self.id,
|
||||||
|
@ -406,7 +400,7 @@ class Chat(TelegramObject):
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.unban_chat_member`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.unban_chat_member`.
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
:obj:`bool`: If the action was sent successfully.
|
:obj:`bool`: On success, :obj:`True` is returned.
|
||||||
|
|
||||||
"""
|
"""
|
||||||
return self.bot.unban_chat_member(
|
return self.bot.unban_chat_member(
|
||||||
|
@ -444,7 +438,7 @@ class Chat(TelegramObject):
|
||||||
.. versionadded:: 13.2
|
.. versionadded:: 13.2
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
:obj:`bool`: If the action was sent successfully.
|
:obj:`bool`: On success, :obj:`True` is returned.
|
||||||
|
|
||||||
"""
|
"""
|
||||||
return self.bot.promote_chat_member(
|
return self.bot.promote_chat_member(
|
||||||
|
@ -483,7 +477,7 @@ class Chat(TelegramObject):
|
||||||
.. versionadded:: 13.2
|
.. versionadded:: 13.2
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
:obj:`bool`: If the action was sent successfully.
|
:obj:`bool`: On success, :obj:`True` is returned.
|
||||||
|
|
||||||
"""
|
"""
|
||||||
return self.bot.restrict_chat_member(
|
return self.bot.restrict_chat_member(
|
||||||
|
@ -509,7 +503,7 @@ class Chat(TelegramObject):
|
||||||
:meth:`telegram.Bot.set_chat_permissions`.
|
:meth:`telegram.Bot.set_chat_permissions`.
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
:obj:`bool`: If the action was sent successfully.
|
:obj:`bool`: On success, :obj:`True` is returned.
|
||||||
|
|
||||||
"""
|
"""
|
||||||
return self.bot.set_chat_permissions(
|
return self.bot.set_chat_permissions(
|
||||||
|
@ -534,7 +528,7 @@ class Chat(TelegramObject):
|
||||||
:meth:`telegram.Bot.set_chat_administrator_custom_title`.
|
:meth:`telegram.Bot.set_chat_administrator_custom_title`.
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
:obj:`bool`: If the action was sent successfully.
|
:obj:`bool`: On success, :obj:`True` is returned.
|
||||||
|
|
||||||
"""
|
"""
|
||||||
return self.bot.set_chat_administrator_custom_title(
|
return self.bot.set_chat_administrator_custom_title(
|
||||||
|
@ -678,7 +672,7 @@ class Chat(TelegramObject):
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_media_group`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_media_group`.
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
List[:class:`telegram.Message`:] On success, instance representing the message posted.
|
List[:class:`telegram.Message`]: On success, instance representing the message posted.
|
||||||
|
|
||||||
"""
|
"""
|
||||||
return self.bot.send_media_group(
|
return self.bot.send_media_group(
|
||||||
|
|
|
@ -446,8 +446,8 @@ class BasePersistence(Generic[UD, CD, BD], ABC):
|
||||||
.. versionadded:: 13.6
|
.. versionadded:: 13.6
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
Optional[:class:`telegram.ext.utils.types.CDCData`]: The restored meta data or
|
Optional[:class:`telegram.ext.utils.types.CDCData`]: The restored meta data or
|
||||||
:obj:`None`, if no data was stored.
|
:obj:`None`, if no data was stored.
|
||||||
"""
|
"""
|
||||||
raise NotImplementedError
|
raise NotImplementedError
|
||||||
|
|
||||||
|
@ -469,8 +469,8 @@ class BasePersistence(Generic[UD, CD, BD], ABC):
|
||||||
def update_conversation(
|
def update_conversation(
|
||||||
self, name: str, key: Tuple[int, ...], new_state: Optional[object]
|
self, name: str, key: Tuple[int, ...], new_state: Optional[object]
|
||||||
) -> None:
|
) -> None:
|
||||||
"""Will be called when a :attr:`telegram.ext.ConversationHandler.update_state`
|
"""Will be called when a :class:`telegram.ext.ConversationHandler` changes states.
|
||||||
is called. This allows the storage of the new state in the persistence.
|
This allows the storage of the new state in the persistence.
|
||||||
|
|
||||||
Args:
|
Args:
|
||||||
name (:obj:`str`): The handler's name.
|
name (:obj:`str`): The handler's name.
|
||||||
|
@ -486,7 +486,7 @@ class BasePersistence(Generic[UD, CD, BD], ABC):
|
||||||
Args:
|
Args:
|
||||||
user_id (:obj:`int`): The user the data might have been changed for.
|
user_id (:obj:`int`): The user the data might have been changed for.
|
||||||
data (:class:`telegram.ext.utils.types.UD`): The
|
data (:class:`telegram.ext.utils.types.UD`): The
|
||||||
:attr:`telegram.ext.dispatcher.user_data` ``[user_id]``.
|
:attr:`telegram.ext.Dispatcher.user_data` ``[user_id]``.
|
||||||
"""
|
"""
|
||||||
|
|
||||||
@abstractmethod
|
@abstractmethod
|
||||||
|
@ -497,7 +497,7 @@ class BasePersistence(Generic[UD, CD, BD], ABC):
|
||||||
Args:
|
Args:
|
||||||
chat_id (:obj:`int`): The chat the data might have been changed for.
|
chat_id (:obj:`int`): The chat the data might have been changed for.
|
||||||
data (:class:`telegram.ext.utils.types.CD`): The
|
data (:class:`telegram.ext.utils.types.CD`): The
|
||||||
:attr:`telegram.ext.dispatcher.chat_data` ``[chat_id]``.
|
:attr:`telegram.ext.Dispatcher.chat_data` ``[chat_id]``.
|
||||||
"""
|
"""
|
||||||
|
|
||||||
@abstractmethod
|
@abstractmethod
|
||||||
|
@ -507,7 +507,7 @@ class BasePersistence(Generic[UD, CD, BD], ABC):
|
||||||
|
|
||||||
Args:
|
Args:
|
||||||
data (:class:`telegram.ext.utils.types.BD`): The
|
data (:class:`telegram.ext.utils.types.BD`): The
|
||||||
:attr:`telegram.ext.dispatcher.bot_data`.
|
:attr:`telegram.ext.Dispatcher.bot_data`.
|
||||||
"""
|
"""
|
||||||
|
|
||||||
def refresh_user_data(self, user_id: int, user_data: UD) -> None:
|
def refresh_user_data(self, user_id: int, user_data: UD) -> None:
|
||||||
|
@ -552,8 +552,8 @@ class BasePersistence(Generic[UD, CD, BD], ABC):
|
||||||
.. versionadded:: 13.6
|
.. versionadded:: 13.6
|
||||||
|
|
||||||
Args:
|
Args:
|
||||||
data (:class:`telegram.ext.utils.types.CDCData`:): The relevant data to restore
|
data (:class:`telegram.ext.utils.types.CDCData`): The relevant data to restore
|
||||||
:attr:`telegram.ext.dispatcher.bot.callback_data_cache`.
|
:class:`telegram.ext.CallbackDataCache`.
|
||||||
"""
|
"""
|
||||||
raise NotImplementedError
|
raise NotImplementedError
|
||||||
|
|
||||||
|
|
|
@ -350,11 +350,11 @@ class ConversationHandler(Handler[Update, CCT]):
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def allow_reentry(self) -> bool:
|
def allow_reentry(self) -> bool:
|
||||||
|
""":obj:`bool`: Determines if a user can restart a conversation with an entry point."""
|
||||||
return self._allow_reentry
|
return self._allow_reentry
|
||||||
|
|
||||||
@allow_reentry.setter
|
@allow_reentry.setter
|
||||||
def allow_reentry(self, value: object) -> NoReturn:
|
def allow_reentry(self, value: object) -> NoReturn:
|
||||||
""":obj:`bool`: Determines if a user can restart a conversation with an entry point."""
|
|
||||||
raise ValueError('You can not assign a new value to allow_reentry after initialization.')
|
raise ValueError('You can not assign a new value to allow_reentry after initialization.')
|
||||||
|
|
||||||
@property
|
@property
|
||||||
|
|
|
@ -294,7 +294,7 @@ class DictPersistence(BasePersistence):
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
Optional[:class:`telegram.ext.utils.types.CDCData`]: The restored meta data or
|
Optional[:class:`telegram.ext.utils.types.CDCData`]: The restored meta data or
|
||||||
:obj:`None`, if no data was stored.
|
:obj:`None`, if no data was stored.
|
||||||
"""
|
"""
|
||||||
if self.callback_data is None:
|
if self.callback_data is None:
|
||||||
self._callback_data = None
|
self._callback_data = None
|
||||||
|
@ -334,7 +334,7 @@ class DictPersistence(BasePersistence):
|
||||||
|
|
||||||
Args:
|
Args:
|
||||||
user_id (:obj:`int`): The user the data might have been changed for.
|
user_id (:obj:`int`): The user the data might have been changed for.
|
||||||
data (:obj:`dict`): The :attr:`telegram.ext.dispatcher.user_data` ``[user_id]``.
|
data (:obj:`dict`): The :attr:`telegram.ext.Dispatcher.user_data` ``[user_id]``.
|
||||||
"""
|
"""
|
||||||
if self._user_data is None:
|
if self._user_data is None:
|
||||||
self._user_data = defaultdict(dict)
|
self._user_data = defaultdict(dict)
|
||||||
|
@ -348,7 +348,7 @@ class DictPersistence(BasePersistence):
|
||||||
|
|
||||||
Args:
|
Args:
|
||||||
chat_id (:obj:`int`): The chat the data might have been changed for.
|
chat_id (:obj:`int`): The chat the data might have been changed for.
|
||||||
data (:obj:`dict`): The :attr:`telegram.ext.dispatcher.chat_data` ``[chat_id]``.
|
data (:obj:`dict`): The :attr:`telegram.ext.Dispatcher.chat_data` ``[chat_id]``.
|
||||||
"""
|
"""
|
||||||
if self._chat_data is None:
|
if self._chat_data is None:
|
||||||
self._chat_data = defaultdict(dict)
|
self._chat_data = defaultdict(dict)
|
||||||
|
@ -361,7 +361,7 @@ class DictPersistence(BasePersistence):
|
||||||
"""Will update the bot_data (if changed).
|
"""Will update the bot_data (if changed).
|
||||||
|
|
||||||
Args:
|
Args:
|
||||||
data (:obj:`dict`): The :attr:`telegram.ext.dispatcher.bot_data`.
|
data (:obj:`dict`): The :attr:`telegram.ext.Dispatcher.bot_data`.
|
||||||
"""
|
"""
|
||||||
if self._bot_data == data:
|
if self._bot_data == data:
|
||||||
return
|
return
|
||||||
|
@ -374,8 +374,8 @@ class DictPersistence(BasePersistence):
|
||||||
.. versionadded:: 13.6
|
.. versionadded:: 13.6
|
||||||
|
|
||||||
Args:
|
Args:
|
||||||
data (:class:`telegram.ext.utils.types.CDCData`:): The relevant data to restore
|
data (:class:`telegram.ext.utils.types.CDCData`): The relevant data to restore
|
||||||
:attr:`telegram.ext.dispatcher.bot.callback_data_cache`.
|
:class:`telegram.ext.CallbackDataCache`.
|
||||||
"""
|
"""
|
||||||
if self._callback_data == data:
|
if self._callback_data == data:
|
||||||
return
|
return
|
||||||
|
|
|
@ -518,6 +518,9 @@ class Job:
|
||||||
With the current backend APScheduler, :attr:`job` holds a :class:`apscheduler.job.Job`
|
With the current backend APScheduler, :attr:`job` holds a :class:`apscheduler.job.Job`
|
||||||
instance.
|
instance.
|
||||||
|
|
||||||
|
Objects of this class are comparable in terms of equality. Two objects of this class are
|
||||||
|
considered equal, if their :attr:`id` is equal.
|
||||||
|
|
||||||
Note:
|
Note:
|
||||||
* All attributes and instance methods of :attr:`job` are also directly available as
|
* All attributes and instance methods of :attr:`job` are also directly available as
|
||||||
attributes/methods of the corresponding :class:`telegram.ext.Job` object.
|
attributes/methods of the corresponding :class:`telegram.ext.Job` object.
|
||||||
|
|
|
@ -60,7 +60,7 @@ class PicklePersistence(BasePersistence[UD, CD, BD]):
|
||||||
|
|
||||||
.. versionadded:: 13.6
|
.. versionadded:: 13.6
|
||||||
single_file (:obj:`bool`, optional): When :obj:`False` will store 5 separate files of
|
single_file (:obj:`bool`, optional): When :obj:`False` will store 5 separate files of
|
||||||
`filename_user_data`, `filename_chat_data`, `filename_bot_data`, `filename_chat_data`,
|
`filename_user_data`, `filename_bot_data`, `filename_chat_data`,
|
||||||
`filename_callback_data` and `filename_conversations`. Default is :obj:`True`.
|
`filename_callback_data` and `filename_conversations`. Default is :obj:`True`.
|
||||||
on_flush (:obj:`bool`, optional): When :obj:`True` will only save to file when
|
on_flush (:obj:`bool`, optional): When :obj:`True` will only save to file when
|
||||||
:meth:`flush` is called and keep data in memory until that happens. When
|
:meth:`flush` is called and keep data in memory until that happens. When
|
||||||
|
@ -87,7 +87,7 @@ class PicklePersistence(BasePersistence[UD, CD, BD]):
|
||||||
|
|
||||||
.. versionadded:: 13.6
|
.. versionadded:: 13.6
|
||||||
single_file (:obj:`bool`): Optional. When :obj:`False` will store 5 separate files of
|
single_file (:obj:`bool`): Optional. When :obj:`False` will store 5 separate files of
|
||||||
`filename_user_data`, `filename_chat_data`, `filename_bot_data`, `filename_chat_data`,
|
`filename_user_data`, `filename_bot_data`, `filename_chat_data`,
|
||||||
`filename_callback_data` and `filename_conversations`. Default is :obj:`True`.
|
`filename_callback_data` and `filename_conversations`. Default is :obj:`True`.
|
||||||
on_flush (:obj:`bool`, optional): When :obj:`True` will only save to file when
|
on_flush (:obj:`bool`, optional): When :obj:`True` will only save to file when
|
||||||
:meth:`flush` is called and keep data in memory until that happens. When
|
:meth:`flush` is called and keep data in memory until that happens. When
|
||||||
|
@ -281,7 +281,7 @@ class PicklePersistence(BasePersistence[UD, CD, BD]):
|
||||||
|
|
||||||
Returns:
|
Returns:
|
||||||
Optional[:class:`telegram.ext.utils.types.CDCData`]: The restored meta data or
|
Optional[:class:`telegram.ext.utils.types.CDCData`]: The restored meta data or
|
||||||
:obj:`None`, if no data was stored.
|
:obj:`None`, if no data was stored.
|
||||||
"""
|
"""
|
||||||
if self.callback_data:
|
if self.callback_data:
|
||||||
pass
|
pass
|
||||||
|
@ -347,7 +347,7 @@ class PicklePersistence(BasePersistence[UD, CD, BD]):
|
||||||
Args:
|
Args:
|
||||||
user_id (:obj:`int`): The user the data might have been changed for.
|
user_id (:obj:`int`): The user the data might have been changed for.
|
||||||
data (:class:`telegram.ext.utils.types.UD`): The
|
data (:class:`telegram.ext.utils.types.UD`): The
|
||||||
:attr:`telegram.ext.dispatcher.user_data` ``[user_id]``.
|
:attr:`telegram.ext.Dispatcher.user_data` ``[user_id]``.
|
||||||
"""
|
"""
|
||||||
if self.user_data is None:
|
if self.user_data is None:
|
||||||
self.user_data = defaultdict(self.context_types.user_data)
|
self.user_data = defaultdict(self.context_types.user_data)
|
||||||
|
@ -367,7 +367,7 @@ class PicklePersistence(BasePersistence[UD, CD, BD]):
|
||||||
Args:
|
Args:
|
||||||
chat_id (:obj:`int`): The chat the data might have been changed for.
|
chat_id (:obj:`int`): The chat the data might have been changed for.
|
||||||
data (:class:`telegram.ext.utils.types.CD`): The
|
data (:class:`telegram.ext.utils.types.CD`): The
|
||||||
:attr:`telegram.ext.dispatcher.chat_data` ``[chat_id]``.
|
:attr:`telegram.ext.Dispatcher.chat_data` ``[chat_id]``.
|
||||||
"""
|
"""
|
||||||
if self.chat_data is None:
|
if self.chat_data is None:
|
||||||
self.chat_data = defaultdict(self.context_types.chat_data)
|
self.chat_data = defaultdict(self.context_types.chat_data)
|
||||||
|
@ -386,7 +386,7 @@ class PicklePersistence(BasePersistence[UD, CD, BD]):
|
||||||
|
|
||||||
Args:
|
Args:
|
||||||
data (:class:`telegram.ext.utils.types.BD`): The
|
data (:class:`telegram.ext.utils.types.BD`): The
|
||||||
:attr:`telegram.ext.dispatcher.bot_data`.
|
:attr:`telegram.ext.Dispatcher.bot_data`.
|
||||||
"""
|
"""
|
||||||
if self.bot_data == data:
|
if self.bot_data == data:
|
||||||
return
|
return
|
||||||
|
@ -405,8 +405,8 @@ class PicklePersistence(BasePersistence[UD, CD, BD]):
|
||||||
.. versionadded:: 13.6
|
.. versionadded:: 13.6
|
||||||
|
|
||||||
Args:
|
Args:
|
||||||
data (:class:`telegram.ext.utils.types.CDCData`:): The relevant data to restore
|
data (:class:`telegram.ext.utils.types.CDCData`): The relevant data to restore
|
||||||
:attr:`telegram.ext.dispatcher.bot.callback_data`.
|
:class:`telegram.ext.CallbackDataCache`.
|
||||||
"""
|
"""
|
||||||
if self.callback_data == data:
|
if self.callback_data == data:
|
||||||
return
|
return
|
||||||
|
|
|
@ -29,7 +29,7 @@ class LoginUrl(TelegramObject):
|
||||||
coming from Telegram. All the user needs to do is tap/click a button and confirm that they want
|
coming from Telegram. All the user needs to do is tap/click a button and confirm that they want
|
||||||
to log in. Telegram apps support these buttons as of version 5.7.
|
to log in. Telegram apps support these buttons as of version 5.7.
|
||||||
|
|
||||||
Sample bot: `@discussbot <https://t.me/dicussbot>`_
|
Sample bot: `@discussbot <https://t.me/discussbot>`_
|
||||||
|
|
||||||
Objects of this class are comparable in terms of equality. Two objects of this class are
|
Objects of this class are comparable in terms of equality. Two objects of this class are
|
||||||
considered equal, if their :attr:`url` is equal.
|
considered equal, if their :attr:`url` is equal.
|
||||||
|
|
|
@ -334,8 +334,8 @@ class Update(TelegramObject):
|
||||||
:class:`telegram.Message`: The message included in this update, no matter what kind of
|
:class:`telegram.Message`: The message included in this update, no matter what kind of
|
||||||
update this is. Will be :obj:`None` for :attr:`inline_query`,
|
update this is. Will be :obj:`None` for :attr:`inline_query`,
|
||||||
:attr:`chosen_inline_result`, :attr:`callback_query` from inline messages,
|
:attr:`chosen_inline_result`, :attr:`callback_query` from inline messages,
|
||||||
:attr:`shipping_query`, :attr:`pre_checkout_query`, :attr:`poll` and
|
:attr:`shipping_query`, :attr:`pre_checkout_query`, :attr:`poll`,
|
||||||
:attr:`poll_answer`.
|
:attr:`poll_answer`, :attr:`my_chat_member` and :attr:`chat_member`.
|
||||||
|
|
||||||
"""
|
"""
|
||||||
if self._effective_message:
|
if self._effective_message:
|
||||||
|
|
|
@ -193,7 +193,7 @@ class User(TelegramObject):
|
||||||
def mention_markdown(self, name: str = None) -> str:
|
def mention_markdown(self, name: str = None) -> str:
|
||||||
"""
|
"""
|
||||||
Note:
|
Note:
|
||||||
:attr:`telegram.ParseMode.MARKDOWN` is is a legacy mode, retained by Telegram for
|
:attr:`telegram.ParseMode.MARKDOWN` is a legacy mode, retained by Telegram for
|
||||||
backward compatibility. You should use :meth:`mention_markdown_v2` instead.
|
backward compatibility. You should use :meth:`mention_markdown_v2` instead.
|
||||||
|
|
||||||
Args:
|
Args:
|
||||||
|
@ -362,7 +362,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_photo(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_photo`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_photo`.
|
||||||
|
|
||||||
|
@ -398,7 +398,7 @@ class User(TelegramObject):
|
||||||
) -> List['Message']:
|
) -> List['Message']:
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_media_group(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_media_group`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_media_group`.
|
||||||
|
|
||||||
|
@ -436,7 +436,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_audio(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_audio`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_audio`.
|
||||||
|
|
||||||
|
@ -471,7 +471,7 @@ class User(TelegramObject):
|
||||||
) -> bool:
|
) -> bool:
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_chat_action(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_chat_action`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_chat_action`.
|
||||||
|
|
||||||
|
@ -505,7 +505,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_contact(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_contact`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_contact`.
|
||||||
|
|
||||||
|
@ -540,7 +540,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_dice(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_dice`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_dice`.
|
||||||
|
|
||||||
|
@ -577,7 +577,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_document(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_document`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_document`.
|
||||||
|
|
||||||
|
@ -614,7 +614,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_game(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_game`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_game`.
|
||||||
|
|
||||||
|
@ -665,7 +665,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_invoice(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_invoice`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_invoice`.
|
||||||
|
|
||||||
|
@ -730,7 +730,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_location(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_location`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_location`.
|
||||||
|
|
||||||
|
@ -775,7 +775,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_animation(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_animation`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_animation`.
|
||||||
|
|
||||||
|
@ -814,7 +814,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_sticker(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_sticker`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_sticker`.
|
||||||
|
|
||||||
|
@ -854,7 +854,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_video(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_video`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_video`.
|
||||||
|
|
||||||
|
@ -902,7 +902,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_venue(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_venue`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_venue`.
|
||||||
|
|
||||||
|
@ -945,7 +945,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_video_note(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_video_note`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_video_note`.
|
||||||
|
|
||||||
|
@ -985,7 +985,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_voice(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_voice`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_voice`.
|
||||||
|
|
||||||
|
@ -1033,7 +1033,7 @@ class User(TelegramObject):
|
||||||
) -> 'Message':
|
) -> 'Message':
|
||||||
"""Shortcut for::
|
"""Shortcut for::
|
||||||
|
|
||||||
bot.send_message(update.effective_user.id, *args, **kwargs)
|
bot.send_poll(update.effective_user.id, *args, **kwargs)
|
||||||
|
|
||||||
For the documentation of the arguments, please see :meth:`telegram.Bot.send_poll`.
|
For the documentation of the arguments, please see :meth:`telegram.Bot.send_poll`.
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue