// Copyright 2024 The Jujutsu 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//// https://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. use crate::common::TestEnvironment; #[test]fn test_help() {    let test_env = TestEnvironment::default();     let help_cmd_stdout = test_env.jj_cmd_success(test_env.env_root(), &["help"]);    // The help command output should be equal to the long --help flag    let help_flag_stdout = test_env.jj_cmd_success(test_env.env_root(), &["--help"]);    assert_eq!(help_cmd_stdout, help_flag_stdout);     // Help command should work with commands    let help_cmd_stdout = test_env.jj_cmd_success(test_env.env_root(), &["help", "log"]);    let help_flag_stdout = test_env.jj_cmd_success(test_env.env_root(), &["log", "--help"]);    assert_eq!(help_cmd_stdout, help_flag_stdout);     // Help command should work with subcommands    let help_cmd_stdout =        test_env.jj_cmd_success(test_env.env_root(), &["help", "workspace", "root"]);    let help_flag_stdout =        test_env.jj_cmd_success(test_env.env_root(), &["workspace", "root", "--help"]);    assert_eq!(help_cmd_stdout, help_flag_stdout);     // Help command should not work recursively    let stderr = test_env.jj_cmd_cli_error(test_env.env_root(), &["workspace", "help", "root"]);    insta::assert_snapshot!(stderr, @r#"    error: unrecognized subcommand 'help'     Usage: jj workspace [OPTIONS] <COMMAND>     For more information, try '--help'.    "#);     let stderr = test_env.jj_cmd_failure(test_env.env_root(), &["workspace", "add", "help"]);    insta::assert_snapshot!(stderr, @r#"    Error: There is no jj repo in "."    "#);     let stderr = test_env.jj_cmd_failure(test_env.env_root(), &["new", "help", "main"]);    insta::assert_snapshot!(stderr, @r#"    Error: There is no jj repo in "."    "#);     // Help command should output the same as --help for nonexistent commands    let help_cmd_stderr = test_env.jj_cmd_cli_error(test_env.env_root(), &["help", "nonexistent"]);    let help_flag_stderr =        test_env.jj_cmd_cli_error(test_env.env_root(), &["nonexistent", "--help"]);    assert_eq!(help_cmd_stderr, help_flag_stderr);     // Some edge cases    let help_cmd_stdout = test_env.jj_cmd_success(test_env.env_root(), &["help", "help"]);    let help_flag_stdout = test_env.jj_cmd_success(test_env.env_root(), &["help", "--help"]);    assert_eq!(help_cmd_stdout, help_flag_stdout);     let stderr = test_env.jj_cmd_cli_error(test_env.env_root(), &["help", "unknown"]);    insta::assert_snapshot!(stderr, @r#"    error: unrecognized subcommand 'unknown'       tip: a similar subcommand exists: 'undo'     Usage: jj [OPTIONS] <COMMAND>     For more information, try '--help'.    "#);     let stderr = test_env.jj_cmd_cli_error(test_env.env_root(), &["help", "log", "--", "-r"]);    insta::assert_snapshot!(stderr, @r#"    error: a value is required for '--revisions <REVISIONS>' but none was supplied     For more information, try '--help'.    "#);} #[test]fn test_help_keyword() {    let test_env = TestEnvironment::default();     // It should show help for a certain keyword if the `--keyword` flag is present    let help_cmd_stdout =        test_env.jj_cmd_success(test_env.env_root(), &["help", "--keyword", "revsets"]);    // It should be equal to the docs    assert_eq!(help_cmd_stdout, include_str!("../../docs/revsets.md"));     // It should show help for a certain keyword if the `-k` flag is present    let help_cmd_stdout = test_env.jj_cmd_success(test_env.env_root(), &["help", "-k", "revsets"]);    // It should be equal to the docs    assert_eq!(help_cmd_stdout, include_str!("../../docs/revsets.md"));     // It should give hints if a similar keyword is present    let help_cmd_stderr = test_env.jj_cmd_cli_error(test_env.env_root(), &["help", "-k", "rev"]);    insta::assert_snapshot!(help_cmd_stderr, @r#"    error: invalid value 'rev' for '--keyword <KEYWORD>'      [possible values: revsets, tutorial]       tip: a similar value exists: 'revsets'     For more information, try '--help'.    "#);     // It should give error with a hint if no similar keyword is found    let help_cmd_stderr =        test_env.jj_cmd_cli_error(test_env.env_root(), &["help", "-k", "<no-similar-keyword>"]);    insta::assert_snapshot!(help_cmd_stderr, @r#"    error: invalid value '<no-similar-keyword>' for '--keyword <KEYWORD>'      [possible values: revsets, tutorial]     For more information, try '--help'.    "#);     // The keyword flag with no argument should error with a hint    let help_cmd_stderr = test_env.jj_cmd_cli_error(test_env.env_root(), &["help", "-k"]);    insta::assert_snapshot!(help_cmd_stderr, @r#"    error: a value is required for '--keyword <KEYWORD>' but none was supplied      [possible values: revsets, tutorial]     For more information, try '--help'.    "#);     // It shouldn't show help for a certain keyword if the `--keyword` is not    // present    let help_cmd_stderr = test_env.jj_cmd_cli_error(test_env.env_root(), &["help", "revsets"]);    insta::assert_snapshot!(help_cmd_stderr, @r#"    error: unrecognized subcommand 'revsets'       tip: some similar subcommands exist: 'resolve', 'prev', 'restore', 'rebase', 'revert'     Usage: jj [OPTIONS] <COMMAND>     For more information, try '--help'.    "#);}