Hydrosignatures

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

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.

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

New Features
~~~~~~~~~~~~
- Add ``baseflow_recession`` function for computing the master
recession curve and baseflow recession constant following
Posavec et al. (2006).

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
~~~~~~~~~~~~
- Add a new function called ``flashiness_index`` for computing the
flashiness index of a daily streamflow time series following
Baker et al. (2004).

Breaking Changes
~~~~~~~~~~~~~~~~
- Improve function naming convention by removing the ``compute_``
prefix from all functions and spelling out the full name of the
function. For example, ``compute_fdc_slope`` and ``compute_ai`` are now
``flow_duration_curve_slope`` and ``aridity_index``, respectively.

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

New Features
~~~~~~~~~~~~
- Add an option to ``compute_mean_monthly`` for specifying whether
the input data unit is in mm/day or m3/s. If m3/s, then the
monthly values are computed by taking the mean of the
daily values for each month. If mm/day, then the monthly
values are computed by taking the sum of the daily values for
each month.

-------------------
From release 0.15 onward, all minor versions of HyRiver packages
will be pinned. This ensures that previous minor versions of HyRiver
packages cannot be installed with later minor releases. For example,
if you have ``py3dep==0.14.x`` installed, you cannot install
``pydaymet==0.15.x``. This is to ensure that the API is
consistent across all minor versions.

Internal Changes
~~~~~~~~~~~~~~~~
- Explicitly use ``nopython`` mode in ``numba``-decorated functions
to avoid deprecation warnings.