expose setup_registry (#89)

* add a __all__

* expose setup_registry

* fix some links

* update whats-new.rst

Author: keewis

docs/api.rst

@@ -6,6 +6,7 @@ This page contains a auto-generated summary of ``pint-xarray``'s API.
    :toctree: generated/
 
    pint_xarray.unit_registry
+   pint_xarray.setup_registry
 
 Dataset
 -------

docs/whats-new.rst

@@ -42,6 +42,8 @@ What's new
   By `Justus Magin <https://github.com/keewis>`_.
 - implement :py:meth:`Dataset.pint.interpolate_na` and :py:meth:`DataArray.pint.interpolate_na` (:pull:`82`).
   By `Justus Magin <https://github.com/keewis>`_.
+- expose :py:func:`pint_xarray.accessors.setup_registry` as public API (:pull:`89`)
+  By `Justus Magin <https://github.com/keewis>`_.
 
 v0.1 (October 26 2020)
 ----------------------

pint_xarray/__init__.py

@@ -5,10 +5,9 @@
 
 import pint
 
-from . import testing  # noqa: F401
-from . import formatting
-from .accessors import PintDataArrayAccessor, PintDatasetAccessor  # noqa: F401
-from .accessors import default_registry as unit_registry  # noqa: F401
+from . import accessors, formatting, testing  # noqa: F401
+from .accessors import default_registry as unit_registry
+from .accessors import setup_registry
 
 try:
     __version__ = version("pint-xarray")
@@ -19,3 +18,10 @@
 
 
 pint.Quantity._repr_inline_ = formatting.inline_repr
+
+
+__all__ = [
+    "testing",
+    "unit_registry",
+    "setup_registry",
+]

pint_xarray/accessors.py

@@ -1033,7 +1033,8 @@ def interpolate_na(
     ):
         """unit-aware version of interpolate_na
 
-        Like :py:meth:`DataArray.interpolate_na` but without stripping the units on data or coordinates.
+        Like :py:meth:`xarray.DataArray.interpolate_na` but without stripping the units
+        on data or coordinates.
 
         .. note::
             ``max_gap`` is not supported, yet, and will be passed through to
@@ -1794,7 +1795,8 @@ def interpolate_na(
     ):
         """unit-aware version of interpolate_na
 
-        Like :py:meth:`Dataset.interpolate_na` but without stripping the units on data or coordinates.
+        Like :py:meth:`xarray.Dataset.interpolate_na` but without stripping the units on
+        data or coordinates.
 
         .. note::
             ``max_gap`` is not supported, yet, and will be passed through to