//! A helper library for parsing values from `clap::ArgMatches`. use clap::ArgMatches; use eth2_network_config::Eth2NetworkConfig; use ssz::Decode; use std::path::PathBuf; use std::str::FromStr; pub mod flags; pub const BAD_TESTNET_DIR_MESSAGE: &str = "The hard-coded testnet directory was invalid. \ This happens when Lighthouse is migrating between spec versions \ or when there is no default public network to connect to. \ During these times you must specify a --testnet-dir."; /// Attempts to load the testnet dir at the path if `name` is in `matches`, returning an error if /// the path cannot be found or the testnet dir is invalid. pub fn parse_testnet_dir( matches: &ArgMatches, name: &'static str, ) -> Result, String> { let path = parse_required::(matches, name)?; Eth2NetworkConfig::load(path.clone()) .map_err(|e| format!("Unable to open testnet dir at {:?}: {}", path, e)) .map(Some) } /// Attempts to load a hardcoded network config if `name` is in `matches`, returning an error if /// the name is not a valid network name. pub fn parse_hardcoded_network( matches: &ArgMatches, name: &str, ) -> Result, String> { let network_name = parse_required::(matches, name)?; Eth2NetworkConfig::constant(network_name.as_str()) } /// If `name` is in `matches`, parses the value as a path. Otherwise, attempts to find the user's /// home directory and appends `default` to it. pub fn parse_path_with_default_in_home_dir( matches: &ArgMatches, name: &'static str, default: PathBuf, ) -> Result { matches .value_of(name) .map(|dir| { dir.parse::() .map_err(|e| format!("Unable to parse {}: {}", name, e)) }) .unwrap_or_else(|| { dirs::home_dir() .map(|home| home.join(default)) .ok_or_else(|| format!("Unable to locate home directory. Try specifying {}", name)) }) } /// Returns the value of `name` or an error if it is not in `matches` or does not parse /// successfully using `std::string::FromStr`. pub fn parse_required(matches: &ArgMatches, name: &str) -> Result where T: FromStr, ::Err: std::fmt::Display, { parse_optional(matches, name)?.ok_or_else(|| format!("{} not specified", name)) } /// Returns the value of `name` (if present) or an error if it does not parse successfully using /// `std::string::FromStr`. pub fn parse_optional(matches: &ArgMatches, name: &str) -> Result, String> where T: FromStr, ::Err: std::fmt::Display, { matches .value_of(name) .map(|val| { val.parse() .map_err(|e| format!("Unable to parse {}: {}", name, e)) }) .transpose() } /// Returns the value of `name` or an error if it is not in `matches` or does not parse /// successfully using `ssz::Decode`. /// /// Expects the value of `name` to be 0x-prefixed ASCII-hex. pub fn parse_ssz_required( matches: &ArgMatches, name: &'static str, ) -> Result { parse_ssz_optional(matches, name)?.ok_or_else(|| format!("{} not specified", name)) } /// Returns the value of `name` (if present) or an error if it does not parse successfully using /// `ssz::Decode`. /// /// Expects the value of `name` (if any) to be 0x-prefixed ASCII-hex. pub fn parse_ssz_optional( matches: &ArgMatches, name: &'static str, ) -> Result, String> { matches .value_of(name) .map(|val| { if let Some(stripped) = val.strip_prefix("0x") { let vec = hex::decode(stripped) .map_err(|e| format!("Unable to parse {} as hex: {:?}", name, e))?; T::from_ssz_bytes(&vec) .map_err(|e| format!("Unable to parse {} as SSZ: {:?}", name, e)) } else { Err(format!("Unable to parse {}, must have 0x prefix", name)) } }) .transpose() }