release: 0.5.0

Author: joshstoik1

CREDITS.md

@@ -1,15 +1,15 @@
 # Project Dependencies
     Package:   cargo-bashman
-    Version:   0.4.9
-    Generated: 2024-10-08 07:33:21 UTC
+    Version:   0.5.0
+    Generated: 2024-10-08 19:58:02 UTC
 
 | Package | Version | Author(s) | License |
 | ---- | ---- | ---- | ---- |
 | [adbyss_psl](https://github.com/Blobfolio/adbyss) | 0.13.0 | [Josh Stoik](mailto:[email protected]) | WTFPL |
 | [adler2](https://github.com/oyvindln/adler2) | 2.0.0 | [Jonas Schievink](mailto:[email protected]) and [oyvindln](mailto:[email protected]) | 0BSD, Apache-2.0, or MIT |
 | [ahash](https://github.com/tkaitchuck/ahash) | 0.8.11 | [Tom Kaitchuck](mailto:[email protected]) | Apache-2.0 or MIT |
 | [argyle](https://github.com/Blobfolio/argyle) | 0.8.1 | [Blobfolio, LLC.](mailto:[email protected]) | WTFPL |
-| [bashman_core](https://github.com/Blobfolio/bashman) | 0.4.9 | [Josh Stoik](mailto:[email protected]) | WTFPL |
+| [bashman_core](https://github.com/Blobfolio/bashman) | 0.5.0 | [Josh Stoik](mailto:[email protected]) | WTFPL |
 | [camino](https://github.com/camino-rs/camino) | 1.1.9 | [Without Boats](mailto:[email protected]), [Ashley Williams](mailto:[email protected]), [Steve Klabnik](mailto:[email protected]), and [Rain](mailto:[email protected]) | Apache-2.0 or MIT |
 | [cargo-platform](https://github.com/rust-lang/cargo) | 0.1.8 |  | Apache-2.0 or MIT |
 | [cargo_metadata](https://github.com/oli-obk/cargo_metadata) | 0.18.1 | [Oliver Schneider](mailto:[email protected]) | MIT |

bashman/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "cargo-bashman"
-version = "0.4.9"
+version = "0.5.0"
 license = "WTFPL"
 authors = ["Josh Stoik <[email protected]>"]
 edition = "2021"

bashman_core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "bashman_core"
-version = "0.4.9"
+version = "0.5.0"
 license = "WTFPL"
 authors = ["Josh Stoik <[email protected]>"]
 edition = "2021"

bashman_core/src/data.rs

@@ -13,6 +13,7 @@ use flate2::{
 };
 use oxford_join::JoinFmt;
 use std::{
+	borrow::Cow,
 	fs::File,
 	io::Write,
 	path::Path,
@@ -120,6 +121,26 @@ impl<'a> Command<'a> {
 	/// # Description.
 	const fn description(&self) -> &'a str { self.description }
 
+	/// # Full Bin.
+	///
+	/// Return either "bin" or "parent bin", depending on context.
+	fn full_bin(&self) -> Cow<'a, str> {
+		self.parent.map_or_else(
+			|| Cow::Borrowed(self.bin()),
+			|p| Cow::Owned(format!("{p} {}", self.bin())),
+		)
+	}
+
+	/// # Full Name.
+	///
+	/// Return either "name" or "parent name", depending on context.
+	fn full_name(&self) -> Cow<'a, str> {
+		self.parent.map_or_else(
+			|| Cow::Borrowed(self.name()),
+			|p| Cow::Owned(format!("{p} {}", self.name())),
+		)
+	}
+
 	#[must_use]
 	/// # Name.
 	const fn name(&self) -> &'a str { self.name }
@@ -408,27 +429,16 @@ impl<'a> Command<'a> {
 		let now = utc2k::Utc2k::now();
 
 		// Start with the header.
-		match self.parent {
-			Some(p) => write!(
-				buf,
-				r#".TH "{} {}" "1" "{} {}" "{} v{}" "User Commands""#,
-				p.to_uppercase(),
-				self.name().to_uppercase(),
-				now.month_name(),
-				now.year(),
-				self.name(),
-				self.version(),
-			),
-			None => write!(
-				buf,
-				r#".TH "{}" "1" "{} {}" "{} v{}" "User Commands""#,
-				self.name().to_uppercase(),
-				now.month_name(),
-				now.year(),
-				self.name(),
-				self.version(),
-			),
-		}
+		let full_name = self.full_name();
+		let full_bin = self.full_bin();
+		write!(
+			buf,
+			r#".TH "{}" "1" "{} {}" "{full_bin} v{}" "User Commands""#,
+			full_name.to_uppercase(),
+			now.month_name(),
+			now.year(),
+			self.version(),
+		)
 			.map_err(|_| BashManError::WriteSubMan(Box::from(self.bin)))?;
 
 		/// # Helper: Generic section writer.
@@ -446,10 +456,9 @@ impl<'a> Command<'a> {
 			"NAME",
 			false,
 			vec![DataKind::Paragraph(vec![&format!(
-				"{} - Manual page for {} v{}.",
-				self.name(),
-				self.bin,
-				self.version()
+				"{} - Manual page for {full_bin} v{}.",
+				self.name().to_uppercase(),
+				self.version(),
 			)])]
 		);
 

release/man/cargo-bashman.1

@@ -1,6 +1,6 @@
-.TH "CARGO BASHMAN" "1" "October 2024" "Cargo BashMan v0.4.9" "User Commands"
+.TH "CARGO BASHMAN" "1" "October 2024" "cargo\-bashman v0.5.0" "User Commands"
 .SH NAME
-Cargo BashMan \- Manual page for cargo\-bashman v0.4.9.
+CARGO BASHMAN \- Manual page for cargo\-bashman v0.5.0.
 .SH DESCRIPTION
 A Cargo plugin to generate BASH completions and MAN pages.
 .SS USAGE: