make modules private (#141)

* make modules private

* fix import

* changelog

Author: mathause

CHANGELOG.md

@@ -15,6 +15,8 @@
   | seaborn     | 0.12   | 0.13    |
   | xarray      | 2022.12| 2023.9  |
 
+- The modules ``cartopy_utils``, ``colormaps``, ``map_layout``, ``mpl``, and ``xrcompat`` were renamed (added a leading underscore) to indicate that they are private ([#141](https://github.com/mathause/mplotutils/pull/141)).
+
 ### Enhancements
 
 - Added convenience functions to draw hatches and add stippling:

mplotutils/__init__.py

@@ -2,11 +2,8 @@
 
 from importlib.metadata import version as _get_version
 
-from mplotutils import _colorbar, cartopy_utils, colormaps
-from mplotutils._colorbar import colorbar
-from mplotutils._hatch import hatch, hatch_map, hatch_map_global
-from mplotutils._savefig import autodraw
-from mplotutils.cartopy_utils import (
+from mplotutils import _cartopy_utils, _colorbar, _colormaps
+from mplotutils._cartopy_utils import (
     cyclic_dataarray,
     sample_data_map,
     sample_dataarray,
@@ -15,20 +12,23 @@
     ylabel_map,
     yticklabels,
 )
-from mplotutils.colormaps import from_levels_and_cmap
-from mplotutils.map_layout import set_map_layout
-from mplotutils.mpl import _get_renderer
-from mplotutils.xrcompat import infer_interval_breaks
+from mplotutils._colorbar import colorbar
+from mplotutils._colormaps import from_levels_and_cmap
+from mplotutils._hatch import hatch, hatch_map, hatch_map_global
+from mplotutils._map_layout import set_map_layout
+from mplotutils._mpl import _get_renderer
+from mplotutils._savefig import autodraw
+from mplotutils._xrcompat import infer_interval_breaks
 
 autodraw(True)
 
 __all__ = [
     "_colorbar",
     "_get_renderer",
     "autodraw",
-    "cartopy_utils",
+    "_cartopy_utils",
     "colorbar",
-    "colormaps",
+    "_colormaps",
     "cyclic_dataarray",
     "from_levels_and_cmap",
     "hatch_map_global",

mplotutils/cartopy_utils.py renamed to mplotutils/_cartopy_utils.py

@@ -6,8 +6,8 @@
 import shapely.geometry
 from cartopy.mpl.gridliner import LATITUDE_FORMATTER, LONGITUDE_FORMATTER
 
+from mplotutils._colormaps import _get_label_attr
 from mplotutils._deprecate import _deprecate_positional_args
-from mplotutils.colormaps import _get_label_attr
 
 
 def sample_data_map(nlons, nlats):

mplotutils/colormaps.py renamed to mplotutils/_colormaps.py

@@ -10,7 +10,7 @@
 _HATCHES_PER_FIGURE = {}
 
 
-from mplotutils.mpl import _maybe_gca
+from mplotutils._mpl import _maybe_gca
 
 
 def hatch(da, hatch, *, ax=None, label=None, linewidth=None, color="0.1"):

mplotutils/_hatch.py

@@ -6,7 +6,7 @@
 from mpl_toolkits.axes_grid1 import AxesGrid
 
 from mplotutils._deprecate import _deprecate_positional_args
-from mplotutils.mpl import _get_renderer
+from mplotutils._mpl import _get_renderer
 
 
 @_deprecate_positional_args("0.3")

mplotutils/map_layout.py renamed to mplotutils/_map_layout.py

@@ -2,7 +2,7 @@
 import pytest
 from numpy.testing import assert_array_equal  # noqa: F401
 
-from mplotutils.xrcompat import _infer_interval_breaks, infer_interval_breaks
+from mplotutils._xrcompat import _infer_interval_breaks, infer_interval_breaks
 
 
 def test_infer_interval_breaks_warns():

mplotutils/mpl.py renamed to mplotutils/_mpl.py

@@ -1,7 +1,7 @@
 import matplotlib as mpl
 import matplotlib.pyplot as plt
 
-from mplotutils.mpl import _maybe_gca
+from mplotutils._mpl import _maybe_gca
 
 from . import figure_context