ci: skip js/py workflows if sources are unchanged

[p2edwards]

(TESTING)

• verify with test commits
  • initial commit skipped the workflows
  • test a python change
  • test a js change
  • test a config change
  • test with a markdown-only commit
• screenshot test commits
• remove test commits
• PR review
• clarify skipping behavior (pr vs commit vs push)

Description

Make Pull Requests CI workflows for pytest, npm-test, and darker only run when related files are updated.

Details

• Faster merge if waiting for CI
• Use fewer build CI minutes

Changes

• pytest workflow — runs on changes to the Python dependencies, files under kpi, kobo and hub, or other scripts.
• darker workflow — runs on changes to Python files it wants to lint, or the linter configuration.
• npm-test workflow — runs on changes to the frontend files, npm dependencies, build system, or linter config.
• all of the above workflows — Markdown-only changes will not trigger a check.

Not changed

• all of the above — all workflows still run on push: branches: [ main ] regardless of files changed
• npm-test node_modules are still cached between runs (keyed on package-lock.json, patches, node version, OS version)

Tradeoffs

• Future additions — New config files, build systems or top-level source folders would need to be included/excluded by the paths in .github/workflows to avoid unnecessary runs or skips.

Checklist

1. If you've added code that should be tested, add tests
2. If you've changed APIs, update (or create!) the documentation
3. Ensure the tests pass
4. Run ./python-format.sh to make sure that your code lints and that you've followed our coding style
5. Write a title and, if necessary, a description of your work suitable for publishing in our release notes
6. Mention any related issues in this repository (as #ISSUE) and in other repositories (as kobotoolbox/other#ISSUE)
7. Open an issue in the docs if there are UI/UX changes

[Akuukis]

See kalvis/checks-selectively branch for alternative approach draft that likely does the same, except with the improvement of visibly marking check as skipped instead of silently skipping it altogether.