network.py

"""Network requests module."""

import typing
from json.decoder import JSONDecodeError

import click
import requests
from requests.exceptions import RequestException


def _get_json(url: typing.Text, timeout: float) -> typing.Dict:
    """Retrieve JSON payload with the HTTP GET method.

    :raises click.ClickException
    :return A JSON response
    """
    try:
        return requests.get(url, timeout=timeout).json()
    except (RequestException, JSONDecodeError):
        message = 'Unable to retrieve {}'.format(url)
        raise click.ClickException(message)