Replace flake8 with flakeheaven

.github/workflows/format-command.yml

@@ -28,7 +28,7 @@ jobs:
       # Install formatting tools
       - name: Install formatting tools
         run: |
-          pip install black blackdoc docformatter flake8 isort
+          pip install black blackdoc docformatter flakeheaven isort
           sudo apt-get install dos2unix
 
       # Run "make format" and commit the change to the PR branch

.github/workflows/style_checks.yaml

@@ -26,10 +26,10 @@ jobs:
 
       - name: Install packages
         run: |
-          pip install black blackdoc docformatter flake8 pylint isort
+          pip install black blackdoc docformatter flakeheaven pylint isort
           sudo apt-get install dos2unix
 
-      - name: Formatting check (black, blackdoc, docformatter, flake8 and isort)
+      - name: Formatting check (black, blackdoc, docformatter, flakeheaven and isort)
         run: make check
 
       - name: Linting (pylint)

Makefile

@@ -8,7 +8,7 @@ BLACK_FILES=$(PROJECT) setup.py doc/conf.py examples
 BLACKDOC_OPTIONS=--line-length 79
 DOCFORMATTER_FILES=$(PROJECT) setup.py doc/conf.py examples
 DOCFORMATTER_OPTIONS=--recursive --pre-summary-newline --make-summary-multi-line --wrap-summaries 79 --wrap-descriptions 79
-FLAKE8_FILES=$(PROJECT) setup.py doc/conf.py examples
+FLAKEHEAVEN_FILES=$(PROJECT) setup.py doc/conf.py examples
 LINT_FILES=$(PROJECT) setup.py doc/conf.py
 
 help:
@@ -19,7 +19,7 @@ help:
 	@echo "  test      run the test suite (including some doctests) and report coverage"
 	@echo "  fulltest  run the test suite (including all doctests) and report coverage"
 	@echo "  format    run black, blackdoc, docformatter and isort to automatically format the code"
-	@echo "  check     run code style and quality checks (black, blackdoc, docformatter, flake8 and isort)"
+	@echo "  check     run code style and quality checks (black, blackdoc, docformatter, flakeheaven and isort)"
 	@echo "  lint      run pylint for a deeper (and slower) quality check"
 	@echo "  clean     clean up build and generated files"
 	@echo "  distclean clean up build and generated files, including project metadata files"
@@ -64,7 +64,7 @@ check:
 	docformatter --check $(DOCFORMATTER_OPTIONS) $(DOCFORMATTER_FILES)
 	black --check $(BLACK_FILES)
 	blackdoc --check $(BLACKDOC_OPTIONS) $(BLACK_FILES)
-	flake8 $(FLAKE8_FILES)
+	FLAKEHEAVEN_CACHE_TIMEOUT=0 flakeheaven lint $(FLAKEHEAVEN_FILES)
 
 lint:
 	pylint $(LINT_FILES)

doc/contributing.md

@@ -499,14 +499,14 @@ words bridged only by consonants, such as `distcalc`, and `crossprofile`. This
 convention is not applied by the code checking tools, but the PyGMT maintainers
 will comment on any pull requests as needed.
 
-We also use [flake8](http://flake8.pycqa.org/en/latest/) and
+We also use [flakeheaven](https://flakeheaven.readthedocs.io) and
 [pylint](https://pylint.pycqa.org/) to check the quality of the code and quickly catch
 common errors.
 The [`Makefile`](https://github.com/GenericMappingTools/pygmt/blob/main/Makefile)
 contains rules for running both checks:
 
 ```bash
-make check   # Runs black, blackdoc, docformatter, flake8 and isort (in check mode)
+make check   # Runs black, blackdoc, docformatter, flakeheaven and isort (in check mode)
 make lint    # Runs pylint, which is a bit slower
 ```
 

environment.yml

@@ -23,7 +23,7 @@ dependencies:
     - black
     - blackdoc
     - docformatter
-    - flake8
+    - flakeheaven
     - isort>=5
     - pylint
     # Dev dependencies (unit testing)

pyproject.toml

@@ -9,6 +9,12 @@ fallback_version = "999.999.999+unknown"
 [tool.coverage.run]
 omit = ["*/tests/*", "*pygmt/__init__.py"]
 
+[tool.flakeheaven]
+ignore = ["E203", "E266", "E501", "W503", "F401", "E741"]
+max_line_length = 88
+max_doc_length = 79
+show_source = true
+
 [tool.pytest.ini_options]
 minversion = "6.0"
 addopts = "--verbose --durations=0 --durations-min=0.2 --doctest-modules --mpl --mpl-results-path=results"