Pydaymet

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

New Features
~~~~~~~~~~~~
- Refactor the ``show_versions`` function to improve performance and
print the output in a nicer table-like format.

Bug Fixes
~~~~~~~~~
- Fix a bug in ``get_bygeom`` where for small requests that lead to
a single download URL, the function failed.

Internal Changes
~~~~~~~~~~~~~~~~
- Skip 0.13.9 version so the minor version of all HyRiver packages become
the same.

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

Internal Changes
~~~~~~~~~~~~~~~~
- More robust handling of getting large gridded data. Instead of caching the requests/
responses, directly store the responses as NetCDF files to a cache folder using
``pygeoogc.streaming_download`` and ultimately read them using ``xarray.open_mfdataset``.
This should make the ``bygeom`` function even faster than before and also make it
possible to make large requests without having to worry about running out of memory
(:issue_day:`59`).
- Modify the codebase based on `Refurb <https://github.com/dosisod/refurb>`__
suggestions.

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

**Since the release of Daymet v4 R1 on November 2022, the URL of Daymet's server has
been changed. Therefore, only PyDaymet v0.13.7+ is going to work, and previous
versions will not work anymore.**

New Features
~~~~~~~~~~~~
- Add support for passing a list of coordinates to the ``get_bycoords`` function.
Also, optionally, you can pass a list of IDs for the input coordinates that
will be used as ``keys`` for the returned ``pandas.DataFrame`` or a dimension
called ``id`` in the returned ``xarray.Dataset`` if ``to_xarray`` is enabled.
- Add a new argument called ``to_xarray`` to the ``get_bycoords`` function for
returning the results as a ``xarray.Dataset`` instead of a ``pandas.DataFrame``.
When set to ``True``, the returned ``xarray.Dataset`` will have three attributes
called ``units``, ``description``, and ``long_name``.
- The ``date`` argument of both ``get_bycoords`` and ``by_geom`` functions
now accepts ``range``-type objects for passing years, e.g., ``range(2000-2005)``.

.. code-block:: python

import pydaymet as daymet

coords = [(-94.986, 29.973), (-95.478, 30.134)]
idx = ["P1", "P2"]
clm = daymet.get_bycoords(coords, range(2000, 2021), coords_id=idx, to_xarray=True)

Internal Changes
~~~~~~~~~~~~~~~~
- Use ``pyupgrade`` package to update the type hinting annotations
to Python 3.10 style.
- Fix the Daymet server URL.

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

Internal Changes
~~~~~~~~~~~~~~~~
- Add the missing PyPi classifiers for the supported Python versions.

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

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

Internal Changes
~~~~~~~~~~~~~~~~
- Bump the minimum versions of ``pygeoogc``, ``pygeoutils``, ``py3dep`` to 0.13.5 and
that of ``async-retriever`` to 0.3.5.

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

Bug Fixes
~~~~~~~~~
- Fix a bug in ``PETGridded`` where the wrong data type was being set for
``pet`` and ``elevation`` variables.
- When initializing ``PETGridded``, only chunk the elevation if the input
climate data is chunked.