Add step input for specifying additional gradle options

[godrei]

Checklist

• I've read and followed the Contribution Guidelines
• step.yml and README.md is updated with the changes (if needed)

Version

Requires a MINOR version update

Context

The Step is running gradlew dependencies command in order to list the given project's missing dependencies.

To make the Step more felxibale and align our Step development guideline (Provide input for additional command-line arguments) this PR introduces a new Step input for specifying additional options for the gradlew dependencies command.

With this change, users can overcome, for example, issues with the incubating Configuration cache feature while migrating the project by passing the --no-configuration-cache or --configuration-cache-problems=warn options.

Changes

• New Step Input (gradlew_dependencies_options) was introduced for passing additional options to the gradlew dependencies command.

Investigation details

Gradle Configuration cache: https://docs.gradle.org/7.4.2/userguide/configuration_cache.html#config_cache:intro

Decisions

The change was manually tested only since the Step is not prepared for writing unit tests easily. I will create a follow-up ticket to make up for the missing test and to make the step testable.

With the manual test, I checked if the provided options are passed properly to the gradlew dependencies command:

• Updated the sample workflow to pass an addition gradlew dependencies option to the step:

...
    - path::./:
        title: Execute step
        inputs:
        - gradlew_dependencies_options: --configuration-cache-problems=warn
...

• Modified the step here to print the executed gradlew command:

func getDependenciesOutput(projectLocation string, options []string) (string, error) {
	args := []string{"dependencies", "--stacktrace"}
	args = append(args, options...)

	gradleCmd := command.New("./gradlew", args...)
	gradleCmd.SetStdin(strings.NewReader("y"))
	gradleCmd.SetDir(projectLocation)
	fmt.Println(gradleCmd.PrintableCommandArgs())
	return gradleCmd.RunAndReturnTrimmedCombinedOutput()
}

[godrei]

Sorry for dismissing the review, I spotted a glitch in the new Step Input description, fixed it, and now it looks like this: