+ 
Telegram MTProto API Framework for Python @@ -9,17 +9,19 @@ Documentation • - + Releases • - - Community + + News
-
+
Telegram MTProto API Framework for Python
@@ -9,17 +9,19 @@
Documentation
•
-
+
Releases
•
-
- Community
+
+ News
inline fixed-width code
@@ -136,14 +135,13 @@ The following tags are currently supported:
.. code-block:: python
app.send_message(
- "haskell",
+ "me",
(
"bold, "
"italic, "
"underline, "
"code\n\n"
""
@@ -181,7 +179,7 @@ This means you can combine together both syntaxes in the same text:
.. code-block:: python
- app.send_message("haskell", "**bold**, italic")
+ app.send_message("me", "**bold**, italic")
Result:
@@ -192,8 +190,8 @@ If you don't like this behaviour you can always choose to only enable either Mar
.. code-block::
- app.send_message("haskell", "**bold**, italic", parse_mode="markdown")
- app.send_message("haskell", "**bold**, italic", parse_mode="html")
+ app.send_message("me", "**bold**, italic", parse_mode="markdown")
+ app.send_message("me", "**bold**, italic", parse_mode="html")
Result:
@@ -206,7 +204,7 @@ as-is.
.. code-block:: python
- app.send_message("haskell", "**bold**, italic", parse_mode=None)
+ app.send_message("me", "**bold**, italic", parse_mode=None)
Result:
diff --git a/docs/source/topics/tgcrypto.rst b/docs/source/topics/tgcrypto.rst
index e0d9beb6..f6ca211d 100644
--- a/docs/source/topics/tgcrypto.rst
+++ b/docs/source/topics/tgcrypto.rst
@@ -1,11 +1,11 @@
Fast Crypto
===========
-Pyrogram's speed can be *dramatically* boosted up by TgCrypto_, a high-performance, easy-to-install Telegram Crypto
-Library specifically written in C for Pyrogram [1]_ as a Python extension.
+Pyrogram's speed can be boosted up by TgCrypto_, a high-performance, easy-to-install cryptography library specifically
+written in C for Pyrogram as a Python extension.
-TgCrypto is a replacement for the much slower PyAES and implements the crypto algorithms Telegram requires, namely
-**AES-IGE 256 bit** (used in MTProto v2.0) and **AES-CTR 256 bit** (used for CDN encrypted files).
+TgCrypto is a replacement for a slower Python-only alternative and implements the cryptographic algorithms Telegram
+requires, namely: AES-256-IGE, AES-256-CTR and AES-256-CBC.
Installation
------------
@@ -14,10 +14,10 @@ Installation
$ pip3 install -U tgcrypto
-.. note:: Being a C extension for Python, TgCrypto is an optional but *highly recommended* dependency; when TgCrypto is
- not detected in your system, Pyrogram will automatically fall back to PyAES and will show you a warning.
+.. note:: When TgCrypto is not detected in your system, Pyrogram will automatically fall back to a slower Python-only
+ implementation and will show you a warning.
-The reason about being an optional package is that TgCrypto requires some extra system tools in order to be compiled.
+The reason about being an optional package is that TgCrypto requires extra system tools in order to be compiled.
The errors you receive when trying to install TgCrypto are system dependent, but also descriptive enough to understand
what you should do next:
@@ -26,7 +26,4 @@ what you should do next:
- **Linux**: Install a proper C compiler (``gcc``, ``clang``) and the Python header files (``python3-dev``).
- **Termux**: Install ``clang`` package.
-.. _TgCrypto: https://github.com/pyrogram/tgcrypto
-
-.. [1] Although TgCrypto is intended for Pyrogram, it is shipped as a standalone package and can thus be used for
- other Python projects too.
+.. _TgCrypto: https://github.com/pyrogram/tgcrypto
\ No newline at end of file
diff --git a/docs/source/topics/use-filters.rst b/docs/source/topics/use-filters.rst
index 7e5219e1..eda6d7ad 100644
--- a/docs/source/topics/use-filters.rst
+++ b/docs/source/topics/use-filters.rst
@@ -19,16 +19,15 @@ Single Filters
Let's start right away with a simple example:
-- This example will show you how to **only** handle messages containing an :class:`~pyrogram.Audio` object and
+- This example will show you how to **only** handle messages containing a :class:`~pyrogram.types.Sticker` object and
ignore any other message. Filters are passed as the first argument of the decorator:
.. code-block:: python
- :emphasize-lines: 4
from pyrogram import filters
- @app.on_message(filters.audio)
+ @app.on_message(filters.sticker)
def my_handler(client, message):
print(message)
@@ -36,7 +35,6 @@ Let's start right away with a simple example:
callback function itself:
.. code-block:: python
- :emphasize-lines: 9
from pyrogram import filters
from pyrogram.handlers import MessageHandler
@@ -46,12 +44,12 @@ Let's start right away with a simple example:
print(message)
- app.add_handler(MessageHandler(my_handler, filters.audio))
+ app.add_handler(MessageHandler(my_handler, filters.sticker))
Combining Filters
-----------------
-Filters can also be used in a more advanced way by inverting and combining more filters together using bitwise
+Filters can be used in a more advanced way by inverting and combining more filters together using bitwise
operators ``~``, ``&`` and ``|``:
- Use ``~`` to invert a filter (behaves like the ``not`` operator).
diff --git a/docs/source/topics/voice-calls.rst b/docs/source/topics/voice-calls.rst
index 19950bf4..aef4030c 100644
--- a/docs/source/topics/voice-calls.rst
+++ b/docs/source/topics/voice-calls.rst
@@ -1,8 +1,8 @@
Voice Calls
===========
-Both private voice calls and group voice calls are currently supported by third-party libraries that integrate with
-Pyrogram.
+Both private voice calls and group voice calls are currently supported by third-party, external libraries that integrate
+with Pyrogram.
Libraries
---------
diff --git a/pyrogram/client.py b/pyrogram/client.py
index c5c72af8..65514cf6 100644
--- a/pyrogram/client.py
+++ b/pyrogram/client.py
@@ -32,6 +32,7 @@ from pathlib import Path
from typing import Union, List, Optional
import pyrogram
+from pyrogram import __version__, __license__
from pyrogram import raw
from pyrogram import utils
from pyrogram.crypto import aes
@@ -281,6 +282,10 @@ class Client(Methods, Scaffold):
if self.bot_token:
return await self.sign_in_bot(self.bot_token)
+ print(f"Welcome to Pyrogram (version {__version__})")
+ print(f"Pyrogram is free software and comes with ABSOLUTELY NO WARRANTY. Licensed\n"
+ f"under the terms of the {__license__}.\n")
+
while True:
try:
if not self.phone_number:
@@ -428,7 +433,6 @@ class Client(Methods, Scaffold):
Example:
.. code-block:: python
- :emphasize-lines: 10,14,18,22
from pyrogram import Client
@@ -436,23 +440,23 @@ class Client(Methods, Scaffold):
with app:
# Default combined mode: Markdown + HTML
- app.send_message("haskell", "1. **markdown** and html")
+ app.send_message("me", "1. **markdown** and html")
# Force Markdown-only, HTML is disabled
app.set_parse_mode("markdown")
- app.send_message("haskell", "2. **markdown** and html")
+ app.send_message("me", "2. **markdown** and html")
# Force HTML-only, Markdown is disabled
app.set_parse_mode("html")
- app.send_message("haskell", "3. **markdown** and html")
+ app.send_message("me", "3. **markdown** and html")
# Disable the parser completely
app.set_parse_mode(None)
- app.send_message("haskell", "4. **markdown** and html")
+ app.send_message("me", "4. **markdown** and html")
# Bring back the default combined mode
app.set_parse_mode()
- app.send_message("haskell", "5. **markdown** and html")
+ app.send_message("me", "5. **markdown** and html")
"""
self.parse_mode = parse_mode
@@ -937,8 +941,8 @@ class Client(Methods, Scaffold):
await self.loop.run_in_executor(self.executor, func)
if len(chunk) < limit:
- break
-
+ break
+
r = await session.send(
raw.functions.upload.GetFile(
location=location,
diff --git a/pyrogram/connection/transport/tcp/tcp_abridged.py b/pyrogram/connection/transport/tcp/tcp_abridged.py
index cee97831..0282e668 100644
--- a/pyrogram/connection/transport/tcp/tcp_abridged.py
+++ b/pyrogram/connection/transport/tcp/tcp_abridged.py
@@ -17,7 +17,6 @@
# along with Pyrogram. If not, see