[pre-commit.ci] pre-commit autoupdate

.pre-commit-config.yaml

@@ -11,6 +11,6 @@ ci:
 
 repos:
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.12.0
+    rev: 26.1.0
     hooks:
       - id: black

docs/sphinxext/custom_roles.py

@@ -2,6 +2,7 @@
 """
 Custom :rc: and :rcraw: roles for rc settings.
 """
+
 import os
 
 from docutils import nodes

ultraplot/__init__.py

@@ -2,6 +2,7 @@
 """
 A succinct matplotlib wrapper for making beautiful, publication-quality graphics.
 """
+
 from __future__ import annotations
 
 import sys

ultraplot/_lazy.py

@@ -2,6 +2,7 @@
 """
 Helpers for lazy attribute loading in :mod:`ultraplot`.
 """
+
 from __future__ import annotations
 
 import ast

ultraplot/axes/__init__.py

@@ -2,6 +2,7 @@
 """
 The various axes classes used throughout ultraplot.
 """
+
 import matplotlib.projections as mproj
 
 from ..internals import context

ultraplot/axes/base.py

@@ -3,6 +3,7 @@
 The first-level axes subclass used for all ultraplot figures.
 Implements basic shared functionality.
 """
+
 import copy
 import inspect
 import re
@@ -4191,8 +4192,8 @@ def _measure_text_overhang_axes(
         renderer = axes.figure._get_renderer()
         bbox = text.get_window_extent(renderer=renderer)
         inv = axes.transAxes.inverted()
-        (x0, y0) = inv.transform((bbox.x0, bbox.y0))
-        (x1, y1) = inv.transform((bbox.x1, bbox.y1))
+        x0, y0 = inv.transform((bbox.x0, bbox.y0))
+        x1, y1 = inv.transform((bbox.x1, bbox.y1))
     except Exception:
         return None
     left = max(0.0, -x0)
@@ -4218,8 +4219,8 @@ def _measure_ticklabel_overhang_axes(
         if not label.get_visible() or not label.get_text():
             continue
         bbox = label.get_window_extent(renderer=renderer)
-        (x0, y0) = inv.transform((bbox.x0, bbox.y0))
-        (x1, y1) = inv.transform((bbox.x1, bbox.y1))
+        x0, y0 = inv.transform((bbox.x0, bbox.y0))
+        x1, y1 = inv.transform((bbox.x1, bbox.y1))
         min_x = min(min_x, x0)
         max_x = max(max_x, x1)
         min_y = min(min_y, y0)
@@ -4595,11 +4596,11 @@ def _reflow_inset_colorbar_frame(
     x1 = max(b.x1 for b in bboxes)
     y1 = max(b.y1 for b in bboxes)
     inv_parent = parent.transAxes.inverted()
-    (px0, py0) = inv_parent.transform((x0, y0))
-    (px1, py1) = inv_parent.transform((x1, y1))
+    px0, py0 = inv_parent.transform((x0, y0))
+    px1, py1 = inv_parent.transform((x1, y1))
     cax_bbox = cax.get_window_extent(renderer=renderer)
-    (cx0, cy0) = inv_parent.transform((cax_bbox.x0, cax_bbox.y0))
-    (cx1, cy1) = inv_parent.transform((cax_bbox.x1, cax_bbox.y1))
+    cx0, cy0 = inv_parent.transform((cax_bbox.x0, cax_bbox.y0))
+    cx1, cy1 = inv_parent.transform((cax_bbox.x1, cax_bbox.y1))
     px0, px1 = sorted((px0, px1))
     py0, py1 = sorted((py0, py1))
     cx0, cx1 = sorted((cx0, cx1))

ultraplot/axes/cartesian.py

@@ -2,6 +2,7 @@
 """
 The standard Cartesian axes used for most ultraplot figures.
 """
+
 import copy
 import inspect
 from dataclasses import dataclass, field

ultraplot/axes/container.py

@@ -6,6 +6,7 @@
 around external axes classes, allowing them to be used within ultraplot's
 figure system while maintaining their native functionality.
 """
+
 import matplotlib.axes as maxes
 import matplotlib.transforms as mtransforms
 from matplotlib import cbook, container

ultraplot/axes/geo.py

