Check if an email address exists without sending any email, written in Rust. Comes with a ⚙️ HTTP backend.
Rust emailemail-validationemail-validation-apiemail-verificationemail-verification-apiemail-verifierhacktoberfest
use check_if_email_exists::{
check_email, smtp::verif_method::VerifMethod, CheckEmailInputBuilder, CheckEmailInputProxy,
};
use clap::Parser;
use once_cell::sync::Lazy;
/// CLI options of this binary.
#[derive(Parser, Debug)]
#[clap(version, about)]
pub struct Cli {
/// The email to use in the `MAIL FROM:` SMTP command.
#[clap(long, env, default_value = "[email protected]")]
pub from_email: String,
/// The name to use in the `EHLO:` SMTP command.
#[clap(long, env, default_value = "gmail.com")]
pub hello_name: String,
/// Use the specified SOCKS5 proxy host to perform email verification.
#[clap(long, env)]
pub proxy_host: Option<String>,
/// Use the specified SOCKS5 proxy port to perform email verification.
/// Only used when `--proxy-host` flag is set.
#[clap(long, env, default_value = "1080")]
pub proxy_port: u16,
/// Username passed to the specified SOCKS5 proxy port to perform email verification.
/// Only used when `--proxy-host` flag is set.
#[clap(long, env)]
pub proxy_username: Option<String>,
/// Username passed to the specified SOCKS5 proxy port to perform email verification.
/// Only used when `--proxy-host` flag is set.
#[clap(long, env)]
pub proxy_password: Option<String>,
/// The port to use for the SMTP request.
#[clap(long, env, default_value = "25")]
pub smtp_port: u16,
/// Whether to check if a gravatar image is existing for the given email.
#[clap(long, env, default_value = "false", parse(try_from_str))]
pub check_gravatar: bool,
/// HaveIBeenPnwed API key, ignore if not provided.
#[clap(long, env, parse(try_from_str))]
pub haveibeenpwned_api_key: Option<String>,
/// The email to check.
pub to_email: String,
}
/// Global config of this application.
pub(crate) static CONF: Lazy<Cli> = Lazy::new(Cli::parse);
#[tokio::main]
async fn main() -> Result<(), anyhow::Error> {
tracing_subscriber::fmt::init();
let to_email = &CONF.to_email;
let proxy = CONF
.proxy_host
.as_ref()
.map(|proxy_host| CheckEmailInputProxy {
host: proxy_host.clone(),
port: CONF.proxy_port,
username: CONF.proxy_username.clone(),
password: CONF.proxy_password.clone(),
timeout_ms: None,
});
let verif_method = VerifMethod::new_with_same_config_for_all(
proxy,
CONF.hello_name.clone(),
CONF.from_email.clone(),
CONF.smtp_port,
None,
1,
);
let mut input = CheckEmailInputBuilder::default();
let input = input
.to_email(to_email.clone())
.verif_method(verif_method)
.check_gravatar(CONF.check_gravatar)
.haveibeenpwned_api_key(CONF.haveibeenpwned_api_key.clone())
.backend_name("reacher-cli".to_string())
.build()?;
let result = check_email(&input).await;
match serde_json::to_string_pretty(&result) {
Ok(output) => {
println!("{output}");
}
Err(err) => {
println!("{err}");
}
};
Ok(())
}