pre-commit: adopt isort hook

.git-blame-ignore-revs

@@ -6,3 +6,6 @@ eb1dd508e087396948de5a3d20c5791500743ddf
 
 # style: sort __all__ statements (#2151)
 c00e0adae1b1e8695e173f4482369face82206ee
+
+# style: adopt isort to enforce import ordering (#2150)
+030a78b0f5cd6a88b04dd2fbe78f12b4b3e5e60d

.pre-commit-config.yaml

@@ -24,3 +24,9 @@ repos:
     hooks:
       - id: sort-all
         types: [file, python]
+  - repo: https://github.com/PyCQA/isort
+    rev: "5.12.0"
+    hooks:
+      - id: isort
+        types: [file, python]
+        args: [--filter-files]

benchmarks/cases/mpl_redraw.py

@@ -4,10 +4,12 @@
 # See COPYING and COPYING.LESSER in the root of the repository for full
 # licensing details.
 
-import cartopy.crs as ccrs
-import matplotlib.pyplot as plt
 import io
 
+import matplotlib.pyplot as plt
+
+import cartopy.crs as ccrs
+
 
 # No need for anything other than the agg backend, and we don't want
 # windows popping up as we are running these tests.

benchmarks/cases/project_linear.py

@@ -4,8 +4,8 @@
 # See COPYING and COPYING.LESSER in the root of the repository for full
 # licensing details.
 
-import cartopy.io.shapereader as shpreader
 import cartopy.crs as ccrs
+import cartopy.io.shapereader as shpreader
 
 
 class Suite:

docs/make_projection.py

@@ -7,9 +7,13 @@
 import inspect
 from pathlib import Path
 import textwrap
+
+import matplotlib.pyplot as plt
 import numpy as np
+
 import cartopy.crs as ccrs
 