@@ -2,6 +2,7 @@
 """
 Axes filled with cartographic projections.
 """
+
 from __future__ import annotations
 
 import copy

ultraplot/axes/plot.py

@@ -3,6 +3,7 @@
 The second-level axes subclass used for all ultraplot figures.
 Implements plotting method overrides.
 """
+
 import contextlib
 import inspect
 import itertools

ultraplot/axes/plot_types/circlize.py

@@ -2,6 +2,7 @@
 """
 Helpers for pyCirclize-backed circular plots.
 """
+
 from __future__ import annotations
 
 import itertools

ultraplot/axes/polar.py

@@ -2,6 +2,7 @@
 """
 Polar axes using azimuth and radius instead of *x* and *y*.
 """
+
 import inspect
 
 try:

ultraplot/axes/shared.py

@@ -2,6 +2,7 @@
 """
 An axes used to jointly format Cartesian and polar axes.
 """
+
 # NOTE: We could define these in base.py but idea is projection-specific formatters
 # should never be defined on the base class. Might add to this class later anyway.
 import numpy as np

ultraplot/axes/three.py

@@ -2,6 +2,7 @@
 """
 The "3D" axes class.
 """
+
 from . import base, shared
 
 try:

ultraplot/colors.py

@@ -2,6 +2,7 @@
 """
 Various colormap classes and colormap normalization classes.
 """
+
 # NOTE: To avoid name conflicts between registered colormaps and colors, print
 # set(uplt.colors._cmap_database) & set(uplt.colors._color_database) whenever
 # you add new colormaps. v0.8 result is {'gray', 'marine', 'ocean', 'pink'} due

ultraplot/config.py

@@ -3,6 +3,7 @@
 Tools for setting up ultraplot and configuring global settings.
 See the :ref:`configuration guide <ug_config>` for details.
 """
+
 # NOTE: The matplotlib analogue to this file is actually __init__.py
 # but it makes more sense to have all the setup actions in a separate file
 # so the namespace of the top-level module is unpolluted.

ultraplot/constructor.py

@@ -2,6 +2,7 @@
 """
 T"he constructor functions used to build class instances from simple shorthand arguments.
 """
+
 # NOTE: These functions used to be in separate files like crs.py and
 # ticker.py but makes more sense to group them together to ensure usage is
 # consistent and so online documentation is easier to understand. Also in

ultraplot/demos.py

@@ -2,6 +2,7 @@
 """
 Functions for displaying colors and fonts.
 """
+
 import os
 import re
 

ultraplot/externals/__init__.py

@@ -2,4 +2,5 @@
 """
 External utilities adapted for ultraplot.
 """
+
 from . import hsluv  # noqa: F401

ultraplot/externals/hsluv.py

