Finish up asyncio docs

readthedocs/extra/examples/working-with-messages.rst

@@ -13,38 +13,39 @@ Forwarding messages
 
 .. note::
 
-    Use the `telethon.telegram_client.TelegramClient.forward_messages`
+    Use the `telethon.client.messages.MessageMethods.forward_messages`
     friendly method instead unless you have a better reason not to!
 
     This method automatically accepts either a single message or many of them.
 
 .. code-block:: python
 
-    # If you only have the message IDs
-    client.forward_messages(
-        entity,  # to which entity you are forwarding the messages
-        message_ids,  # the IDs of the messages (or message) to forward
-        from_entity  # who sent the messages?
-    )
+    async def main():
+        # If you only have the message IDs
+        await client.forward_messages(
+            entity,  # to which entity you are forwarding the messages
+            message_ids,  # the IDs of the messages (or message) to forward
+            from_entity  # who sent the messages?
+        )
 
-    # If you have ``Message`` objects
-    client.forward_messages(
-        entity,  # to which entity you are forwarding the messages
-        messages  # the messages (or message) to forward
-    )
+        # If you have ``Message`` objects
+        await client.forward_messages(
+            entity,  # to which entity you are forwarding the messages
+            messages  # the messages (or message) to forward
+        )
 
-    # You can also do it manually if you prefer
-    from telethon.tl.functions.messages import ForwardMessagesRequest
+        # You can also do it manually if you prefer
+        from telethon.tl.functions.messages import ForwardMessagesRequest
 
-    messages = foo()  # retrieve a few messages (or even one, in a list)
-    from_entity = bar()
-    to_entity = baz()
+        messages = foo()  # retrieve a few messages (or even one, in a list)
+        from_entity = bar()
+        to_entity = baz()
 
-    client(ForwardMessagesRequest(
-        from_peer=from_entity,  # who sent these messages?
-        id=[msg.id for msg in messages],  # which are the messages?
-        to_peer=to_entity  # who are we forwarding them to?
-    ))
+        await client(ForwardMessagesRequest(
+            from_peer=from_entity,  # who sent these messages?
+            id=[msg.id for msg in messages],  # which are the messages?
+            to_peer=to_entity  # who are we forwarding them to?
+        ))
 
 The named arguments are there for clarity, although they're not needed because
 they appear in order. You can obviously just wrap a single message on the list
@@ -56,7 +57,7 @@ Searching Messages
 
 .. note::
 
-    Use the `telethon.telegram_client.TelegramClient.iter_messages`
+    Use the `telethon.client.messages.MessageMethods.iter_messages`
     friendly method instead unless you have a better reason not to!
 
     This method has ``search`` and ``filter`` parameters that will
@@ -71,7 +72,7 @@ into issues_. A valid example would be:
     from telethon.tl.types import InputMessagesFilterEmpty
 
     filter = InputMessagesFilterEmpty()
-    result = client(SearchRequest(
+    result = loop.run_until_complete(client(SearchRequest(
         peer=peer,      # On which chat/conversation
         q='query',      # What to search for
         filter=filter,  # Filter to use (maybe filter for media)
@@ -84,7 +85,7 @@ into issues_. A valid example would be:
         min_id=0,       # Minimum message ID
         from_id=None,   # Who must have sent the message (peer)
         hash=0          # Special number to return nothing on no-change
-    ))
+    )))
 
 It's important to note that the optional parameter ``from_id`` could have
 been omitted (defaulting to ``None``). Changing it to :tl:`InputUserEmpty`, as one
@@ -99,7 +100,7 @@ you tried setting the ``from_id`` filter, and as the error says, you can't
 do that. Leave it set to ``None`` and it should work.
 
 As with every method, make sure you use the right ID/hash combination for
-your ``InputUser`` or ``InputChat``, or you'll likely run into errors like
+your :tl:`InputUser` or :tl:`InputChat`, or you'll likely run into errors like
 ``UserIdInvalidError``.
 
 
@@ -115,29 +116,25 @@ send yourself the very first sticker you have:
 
 .. code-block:: python
 
-    # Get all the sticker sets this user has
-    sticker_sets = client(GetAllStickersRequest(0))
+    async def main():
+        # Get all the sticker sets this user has
+        from telethon.tl.functions.messages import GetAllStickersRequest
+        sticker_sets = await client(GetAllStickersRequest(0))
 
-    # Choose a sticker set
-    sticker_set = sticker_sets.sets[0]
+        # Choose a sticker set
+        from telethon.tl.functions.messages import GetStickerSetRequest
+        from telethon.tl.types import InputStickerSetID
+        sticker_set = sticker_sets.sets[0]
 
-    # Get the stickers for this sticker set
-    stickers = client(GetStickerSetRequest(
-        stickerset=InputStickerSetID(
-            id=sticker_set.id, access_hash=sticker_set.access_hash
-        )
-    ))
-
-    # Stickers are nothing more than files, so send that
-    client(SendMediaRequest(
-        peer=client.get_me(),
-        media=InputMediaDocument(
-            id=InputDocument(
-                id=stickers.documents[0].id,
-                access_hash=stickers.documents[0].access_hash
+        # Get the stickers for this sticker set
+        stickers = await client(GetStickerSetRequest(
+            stickerset=InputStickerSetID(
+                id=sticker_set.id, access_hash=sticker_set.access_hash
             )
-        )
-    ))
+        ))
+
+        # Stickers are nothing more than files, so send that
+        await client.send_file('me', stickers.documents[0])
 
 
 .. _issues: https://github.com/LonamiWebs/Telethon/issues/215