Add keygen command.

src/commands/keygen.rs

@@ -2,7 +2,8 @@ use std::ffi::OsString;
 use std::io::Write;
 use std::path::Path;
 
-use clap::{builder::ValueParser, ValueEnum};
+use clap::builder::ValueParser;
+use clap::ValueEnum;
 use domain::base::iana::{DigestAlg, SecAlg};
 use domain::base::name::Name;
 use domain::base::zonefile_fmt::ZonefileFmt;
@@ -27,6 +28,7 @@ pub struct Keygen {
     /// - ECDSAP384SHA384:    An ECDSA P-384 SHA-384 key (algorithm 14)
     /// - ED25519:            An Ed25519 key (algorithm 15)
     /// - ED448:              An Ed448 key (algorithm 16)
+    #[allow(rustdoc::invalid_html_tags)]
     #[arg(
         short = 'a',
         long = "algorithm",
@@ -63,7 +65,7 @@ pub struct Keygen {
     symlink: SymlinkArg,
 
     /// The domain name to generate a key for
-    #[arg(value_name = "domain name", value_parser = ValueParser::new(parse_name))]
+    #[arg(value_name = "DOMAIN_NAME", value_parser = ValueParser::new(parse_name))]
     name: Name<Vec<u8>>,
 }
 

src/commands/mod.rs

@@ -39,6 +39,7 @@ pub enum Command {
     /// <tag> is the 16-bit tag of the key, zero-padded to 5 digits.
     ///
     /// Upon completion, 'K<name>+<alg>+<tag>' will be printed.
+    #[allow(rustdoc::invalid_html_tags)]
     #[command(name = "keygen", verbatim_doc_comment)]
     Keygen(self::keygen::Keygen),
 

src/util.rs

@@ -1,8 +1,10 @@
 //! A utility module for common operations.
 
-use std::{fs::File, path::Path};
+use std::fs::File;
+use std::path::Path;
 
-use crate::{env::Env, error::Result};
+use crate::env::Env;
+use crate::error::Result;
 
 /// Create and open a file.
 pub fn create_new_file(env: &impl Env, path: impl AsRef<Path>) -> Result<File> {