feat: suppress Maven transfer progress via MAVEN_ARGS by default (add show-download-progress input)

[brunoborges]

Description

By default, Maven logs a line for every artifact it downloads, which adds significant noise to CI logs. This PR makes setup-java set the MAVEN_ARGS environment variable to include -ntp (--no-transfer-progress) so that Maven invocations in the job produce cleaner, smaller logs — without needing to add -ntp to every mvn command.

A new optional input lets users opt back into the progress output.

Behavior

• Default (show-download-progress: false): the action exports MAVEN_ARGS with -ntp appended.
  • Any existing MAVEN_ARGS value is preserved (the flag is appended, not overwritten).
  • Idempotent: the flag is not added if MAVEN_ARGS already contains -ntp or --no-transfer-progress.
• Opt-in (show-download-progress: true): MAVEN_ARGS is left untouched, preserving Maven's default progress output and any user-provided value.
• Applies on all platforms. MAVEN_ARGS is honored by Maven 3.9.0+ and the Maven Wrapper; older Maven versions ignore it (no-op). It has no effect on non-Maven builds (Gradle, sbt, etc.).

Example

- uses: actions/setup-java@v5
  with:
    distribution: 'temurin'
    java-version: '21'
    show-download-progress: true # keep Maven download/transfer progress in the logs

Changes

• action.yml: add show-download-progress input (default false).
• src/constants.ts: add the input name and MAVEN_ARGS / flag constants.
• src/maven-args.ts: new configureMavenArgs() implementing the logic above.
• src/setup-java.ts: invoke configureMavenArgs() during setup.
• __tests__/maven-args.test.ts: unit tests (default, opt-in, existing-value preservation, idempotency for both flag spellings).
• docs/advanced-usage.md: new "Maven transfer progress" section + TOC entry.
• dist/: rebuild bundled action.

Notes

• This is the correct mechanism for suppressing transfer progress, distinct from <interactiveMode>false</interactiveMode> (batch mode), which does not control progress output. See the discussion on feat: Disable interactiveMode in generated Maven settings.xml #1052.

Check list

• Mark if documentation changes are required.
• Mark if tests were added or updated to cover the changes.

[Copilot]

Pull request overview

This PR reduces CI log noise for Maven builds by defaulting Maven to “no transfer progress” output via MAVEN_ARGS, while adding an input to opt back into showing download/transfer progress.

Changes:

• Add show-download-progress input (default false) and wire it into setup.
• Introduce configureMavenArgs() to append -ntp to MAVEN_ARGS (preserving existing values and avoiding duplicates).
• Add unit tests and documentation describing the new default and opt-in behavior.

Show a summary per file

File	Description
action.yml	Adds the show-download-progress input with a default of false.
src/constants.ts	Defines the new input name and Maven-related constants (MAVEN_ARGS, -ntp, --no-transfer-progress).
src/maven-args.ts	Implements the MAVEN_ARGS configuration/idempotency logic.
src/setup-java.ts	Invokes Maven args configuration during setup.
__tests__/maven-args.test.ts	Adds unit coverage for defaults, opt-in behavior, preservation, and idempotency.
docs/advanced-usage.md	Documents the new default behavior and the opt-in input.
dist/setup/index.js	Rebuild output including the new logic/constants.
dist/cleanup/index.js	Rebuild output including updated constants exports.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

• Files reviewed: 6/8 changed files
• Comments generated: 1