/*
 * Copyright 2025 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.gradle.launcher.cli

class HelpFixture {

    static final String DEFAULT_OUTPUT = '''
To see help contextual to the project, use gradle help

To see more detail about a task, run gradle help --task <task>

To see a list of available tasks, run gradle tasks

USAGE: gradle [option...] [task...]

--                                   Signals the end of built-in options. Parses subsequent parameters as tasks or task options only.

Help:
  --help, -?, -h                     Shows this help message.
  --show-version, -V                 Prints version information and continues.
  --version, -v                      Prints version information and exits.

Logging:
  --debug, -d                        Sets log level to debug. Includes the normal stacktrace.
  --full-stacktrace, -S              Prints the full (very verbose) stacktrace for all exceptions.
  --info, -i                         Sets the log level to info.
  --quiet, -q                        Logs errors only.
  --stacktrace, -s                   Prints the stacktrace for all exceptions.
  --warn, -w                         Sets the log level to warn.

Console:
  --console                          Specifies which type of console output to generate. Supported values are 'plain', 'colored', 'auto' (default), 'rich', or 'verbose'.
  --console-unicode                  Specifies which character types are allowed in the console output. Supported values are 'auto' (default), 'disable', or 'enable'.
  --non-interactive                  Do not do interactive prompting. [incubating]

Configuration:
  --gradle-user-home, -g             Specifies the Gradle user home directory. Default is ~/.gradle.
  --include-build                    Includes the specified build in the composite.
  --init-script, -I                  Specifies an initialization script.
  --offline                          Runs the build without accessing network resources.
  --project-cache-dir                Specifies the project-specific cache directory. Default is .gradle in the root project directory.
  --project-dir, -p                  Specifies the start directory for Gradle. Default is the current directory.
  --project-prop, -P                 Sets a project property for the build script (for example, -Pmyprop=myvalue).
  --refresh-dependencies, -U         Refreshes the state of dependencies.
  --system-prop, -D                  Sets a JVM system property (for example, -Dmyprop=myvalue).

Execution:
  --continue                         Continues task execution after a task failure.
  --no-continue                      Stops task execution after a task failure.
  --continuous, -t                   Enables continuous build. Gradle does not exit and will re-execute tasks when task file inputs change.
  --dry-run, -m                      Runs the build with all task actions disabled.
  --exclude-task, -x                 Specifies a task to exclude from execution.
  --no-rebuild, -a                   Disables rebuilding of project dependencies.
  --rerun-tasks                      Ignores previously cached task results.

Performance:
  --build-cache                      Enables the Gradle build cache. Gradle will try to reuse outputs from previous builds.
  --no-build-cache                   Disables the Gradle build cache.
  --configuration-cache              Enables the configuration cache. Gradle will try to reuse the build configuration from previous builds.
  --no-configuration-cache           Disables the configuration cache.
  --configure-on-demand              Configures necessary projects only. Gradle will attempt to reduce configuration time for large multi-project builds. [incubating]
  --no-configure-on-demand           Disables the use of configuration on demand. [incubating]
  --isolated-projects                Enables Isolated Projects. Projects are configured in parallel. Implies `--configuration-cache`. [incubating]
  --no-isolated-projects             Disables Isolated Projects. [incubating]
  --max-workers                      Configures the maximum number of concurrent workers Gradle is allowed to use.
  --parallel                         Builds projects in parallel. Gradle will attempt to determine the optimal number of executor threads to use.
  --no-parallel                      Disables parallel project execution.
  --priority                         Specifies the scheduling priority for the Gradle daemon and all processes launched by it. Supported values are 'normal' (default) or 'low'.
  --watch-fs                         Enables file system watching. Reuses file system data for subsequent builds.
  --no-watch-fs                      Disables file system watching.

Security:
  --dependency-verification, -F      Configures the dependency verification mode. Supported values are 'strict', 'lenient', or 'off'.
  --export-keys                      Exports the public keys used for dependency verification.
  --refresh-keys                     Refreshes the public keys used for dependency verification.
  --update-locks                     Performs a partial update of the dependency lock. Allows passed-in module notations to change version. [incubating]
  --write-locks                      Persists dependency resolution for locked configurations. Ignores existing locking information if it exists.
  --write-verification-metadata, -M  Generates checksums for dependencies used in the project. Accepts a comma-separated list.

Diagnostics:
  --configuration-cache-problems     Configures how the configuration cache handles problems (fail or warn). Supported values are 'warn', or 'fail' (default).
  --problems-report                  Enables the HTML problems report. [incubating]
  --no-problems-report               Disables the HTML problems report. [incubating]
  --profile                          Profiles build execution time. Generates a report in the <build_dir>/reports/profile directory.
  --property-upgrade-report          Runs the build with the experimental property upgrade report. [incubating]
  --task-graph                       Prints the task graph instead of executing tasks.
  --warning-mode                     Specifies which mode of warnings to generate. Supported values are 'all', 'fail', 'summary' (default), or 'none'.

Daemon:
  --daemon                           Uses the Gradle daemon to run the build. Starts the daemon if it is not running.
  --no-daemon                        Runs the build without the Gradle daemon. Useful occasionally if you have configured Gradle to always run with the daemon by default.
  --foreground                       Starts the Gradle daemon in the foreground.
  --status                           Shows the status of running and recently stopped Gradle daemons.
  --stop                             Stops the Gradle daemon if it is running.

Develocity:
  --develocity-plugin-version        Version of the Develocity plugin to auto-apply, must be 4.4.0 or higher if Develocity URL is specified as well.
                                     Used only if --develocity-url or --scan triggers auto-application of the Develocity plugin.
  --develocity-url                   Default URL of the Develocity server to publish Build Scan to. Triggers auto-application of the Develocity plugin if not already applied.
                                     Has no effect if the Develocity plugin is already applied and a server URL is configured.
  --scan                             Generates a Build Scan (powered by Develocity).
  --no-scan                          Disables the creation of a Build Scan.

'''
}
