fix: support older matplotlib (#455)

* fix: support older matplotlib

* fix: apply to all styles

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

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

* chore: add _compat.py

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

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

* chore: ignore attr-defined

---------

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

src/mplhep/_compat.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+import matplotlib
+from packaging.version import parse as parse_version
+
+if parse_version(matplotlib.__version__) < parse_version("3.8.0"):
+    from matplotlib import docstring  # type: ignore[attr-defined]
+else:
+    from matplotlib import _docstring as docstring  # type: ignore[attr-defined]
+
+
+__all__ = ("docstring",)

src/mplhep/alice.py

@@ -2,11 +2,10 @@
 
 import inspect
 
-from matplotlib import _docstring as docstring
-
 import mplhep
 
 from . import label as label_base
+from ._compat import docstring
 from .label import lumitext
 
 # Log styles

src/mplhep/atlas.py

@@ -7,6 +7,7 @@
 import mplhep
 
 from . import label as label_base
+from ._compat import docstring
 from .label import lumitext
 
 # Log styles
@@ -15,7 +16,7 @@
 __all__ = ("style", "lumitext")
 
 
-@mpl._docstring.copy(label_base.exp_text)
+@docstring.copy(label_base.exp_text)
 def text(text="", **kwargs):
     for key, value in dict(mplhep.rcParams.text._get_kwargs()).items():
         if (
@@ -29,7 +30,7 @@ def text(text="", **kwargs):
     return label_base.exp_text("ATLAS", text=text, **kwargs)
 
 
-@mpl._docstring.copy(label_base.exp_label)
+@docstring.copy(label_base.exp_label)
 def label(label=None, **kwargs):
     for key, value in dict(mplhep.rcParams.label._get_kwargs()).items():
         if (

src/mplhep/cms.py

@@ -2,11 +2,10 @@
 
 import inspect
 
-from matplotlib import _docstring as docstring
-
 import mplhep
 
 from . import label as label_base
+from ._compat import docstring
 from .label import lumitext
 
 # Log styles

src/mplhep/lhcb.py

@@ -20,11 +20,10 @@
 
 import inspect
 
-from matplotlib import _docstring as docstring
-
 import mplhep
 from mplhep import label as label_base
 
+from ._compat import docstring
 from .label import lumitext
 from .styles import lhcb as style