build.rs

@@ -1,3 +1,4 @@
+use clap::CommandFactory;
 use clap_mangen::Man;
 use std::env;
 use std::path::Path;
@@ -20,21 +21,11 @@ macro_rules! generate_manpage {
 }
 
 fn main() -> std::io::Result<()> {
-    let target_dir = env::var("CARGO_TARGET_DIR").unwrap_or("target".to_string());
+    generate_manpage!(GitMob);
-    let output_dir = Path::new(&target_dir).join(env::var("PROFILE").unwrap());
+    generate_manpage!(GitSolo);
-
+    generate_manpage!(GitAddCoauthor);
-    let cmd = cli::git_mob_cmd();
+    generate_manpage!(GitEditCoauthor);
-    let man = Man::new(cmd.clone());
+    generate_manpage!(GitDeleteCoauthor);
-    let mut buffer: Vec<u8> = Default::default();
-    man.render(&mut buffer)?;
-    std::fs::write(output_dir.join("git-mob.1"), buffer)?;
-
-    for subcommand in cmd.get_subcommands() {
-        let man = Man::new(subcommand.clone());
-        let mut buffer: Vec<u8> = Default::default();
-        man.render(&mut buffer)?;
-        std::fs::write(output_dir.join(format!("git-mob-{}.1", subcommand.get_name())), buffer)?;
-    }
 
     Ok(())
 }

src/bin/git-add-coauthor.rs

@@ -0,0 +1,15 @@
+use clap::Parser;
+use git_mob::{cli, parse_coauthors_file, write_coauthors_file, Author};
+
+fn main() {
+    let opt = cli::GitAddCoauthor::parse();
+    let mut authors = parse_coauthors_file().unwrap_or_default();
+    let new_author = Author {
+        name: opt.name,
+        email: opt.email,
+    };
+
+    authors.insert(opt.initials, new_author);
+
+    write_coauthors_file(authors);
+}

src/bin/git-delete-coauthor.rs

@@ -0,0 +1,9 @@
+use clap::Parser;
+use git_mob::{cli, get_available_coauthors, write_coauthors_file};
+
+fn main() {
+    let opt = cli::GitDeleteCoauthor::parse();
+    let mut authors = get_available_coauthors();
+    authors.remove(&opt.initials);
+    write_coauthors_file(authors);
+}

src/bin/git-edit-coauthor.rs

@@ -0,0 +1,22 @@
+use clap::Parser;
+use git_mob::{cli, get_available_coauthors, write_coauthors_file, Author};
+use std::process;
+
+fn main() {
+    let opt = cli::GitDeleteCoauthor::parse();
+
+    let mut authors = get_available_coauthors();
+
+    if let Some(author) = authors.get(&opt.initials) {
+        let mut updated_author: Author = author.clone();
+        updated_author.name = opt.name;
+        updated_author.email = opt.email;
+
+        authors.insert(opt.initials, updated_author);
+
+        write_coauthors_file(authors);
+    } else {
+        eprintln!("No author found with initials {}", &opt.initials);
+        process::exit(1);
+    };
+}

src/bin/git-mob.rs

