.. image:: https://codecov.io/gh/night-crawler/async-fetcher/branch/master/graph/badge.svg
:target: https://codecov.io/gh/night-crawler/async-fetcher
.. image:: https://travis-ci.org/night-crawler/async-fetcher.svg?branch=master
:target: https://travis-ci.org/night-crawler/async-fetcher
.. image:: https://img.shields.io/pypi/v/async-fetcher.svg
:target: https://pypi.python.org/pypi/async-fetcher
.. image:: https://img.shields.io/pypi/wheel/async-fetcher.svg
:alt: PyPI Wheel
:target: https://pypi.python.org/pypi/async-fetcher
.. image:: https://requires.io/github/night-crawler/async-fetcher/requirements.svg?branch=master
:target: https://requires.io/github/night-crawler/async-fetcher/requirements/?branch=master
:alt: Requirements Status
.. image:: https://img.shields.io/pypi/pyversions/async-fetcher.svg
:alt: Supported versions
:target: https://pypi.python.org/pypi/async-fetcher
.. image:: https://img.shields.io/pypi/implementation/async-fetcher.svg
:alt: Supported implementations
:target: https://pypi.python.org/pypi/async-fetcher
Installation
------------
.. code:: bash
pip install async-fetcher
# or
pip install -e git+https://github.com/night-crawler/async-fetcher.git@#egg=async-fetcher
Sample
------
.. code:: python
af = AsyncFetch({
'first': AsyncFetch.mk_task(build_url('request-info')),
'second': AsyncFetch.mk_task('http://example.com/'),
'fail': AsyncFetch.mk_task(build_url('404'))
})
responses = af.go()
``mk_task`` static method can take this arguments:
.. code:: python
:param fail_silently: bool, do not raise exceptions, default is False;
for test purpose, do not use in production
:param num_retries: int, *optional*, default is -1; -1 - no retries; 0 - use AsyncFetch.num_retries
:param autodetect_content_type: if no `content-type` header was specified, set `content-type` as
`application/json` for dict, and `text/html` otherwise; default is True
:param json_encoder: JSONEncoder, *optional*, JSON encoder for data serialization
tries to use DRF's encoder, or default JSONEncoder from json package; default is JSONEncoder
:param url: str, *required*, url address
:param api_key: str, optional API key passed into HEADERS dict
:param data: dict, *optional*, request data. Default is None,
:param method: str, *optional*, HTTP request method. Default is True.
:param headers: dict, *optional*, optional HTTP headers
:param response_type: str, *optional*, HTTP response type
(in fact it's just aiohttp's method name, i.e. text, or json); default is 'json'
:param language_code: str, set `accept-language` header
:param timeout: float, *optional*, time to wait for response in seconds before TimeoutError
:param query: dict, *optional*, url get arguments
:param do_not_wait: bool, *optional*, fail silently with no retries and empty resultset
.. code:: python
af0 = AsyncFetch({})
tcp_connector = af0.get_tcp_connector()
af1 = AsyncFetch({
'1': AsyncFetch.mk_task(build_url('request-info')),
'2': AsyncFetch.mk_task(build_url('request-info')),
}, tcp_connector=tcp_connector)
responses = af1.go()
