Async-retriever

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

Internal Changes
~~~~~~~~~~~~~~~~
- Replace ``max_connection`` argument in all ``retrieve*`` functions
with ``limit_per_host``. This uses the ``aiohttp`` argument
``limit_per_host`` to limit the number of connections per host which
prevents the server from being overwhelmed with too many connections.
The default value is set to 5.
- Add ``aiofiles`` as a new dependency for writing responses to a file
in the ``stream_write`` function. This should speed up the writing process
and make it more efficient.

Bug Fixes
~~~~~~~~~
- Fix an issue with running the library inside IPython terminal.
(:issue_async:`50`)

Breaking Changes
~~~~~~~~~~~~~~~~
- Move ``stream_write`` function to its own module called ``streaming``.
This is to separate the streaming functionality from the main module
and make it easier to maintain.
- Simplify the ``stream_write`` function to only accept a list of URLs
and a directory path to save the files. It no longer accepts passing
keyword arguments and assumes that the user has added the necessary
arguments to the URLs itself and is encoded correctly. Additionally,
the chunk size by default is set to 1 MB.

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

Bug Fixes
~~~~~~~~~
- Bump the minimum version of ``aiohttp-client-cache>=0.12.3`` to fix an
issue with the latest version of ``aiohttp``. (:issue_async:`48`)

Breaking Changes
~~~~~~~~~~~~~~~~
- Drop support for Python 3.8 since its end-of-life date is October 2024.
- Remove all exceptions from the main module and raise them from the
``exceptions`` module. This is to declutter the public API and make
it easier to maintain.

Internal Changes
~~~~~~~~~~~~~~~~
- Make ``nest_asyncio`` a required dependency since most users will need
it to run the package in Jupyter notebooks.

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

Internal Changes
~~~~~~~~~~~~~~~~
- Drop support for Python 3.8 since its end-of-life date is October 2024.

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

Internal Changes
~~~~~~~~~~~~~~~~
- Add the ``exceptions`` module to the high-level API to declutter
the main module. In the future, all exceptions will be raised from
this module and not from the main module. For now, the exceptions
are raised from both modules for backward compatibility.
- Switch to using the ``src`` layout instead of the ``flat`` layout
for the package structure. This is to make the package more
maintainable and to avoid any potential conflicts with other
packages.
- Add artifact attestations to the release workflow.

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

New Features
~~~~~~~~~~~~
- When a request fails with encoding error, it gets retried with the
encoding set to ``latine1``. This is to handle cases where the server
sends a response with an encoding that is not supported by the client.
(:issue_hydro:`120`)

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

New Features
~~~~~~~~~~~~
- Add a new environmental variable called ``"HYRIVER_SSL_CERT"``
for setting the path to a SSL certificate file other than the
default one. You can do this like so:

.. code-block:: python

import os

os.environ["HYRIVER_SSL_CERT"] = "path/to/file.pem"