Merge branch 'develop' into types-revamp

delivrance · delivrance · commit 1ee848771281 · 2019-06-11T14:45:21.000+02:00
# Conflicts:
#	pyrogram/client/methods/users/get_profile_photos.py
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -4,7 +4,7 @@ about: Create a bug report affecting the library
 labels: "bug"
 ---
 
-<!-- WARNING: Ignoring this template will lead to the issue being closed as incomplete -->
+<!-- WARNING: Ignoring this template could lead to the issue being closed as incomplete -->
 
 ## Checklist
 - [ ] I am sure the error is coming from Pyrogram's code and not elsewhere.
@@ -15,7 +15,7 @@ labels: "bug"
 A clear and concise description of the problem.
 
 ## Steps to Reproduce
-[A minimal, complete and verifiable example](https://stackoverflow.com/help/mcve).
+[A minimal, reproducible example](https://stackoverflow.com/help/minimal-reproducible-example).
 
 ## Traceback
 The full traceback (if applicable).
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -4,7 +4,7 @@ about: Suggest ideas, new features or enhancements
 labels: "enhancement"
 ---
 
-<!-- WARNING: Ignoring this template will lead to the issue being closed as incomplete -->
+<!-- WARNING: Ignoring this template could lead to the issue being closed as incomplete -->
 
 ## Checklist
 - [ ] I believe the idea is awesome and would benefit the library.
diff --git a/.github/ISSUE_TEMPLATE/question.md b/.github/ISSUE_TEMPLATE/question.md
@@ -5,11 +5,11 @@ title: For Q&A purposes, please read this template body
 labels: "question"
 ---
 
-<!-- WARNING: Ignoring this template will lead to the issue being closed as incomplete -->
+<!-- WARNING: Ignoring this template could lead to the issue being closed as incomplete -->
 
 # Important
 This place is for issues about Pyrogram, it's **not a forum**.
 
-If you'd like to post a question, please move to https://stackoverflow.com or join the Telegram community by following the description in https://t.me/pyrogram.
+If you'd like to post a question, please move to https://stackoverflow.com or join the Telegram community at https://t.me/pyrogram.
 
 Thanks.
diff --git a/compiler/error/source/400_BAD_REQUEST.tsv b/compiler/error/source/400_BAD_REQUEST.tsv
@@ -99,4 +99,10 @@ RESULT_ID_DUPLICATE	The result contains items with duplicated identifiers
 ACCESS_TOKEN_INVALID	The bot access token is invalid
 INVITE_HASH_EXPIRED	The chat invite link is no longer valid
 USER_BANNED_IN_CHANNEL	You are limited, check @SpamBot for details
-MESSAGE_EDIT_TIME_EXPIRED	You can no longer edit this message
+MESSAGE_EDIT_TIME_EXPIRED	You can no longer edit this message
+FOLDER_ID_INVALID	The folder id is invalid
+MEGAGROUP_PREHISTORY_HIDDEN	The action failed because the supergroup has the pre-history hidden
+CHAT_LINK_EXISTS	The action failed because the supergroup is linked to a channel
+LINK_NOT_MODIFIED	The chat link was not modified because you tried to link to the same target
+BROADCAST_ID_INVALID	The channel is invalid
+MEGAGROUP_ID_INVALID	The supergroup is invalid
diff --git a/docs/robots.txt b/docs/robots.txt
@@ -1,3 +1,8 @@
 User-agent: *
+
 Allow: /
+
+Disallow: /dev/*
+Disallow: /old/*
+
 Sitemap: https://docs.pyrogram.org/sitemap.xml
diff --git a/docs/source/api/bound-methods.rst b/docs/source/api/bound-methods.rst
@@ -59,6 +59,24 @@ Message
     - :meth:`~Message.reply_video_note`
     - :meth:`~Message.reply_voice`
 
+Chat
+^^^^
+
+.. hlist::
+    :columns: 2
+
+    - :meth:`~Chat.archive`
+    - :meth:`~Chat.unarchive`
+
+User
+^^^^
+
+.. hlist::
+    :columns: 2
+
+    - :meth:`~User.archive`
+    - :meth:`~User.unarchive`
+
 CallbackQuery
 ^^^^^^^^^^^^^
 
@@ -109,6 +127,14 @@ Details
 .. automethod:: Message.reply_video_note()
 .. automethod:: Message.reply_voice()
 
+.. Chat
+.. automethod:: Chat.archive()
+.. automethod:: Chat.unarchive()
+
+.. User
+.. automethod:: User.archive()
+.. automethod:: User.unarchive()
+
 .. CallbackQuery
 .. automethod:: CallbackQuery.answer()
 
diff --git a/docs/source/api/client.rst b/docs/source/api/client.rst
@@ -13,4 +13,7 @@ This is the Client class. It exposes high-level methods for an easy access to th
     with app:
         app.send_message("me", "Hi!")
 
+Details
+-------
+
 .. autoclass:: pyrogram.Client()
diff --git a/docs/source/api/filters.rst b/docs/source/api/filters.rst
@@ -1,5 +1,8 @@
 Update Filters
 ==============
 
+Details
+-------
+
 .. autoclass:: pyrogram.Filters
     :members:
diff --git a/docs/source/api/methods.rst b/docs/source/api/methods.rst
@@ -104,6 +104,8 @@ Chats
     - :meth:`~Client.get_dialogs_count`
     - :meth:`~Client.restrict_chat`
     - :meth:`~Client.update_chat_username`
+    - :meth:`~Client.archive_chats`
+    - :meth:`~Client.unarchive_chats`
 
 Users
 ^^^^^
@@ -233,6 +235,8 @@ Details
 .. automethod:: Client.get_dialogs_count()
 .. automethod:: Client.restrict_chat()
 .. automethod:: Client.update_chat_username()
+.. automethod:: Client.archive_chats()
+.. automethod:: Client.unarchive_chats()
 
 ..  Users
 .. automethod:: Client.get_me()
diff --git a/docs/source/license.rst b/docs/source/license.rst
@@ -2,7 +2,7 @@ About the License
 =================
 
 .. image:: https://www.gnu.org/graphics/lgplv3-with-text-154x68.png
-    :align: left
+    :align: right
 
 Pyrogram is free software and is currently licensed under the terms of the
 `GNU Lesser General Public License v3 or later (LGPLv3+)`_. In short: you may use, redistribute and/or modify it
diff --git a/pyrogram/client/methods/chats/__init__.py b/pyrogram/client/methods/chats/__init__.py
@@ -16,6 +16,7 @@
 # You should have received a copy of the GNU Lesser General Public License
 # along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
 
+from .archive_chats import ArchiveChats
 from .delete_chat_photo import DeleteChatPhoto
 from .export_chat_invite_link import ExportChatInviteLink
 from .get_chat import GetChat
@@ -36,6 +37,7 @@
 from .set_chat_description import SetChatDescription
 from .set_chat_photo import SetChatPhoto
 from .set_chat_title import SetChatTitle
+from .unarchive_chats import UnarchiveChats
 from .unban_chat_member import UnbanChatMember
 from .unpin_chat_message import UnpinChatMessage
 from .update_chat_username import UpdateChatUsername
@@ -64,6 +66,8 @@ class Chats(
     IterChatMembers,
     UpdateChatUsername,
     RestrictChat,
-    GetDialogsCount
+    GetDialogsCount,
+    ArchiveChats,
+    UnarchiveChats
 ):
     pass
diff --git a/pyrogram/client/methods/chats/archive_chats.py b/pyrogram/client/methods/chats/archive_chats.py
@@ -0,0 +1,58 @@
+# Pyrogram - Telegram MTProto API Client Library for Python
+# Copyright (C) 2017-2019 Dan Tès <https://github.com/delivrance>
+#
+# This file is part of Pyrogram.
+#
+# Pyrogram is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Pyrogram 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 General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+from typing import Union, List
+
+from pyrogram.api import functions, types
+from ...ext import BaseClient
+
+
+class ArchiveChats(BaseClient):
+    def archive_chats(
+        self,
+        chat_ids: Union[int, str, List[Union[int, str]]],
+    ) -> bool:
+        """Archive one or more chats.
+
+        Parameters:
+            chat_ids (``int`` | ``str`` | List[``int``, ``str``]):
+                Unique identifier (int) or username (str) of the target chat.
+                You can also pass a list of ids (int) or usernames (str).
+
+        Returns:
+            ``bool``: On success, True is returned.
+
+        Raises:
+            RPCError: In case of a Telegram RPC error.
+        """
+
+        if not isinstance(chat_ids, list):
+            chat_ids = [chat_ids]
+
+        self.send(
+            functions.folders.EditPeerFolders(
+                folder_peers=[
+                    types.InputFolderPeer(
+                        peer=self.resolve_peer(chat),
+                        folder_id=1
+                    ) for chat in chat_ids
+                ]
+            )
+        )
+
+        return True
diff --git a/pyrogram/client/methods/chats/unarchive_chats.py b/pyrogram/client/methods/chats/unarchive_chats.py
@@ -0,0 +1,58 @@
+# Pyrogram - Telegram MTProto API Client Library for Python
+# Copyright (C) 2017-2019 Dan Tès <https://github.com/delivrance>
+#
+# This file is part of Pyrogram.
+#
+# Pyrogram is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Pyrogram 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 General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+from typing import Union, List
+
+from pyrogram.api import functions, types
+from ...ext import BaseClient
+
+
+class UnarchiveChats(BaseClient):
+    def unarchive_chats(
+        self,
+        chat_ids: Union[int, str, List[Union[int, str]]],
+    ) -> bool:
+        """Unarchive one or more chats.
+
+        Parameters:
+            chat_ids (``int`` | ``str`` | List[``int``, ``str``]):
+                Unique identifier (int) or username (str) of the target chat.
+                You can also pass a list of ids (int) or usernames (str).
+
+        Returns:
+            ``bool``: On success, True is returned.
+
+        Raises:
+            RPCError: In case of a Telegram RPC error.
+        """
+
+        if not isinstance(chat_ids, list):
+            chat_ids = [chat_ids]
+
+        self.send(
+            functions.folders.EditPeerFolders(
+                folder_peers=[
+                    types.InputFolderPeer(
+                        peer=self.resolve_peer(chat),
+                        folder_id=0
+                    ) for chat in chat_ids
+                ]
+            )
+        )
+
+        return True
diff --git a/pyrogram/client/methods/users/get_profile_photos.py b/pyrogram/client/methods/users/get_profile_photos.py
@@ -55,7 +55,7 @@ def get_profile_photos(
         """
         peer_id = self.resolve_peer(chat_id)
 
-        if isinstance(peer_id, types.InputPeerUser):
+        if isinstance(peer_id, (types.InputPeerUser, types.InputPeerSelf)):
             r = self.send(
                 functions.photos.GetUserPhotos(
                     user_id=peer_id,
diff --git a/pyrogram/client/types/messages_and_media/message.py b/pyrogram/client/types/messages_and_media/message.py
diff --git a/pyrogram/client/types/user_and_chats/chat.py b/pyrogram/client/types/user_and_chats/chat.py
diff --git a/pyrogram/client/types/user_and_chats/user.py b/pyrogram/client/types/user_and_chats/user.py
