Add public typing.py module (#10215)

* created plain new module

* Drafted a first version of the typing.py module

* Removed TYPPE_CHECKING. Also removed DataArray, Dataset

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Added typing module as new feature for next version releas

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Deepak Cherian <[email protected]>

Author: 3 people

doc/whats-new.rst

@@ -31,6 +31,9 @@ New Features
 
 - Added `scipy-stubs <https://github.com/scipy/scipy-stubs>`_ to the ``xarray[types]`` dependencies.
   By `Joren Hammudoglu <https://github.com/jorenham>`_.
+- Added a :mod:`xarray.typing` module  to expose selected public types for use in downstream libraries and static type checking.
+  (:issue:`10179`, :pull:`10215`).
+  By `Michele Guerreri <https://github.com/micguerr-bopen>`_.
 - Improved compatibility with OPeNDAP DAP4 data model for backend engine ``pydap``. This
   includes ``datatree`` support, and removing slashes from dimension names. By
   `Miguel Jimenez-Urias <https://github.com/Mikejmnez>`_.

xarray/typing.py

@@ -0,0 +1,23 @@
+"""
+Public typing utilities for use by external libraries.
+"""
+
+from xarray.computation.rolling import (
+    DataArrayCoarsen,
+    DataArrayRolling,
+    DatasetRolling,
+)
+from xarray.computation.weighted import DataArrayWeighted, DatasetWeighted, Weighted
+from xarray.core.groupby import DataArrayGroupBy
+from xarray.core.resample import DataArrayResample
+
+__all__ = [
+    "DataArrayCoarsen",
+    "DataArrayGroupBy",
+    "DataArrayResample",
+    "DataArrayRolling",
+    "DataArrayWeighted",
+    "DatasetRolling",
+    "DatasetWeighted",
+    "Weighted",
+]