Py3dep

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

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
~~~~~~~~~~~~~~~~
- A release without change to match the version of other HyRiver packages.

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

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.

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

Bug Fixes
~~~~~~~~~
- In ``check_3dep_availability`` function, fix a bug where the function fails to
return a valid response when the web service is down.

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

Bug Fixes
~~~~~~~~~
- In ``add_elvation`` function, fix a bug where the function fails to add
elevation to a ``xarray.Dataset`` with x and y dims not being ``x`` and ``y``.

Internal Changes
~~~~~~~~~~~~~~~~
- Refactor ``fill_depressions`` function by porting the code from ``pyflwdir``
and improve its performance and also now, it directly support ``xarray.DataArray``.
Now, ``pyflwdir`` is not an optional dependency anymore. You can install ``numba``
to improve the performance of the function.

Breaking Changes
~~~~~~~~~~~~~~~~
- The AirMap service has been deprecated and removed from the package. The
``elevation_bycoords`` function now only supports the the National Map and
the 3DEP services.

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

Bug Fixes
~~~~~~~~~
- In the ``check_3dep_availability`` function when the web service is down
the function raises a ``TypeError`` instead of setting the value of the
failed resolution to ``Failed``. This is fixed now. (:issue_3dep:`66`).

Internal Changes
~~~~~~~~~~~~~~~~
- Simplify the logic of adding elevation to a Dataset in the
``add_elevation`` function to avoid modifying CRS of the input
Dataset.