colorbar keyword for iris.quickplot routines

[ukmo-ccbunney]

🚀 Pull Request

Description

New boolean colorbar keywork allows user to control automatic generation of a colorbar in iris.quickplot plotting routines.
Only implemented for pcolormesh, colormesh and coutourf as the other plotting routines do not generate a colorbar.

Fixes: #5970

---

Consult Iris pull request check list

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 89.81%. Comparing base (54f430b) to head (3b5b3fe).
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #6169   +/-   ##
=======================================
  Coverage   89.81%   89.81%           
=======================================
  Files          88       88           
  Lines       23178    23181    +3     
  Branches     4313     4313           
=======================================
+ Hits        20818    20821    +3     
  Misses       1628     1628           
  Partials      732      732           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[ukmo-ccbunney]

@trexfeathers I've added 3 new tests for this change in test_quickplot.py::TestLabels and generated the new images and imagerepo.json files. If you're happy with the tests I've added, then I'll update raise a PR for the iris-test-data repo.

[trexfeathers]

Thanks @ukmo-ccbunney, I agree with your logic, please do put up that iris-test-data pull request - I assume you are following this guidance: Adding or Updating Graphics Tests — Iris 3.10.0 documentation (scitools-iris.readthedocs.io)

[trexfeathers]

Oh and don't forget a What's New entry in latest.rst

[ukmo-ccbunney]

Oh and don't forget a What's New entry in latest.rst

Done; 8261d3b

[ukmo-ccbunney]

New test data for this change: SciTools/iris-test-data#94

[trexfeathers]

Great! Now that iris-test-data is sorted, we need to reference 2.27 in the below places.

While you're there, could you add a comment in ci-tests.yml to remind people that iris-test-data is also referenced in benchmarks_run.yml (they end up mis-aligned a lot!)?

iris/.github/workflows/ci-tests.yml

Lines 52 to 54 in e9a7319

	env:
	IRIS_TEST_DATA_VERSION: "2.26"
	ENV_NAME: "ci-tests"

iris/.github/workflows/benchmarks_run.yml

Lines 60 to 66 in e9a7319

	env:
	IRIS_TEST_DATA_LOC_PATH: benchmarks
	IRIS_TEST_DATA_PATH: benchmarks/iris-test-data
	IRIS_TEST_DATA_VERSION: "2.26"
	# Lets us manually bump the cache to rebuild
	ENV_CACHE_BUILD: "0"
	TEST_DATA_CACHE_BUILD: "2"