Add get-version command to default configuration (#994)

Adds the `get-version` command to the default configuration:

```toml
[[workflows]]
name = "get-version"
help_text = "Get the current version of the project"

[[workflows.steps]]
type = "Command"
command = "echo \"$version\""

[workflows.steps.variables]
"$version" = "Version"
```

Closes #885

---------

Co-authored-by: Dylan Anthony <[email protected]>

Author: alex-way

.changeset/add_get_version_default_workflow.md

@@ -0,0 +1,15 @@
+---
+knope: minor
+---
+
+# Add `get-version` default workflow
+
+For **single-package repositories** with no custom workflows defined,
+there is now a [default workflow](https://knope.tech/reference/default-config/#workflows) called `get-version` that
+prints out the current package version.
+
+If you want similar functionality for multi-package repositories, please add your ideas to [issue #988](https://github.com/knope-dev/knope/issues/988).
+
+Thanks to @BatmanAoD for the suggestion and @alex-way for the implementation!
+
+PR #994 closed #885.

crates/knope/src/config/mod.rs

@@ -333,7 +333,8 @@ fn generate_workflows(has_forge: bool, packages: &[Package]) -> Vec<Workflow> {
         ]
     };
     release_steps.insert(0, Step::PrepareRelease(PrepareRelease::default()));
-    vec![
+
+    let mut workflows = vec![
         Workflow {
             name: String::from("release"),
             help_text: None,
@@ -344,7 +345,25 @@ fn generate_workflows(has_forge: bool, packages: &[Package]) -> Vec<Workflow> {
             help_text: None,
             steps: vec![Step::CreateChangeFile],
         },
-    ]
+    ];
+
+    if packages.len() == 1 {
+        let mut get_version_variables = IndexMap::new();
+        get_version_variables.insert(String::from("$version"), Variable::Version);
+
+        let get_version_steps = vec![Step::Command {
+            command: String::from("echo \"$version\""),
+            variables: Some(get_version_variables),
+            shell: None,
+        }];
+
+        workflows.push(Workflow {
+            name: String::from("get-version"),
+            help_text: Some(String::from("Get the current version of the project")),
+            steps: get_version_steps,
+        });
+    }
+    workflows
 }
 
 #[cfg(test)]

crates/knope/tests/default_workflows/get_version/mod.rs

@@ -0,0 +1,2 @@
+mod multi_package;
+mod single_package;

crates/knope/tests/default_workflows/get_version/multi_package/in/Cargo.toml

@@ -0,0 +1,3 @@
+[package]
+name = "single-package-get-version"
+version = "1.23.45"

crates/knope/tests/default_workflows/get_version/multi_package/in/knope.toml

@@ -0,0 +1,5 @@
+[packages.rust]
+versioned_files = ["Cargo.toml"]
+
+[packages.js]
+versioned_files = ["package.json"]

crates/knope/tests/default_workflows/get_version/multi_package/in/package.json

@@ -0,0 +1,3 @@
+{
+  "version": "13.24.54"
+}

crates/knope/tests/default_workflows/get_version/multi_package/mod.rs

@@ -0,0 +1,6 @@
+use crate::helpers::TestCase;
+
+#[test]
+fn get_version() {
+    TestCase::new(file!()).run("get-version");
+}

crates/knope/tests/default_workflows/get_version/multi_package/stderr.log

@@ -0,0 +1,5 @@
+error: unrecognized subcommand 'get-version'
+
+Usage: knope[EXE] [OPTIONS] [COMMAND]
+
+For more information, try '--help'.

crates/knope/tests/default_workflows/get_version/single_package/in/Cargo.toml

@@ -0,0 +1,3 @@
+[package]
+name = "single-package-get-version"
+version = "1.23.45"

crates/knope/tests/default_workflows/get_version/single_package/mod.rs

@@ -0,0 +1,6 @@
+use crate::helpers::TestCase;
+
+#[test]
+fn get_version() {
+    TestCase::new(file!()).run("get-version");
+}

crates/knope/tests/default_workflows/get_version/single_package/stdout.log

@@ -0,0 +1 @@
+1.23.45

crates/knope/tests/default_workflows/mod.rs

@@ -1,6 +1,3 @@
-mod cargo_workspace;
 mod document_change;
-mod gitea;
-mod github;
-mod no_forge;
+mod get_version;
 mod release;

crates/knope/tests/default_workflows/cargo_workspace/in/Cargo.toml crates/knope/tests/default_workflows/release/cargo_workspace/in/Cargo.toml

@@ -1,4 +1,6 @@
+use crate::helpers::TestCase;
+
 #[test]
 fn help() {
     TestCase::new(file!()).run("release --help");
-}
+}

crates/knope/tests/default_workflows/cargo_workspace/in/first/Cargo.toml crates/knope/tests/default_workflows/release/cargo_workspace/in/first/Cargo.toml

@@ -1,4 +1,4 @@
-Usage: knope release [OPTIONS]
+Usage: knope[EXE] release [OPTIONS]
 
 Options:
       --dry-run

crates/knope/tests/default_workflows/cargo_workspace/in/knope.toml crates/knope/tests/default_workflows/release/cargo_workspace/in/knope.toml

@@ -1,4 +1,6 @@
+use crate::helpers::TestCase;
+
 #[test]
 fn help() {
     TestCase::new(file!()).run("release --help");
-}
+}

