GitHub actions for QuPath

This repo contains reusable actions for QuPath-related projects.

Usage

The basic gradle CI can be used as follows:

jobs:
  build:
    uses: qupath/actions/.github/workflows/gradle.yml@main

For more complex builds, you can change the input variables, e.g.

jobs:
  build:
    uses: qupath/actions/.github/workflows/gradle.yml@main
    with:
      java-version: 17
      java-distribution: liberica
      artifact-name: my-silly-artifact-name
      gradle-args: shadowJar

Similarly, SciJava maven snapshots and releases can be made, respectively, using

jobs:
  snapshot:
    uses: qupath/actions/.github/workflows/scijava-maven.yml@main

and

jobs:
  release:
    uses: qupath/actions/.github/workflows/scijava-maven.yml@main
    with: 
      release: true

Similar build arguments can be passed in here, although gradle arguments are "extra arguments" and don't replace the single publish command.

Github draft releases can be made with:

jobs:
  github-release:
    uses: qupath/actions/.github/workflows/github-release.yml@main

This last action is a bit more complex as it requires downloading artifacts from the build action and globbing them... Therefore it may not work as expected at first.

Versioning

Currently it's probably best if we use main by default. Once stable, we should consider tagging this repository to improve reproducibility and traceability.

Updating repositories

You can bump the gradle version for all listed repos by going to Actions -> Update gradle versions -> Run workflow -> Run workflow. You can specify the version if needed, although usually it will be better to use the default. In future it may be possible to only update some repos, but this is not implemented yet.