test: add integration tests as example projects

.gitignore

@@ -1,4 +1,4 @@
-/target
+target
 Cargo.lock
 .*
 

.vscode/settings.json

@@ -7,5 +7,6 @@
 	"rust-analyzer.imports.prefix": "crate",
 	"trailing-spaces.includeEmptyLines": false,
 	"editor.renderWhitespace": "all",
-	"git.ignoreLimitWarning": true
+	"git.ignoreLimitWarning": true,
+	"rust-analyzer.showUnlinkedFileNotification": false
 }

Cargo.toml

@@ -11,10 +11,13 @@ keywords = ["cli", "macro", "clap"]
 edition = "2021"
 exclude = [".*", "rust-toolchain", "*.toml", "justfile"]
 
+[lib]
+doctest = false
+
+[workspace]
+members = ["impl"]
+
 [dependencies]
 clap = { version = "3.0.7", features = ["derive"] }
 fncmd-impl = { path = "impl", version = "=1.3.0" }
-once_cell = "1.9.0"
-
-[workspace]
-members = ["impl"]
+once_cell = "1.9.0"

examples/example-basic/Cargo.toml

@@ -0,0 +1,12 @@
+[package]
+name = "example-basic"
+version = "0.0.0"
+edition = "2021"
+
+[dependencies]
+fncmd = { path = "../.." }
+
+[dev-dependencies]
+trycmd = "0.14.16"
+
+[workspace]

examples/example-basic/README.md

@@ -0,0 +1,43 @@
+```console
+$ example-basic
+? 2
+error: The following required arguments were not provided:
+    <GREETING>
+
+USAGE:
+    example-basic [OPTIONS] <GREETING> [NAME]
+
+For more information try --help
+
+```
+
+```console
+$ example-basic --help
+example-basic 0.0.0
+Prints greeting message
+
+USAGE:
+    example-basic [OPTIONS] <GREETING> [NAME]
+
+ARGS:
+    <GREETING>    Greeting message
+    <NAME>        Name of someone to greet
+
+OPTIONS:
+        --bang       Whether to use “!” instead of “.” at the end of the message
+    -h, --help       Print help information
+    -V, --version    Print version information
+
+```
+
+```console
+$ example-basic Hello World
+Hello, World.
+
+```
+
+```console
+$ example-basic Hello --bang
+Hello!
+
+```

examples/example-basic/src/main.rs

@@ -0,0 +1,17 @@
+/// Prints greeting message.
+#[fncmd::fncmd]
+fn main(
+	/// Greeting message.
+	greeting: String,
+	/// Name of someone to greet.
+	name: Option<String>,
+	/// Whether to use “!” instead of “.” at the end of the message.
+	#[opt]
+	bang: bool,
+) {
+	if let Some(name) = name {
+		println!("{greeting}, {name}{}", if bang { "!" } else { "." });
+	} else {
+		println!("{greeting}{}", if bang { "!" } else { "." });
+	}
+}

examples/example-basic/tests/trycmd.rs

@@ -0,0 +1,2 @@
+#[test]
+fn trycmd() { trycmd::TestCases::new().case("README.md"); }

examples/example-subcmds/Cargo.toml

@@ -0,0 +1,12 @@
+[package]
+name = "example-subcmds"
+version = "0.0.0"
+edition = "2021"
+
+[dependencies]
+fncmd = { path = "../.." }
+
+[dev-dependencies]
+trycmd = "0.14.16"
+
+[workspace]

examples/example-subcmds/README.md

@@ -0,0 +1,52 @@
+```console
+$ example-subcmds
+Top-level command is called.
+
+```
+
+```console
+$ example-subcmds --help
+example-subcmds 0.0.0
+
+USAGE:
+    example-subcmds [SUBCOMMAND]
+
+OPTIONS:
+    -h, --help       Print help information
+    -V, --version    Print version information
+
+SUBCOMMANDS:
+    child    
+    help     Print this message or the help of the given subcommand(s)
+
+```
+
+```console
+$ example-subcmds child
+One-level-deep subcommand is called.
+
+```
+
+```console
+$ example-subcmds child grandchild
+Two-level-deep subcommand is called.
+
+```
+
+```console
+$ example-subcmds orphan
+? 2
+error: Found argument 'orphan' which wasn't expected, or isn't valid in this context
+
+USAGE:
+    example-subcmds [SUBCOMMAND]
+
+For more information try --help
+
+```
+
+```console
+$ example-subcmds-orphan
+Top-level orphan command is called.
+
+```

examples/example-subcmds/src/bin/example-subcmds-child-grandchild.rs

@@ -0,0 +1,4 @@
+#[fncmd::fncmd]
+pub fn main() {
+	println!("Two-level-deep subcommand is called.");
+}

examples/example-subcmds/src/bin/example-subcmds-child.rs

@@ -0,0 +1,4 @@
+#[fncmd::fncmd]
+pub fn main() {
+	println!("One-level-deep subcommand is called.");
+}

examples/example-subcmds/src/bin/example-subcmds-orphan.rs

@@ -0,0 +1,4 @@
+#[fncmd::fncmd]
+fn main() {
+	println!("Top-level orphan command is called.");
+}

examples/example-subcmds/src/main.rs

@@ -0,0 +1,4 @@
+#[fncmd::fncmd]
+fn main() {
+	println!("Top-level command is called.");
+}

examples/example-subcmds/tests/trycmd.rs

