✨ Add add_subplot_labels function

[s-weigand]

This adds add_subplot_labels as a convenience function to add subplot labels.

Instead of duplicating code for each axis possibly creating inconsistency.

axes[0].annotate("A", xy=(0.01, 0.89), xycoords="axes fraction", fontsize=16)
axes[1].annotate("B", xy=(0.01, 0.89), xycoords="axes fraction", fontsize=16)
axes[2].annotate("C", xy=(0.01, 0.89), xycoords="axes fraction", fontsize=16)

This function allows adding labels consistently for all axes

add_subplot_labels(axes, label_position=(0.01, 0.89), label_format_function="upper_case_letter")

Change summary

• ✨ Added format_sub_plot_number_upper_case_letter function
• 🩹📚 Fixed missing arg docstring for not_single_element_dims
• ✨ Added ensure_axes_array function
• ✨ Added add_subplot_labels function

Checklist

• ✔️ Passing the tests (mandatory for all PR's)
• 🧪 Adds new tests for the feature (mandatory for ✨ feature and 🩹 bug fix PR's)

[github-actions]

👈 Launch a binder notebook on branch s-weigand/pyglotaran-extras/anotate

[codecov]

Codecov Report

Patch coverage: 94.11% and project coverage change: +1.59 🎉

Comparison is base (289c3c3) 43.30% compared to head (510fc30) 44.90%.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #181      +/-   ##
==========================================
+ Coverage   43.30%   44.90%   +1.59%     
==========================================
  Files          27       27              
  Lines         979     1011      +32     
  Branches      142      149       +7     
==========================================
+ Hits          424      454      +30     
- Misses        548      549       +1     
- Partials        7        8       +1     

Impacted Files	Coverage Δ
pyglotaran_extras/plotting/utils.py	37.80% <92.59%> (+9.74%)	⬆️
pyglotaran_extras/__init__.py	100.00% <100.00%> (ø)
pyglotaran_extras/types.py	100.00% <100.00%> (ø)

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[jsnel]

Looks good.

I do note that 'advanced' (or complex) functionality like this could do with some additional documentation in the form of examples (rather than just the API docstrings), something like some snippets in the readme, or example notebooks. Suggest we made an issue of this for a future PR. Because of the tight coupling between pyglotaran and the -extras it can be done in either repository, but it may make more sense to be in -extras as a self-contained example.