538f1e3972
- 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
63 lines
1.7 KiB
ReStructuredText
63 lines
1.7 KiB
ReStructuredText
Install Guide
|
|
=============
|
|
|
|
Being a modern Python library, **Pyrogram** requires Python 3.6+ to be installed in your system.
|
|
We recommend using the latest versions of both Python 3 and pip.
|
|
|
|
- Get **Python 3** from https://www.python.org/downloads/ (or with your package manager).
|
|
- Get **pip** by following the instructions at https://pip.pypa.io/en/latest/installing/.
|
|
|
|
.. important::
|
|
|
|
Pyrogram supports **Python 3** only, starting from version 3.6. **PyPy** is supported too.
|
|
|
|
.. contents:: Contents
|
|
:backlinks: none
|
|
:depth: 1
|
|
:local:
|
|
|
|
-----
|
|
|
|
Install Pyrogram
|
|
----------------
|
|
|
|
- The easiest way to install and upgrade Pyrogram to its latest stable version is by using **pip**:
|
|
|
|
.. code-block:: text
|
|
|
|
$ pip3 install -U pyrogram
|
|
|
|
- or, with :doc:`TgCrypto <../topics/tgcrypto>` as extra requirement (recommended):
|
|
|
|
.. code-block:: text
|
|
|
|
$ pip3 install -U pyrogram tgcrypto
|
|
|
|
Bleeding Edge
|
|
-------------
|
|
|
|
Pyrogram is always evolving, although new releases on PyPI are published only when enough changes are added, but this
|
|
doesn't mean you can't try new features right now!
|
|
|
|
In case you'd like to try out the latest Pyrogram features, the `GitHub repo`_ is always kept updated with new changes;
|
|
you can install the development version straight from the ``develop`` branch using this command (note "develop.zip" in
|
|
the link):
|
|
|
|
.. code-block:: text
|
|
|
|
$ pip3 install -U https://github.com/pyrogram/pyrogram/archive/develop.zip
|
|
|
|
Verifying
|
|
---------
|
|
|
|
To verify that Pyrogram is correctly installed, open a Python shell and import it.
|
|
If no error shows up you are good to go.
|
|
|
|
.. parsed-literal::
|
|
|
|
>>> import pyrogram
|
|
>>> pyrogram.__version__
|
|
'|version|'
|
|
|
|
.. _`Github repo`: http://github.com/pyrogram/pyrogram
|