Async-retriever

------------------

Internal Changes
~~~~~~~~~~~~~~~~
- Add the missing PyPi classifiers for the supported Python versions.
- Release the package as both ``async_retriever`` and ``async-retriever``
on PyPi and Conda-forge.

------------------

Breaking Changes
~~~~~~~~~~~~~~~~
- Append "Error" to all exception classes for conforming to PEP-8 naming conventions.

Internal Changes
~~~~~~~~~~~~~~~~
- Bump minimum version of ``aiohttp-client-cache`` to 0.7.3 since the ``attrs`` version
issue has been addressed.

------------------

New Features
~~~~~~~~~~~~
- Add a new function, ``stream_write``, for writing a response to a file as it's being
retrieved. This could be very useful for downloading large files. This function does
not use persistent caching.

------------------

Breaking Changes
~~~~~~~~~~~~~~~~
- Set the minimum supported version of Python to 3.8 since many of the
dependencies such as ``xarray``, ``pandas``, ``rioxarray`` have dropped support
for Python 3.7.

Internal Changes
~~~~~~~~~~~~~~~~
- Use `micromamba <https://github.com/marketplace/actions/provision-with-micromamba>`__
for running tests
and use `nox <https://github.com/marketplace/actions/setup-nox>`__
for linting in CI.

------------------

New Features
~~~~~~~~~~~~
- Add support for setting caching-related arguments using three environmental variables:

* ``HYRIVER_CACHE_NAME``: Path to the caching SQLite database.
* ``HYRIVER_CACHE_EXPIRE``: Expiration time for cached requests in seconds.
* ``HYRIVER_CACHE_DISABLE``: Disable reading/writing from/to the cache file.

You can do this like so:

.. code-block:: python

import os

os.environ["HYRIVER_CACHE_NAME"] = "path/to/file.sqlite"
os.environ["HYRIVER_CACHE_EXPIRE"] = "3600"
os.environ["HYRIVER_CACHE_DISABLE"] = "true"

Internal Changes
~~~~~~~~~~~~~~~~
- Include the URL of a failed request in its exception error message.

------------------

New Features
~~~~~~~~~~~~
- Add three new functions called ``retrieve_text``, ``retrieve_json``, and
``retrieve_binary``. These functions are derived from the ``retrieve`` function
and are used to retrieve the text, JSON, or binary content of a response. They
are meant to help with type hinting since they have only one return type instead
of the three different return types that the ``retrieve`` function has.

Internal Changes
~~~~~~~~~~~~~~~~
- Move all private functions to a new module called ``utils``. This makes the code-base
more readable and easier to maintain.