@@ -0,0 +1,2 @@
+#[test]
+fn trycmd() { trycmd::TestCases::new().case("README.md"); }

examples/example-subcmdsflat/Cargo.toml

@@ -0,0 +1,12 @@
+[package]
+name = "example-subcmdsflat"
+version = "0.0.0"
+edition = "2021"
+
+[dependencies]
+fncmd = { path = "../.." }
+
+[dev-dependencies]
+trycmd = "0.14.16"
+
+[workspace]

examples/example-subcmdsflat/README.md

@@ -0,0 +1,52 @@
+```console
+$ example-subcmdsflat
+Top-level command is called.
+
+```
+
+```console
+$ example-subcmdsflat --help
+example-subcmdsflat 0.0.0
+
+USAGE:
+    example-subcmdsflat [SUBCOMMAND]
+
+OPTIONS:
+    -h, --help       Print help information
+    -V, --version    Print version information
+
+SUBCOMMANDS:
+    child    
+    help     Print this message or the help of the given subcommand(s)
+
+```
+
+```console
+$ example-subcmdsflat child
+One-level-deep subcommand is called.
+
+```
+
+```console
+$ example-subcmdsflat child grandchild
+Two-level-deep subcommand is called.
+
+```
+
+```console
+$ example-subcmdsflat orphan
+? 2
+error: Found argument 'orphan' which wasn't expected, or isn't valid in this context
+
+USAGE:
+    example-subcmdsflat [SUBCOMMAND]
+
+For more information try --help
+
+```
+
+```console
+$ example-subcmdsflat-orphan
+Top-level orphan command is called.
+
+```

examples/example-subcmdsflat/src/bin/example-subcmdsflat-child-grandchild.rs

@@ -0,0 +1,4 @@
+#[fncmd::fncmd]
+pub fn main() {
+	println!("Two-level-deep subcommand is called.");
+}

examples/example-subcmdsflat/src/bin/example-subcmdsflat-child.rs

@@ -0,0 +1,4 @@
+#[fncmd::fncmd]
+pub fn main() {
+	println!("One-level-deep subcommand is called.");
+}

examples/example-subcmdsflat/src/bin/example-subcmdsflat-orphan.rs

@@ -0,0 +1,4 @@
+#[fncmd::fncmd]
+fn main() {
+	println!("Top-level orphan command is called.");
+}

examples/example-subcmdsflat/src/bin/example-subcmdsflat.rs

@@ -0,0 +1,4 @@
+#[fncmd::fncmd]
+fn main() {
+	println!("Top-level command is called.");
+}

examples/example-subcmdsflat/tests/trycmd.rs

@@ -0,0 +1,2 @@
+#[test]
+fn trycmd() { trycmd::TestCases::new().case("README.md"); }

examples/example-workspace/Cargo.toml

@@ -0,0 +1,6 @@
+[workspace]
+members = ["crates/*"]
+
+[workspace.package]
+version = "0.0.0"
+edition = "2021"

examples/example-workspace/crates/bar/Cargo.toml

@@ -0,0 +1,10 @@
+[package]
+name = "example-workspace-bar"
+version.workspace = true
+edition.workspace = true
+
+[dependencies]
+fncmd = { path = "../../../.." }
+
+[dev-dependencies]
+trycmd = "0.14.16"

examples/example-workspace/crates/bar/README.md

@@ -0,0 +1,11 @@
+```console
+$ example-workspace-bar
+Top-level command is called.
+
+```
+
+```console
+$ example-workspace-bar child
+One-level-deep subcommand is called.
+
+```

examples/example-workspace/crates/bar/src/bin/example-workspace-bar-child.rs

@@ -0,0 +1,4 @@
+#[fncmd::fncmd]
+pub fn main() {
+	println!("One-level-deep subcommand is called.");
+}

examples/example-workspace/crates/bar/src/main.rs

@@ -0,0 +1,4 @@
+#[fncmd::fncmd]
+fn main() {
+	println!("Top-level command is called.");
+}

examples/example-workspace/crates/bar/tests/trycmd.rs

@@ -0,0 +1,2 @@
+#[test]
+fn trycmd() { trycmd::TestCases::new().case("README.md"); }

examples/example-workspace/crates/foo/Cargo.toml

@@ -0,0 +1,10 @@
+[package]
+name = "example-workspace-foo"
+version.workspace = true
+edition.workspace = true
+
+[dependencies]
+fncmd = { path = "../../../.." }
+
+[dev-dependencies]
+trycmd = "0.14.16"

examples/example-workspace/crates/foo/README.md

@@ -0,0 +1,11 @@
+```console
+$ example-workspace-foo
+Top-level command is called.
+
+```
+
+```console
+$ example-workspace-foo child
+One-level-deep subcommand is called.
+
+```

examples/example-workspace/crates/foo/src/bin/example-workspace-foo-child.rs

@@ -0,0 +1,4 @@
+#[fncmd::fncmd]
+pub fn main() {
+	println!("One-level-deep subcommand is called.");
+}

examples/example-workspace/crates/foo/src/main.rs

@@ -0,0 +1,4 @@
+#[fncmd::fncmd]
+fn main() {
+	println!("Top-level command is called.");
+}

examples/example-workspace/crates/foo/tests/trycmd.rs

@@ -0,0 +1,2 @@
+#[test]
+fn trycmd() { trycmd::TestCases::new().case("README.md"); }