@@ -0,0 +1,79 @@
+use clap::Parser;
+use git_mob::{
+    cli, ensure_commit_template_is_set, get_available_coauthors, get_main_author, set_main_author,
+    with_gitmessage_template_path_or_exit, Author,
+};
+use std::fmt::Write;
+use std::fs;
+use std::process;
+
+fn main() {
+    let args = cli::GitMob::parse();
+
+    if args.list {
+        list_coauthors();
+        process::exit(0);
+    }
+
+    if let Some(initials) = args.overwrite {
+        override_main_author(&initials);
+    }
+
+    write_coauthors_to_gitmessage_file(&args.coauthors);
+    ensure_commit_template_is_set();
+}
+
+fn list_coauthors() {
+    for (abbrev, author) in &get_available_coauthors() {
+        println!("{abbrev}\t{author}");
+    }
+}
+
+fn override_main_author(initials: &str) {
+    let all_authors = get_available_coauthors();
+    match all_authors.get(initials) {
+        Some(new_main_author) => set_main_author(new_main_author),
+        None => {
+            eprintln!("Error: author with initials {initials} not found");
+            process::exit(1);
+        }
+    }
+}
+
+fn write_coauthors_to_gitmessage_file(coauthor_initials: &[String]) {
+    let coauthors = select_coauthors(coauthor_initials);
+    let mut content = String::from("\n\n");
+    for author in &coauthors {
+        _ = writeln!(content, "Co-authored-by: {}", &author.to_string());
+    }
+
+    with_gitmessage_template_path_or_exit(|path| match fs::write(path, content) {
+        Ok(_) => {
+            println!("{}", get_main_author());
+            for author in &coauthors {
+                println!("{author}");
+            }
+        }
+        Err(e) => {
+            eprintln!("Error writing to .gitmessage template: {e}");
+            process::exit(1);
+        }
+    });
+}
+
+fn select_coauthors(coauthor_initials: &[String]) -> Vec<Author> {
+    let all_coauthors = get_available_coauthors();
+    let mut coauthors: Vec<Author> = Vec::new();
+
+    for initial in coauthor_initials {
+        match all_coauthors.get(initial) {
+            Some(coauthor) => coauthors.push(coauthor.clone()),
+            None => {
+                eprintln!("Error: author with initials {initial} not found");
+                process::exit(1);
+            }
+        }
+    }
+
+    coauthors
+}

src/bin/git-solo.rs

@@ -0,0 +1,16 @@
+use clap::Parser;
+use git_mob::{
+    cli, ensure_commit_template_is_set, get_main_author, with_gitmessage_template_path_or_exit,
+};
+use std::fs::File;
+
+fn main() {
+    let _opt = cli::GitSolo::parse();
+    let main_author = get_main_author();
+    println!("{main_author}");
+
+    with_gitmessage_template_path_or_exit(|path| {
+        let _template = File::create(path);
+    });
+    ensure_commit_template_is_set();
+}

src/cli.rs

@@ -1,69 +1,56 @@
-use clap::{Arg, ArgAction};
+use clap::Parser;
 