@@ -23,6 +23,7 @@
 the `HCL colorspace <https://en.wikipedia.org/wiki/HCL_color_space>`__,
 and the `HSLuv system <http://www.hsluv.org/implementations/>`__.
 """
+
 # Imports. See: https://stackoverflow.com/a/2353265/4970632
 # The HLS is actually HCL
 import math

ultraplot/figure.py

@@ -2,6 +2,7 @@
 """
 The figure class used for all ultraplot figures.
 """
+
 import functools
 import inspect
 import os

ultraplot/gridspec.py

@@ -2,6 +2,7 @@
 """
 The gridspec and subplot grid classes used throughout ultraplot.
 """
+
 import inspect
 import itertools
 import re

ultraplot/internals/__init__.py

@@ -2,6 +2,7 @@
 """
 Internal utilities.
 """
+
 # Import statements
 import inspect
 from importlib import import_module

ultraplot/internals/benchmarks.py

@@ -2,6 +2,7 @@
 """
 Utilities for benchmarking ultraplot performance.
 """
+
 import time
 
 from . import ic  # noqa: F401

ultraplot/internals/context.py

@@ -2,6 +2,7 @@
 """
 Utilities for manging context.
 """
+
 from . import ic  # noqa: F401
 
 

ultraplot/internals/docstring.py

@@ -2,6 +2,7 @@
 """
 Utilities for modifying ultraplot docstrings.
 """
+
 # WARNING: To check every docstring in the package for
 # unfilled snippets simply use the following code:
 # >>> import ultraplot as uplt

ultraplot/internals/fonts.py

@@ -2,6 +2,7 @@
 """
 Overrides related to math fonts.
 """
+
 import matplotlib as mpl
 from matplotlib.font_manager import findfont, ttfFontProperty
 from matplotlib.mathtext import MathTextParser

ultraplot/internals/guides.py

@@ -2,6 +2,7 @@
 """
 Utilties related to legends and colorbars.
 """
+
 import matplotlib.artist as martist
 import matplotlib.colorbar as mcolorbar
 import matplotlib.legend as mlegend  # noqa: F401

ultraplot/internals/inputs.py

@@ -2,6 +2,7 @@
 """
 Utilities for processing input data passed to plotting commands.
 """
+
 import functools
 import sys
 

ultraplot/internals/labels.py

@@ -2,6 +2,7 @@
 """
 Utilities related to matplotlib text labels.
 """
+
 import matplotlib.patheffects as mpatheffects
 import matplotlib.text as mtext
 from matplotlib.font_manager import FontProperties

ultraplot/internals/rcsetup.py

@@ -2,6 +2,7 @@
 """
 Utilities for global configuration.
 """
+
 import functools
 import re
 from collections.abc import MutableMapping

ultraplot/internals/versions.py

@@ -2,6 +2,7 @@
 """
 Utilities for handling dependencies and version changes.
 """
+
 from . import ic  # noqa: F401
 from . import warnings
 

ultraplot/internals/warnings.py

@@ -2,6 +2,7 @@
 """
 Utilities for internal warnings and deprecations.
 """
+
 import functools
 import re
 import sys

ultraplot/proj.py

@@ -2,6 +2,7 @@
 """
 Additional cartopy projection classes.
 """
+
 import warnings
 
 from .internals import ic  # noqa: F401

ultraplot/scale.py

@@ -2,6 +2,7 @@
 """
 Various axis `~matplotlib.scale.ScaleBase` classes.
 """
+
 import copy
 
 import matplotlib.scale as mscale

ultraplot/tests/test_1dplots.py

@@ -2,6 +2,7 @@
 """
 Test 1D plotting overrides.
 """
+
 import numpy as np
 import numpy.ma as ma
 import pandas as pd

ultraplot/tests/test_2dplots.py

@@ -2,6 +2,7 @@
 """
 Test 2D plotting overrides.
 """
+
 import numpy as np
 import pytest
 import xarray as xr

ultraplot/tests/test_axes.py

@@ -2,6 +2,7 @@
 """
 Test twin, inset, and panel axes.
 """
+
 import numpy as np
 import pytest
 

ultraplot/tests/test_colorbar.py

@@ -2,6 +2,7 @@
 """
 Test colorbars.
 """
+
 import numpy as np
 import pytest
 

ultraplot/tests/test_docs.py

@@ -2,6 +2,7 @@
 """
 Automatically build pytests from jupytext py:percent documentation files.
 """
+
 # import glob
 # import os
 

ultraplot/tests/test_external_axes_container_integration.py

@@ -5,6 +5,7 @@
 These tests verify that the ExternalAxesContainer works correctly with
 external axes like mpltern.TernaryAxes.
 """
+
 import numpy as np
 import pytest
 

ultraplot/tests/test_external_container_edge_cases.py

@@ -5,6 +5,7 @@
 These tests cover error handling, edge cases, and integration scenarios
 without requiring external dependencies.
 """
+
 from unittest.mock import Mock, patch
 
 import numpy as np

ultraplot/tests/test_external_container_mocked.py

@@ -5,6 +5,7 @@
 These tests verify container behavior without requiring external dependencies
 like mpltern to be installed.
 """
+
 from unittest.mock import MagicMock, Mock, call, patch
 
 import numpy as np

ultraplot/tests/test_format.py

@@ -2,10 +2,10 @@
 """
 Test format and rc behavior.
 """
+
 import locale, numpy as np, ultraplot as uplt, pytest
 import warnings
 
-
 # def test_colormap_assign():
 #     """
 #     Test below line is possible and naming schemes.

ultraplot/tests/test_integration.py

@@ -2,6 +2,7 @@
 """
 Test xarray, pandas, pint, seaborn integration.
 """
+
 import numpy as np
 import pandas as pd
 import pint