crates/knope/tests/default_workflows/cargo_workspace/in/second/Cargo.toml crates/knope/tests/default_workflows/release/cargo_workspace/in/second/Cargo.toml

@@ -1,4 +1,4 @@
-Usage: knope release [OPTIONS]
+Usage: knope[EXE] release [OPTIONS]
 
 Options:
       --dry-run

crates/knope/tests/default_workflows/cargo_workspace/mod.rs crates/knope/tests/default_workflows/release/cargo_workspace/mod.rs

@@ -1 +1,6 @@
-
+mod cargo_workspace;
+mod gitea;
+mod github;
+mod help_multi_package;
+mod help_single_package;
+mod no_forge;

crates/knope/tests/default_workflows/cargo_workspace/stdout.log crates/knope/tests/default_workflows/release/cargo_workspace/stdout.log

@@ -30,3 +30,14 @@ name = "document-change"
 
 [[workflows.steps]]
 type = "CreateChangeFile"
+
+[[workflows]]
+name = "get-version"
+help_text = "Get the current version of the project"
+
+[[workflows.steps]]
+type = "Command"
+command = "echo \"$version\""
+
+[workflows.steps.variables]
+"$version" = "Version"

crates/knope/tests/default_workflows/gitea/in/Cargo.toml crates/knope/tests/default_workflows/release/gitea/in/Cargo.toml

@@ -31,3 +31,14 @@ name = "document-change"
 
 [[workflows.steps]]
 type = "CreateChangeFile"
+
+[[workflows]]
+name = "get-version"
+help_text = "Get the current version of the project"
+
+[[workflows.steps]]
+type = "Command"
+command = "echo \"$version\""
+
+[workflows.steps.variables]
+"$version" = "Version"

crates/knope/tests/default_workflows/gitea/in/knope.toml crates/knope/tests/default_workflows/release/gitea/in/knope.toml

@@ -74,7 +74,7 @@ scopes = ["something-else"]
 When there are no workflows defined in a `knope.toml` file, Knope will use the default workflows.
 Some pieces will differ depending on the configured packages and forges:
 
-```toml title="knope.toml" {"Does not use a $version variable when there are multiple packages": 9-13} {"Moves git push down here and pushes tags if no forges are configured": 18}
+```toml title="knope.toml" {"Does not use a $version variable when there are multiple packages": 11-13} {"Moves git push down here and pushes tags if no forges are configured": 22} {"Omits "get-version" when there are multiple packages": 30-40}
 [[workflows]]
 name = "release"
 
@@ -85,13 +85,14 @@ type = "PrepareRelease"
 type = "Command"
 command = "git commit -m \"chore: prepare release $version\""
 
-[[workflows.steps]]
-type = "Command"
-command = "git push"
 
 [workflows.steps.variables]
 "$version" = "Version"
 
+[[workflows.steps]]
+type = "Command"
+command = "git push"
+
 [[workflows.steps]]
 type = "Release"
 
@@ -102,6 +103,18 @@ name = "document-change"
 
 [[workflows.steps]]
 type = "CreateChangeFile"
+
+
+[[workflows]]
+name = "get-version"
+help_text = "Get the current version of the project"
+
+[[workflows.steps]]
+type = "Command"
+command = "echo \"$version\""
+
+[[workflows.steps.variables]]
+"$version" = "Version"
 ```
 
 ## Forges