aiomailru

aiomailru is a python Mail.Ru API wrapper. The main features are:

• authorization (Authorization Code, Implicit Flow, Password Grant, Refresh Token)
• REST API methods
• web scrapers

Usage

To use Mail.Ru API you need a registered app and Mail.Ru account. For more details, see aiomailru Documentation.

Client application

Use ClientSession when REST API is needed in:

• a client component of the client-server application
• a standalone mobile/desktop application

i.e. when you embed your app's info (private key) in publicly available code.

from aiomailru import ClientSession, API

session = ClientSession(app_id, private_key, access_token, uid)
api = API(session)

events = await api.stream.get()
friends = await api.friends.getOnline()

Use access_token and uid that were received after authorization. For more details, see authorization instruction.

Server application

Use ServerSession when REST API is needed in:

• a server component of the client-server application
• requests from your servers

from aiomailru import ServerSession, API

session = ServerSession(app_id, secret_key, access_token)
api = API(session)

events = await api.stream.get()
friends = await api.friends.getOnline()

Use access_token that was received after authorization. For more details, see authorization instruction.

Installation

$ pip install aiomailru

or

$ python setup.py install

Supported Python Versions

Python 3.5, 3.6, 3.7 and 3.8 are supported.

Test

Run all tests.

$ python setup.py test

Run tests with PyTest.

$ python -m pytest [-k TEST_NAME]

License

aiomailru is released under the BSD 2-Clause License.