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
mod error;
mod v0;
mod v1;
mod version;
use crate::config::BackendConfig;
use check_if_email_exists::LOG_TARGET;
use error::handle_rejection;
pub use error::ReacherResponseError;
use sqlxmq::JobRunnerHandle;
use std::env;
use std::net::IpAddr;
use std::sync::Arc;
use tracing::info;
pub use v0::check_email::post::CheckEmailRequest;
use warp::Filter;
pub fn create_routes(
config: Arc<BackendConfig>,
) -> impl Filter<Extract = (impl warp::Reply,), Error = warp::Rejection> + Clone {
let pg_pool = config.get_pg_pool();
version::get::get_version()
.or(v0::check_email::post::post_check_email(Arc::clone(&config)))
// The 3 following routes will 404 if o is None.
.or(v0::bulk::post::create_bulk_job(
Arc::clone(&config),
pg_pool.clone(),
))
.or(v0::bulk::get::get_bulk_job_status(pg_pool.clone()))
.or(v0::bulk::results::get_bulk_job_result(pg_pool))
.or(v1::check_email::post::v1_check_email(Arc::clone(&config)))
.or(v1::bulk::post::v1_create_bulk_job(Arc::clone(&config)))
.or(v1::bulk::get_progress::v1_get_bulk_job_progress(
Arc::clone(&config),
))
.or(v1::bulk::get_results::v1_get_bulk_job_results(config))
.recover(handle_rejection)
}
/// Runs the Warp server.
///
/// This function starts the Warp server and listens for incoming requests.
/// It returns a `Result` indicating whether the server started successfully or
/// encountered an error, as well as an optional `JobRunnerHandle` if the bulk
/// job listener is enabled. The handle can be used to stop the listener or to
/// keep it alive.
pub async fn run_warp_server(
config: Arc<BackendConfig>,
) -> Result<Option<JobRunnerHandle>, anyhow::Error> {
let host = config
.http_host
.parse::<IpAddr>()
.unwrap_or_else(|_| panic!("Invalid host: {}", config.http_host));
// For backwards compatibility, we allow the port to be set via the
// environment variable PORT, instead of the new configuration file. The
// PORT environment variable takes precedence.
let port = env::var("PORT")
.map(|port: String| {
port.parse::<u16>()
.unwrap_or_else(|_| panic!("Invalid port: {}", port))
})
.unwrap_or(config.http_port);
let routes = create_routes(Arc::clone(&config));
// Run v0 bulk job listener.
let is_bulk_enabled = env::var("RCH_ENABLE_BULK").unwrap_or_else(|_| "0".into()) == "1";
let runner = if is_bulk_enabled {
let pg_pool = config.get_pg_pool().expect(
"Please set the RCH__STORAGE__POSTGRES__DB_URL environment when RCH_ENABLE_BULK is set",
);
let runner = v0::bulk::create_job_registry(&pg_pool).await?;
Some(runner)
} else {
None
};
info!(target: LOG_TARGET, host=?host,port=?port, "Server is listening");
warp::serve(routes).run((host, port)).await;
// Returning runner, because dropping it would stop the listener.
Ok(runner)
}
/// The header which holds the Reacher backend secret.
pub const REACHER_SECRET_HEADER: &str = "x-reacher-secret";
/// Warp filter to check that the header secret is correct, if the header is
/// set in the config.
pub fn check_header(config: Arc<BackendConfig>) -> warp::filters::BoxedFilter<()> {
if let Some(secret) = config.header_secret.clone() {
if secret.is_empty() {
return warp::any().boxed();
}
let secret: &'static str = Box::leak(Box::new(secret));
warp::header::exact(REACHER_SECRET_HEADER, secret).boxed()
} else {
warp::any().boxed()
}
}