aiorequest 0.0.1

Package provides asynchronous user-friendly HTTP client with clean objects.

aioRequest

Provides asynchronous user-friendly micro HTTP client with nothing but clean objects.

Basically, it is a wrapper over requests python library with async/await approach. Represents asynchronous version of urequest package.

Tools

• python 3.7, 3.8
• asyncio library
• requests library
• travis CI
• code analysis
  • pytest
  • black
  • mypy
  • pylint
  • flake8
  • pydocstyle
  • interrogate

Usage

Installation

pip install aiorequest
✨ 🍰 ✨

Quick start

>>> import asyncio
>>> from aiorequest.sessions import Session, HttpSession
>>> from aiorequest.responses import Response
>>> from aiorequest.urls import HttpUrl
>>>
>>>
>>> async def aioresponse() -> None:
...     session: Session
...     async with HttpSession() as session:
...         response: Response = await session.get(HttpUrl(host="xkcd.com", path="info.0.json"))
...         print(await response.is_ok())
...         print(await response.as_json())
...
>>>
>>> asyncio.run(aioresponse())
True
{
    "month": "3",
    "num": 2284,
    "link": "",
    "year": "2020",
    "news": "",
    "safe_title": "Sabotage",
    "transcript": "",
    "alt": "So excited to see everyone after my cruise home from the World Handshake Championships!",
    "img": "https://imgs.xkcd.com/comics/sabotage.png",
    "title": "Sabotage",
    "day": "23",
}

Source code

git clone [e-mail]:aiopymake/aiorequest.git
python setup.py install

Or using specific release:

pip install git+https://github.com/aiopymake/aiorequest@0.0.1

Local debug

git clone [e-mail]:aiopymake/aiorequest.git

>>> import aiorequest
>>> aiorequest.__doc__
'Package provides asynchronous user-friendly HTTP client with clean objects.'

⬆ back to top

Development notes

Testing

Generally, pytest tool is used to organize testing procedure.

Please follow next command to run unittests:

pytest

CI

Project has Travis CI integration using .travis.yml file thus code analysis (black, pylint, flake8, mypy, pydocstyle and interrogate) and unittests (pytest) will be run automatically after every made change to the repository.

To be able to run code analysis, please execute command below:

./analyse-source-code.sh

Release notes

Please check changelog file to get more details about actual versions and it's release notes.

Meta

Author – Volodymyr Yahello. Please check AUTHORS file for all contributors.

Distributed under the MIT license. See LICENSE for more information.

You can reach out me at:

• [e-mail]
• https://github.com/vyahello
• https://www.linkedin.com/in/volodymyr-yahello-821746127

Contributing

1. clone the repository
2. configure Git for the first time after cloning with your name and email
3. pip install -r requirements.txt to install all project dependencies
4. pip install -r requirements-dev.txt to install all development project dependencies

⬆ back to top