Pydaymet

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

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.

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

Bug Fixes
~~~~~~~~~
- In ``get_bystac`` function, only three variables were being returned regardless
of the input variables. This version fixes this issue by returning all the
requested variables.

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.

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

New Features
~~~~~~~~~~~~
- Add a new function for getting Daymet data from Microsoft's
`Planetary Computer <https://planetarycomputer.microsoft.com/dataset/group/daymet>`__
called ``get_bystac``. Although this function can be much faster than
``get_bygeom``, currently, it gives access to Daymet v4.2 from 1980
to 2020. As discussed
`here <https://github.com/microsoft/PlanetaryComputer/discussions/311>`__,
the Daymet v4.5 will be added to the Planetary Computer in the future.
Until then, for accessing the latest version of Daymet (v4.5) you need to
use ``get_bygeom``. Additionally, this function requires ``fsspec``,
``dask``, ``zarr``, and ``pystac-client`` packages.
- Make ``separate_snow`` a standalone, pure, and public function.
Now, it can be used like so: ``pydaymet.separate_snow``.
- Change the length unit from ``km`` to ``m`` for ``get_bygeom``.

Internal Changes
~~~~~~~~~~~~~~~~
- The ``potential_et`` function uses ``py3dep.add_elevation`` function
but the CRS info gets lost in the process for the new ``elevation``
variable. This version fixes this issue by adding the CRS info to
the ``elevation`` variable.
- Change ``PetParams`` class from ``NamedTuple`` to ``dataclass``
for better performance and consistency. Now, it has a new
``classmethod`` called ``fields`` that returns a list of
the four fields of the class.

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

Breaking Changes
~~~~~~~~~~~~~~~~
- Bump min version of ``shapely`` to 2.

Internal Changes
~~~~~~~~~~~~~~~~
- Use the new ``py3dep.add_elevation`` API.

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

Internal Changes
~~~~~~~~~~~~~~~~
- Remove dependency on ``dask``.