Generic Python linter

[Pierre Siddall (Pierre-siddall)]

PR Summary

Code Reviewer:

Similarly to the Fortran linting workflow this PR implements a generic Python linter using ruff and it's associated documentation

This workflow can take in the following input parameters when called by another workflow in a different repository:

Input Parameters

Parameter	Description	Required	Default	Type
runner	The runner to use for the job	No	ubuntu-latest	string
timeout	Maximum time in minutes the job can run	No	10	number
ruff-version	Ruff linter version	No	0.15.0	string
source-path	Path to source code directory	No	.	string
fail-on-error	Fail workflow on linting errors	No	true	boolean

closes #81

Code Quality Checklist

(Some checks are automatically carried out via the CI pipeline)

• I have performed a self-review of my own code
• My code follows the project's style guidelines
• The modified workflow's README has been updated, if required
• The changes have been sufficiently tested (please describe)

AI Assistance and Attribution

• Some of the content of this change has been produced with the assistance
  of Generative AI tool name (e.g., Met Office Github Copilot Enterprise,
  Github Copilot Personal, ChatGPT GPT-4, etc) and I have followed the
  Simulation Systems AI policy
  (including attribution labels)

Code Review

• The changes are approriate and testing has been sufficient