#!/usr/bin/env python # pylint: disable=C0103,W0622 # # A library that provides a Python interface to the Telegram Bot API # Copyright (C) 2015-2017 # 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 an object that represents a Telegram Chat.""" from telegram import TelegramObject class Chat(TelegramObject): """This object represents a Telegram Chat. Attributes: id (int): type (str): Can be 'private', 'group', 'supergroup' or 'channel' title (str): Title, for channels and group chats username (str): Username, for private chats and channels if available first_name (str): First name of the other party in a private chat last_name (str): Last name of the other party in a private chat all_members_are_administrators (bool): True if group has 'All Members Are Administrators' Args: id (int): type (str): title (Optional[str]): username(Optional[str]): first_name(Optional[str]): last_name(Optional[str]): bot (Optional[telegram.Bot]): The Bot to use for instance methods **kwargs (dict): Arbitrary keyword arguments. """ PRIVATE = 'private' GROUP = 'group' SUPERGROUP = 'supergroup' CHANNEL = 'channel' def __init__(self, id, type, title=None, username=None, first_name=None, last_name=None, all_members_are_administrators=None, bot=None, **kwargs): # Required self.id = int(id) self.type = type # Optionals self.title = title self.username = username self.first_name = first_name self.last_name = last_name self.all_members_are_administrators = all_members_are_administrators self.bot = bot self._id_attrs = (self.id,) @staticmethod def de_json(data, bot): """ Args: data (dict): bot (telegram.Bot): Returns: telegram.Chat: """ if not data: return None return Chat(bot=bot, **data) def send_action(self, *args, **kwargs): """Shortcut for ``bot.send_chat_action(update.message.chat.id, *args, **kwargs)``""" return self.bot.send_chat_action(self.id, *args, **kwargs) def leave(self, *args, **kwargs): """Shortcut for ``bot.leave_chat(update.message.chat.id, *args, **kwargs)``""" return self.bot.leave_chat(self.id, *args, **kwargs) def get_administrators(self, *args, **kwargs): """Shortcut for ``bot.get_chat_administrators(update.message.chat.id, *args, **kwargs)``""" return self.bot.get_chat_administrators(self.id, *args, **kwargs) def get_members_count(self, *args, **kwargs): """Shortcut for ``bot.get_chat_members_count(update.message.chat.id, *args, **kwargs)``""" return self.bot.get_chat_members_count(self.id, *args, **kwargs) def get_member(self, *args, **kwargs): """Shortcut for ``bot.get_chat_member(update.message.chat.id, *args, **kwargs)``""" return self.bot.get_chat_member(self.id, *args, **kwargs) def kick_member(self, *args, **kwargs): """Shortcut for ``bot.kick_chat_member(update.message.chat.id, *args, **kwargs)``""" return self.bot.kick_chat_member(self.id, *args, **kwargs) def unban_member(self, *args, **kwargs): """Shortcut for ``bot.unban_chat_member(update.message.chat.id, *args, **kwargs)``""" return self.bot.unban_chat_member(self.id, *args, **kwargs)