Skip to main content

Provides user-friendly HTTP client with clean objects.

Project description

made-with-python Build Status Coverage Status Code style: black Checked with pylint Checked with flake8 Checked with pydocstyle Checked with mypy License EO principles respected here PyPI version shields.io PyPI pyversions Downloads CodeFactor

uRequest

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

Basically, it is a wrapper over requests python library. For asynchronous version please check aiorequest package.

Tools

Usage

Installation

Please run following script to obtain latest package from PYPI:

pip install urequest
✨ 🍰 

Quick start

>>> from urequest.session import Session, HttpSession
>>> from urequest.response import Response
>>> from urequest.url import HttpUrl
>>>
>>> session: Session
>>> with HttpSession() as session:
...     response: Response = session.get(HttpUrl(host="xkcd.com", path="info.0.json"))
...     response.is_ok()
...     response.as_json()
...
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 git@github.com:vyahello/urequest.git
python setup.py install

Or using specific release:

pip install git+https://github.com/vyahello/urequest@0.0.1

Local debug

git clone git@github.com:aiopymake/aiorequest.git
>>> import urequest
>>> urequest.__doc__
'Provides user-friendly HTTP client with clean objects.'

⬆ back to top

Development notes

CI

Project has Travis CI integration using .travis.yml file thus code analysis (black, pylint, flake8, mypy, pydocstyle) 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:

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

urequest-0.0.6.tar.gz (10.1 kB view hashes)

Uploaded Source

Built Distribution

urequest-0.0.6-py3-none-any.whl (7.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page