Deep rewrite: preparing for v1.0

- Pyrogram core is now fully asynchronous
- Ditched Python 3.5, welcome 3.6 as minimum version.
- Moved all types to pyrogram.types
- Turned the Filters class into a module (filters)
- Moved all filters to pyrogram.filters
- Moved all handlers to pyrogram.handlers
- Moved all emoji to pyrogram.emoji
- Renamed pyrogram.api to pyrogram.raw
- Clock is now synced with server's time
- Telegram schema updated to Layer 117
- Greatly improved the TL compiler (proper type-constructor hierarchy)
- Added "do not edit" warning in generated files
- Crypto parts are executed in a thread pool to avoid blocking the event loop
- idle() is now a separate function (it doesn't deal with Client instances)
- Async storage, async filters and async progress callback (optional, can be sync too)
- Added getpass back, for hidden password inputs

docs/source/api/decorators.rst

@@ -26,6 +26,7 @@ functions.
 
 .. contents:: Contents
     :backlinks: none
+    :depth: 1
     :local:
 
 -----

docs/source/api/errors.rst

@@ -1,78 +0,0 @@
-RPC Errors
-==========
-
-All Pyrogram API errors live inside the ``errors`` sub-package: ``pyrogram.errors``.
-The errors ids listed here are shown as *UPPER_SNAKE_CASE*, but the actual exception names to import from Pyrogram
-follow the usual *PascalCase* convention.
-
-.. code-block:: python
-    :emphasize-lines: 1, 5
-
-    from pyrogram.errors import FloodWait
-
-    try:
-        ...
-    except FloodWait as e:
-        ...
-
-.. contents:: Contents
-    :backlinks: none
-    :local:
-
------
-
-303 - SeeOther
---------------
-
-.. csv-table::
-    :file: ../../../compiler/error/source/303_SEE_OTHER.tsv
-    :delim: tab
-    :header-rows: 1
-
-400 - BadRequest
-----------------
-
-.. csv-table::
-    :file: ../../../compiler/error/source/400_BAD_REQUEST.tsv
-    :delim: tab
-    :header-rows: 1
-
-401 - Unauthorized
-------------------
-
-.. csv-table::
-    :file: ../../../compiler/error/source/401_UNAUTHORIZED.tsv
-    :delim: tab
-    :header-rows: 1
-
-403 - Forbidden
----------------
-
-.. csv-table::
-    :file: ../../../compiler/error/source/403_FORBIDDEN.tsv
-    :delim: tab
-    :header-rows: 1
-
-406 - NotAcceptable
--------------------
-
-.. csv-table::
-    :file: ../../../compiler/error/source/406_NOT_ACCEPTABLE.tsv
-    :delim: tab
-    :header-rows: 1
-
-420 - Flood
------------
-
-.. csv-table::
-    :file: ../../../compiler/error/source/420_FLOOD.tsv
-    :delim: tab
-    :header-rows: 1
-
-500 - InternalServerError
--------------------------
-
-.. csv-table::
-    :file: ../../../compiler/error/source/500_INTERNAL_SERVER_ERROR.tsv
-    :delim: tab
-    :header-rows: 1

docs/source/api/errors/bad-request.rst

@@ -0,0 +1,7 @@
+400 - BadRequest
+----------------
+
+.. csv-table::
+    :file: ../../../../compiler/error/source/400_BAD_REQUEST.tsv
+    :delim: tab
+    :header-rows: 1

docs/source/api/errors/flood.rst

@@ -0,0 +1,7 @@
+420 - Flood
+-----------
+
+.. csv-table::
+    :file: ../../../../compiler/error/source/420_FLOOD.tsv
+    :delim: tab
+    :header-rows: 1

docs/source/api/errors/forbidden.rst

@@ -0,0 +1,7 @@
+403 - Forbidden
+---------------
+
+.. csv-table::
+    :file: ../../../../compiler/error/source/403_FORBIDDEN.tsv
+    :delim: tab
+    :header-rows: 1

docs/source/api/errors/index.rst

@@ -0,0 +1,37 @@
+RPC Errors
+==========
+
+All Pyrogram API errors live inside the ``errors`` sub-package: ``pyrogram.errors``.
+The errors ids listed here are shown as *UPPER_SNAKE_CASE*, but the actual exception names to import from Pyrogram
+follow the usual *PascalCase* convention.
+
+.. code-block:: python
+
+    from pyrogram.errors import FloodWait
+
+    try:
+        ...
+    except FloodWait as e:
+        ...
+
+.. hlist::
+    :columns: 1
+
+    - :doc:`see-other`
+    - :doc:`bad-request`
+    - :doc:`unauthorized`
+    - :doc:`forbidden`
+    - :doc:`not-acceptable`
+    - :doc:`flood`
+    - :doc:`internal-server-error`
+
+.. toctree::
+    :hidden:
+
+    see-other
+    bad-request
+    unauthorized
+    forbidden
+    not-acceptable
+    flood
+    internal-server-error

docs/source/api/errors/internal-server-error.rst

@@ -0,0 +1,7 @@
+500 - InternalServerError
+-------------------------
+
+.. csv-table::
+    :file: ../../../../compiler/error/source/500_INTERNAL_SERVER_ERROR.tsv
+    :delim: tab
+    :header-rows: 1

docs/source/api/errors/not-acceptable.rst

@@ -0,0 +1,7 @@
+406 - NotAcceptable
+-------------------
+
+.. csv-table::
+    :file: ../../../../compiler/error/source/406_NOT_ACCEPTABLE.tsv
+    :delim: tab
+    :header-rows: 1

docs/source/api/errors/see-other.rst

@@ -0,0 +1,7 @@
+303 - SeeOther
+--------------
+
+.. csv-table::
+    :file: ../../../../compiler/error/source/303_SEE_OTHER.tsv
+    :delim: tab
+    :header-rows: 1

docs/source/api/errors/unauthorized.rst

@@ -0,0 +1,7 @@
+401 - Unauthorized
+------------------
+
+.. csv-table::
+    :file: ../../../../compiler/error/source/401_UNAUTHORIZED.tsv
+    :delim: tab
+    :header-rows: 1

docs/source/api/filters.rst

@@ -1,8 +1,11 @@
 Update Filters
 ==============
 
+Filters are objects that can be used to filter the content of incoming updates.
+:doc:`Read more about how filters work <../topics/use-filters>`.
+
 Details
 -------
 
-.. autoclass:: pyrogram.Filters
+.. automodule:: pyrogram.filters
     :members:

docs/source/api/handlers.rst

@@ -7,7 +7,8 @@ For a much more convenient way of registering callback functions have a look at
 .. code-block:: python
     :emphasize-lines: 1, 10
 
-    from pyrogram import Client, MessageHandler
+    from pyrogram import Client
+    from pyrogram.handlers import MessageHandler
 
     app = Client("my_account")
 
@@ -22,11 +23,12 @@ For a much more convenient way of registering callback functions have a look at
 
 .. contents:: Contents
     :backlinks: none
+    :depth: 1
     :local:
 
 -----
 
-.. currentmodule:: pyrogram
+.. currentmodule:: pyrogram.handlers
 
 Index
 -----