+
 #: A dictionary to allow examples to use non-default parameters to the CRS
 #: constructor.
 SPECIFIC_PROJECTION_KWARGS = {
@@ -25,9 +29,6 @@
 
 
 def plate_carree_plot():
-    import matplotlib.pyplot as plt
-    import cartopy.crs as ccrs
-
     nplots = 2
 
     fig = plt.figure(figsize=(6, 6))
@@ -42,9 +43,6 @@ def plate_carree_plot():
 
 
 def igh_plot():
-    import matplotlib.pyplot as plt
-    import cartopy.crs as ccrs
-
     fig = plt.figure(figsize=(6.9228, 6))
 
     ax1 = fig.add_subplot(2, 1, 1,
@@ -61,9 +59,6 @@ def igh_plot():
 
 
 def utm_plot():
-    import matplotlib.pyplot as plt
-    import cartopy.crs as ccrs
-
     nplots = 60
 
     fig = plt.figure(figsize=(10, 3))
@@ -201,6 +196,9 @@ def prj_class_sorter(cls):
             code = textwrap.dedent("""
             .. plot::
 
+                import matplotlib.pyplot as plt
+                import cartopy.crs as ccrs
+
             {func_code}
 
             """).format(func_code=func_code)

docs/source/conf.py

@@ -20,10 +20,12 @@
 from pathlib import Path
 import sys
 
-import cartopy
 import matplotlib
 from sphinx_gallery.sorting import ExampleTitleSortKey, ExplicitOrder
 
+import cartopy
+
+
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here.
 sys.path.insert(0, str(Path(__file__).parent.resolve()))

examples/gridlines_and_labels/gridliner.py

@@ -17,11 +17,11 @@
 
 In the third example, labels are drawn only on the left and bottom sides.
 """
+import matplotlib.pyplot as plt
+
 import cartopy.crs as ccrs
 import cartopy.feature as cfeature
 
-import matplotlib.pyplot as plt
-
 
 def main():
 

examples/gridlines_and_labels/tick_labels.py

@@ -6,10 +6,11 @@
 projections using special tick formatters.
 
 """
-import cartopy.crs as ccrs
-from cartopy.mpl.ticker import LongitudeFormatter, LatitudeFormatter
 import matplotlib.pyplot as plt
 
+import cartopy.crs as ccrs
+from cartopy.mpl.ticker import LatitudeFormatter, LongitudeFormatter
+
 
 def main():
     fig = plt.figure(figsize=(8, 10))

examples/lines_and_polygons/effects_of_the_ellipse.py

@@ -14,16 +14,17 @@
 coastlines are shifted as a result of referencing the incorrect ellipse.
 
 """
-import cartopy.crs as ccrs
-import cartopy.feature as cfeature
-from cartopy.io.img_tiles import Stamen
-import matplotlib.pyplot as plt
 from matplotlib.lines import Line2D as Line
 from matplotlib.patheffects import Stroke
+import matplotlib.pyplot as plt
 import numpy as np
 import shapely.geometry as sgeom
 from shapely.ops import transform as geom_transform
 
+import cartopy.crs as ccrs
+import cartopy.feature as cfeature
+from cartopy.io.img_tiles import Stamen
+
 
 def transform_fn_factory(target_crs, source_crs):
     """

examples/lines_and_polygons/feature_creation.py

@@ -13,10 +13,11 @@
 pre-defined :data:`cartopy.feature.STATES` constant.
 
 """
+from matplotlib.offsetbox import AnchoredText
 import matplotlib.pyplot as plt
+
 import cartopy.crs as ccrs
 import cartopy.feature as cfeature
-from matplotlib.offsetbox import AnchoredText
 
 
 def main():

examples/lines_and_polygons/features.py

@@ -6,9 +6,10 @@
 in cartopy.
 
 """
+import matplotlib.pyplot as plt
+
 import cartopy.crs as ccrs
 import cartopy.feature as cfeature
-import matplotlib.pyplot as plt
 
 
 def main():

examples/lines_and_polygons/nightshade.py

@@ -6,7 +6,9 @@
 
 """
 import datetime
+
 import matplotlib.pyplot as plt
+
 import cartopy.crs as ccrs
 from cartopy.feature.nightshade import Nightshade
 

examples/miscellanea/animate_surface.py

@@ -5,11 +5,13 @@
 This example demonstrates how to animate
 gridded data using `pcolormesh()`.
 """
-import matplotlib.pyplot as plt
 from matplotlib.animation import FuncAnimation
+import matplotlib.pyplot as plt
 import numpy as np
+
 import cartopy.crs as ccrs
 
+
 fig = plt.figure(figsize=(10, 5))
 ax = plt.axes(projection=ccrs.Robinson())
 ax.set_global()

examples/miscellanea/axes_grid_basic.py

@@ -9,13 +9,14 @@
 labelling is switched off, and instead a standard procedure
 of creating grid lines is used. Then some fake data is plotted.
 """
-import cartopy.crs as ccrs
-from cartopy.mpl.geoaxes import GeoAxes
-from cartopy.mpl.ticker import LongitudeFormatter, LatitudeFormatter
 import matplotlib.pyplot as plt
 from mpl_toolkits.axes_grid1 import AxesGrid
 import numpy as np
 
+import cartopy.crs as ccrs
+from cartopy.mpl.geoaxes import GeoAxes
+from cartopy.mpl.ticker import LatitudeFormatter, LongitudeFormatter
+
 
 def sample_data_3d(shape):
     """Return `lons`, `lats`, `times` and fake `data`"""

examples/miscellanea/eccentric_ellipse.py

@@ -13,10 +13,11 @@
 from io import BytesIO
 from urllib.request import urlopen
 
-import cartopy.crs as ccrs
+from PIL import Image
 import matplotlib.pyplot as plt
 import numpy as np
-from PIL import Image
+
+import cartopy.crs as ccrs
 
 
 def vesta_image():

examples/miscellanea/favicon.py

@@ -5,11 +5,12 @@
 The actual code to generate cartopy's favicon.
 
 """
-import cartopy.crs as ccrs
+from matplotlib.font_manager import FontProperties
+import matplotlib.patches
 import matplotlib.pyplot as plt
 import matplotlib.textpath
-import matplotlib.patches
-from matplotlib.font_manager import FontProperties
+
+import cartopy.crs as ccrs
 
 
 def main():

examples/miscellanea/logo.py

@@ -5,12 +5,13 @@
 The actual code to produce cartopy's logo.
 
 """
-import cartopy.crs as ccrs
+from matplotlib.font_manager import FontProperties
+import matplotlib.patches
 import matplotlib.pyplot as plt
 import matplotlib.textpath
-import matplotlib.patches
 import matplotlib.transforms
-from matplotlib.font_manager import FontProperties
+
+import cartopy.crs as ccrs
 
 
 def main():

examples/miscellanea/un_flag.py

@@ -6,15 +6,16 @@
 Equidistant projection to reproduce the UN flag.
 
 """
-import cartopy.crs as ccrs
-import cartopy.feature as cfeature
-import matplotlib.pyplot as plt
 from matplotlib.patches import PathPatch
 import matplotlib.path
+import matplotlib.pyplot as plt
 import matplotlib.ticker
-from matplotlib.transforms import BboxTransform, Bbox
+from matplotlib.transforms import Bbox, BboxTransform
 import numpy as np
 
+import cartopy.crs as ccrs
+import cartopy.feature as cfeature
+
 
 # When drawing the flag, we can either use white filled land, or be a little
 # more fancy and use the Natural Earth shaded relief imagery.

examples/miscellanea/utm_all_zones.py

@@ -10,9 +10,10 @@
 Then we add coastlines, gridlines and the number of the zone.
 Finally we add a supertitle and display the figure.
 """
-import cartopy.crs as ccrs
 import matplotlib.pyplot as plt
 
+import cartopy.crs as ccrs
+
 
 def main():
     # Create a list of integers from 1 - 60

examples/scalar_data/aurora_forecast.py

@@ -16,11 +16,12 @@
 from io import StringIO
 from urllib.request import urlopen
 
+from matplotlib.colors import LinearSegmentedColormap
+import matplotlib.pyplot as plt
 import numpy as np
+
 import cartopy.crs as ccrs
 from cartopy.feature.nightshade import Nightshade
-import matplotlib.pyplot as plt
-from matplotlib.colors import LinearSegmentedColormap
 
 
 def aurora_forecast():

examples/scalar_data/contour_labels.py

@@ -5,9 +5,10 @@
 An example of adding contour labels to matplotlib contours.
 
 """
-import cartopy.crs as ccrs
 import matplotlib.pyplot as plt
 
+import cartopy.crs as ccrs
+
 
 def sample_data(shape=(73, 145)):
     """Return ``lons``, ``lats`` and ``data`` of some fake data."""

examples/scalar_data/contour_transforms.py

@@ -11,9 +11,10 @@
 have a negative impact on the wrapped coordinates as one can see in the
 second axes that the data does not extend to the full global extent.
 """
-import cartopy.crs as ccrs
 import matplotlib.pyplot as plt
 
+import cartopy.crs as ccrs
+
 
 def sample_data(shape=(73, 145)):
     """Return ``lons``, ``lats`` and ``data`` of some fake data."""

examples/scalar_data/geostationary.py

@@ -14,9 +14,10 @@
 from io import BytesIO
 from urllib.request import urlopen
 
-import cartopy.crs as ccrs
 import matplotlib.pyplot as plt
 
+import cartopy.crs as ccrs
+
 
 def geos_image():
     """

examples/scalar_data/wrapping_global.py

@@ -14,8 +14,9 @@
 data values at the ending longitudes will be closed to the wrap point.
 
 """
-import numpy as np
 import matplotlib.pyplot as plt
+import numpy as np
+
 import cartopy.crs as ccrs
 import cartopy.util as cutil
 

examples/web_services/image_tiles.py

@@ -7,8 +7,8 @@
 
 """
 import matplotlib.pyplot as plt
-import cartopy.crs as ccrs
 
+import cartopy.crs as ccrs
 from cartopy.io.img_tiles import Stamen
 
 

examples/web_services/reprojected_wmts.py

@@ -17,6 +17,7 @@
 
 """
 import matplotlib.pyplot as plt
+
 import cartopy.crs as ccrs
 
 

examples/web_services/wms.py

@@ -6,9 +6,10 @@
 supported by an OGC web services Web Map Service (WMS) aware axes.
 
 """
-import cartopy.crs as ccrs
 import matplotlib.pyplot as plt
 
+import cartopy.crs as ccrs
+
 
 def main():
     fig = plt.figure(figsize=(10, 5))