Pygeoogc

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

New Features
~~~~~~~~~~~~
- Make ``match_crs`` less strict in terms of the input geometry type
being ``tuple`` or ``list`` by relying on ``shapely`` and
``contextlib.suppress``. So, now users can pass any combination of
``list`` or ``tuple`` as coordinates or bounding box.
- More robust handling of inputs and outputs in ``streaming_download``.
Now, only if input is ``str`` the function returns a single ``Path`` object.
Previously if there was only one URL, whether ``list`` of length one or
``str``, the output was a single ``Path``, which could have had unintended
consequences.

Bug Fixes
~~~~~~~~~
- In ``WFS`` when some layers have missing schema info, the class failed
to initialize. This release fixes this issue by ignoring layers with
missing schema info and asks the user to pass a sort parameter instead
of trying to automatically find a sort parameter. This fix also improves
the performance of this function by making fewer web requests.

Internal Changes
~~~~~~~~~~~~~~~~
- Fully migrate ``setup.cfg`` and ``setup.py`` to ``pyproject.toml``.
- Convert relative imports to absolute with ``absolufy-imports``.
- Sync all patch versions of HyRiver packages to x.x.12.

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

Bug Fixes
~~~~~~~~~
- Remove all Python 3.9 type-annotation-style in the codebase except for
function signatures to ensure compatibility with Python 3.8.
(:issue_ogc:`57`, :pull_ogc:`58`). Thanks to
`Tim Cera <https://github.com/timcera>`__ for reporting and fixing the
issue.

Internal Changes
~~~~~~~~~~~~~~~~
- Use ``pyright`` for type checking instead of ``mypy`` since it is faster
and more accurate. Also, fix all the type errors reported by ``pyright``.
- Improve code quality by addressing issues raised by
`DeepSource <https://deepsource.io/gh/hyriver/pygeoogc>`__.

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

Bug Fixes
~~~~~~~~~
- Add the missing annotation import to the ``cache_keys`` to ensure
Python 3.8 and 3.9 work with Python 3.10 style type hinting.

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

New Features
~~~~~~~~~~~~
- Add a new property to ``WFS`` class called ``schema`` that contains
information about column names and their types for all layers. It also
the geometry type and its name for each layer.
- Automatically determine the geometry keyword that should be passed to
``WFS.getfeature_bygeom`` using the new ``schema`` property of ``WFS``.
- Add support for disabling SSL verification to ``RetrySession`` via ``ssl``
parameter.
- Add support for streaming responses to ``RetrySession`` via ``stream``
parameter to ``get`` and ``post`` methods.
- Add support for closing the session to ``RetrySession`` via ``close``
method.
- Add support for passing ``params``, ``data``, and ``json`` to ``RetrySession``
via ``get`` and ``post`` methods. Previously, keyword ``payload`` was used for
``params`` in ``get`` and ``data`` in ``post``. Now, ``params`` and ``data``
can also be passed as keyword arguments to these methods.
- Add a new function called ``streaming_download`` for downloading large
files in parallel and in chunks.

Bug Fixes
~~~~~~~~~
- Fix an issue in ``WFS`` class where number of requested features
exceeds the maximum number of features allowed by the server, but
only a portion of the features are returned. This release addresses
this issue by first getting only the number of features and then
requesting the features in chunks of features IDs based on the
maximum number of features allowed by the server.

Internal Changes
~~~~~~~~~~~~~~~~
- Drop support for WFS version 1.0.0 since it does not support paging.
- Modify the codebase based on `Refurb <https://github.com/dosisod/refurb>`__
suggestions.


Bug Fixes
~~~~~~~~~
- Fix the warning message in ``ArcGISRESTFul`` where wrong number of missing
feature IDs were being reported.

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

New Features
~~~~~~~~~~~~
- Add a new method to ``RetrySession`` for getting the request head called
``RetrySession.head``. This is useful for getting the headers of a request
without having to make a full request which is useful for getting the
``Content-Length`` header for example, i.e., download size.

Bug Fixes
~~~~~~~~~
- Fix an issue in the decompose function, ``utils.bbox_decompose``, where the generated
bounding boxes might overlap in some cases. A new approach has been implemented based
on finding the number of required bounding boxes from max allowable no. of pixels and
total requested pixels without changing the input bounding box projection. This ensures
that the decomposed bounding boxes are not overlapping so ``xarray.open_mfdataset``
can be used without any issues.

Internal Changes
~~~~~~~~~~~~~~~~
- In the ``utils.match_crs`` function, don't perform any projection if the source
target CRS are the same.
- Improve type hints for CRS-related arguments of all functions by including string,
integer, and ``pyproj.CRS`` types.
- Add a new class method to ``WMSBase`` and ``WFSBase`` classes called
``get_service_options`` for retrieving the available layers, output formats, and
CRSs for a given service. Here's an example:
- Use ``pyupgrade`` package to update the type hinting annotations
to Python 3.10 style.

.. code-block:: python

from pygeoogc.core import WMSBase

url = "https://elevation.nationalmap.gov/arcgis/services/3DEPElevation/ImageServer/WMSServer"
wms = WMSBase(url, validation=False)
wms.get_service_options()
print(wms.available_layer)

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

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