git-gamble 2.12.1

blend TDD + TCR to make sure to develop the right thing 😌, baby step by baby step 👶🦶
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

use std::path::PathBuf;

use clap::ArgAction;
use clap::ArgGroup;
use clap::Args;
use clap::Parser;
use clap::Subcommand;
use clap_complete::Shell;

#[derive(Args, Debug)]
pub struct GenerateShellCompletions {
	#[arg(
		value_enum,
		long_help(
			"Put generated file here :\n".to_string() +
			"* Bash : add it to your bash profile in ~/.bashrc\n" +
			"* Fish : see https://fishshell.com/docs/current/completions.html#where-to-put-completions\n" +
			"* Powershell : see https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_profiles\n" +
			"* Others shells : don't know, MR are welcome"
		)
	)]
	pub shell: Option<Shell>,
}

#[derive(Subcommand, Debug)]
pub enum OptionalSubcommands {
	GenerateShellCompletions(GenerateShellCompletions),
}

#[derive(Parser, Debug)]
#[command(
	version,
	infer_subcommands = true,
	subcommand_negates_reqs = true,
	group = ArgGroup::new("gambling").required(true),
	about(
		"Blend TDD (Test Driven Development) + TCR (`test && commit || revert`) to make sure to develop\n".to_string() +
		"the right thing 😌, baby step by baby step 👶🦶"
	),
	after_help(
		"Any contributions (feedback, bug report, merge request ...) are welcome\n".to_string() +
		"https://git-gamble.is-cool.dev/contributing/index.html"
	)
)]
pub struct Cli {
	// subcommands
	#[command(subcommand)]
	pub optional_subcommands: Option<OptionalSubcommands>,

	// flags
	/// Gamble that tests should pass
	#[arg(
		short = 'g',
		long,
		group = "gambling",
		visible_aliases = &["green", "refactor"],
		display_order = 1,
	)]
	pub pass: bool,
	/// Gamble that tests should fail
	#[arg(
		short = 'r',
		long,
		group = "gambling",
		visible_alias = "red",
		display_order = 1
	)]
	pub fail: bool,

	/// Do not make any changes
	/// and run test command
	#[arg(short = 'n', long)]
	pub dry_run: bool,

	/// Do not run git hooks
	#[arg(long)]
	pub no_verify: bool,

	// options
	/// Repository path
	// reflect `git -C <repository-path>`
	#[arg(short = 'C', long, default_value = ".")]
	pub repository_path: PathBuf,

	/// Commit's message
	#[arg(short = 'm', long, default_value = "")]
	pub message: String,

	/// Open editor to edit commit's message
	#[arg(short = 'e', long)]
	pub edit: bool,

	/// Fixes up commit
	#[arg(long, group = "rebase-message")]
	pub fixup: Option<String>,

	/// Construct a commit message for use with `rebase --autosquash`
	#[arg(long, group = "rebase-message")]
	pub squash: Option<String>,

	// rest arguments
	/// The command to execute to know the result
	#[arg(
		env = "GAMBLE_TEST_COMMAND",
		action(ArgAction::Append),
		last = true,
		required = true
	)]
	pub test_command: Vec<String>,
}

#[test]
fn verify_app() {
	use clap::CommandFactory;

	Cli::command().debug_assert()
}