Tasks

The nmk-github plugin defines the tasks described below.

Setup tasks

All tasks in this chapter are dependencies of the base setup task.

gh.actions – workflow file generation

This tasks generate the ${githubAction} workflow file.

Property	Value/description
builder	nmk_github.action.ActionFileBuilder
input	${githubActionTemplate} template file
output	${githubAction} workflow file

The builder is invoked with the following parameters mapping:

Name	Value
python_versions	${githubDetectedPythonVersions}
images	${githubOSImages}
build_steps	${githubBuildSteps}
publish_steps	${githubPublishSteps}

This task is enabled only if python supported version(s) are configured (see ${githubDetectedPythonVersions})

The generated Github workflow implements the following steps:

• On branch push:

  • parallelizes multiple jobs for all combinations of ${githubDetectedPythonVersions} and ${githubOSImages} values

  • launches ${githubCommand} build command

  • launches ${githubPackageCommand} packaging command

  • launches extra steps defined by ${githubBuildSteps}

• On tag push:

  • runs a single job on a default configuration (ubuntu latest + python minimum supported version)

  • launches ${githubPackageCommand} packaging command

  • launches extra steps defined by ${githubPublishSteps}