512369f93e 2026-08-01 arcade: //! SMTP-to-Telegram gateway main library.
512369f93e 2026-08-01 arcade: //!
512369f93e 2026-08-01 arcade: //! This module provides the core functionality for receiving emails via SMTP
512369f93e 2026-08-01 arcade: //! and forwarding them to Telegram chats.
512369f93e 2026-08-01 arcade: //!
512369f93e 2026-08-01 arcade: //! As we are not actually exporting this lib there would be no local Error's
512369f93e 2026-08-01 arcade: //! for now, everything will be just .stack()?'ed and propagated like in real
512369f93e 2026-08-01 arcade: //! bin The lib here is just to separate all tests from main code into tests/
512369f93e 2026-08-01 arcade:
713c1e7fb2 2026-07-31 arcade: pub mod mail;
3c858ed7c4 2026-07-31 arcade: mod telegram;
3c858ed7c4 2026-07-31 arcade: pub mod utils;
3c858ed7c4 2026-07-31 arcade:
3c858ed7c4 2026-07-31 arcade: use crate::mail::MailServer;
3c858ed7c4 2026-07-31 arcade:
713c1e7fb2 2026-07-31 arcade: use std::{
713c1e7fb2 2026-07-31 arcade: io::Cursor,
713c1e7fb2 2026-07-31 arcade: os::unix::fs::PermissionsExt,
713c1e7fb2 2026-07-31 arcade: path::Path,
3c858ed7c4 2026-07-31 arcade: };
713c1e7fb2 2026-07-31 arcade:
512369f93e 2026-08-01 arcade: use clap::Parser;
3c858ed7c4 2026-07-31 arcade: use smol::{
3c858ed7c4 2026-07-31 arcade: fs::metadata,
3c858ed7c4 2026-07-31 arcade: };
3c858ed7c4 2026-07-31 arcade: use stacked_errors::{
3c858ed7c4 2026-07-31 arcade: Result,
3c858ed7c4 2026-07-31 arcade: StackableErr,
3c858ed7c4 2026-07-31 arcade: bail,
3c858ed7c4 2026-07-31 arcade: };
3c858ed7c4 2026-07-31 arcade:
512369f93e 2026-08-01 arcade: /// SMTP-to-Telegram gateway
512369f93e 2026-08-01 arcade: #[derive(Parser, Debug)]
512369f93e 2026-08-01 arcade: #[command(name = "smtp2tg")]
512369f93e 2026-08-01 arcade: #[command(about = format!("SMTP-to-Telegram gateway v{}, (C) 2024 - 2026", env!("CARGO_PKG_VERSION")), long_about = None)]
512369f93e 2026-08-01 arcade: struct Args {
512369f93e 2026-08-01 arcade: /// Set configuration file location
512369f93e 2026-08-01 arcade: #[arg(short, long, default_value = "smtp2tg.toml")]
512369f93e 2026-08-01 arcade: config: String,
512369f93e 2026-08-01 arcade: }
512369f93e 2026-08-01 arcade:
512369f93e 2026-08-01 arcade: /// Main asynchronous entry point for the application.
512369f93e 2026-08-01 arcade: ///
512369f93e 2026-08-01 arcade: /// Parses command-line arguments, loads configuration, and starts the SMTP
512369f93e 2026-08-01 arcade: /// server.
512369f93e 2026-08-01 arcade: ///
512369f93e 2026-08-01 arcade: /// # Errors
512369f93e 2026-08-01 arcade: /// Returns an error if configuration is invalid, files are inaccessible, or
512369f93e 2026-08-01 arcade: /// server fails to start.
713c1e7fb2 2026-07-31 arcade: pub async fn async_main () -> Result<()> {
512369f93e 2026-08-01 arcade: let args = Args::parse();
512369f93e 2026-08-01 arcade: let config_file = Path::new(&args.config);
3c858ed7c4 2026-07-31 arcade: if !config_file.exists() {
3c858ed7c4 2026-07-31 arcade: bail!("can't read configuration from {config_file:?}");
3c858ed7c4 2026-07-31 arcade: };
3c858ed7c4 2026-07-31 arcade: {
3c858ed7c4 2026-07-31 arcade: let meta = metadata(config_file).await.stack()?;
3c858ed7c4 2026-07-31 arcade: if (!0o100600 & meta.permissions().mode()) > 0 {
3c858ed7c4 2026-07-31 arcade: bail!("other users can read or write config file {config_file:?}\n\
3c858ed7c4 2026-07-31 arcade: File permissions: {:o}", meta.permissions().mode());
3c858ed7c4 2026-07-31 arcade: }
3c858ed7c4 2026-07-31 arcade: }
3c858ed7c4 2026-07-31 arcade: let settings: config::Config = config::Config::builder()
3c858ed7c4 2026-07-31 arcade: .set_default("api_gateway", "https://api.telegram.org").stack()?
3c858ed7c4 2026-07-31 arcade: .set_default("fields", vec!["date", "from", "subject"]).stack()?
3c858ed7c4 2026-07-31 arcade: .set_default("hostname", "smtp.2.tg").stack()?
3c858ed7c4 2026-07-31 arcade: .set_default("listen_on", "0.0.0.0:1025").stack()?
713c1e7fb2 2026-07-31 arcade: .set_default("domains", vec!["localhost",
98c5a42df0 2026-08-01 arcade: hostname::get().context("Failed to get current hostname")?
98c5a42df0 2026-08-01 arcade: .to_str().context("Can't convert hostname to string, bad UTF-8?")?]).stack()?
3c858ed7c4 2026-07-31 arcade: .add_source(config::File::from(config_file))
3c858ed7c4 2026-07-31 arcade: .build()
3c858ed7c4 2026-07-31 arcade: .with_context(|| format!("[{config_file:?}] there was an error reading config\n\
3c858ed7c4 2026-07-31 arcade: \tplease consult \"smtp2tg.toml.example\" for details"))?;
3c858ed7c4 2026-07-31 arcade:
3c858ed7c4 2026-07-31 arcade: let listen_on = settings.get_string("listen_on").stack()?;
3c858ed7c4 2026-07-31 arcade: let server_name = settings.get_string("hostname").stack()?;
3c858ed7c4 2026-07-31 arcade: let core = MailServer::new(settings)?;
3c858ed7c4 2026-07-31 arcade: let mut server = mailin_embedded::Server::new(core);
3c858ed7c4 2026-07-31 arcade:
98c5a42df0 2026-08-01 arcade: // TODO: remove unwraps when mailin-embedded bumps with better error handling
3c858ed7c4 2026-07-31 arcade: server.with_name(server_name)
3c858ed7c4 2026-07-31 arcade: .with_ssl(mailin_embedded::SslConfig::None).unwrap()
3c858ed7c4 2026-07-31 arcade: .with_addr(listen_on).unwrap();
3c858ed7c4 2026-07-31 arcade: server.serve().unwrap();
3c858ed7c4 2026-07-31 arcade:
3c858ed7c4 2026-07-31 arcade: Ok(())
3c858ed7c4 2026-07-31 arcade: }