#!/usr/bin/env python # # A library that provides a Python interface to the Telegram Bot API # Copyright (C) 2015-2023 # Leandro Toledo de Souza # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser Public License for more details. # # You should have received a copy of the GNU Lesser Public License # along with this program. If not, see [http://www.gnu.org/licenses/]. """This module contains the classes that represent Telegram InlineQueryResultContact.""" from typing import TYPE_CHECKING, Optional from telegram._inline.inlinekeyboardmarkup import InlineKeyboardMarkup from telegram._inline.inlinequeryresult import InlineQueryResult from telegram._utils.types import JSONDict from telegram._utils.warnings_transition import ( warn_about_deprecated_arg_return_new_arg, warn_about_deprecated_attr_in_property, ) from telegram.constants import InlineQueryResultType if TYPE_CHECKING: from telegram import InputMessageContent class InlineQueryResultContact(InlineQueryResult): """ Represents a contact with a phone number. By default, this contact will be sent by the user. Alternatively, you can use :attr:`input_message_content` to send a message with the specified content instead of the contact. Args: id (:obj:`str`): Unique identifier for this result, :tg-const:`telegram.InlineQueryResult.MIN_ID_LENGTH`- :tg-const:`telegram.InlineQueryResult.MAX_ID_LENGTH` Bytes. phone_number (:obj:`str`): Contact's phone number. first_name (:obj:`str`): Contact's first name. last_name (:obj:`str`, optional): Contact's last name. vcard (:obj:`str`, optional): Additional data about the contact in the form of a vCard, 0-:tg-const:`telegram.constants.ContactLimit.VCARD` bytes. reply_markup (:class:`telegram.InlineKeyboardMarkup`, optional): Inline keyboard attached to the message. input_message_content (:class:`telegram.InputMessageContent`, optional): Content of the message to be sent instead of the contact. thumb_url (:obj:`str`, optional): Url of the thumbnail for the result. .. deprecated:: NEXT.VERSION |thumbargumentdeprecation| :paramref:`thumbnail_url`. thumb_width (:obj:`int`, optional): Thumbnail width. .. deprecated:: NEXT.VERSION |thumbargumentdeprecation| :paramref:`thumbnail_width`. thumb_height (:obj:`int`, optional): Thumbnail height. .. deprecated:: NEXT.VERSION |thumbargumentdeprecation| :paramref:`thumbnail_height`. thumbnail_url (:obj:`str`, optional): Url of the thumbnail for the result. .. versionadded:: NEXT.VERSION thumbnail_width (:obj:`int`, optional): Thumbnail width. .. versionadded:: NEXT.VERSION thumbnail_height (:obj:`int`, optional): Thumbnail height. .. versionadded:: NEXT.VERSION Attributes: type (:obj:`str`): :tg-const:`telegram.constants.InlineQueryResultType.CONTACT`. id (:obj:`str`): Unique identifier for this result, :tg-const:`telegram.InlineQueryResult.MIN_ID_LENGTH`- :tg-const:`telegram.InlineQueryResult.MAX_ID_LENGTH` Bytes. phone_number (:obj:`str`): Contact's phone number. first_name (:obj:`str`): Contact's first name. last_name (:obj:`str`): Optional. Contact's last name. vcard (:obj:`str`): Optional. Additional data about the contact in the form of a vCard, 0-:tg-const:`telegram.constants.ContactLimit.VCARD` bytes. reply_markup (:class:`telegram.InlineKeyboardMarkup`): Optional. Inline keyboard attached to the message. input_message_content (:class:`telegram.InputMessageContent`): Optional. Content of the message to be sent instead of the contact. thumbnail_url (:obj:`str`): Optional. Url of the thumbnail for the result. .. versionadded:: NEXT.VERSION thumbnail_width (:obj:`int`): Optional. Thumbnail width. .. versionadded:: NEXT.VERSION thumbnail_height (:obj:`int`): Optional. Thumbnail height. .. versionadded:: NEXT.VERSION """ __slots__ = ( "reply_markup", "thumbnail_width", "thumbnail_height", "vcard", "first_name", "last_name", "phone_number", "input_message_content", "thumbnail_url", ) def __init__( self, id: str, # pylint: disable=redefined-builtin phone_number: str, first_name: str, last_name: str = None, reply_markup: InlineKeyboardMarkup = None, input_message_content: "InputMessageContent" = None, thumb_url: str = None, thumb_width: int = None, thumb_height: int = None, vcard: str = None, thumbnail_url: str = None, thumbnail_width: int = None, thumbnail_height: int = None, *, api_kwargs: JSONDict = None, ): # Required super().__init__(InlineQueryResultType.CONTACT, id, api_kwargs=api_kwargs) with self._unfrozen(): self.phone_number: str = phone_number self.first_name: str = first_name # Optionals self.last_name: Optional[str] = last_name self.vcard: Optional[str] = vcard self.reply_markup: Optional[InlineKeyboardMarkup] = reply_markup self.input_message_content: Optional[InputMessageContent] = input_message_content self.thumbnail_url: Optional[str] = warn_about_deprecated_arg_return_new_arg( deprecated_arg=thumb_url, new_arg=thumbnail_url, deprecated_arg_name="thumb_url", new_arg_name="thumbnail_url", bot_api_version="6.6", ) self.thumbnail_width: Optional[int] = warn_about_deprecated_arg_return_new_arg( deprecated_arg=thumb_width, new_arg=thumbnail_width, deprecated_arg_name="thumb_width", new_arg_name="thumbnail_width", bot_api_version="6.6", ) self.thumbnail_height: Optional[int] = warn_about_deprecated_arg_return_new_arg( deprecated_arg=thumb_height, new_arg=thumbnail_height, deprecated_arg_name="thumb_height", new_arg_name="thumbnail_height", bot_api_version="6.6", ) @property def thumb_url(self) -> Optional[str]: """:obj:`str`: Optional. Url of the thumbnail for the result. .. deprecated:: NEXT.VERSION |thumbattributedeprecation| :attr:`thumbnail_url`. """ warn_about_deprecated_attr_in_property( deprecated_attr_name="thumb_url", new_attr_name="thumbnail_url", bot_api_version="6.6", ) return self.thumbnail_url @property def thumb_width(self) -> Optional[int]: """:obj:`str`: Optional. Thumbnail width. .. deprecated:: NEXT.VERSION |thumbattributedeprecation| :attr:`thumbnail_width`. """ warn_about_deprecated_attr_in_property( deprecated_attr_name="thumb_width", new_attr_name="thumbnail_width", bot_api_version="6.6", ) return self.thumbnail_width @property def thumb_height(self) -> Optional[int]: """:obj:`str`: Optional. Thumbnail height. .. deprecated:: NEXT.VERSION |thumbattributedeprecation| :attr:`thumbnail_height`. """ warn_about_deprecated_attr_in_property( deprecated_attr_name="thumb_height", new_attr_name="thumbnail_height", bot_api_version="6.6", ) return self.thumbnail_height