-pub fn git_mob_cmd() -> clap::Command {
+#[derive(Parser, Debug)]
-    clap::Command::new("git-mob")
+#[clap(version, name = "git-mob")]
-        .bin_name("git-mob")
+/// Assemble a group of co-authors to help you on your coding quest
-        .author("Martin Frost, martin@frost.codes")
+pub struct GitMob {
-        .version("0.0.0")
+    /// Prints list of available co-authors
-        .about("A command-line tool for social coding")
+    #[clap(short, long)]
-        .arg(Arg::new("add")
+    pub list: bool,
-             .display_order(3)
+    /// Overwrite the main author
-             .exclusive(true)
+    #[clap(short, long)]
-             .help("Add a coauthor to the database")
+    pub overwrite: Option<String>,
-             .long("add-coauthor")
+    /// A list of co-author initials
-             .num_args(3)
+    pub coauthors: Vec<String>,
-             .short('a')
-             .value_names(["handle", "name", "email"])
-        )
-        .arg(Arg::new("edit")
-             .display_order(3)
-             .exclusive(true)
-             .help("Edit a coauthor in the database")
-             .long("edit-coauthor")
-             .num_args(3)
-             .short('e')
-             .value_names(["handle", "name", "email"])
-        )
-        .arg(Arg::new("delete")
-             .display_order(3)
-             .exclusive(true)
-             .help("Delete a coauthor from the database")
-             .long("delete-coauthor")
-             .short('d')
-             .value_name("handle")
-        )
-        .arg(Arg::new("solo")
-             .action(ArgAction::SetTrue)
-             .display_order(1)
-             .exclusive(true)
-             .help("Continue on your coding quest by yourself")
-             .long("solo")
-             .short('s')
-        )
-        .arg(Arg::new("list")
-             .action(ArgAction::SetTrue)
-             .display_order(4)
-             .exclusive(true)
-             .help("List available coauthors in the database")
-             .long("list-coauthors")
-             .short('l')
-        )
-        .arg(Arg::new("with")
-             .conflicts_with_all(["add", "edit", "delete", "solo", "list"])
-             .exclusive(true)
-             .help("Choose coauthors to help you on your coding quest")
-             .long("with")
-             .num_args(1..)
-             .short('w')
-             .display_order(0)
-             .value_name("handle")
-        )
-        .arg(Arg::new("current")
-             .action(ArgAction::SetTrue)
-             .display_order(2)
-             .exclusive(true)
-             .help("Show current mob (including main author)")
-             .long("current-mob")
-             .short('c')
-        )
 }
+
+#[derive(Parser, Debug)]
+#[clap(name = "git-add-coauthor", version)]
+/// Add a co-author to your list of available co-authors
+pub struct GitAddCoauthor {
+    /// Co-author initials
+    pub initials: String,
+    /// The name of the co-author, in quotes, e.g. "Foo Bar"
+    pub name: String,
+    /// The email of the co-author
+    pub email: String,
+}
+
+#[derive(Parser, Debug)]
+#[clap(name = "git-edit-coauthor", version)]
+/// Edit a co-author in your list of available co-authors
+pub struct GitEditCoauthor {
+    /// Co-author initials
+    pub initials: String,
+    /// The name of the co-author, in quotes, e.g. "Foo Bar"
+    pub name: String,
+    /// The email of the co-author
+    pub email: String,
+}
+
+#[derive(Parser, Debug)]
+#[clap(name = "git-delete-coauthor", version)]
+/// Delete a co-author from your list of available co-authors
+pub struct GitDeleteCoauthor {
+    /// Co-author initials
+    pub initials: String,
+    /// The name of the co-author, in quotes, e.g. "Foo Bar"
+    pub name: String,
+    /// The email of the co-author
+    pub email: String,
+}
+
+#[derive(Parser, Debug)]
+#[clap(name = "git-solo", version)]
+/// Disband the mob and continue working solo.
+pub struct GitSolo {}

src/main.rs

@@ -1,180 +0,0 @@
-use git_mob::cli;
-use std::fmt::Write;
-use std::fs;
-use std::fs::File;
-use std::process;
-use git_mob::{
-    ensure_commit_template_is_set, get_available_coauthors,
-    get_main_author, set_main_author, with_gitmessage_template_path_or_exit,
-    Author, parse_coauthors_file, write_coauthors_file
-};
-
-fn main() {
-    let matches = cli::git_mob_cmd().get_matches();
-
-    println!("matches: {:?}", matches);
-
-    if let Some(handles) = matches.get_raw("with") {
-        println!("with: {:?}", handles);
-    }
-    if matches.get_one("solo") == Some(&true) {
-        solo();
-    }
-    if matches.get_one("current") == Some(&true) {
-        println!("current.");
-    }
-
-    if let Some(add_args) = matches.get_raw("add") {
-        println!("add: {:?}", add_args);
-
-    }
-    if let Some(edit_args) = matches.get_raw("edit") {
-        println!("edit: {:?}", edit_args);
-
-    }
-    if let Some(delete_handle) = matches.get_one::<String>("delete") {
-        println!("delete: {:?}", delete_handle);
-
-    }
-    if matches.get_one("list") == Some(&true) {
-        list_coauthors();
-    }
-
-
-
-    // match matches.subcommand_name() {
-    //     Some("add") => {
-    //         let args = matches.subcommand_matches("add").unwrap();
-    //         let handle = args.get_one("handle").unwrap();
-    //         let name = args.get_one("name").unwrap();
-    //         let email = args.get_one("email").unwrap();
-    //         add_coauthor(handle, name, email);
-    //     },
-    //     Some("edit") => {
-    //         let args = matches.subcommand_matches("edit").unwrap();
-    //         let handle = args.get_one("handle").unwrap();
-    //         let name = args.get_one("name").unwrap();
-    //         let email = args.get_one("email").unwrap();
-    //         edit_coauthor(handle, name, email);
-    //     },
-    //     Some("remove") => {
-    //         let handle = matches.subcommand_matches("remove").unwrap()
-    //             .get_one("handle").unwrap();
-    //         remove_coauthor(handle);
-    //     },
-    //     Some("list") => list_coauthors(),
-    //     Some("solo") => solo(),
-    //     Some("with") => {
-    //         let matches = matches.subcommand_matches("with").unwrap();
-    //         let handles: Vec<String> =
-    //             matches.get_many::<String>("handles").unwrap().map(|s| s.clone()).collect();
-
-    //         if let Some(handle) = matches.get_one::<String>("override") {
-    //             override_main_author(handle);
-    //         }
-
-    //         write_coauthors_to_gitmessage_file(&handles);
-    //     },
-    //     _ => println!("Something else"),
-    // }
-}
-
-fn list_coauthors() {
-    for (abbrev, author) in &get_available_coauthors() {
-        println!("{abbrev}\t{author}");
-    }
-}
-
-fn add_coauthor(handle: &String, name: &String, email: &String) {
-    let mut authors = parse_coauthors_file().unwrap_or_default();
-    let new_author = Author {
-        name: name.to_string(),
-        email: email.to_string(),
-    };
-
-    authors.insert(handle.to_string(), new_author);
-
-    write_coauthors_file(authors);
-}
-
-fn edit_coauthor(handle: &String, name: &String, email: &String) {
-    let mut authors = get_available_coauthors();
-
-    if let Some(author) = authors.get(handle) {
-        let mut updated_author: Author = author.clone();
-        updated_author.name = name.to_string();
-        updated_author.email = email.to_string();
-
-        authors.insert(handle.to_string(), updated_author);
-
-        write_coauthors_file(authors);
-    } else {
-        eprintln!("No author found with initials {}", handle);
-        process::exit(1);
-    };
-}
-
-fn remove_coauthor(handle: &String) {
-    let mut authors = get_available_coauthors();
-    authors.remove(handle);
-    write_coauthors_file(authors);
-}
-
-fn solo() {
-    let main_author = get_main_author();
-    println!("{main_author}");
-
-    with_gitmessage_template_path_or_exit(|path| {
-        let _template = File::create(path);
-    });
-    ensure_commit_template_is_set();
-}
-
-fn override_main_author(initials: &str) {
-    let all_authors = get_available_coauthors();
-    match all_authors.get(initials) {
-        Some(new_main_author) => set_main_author(new_main_author),
-        None => {
-            eprintln!("Error: author with initials {initials} not found");
-            process::exit(1);
-        }
-    }
-}
-
-fn write_coauthors_to_gitmessage_file(coauthor_initials: &[String]) {
-    let coauthors = select_coauthors(coauthor_initials);
-    let mut content = String::from("\n\n");
-    for author in &coauthors {
-        _ = writeln!(content, "Co-authored-by: {}", &author.to_string());
-    }
-
-    with_gitmessage_template_path_or_exit(|path| match fs::write(path, content) {
-        Ok(_) => {
-            println!("{}", get_main_author());
-            for author in &coauthors {
-                println!("{author}");
-            }
-        }
-        Err(e) => {
-            eprintln!("Error writing to .gitmessage template: {e}");
-            process::exit(1);
-        }
-    });
-}
-
-fn select_coauthors(coauthor_initials: &[String]) -> Vec<Author> {
-    let all_coauthors = get_available_coauthors();
-    let mut coauthors: Vec<Author> = Vec::new();
-
-    for initial in coauthor_initials {
-        match all_coauthors.get(initial) {
-            Some(coauthor) => coauthors.push(coauthor.clone()),
-            None => {
-                eprintln!("Error: author with initials {initial} not found");
-                process::exit(1);
-            }
-        }
-    }
-
-    coauthors
-}