1db9dbe390 2024-11-28 arcade: //! Simple SMTP-to-Telegram gateway. Can parse email and send them as telegram
1db9dbe390 2024-11-28 arcade: //! messages to specified chats, generally you specify which email address is
1db9dbe390 2024-11-28 arcade: //! available in configuration, everything else is sent to default address.
1db9dbe390 2024-11-28 arcade:
9fecd57a99 2026-10-28 arcade: use smol_macros::{
9fecd57a99 2026-10-28 arcade: LocalExecutor,
9fecd57a99 2026-10-28 arcade: main,
9fecd57a99 2026-10-28 arcade: };
9fecd57a99 2026-10-28 arcade:
9fecd57a99 2026-10-28 arcade: use std::{
9fecd57a99 2026-10-28 arcade: os::unix::fs::PermissionsExt,
9fecd57a99 2026-10-28 arcade: path::Path,
9fecd57a99 2026-10-28 arcade: };
9fecd57a99 2026-10-28 arcade:
9fecd57a99 2026-10-28 arcade: use clap::Parser;
9fecd57a99 2026-10-28 arcade: use smol::fs::metadata;
9fecd57a99 2026-10-28 arcade: use stacked_errors::{
9fecd57a99 2026-10-28 arcade: Result,
9fecd57a99 2026-10-28 arcade: StackableErr,
9fecd57a99 2026-10-28 arcade: bail,
9fecd57a99 2026-10-28 arcade: };
9fecd57a99 2026-10-28 arcade:
9fecd57a99 2026-10-28 arcade: use smtp2tg::mail::MailServer;
9fecd57a99 2026-10-28 arcade:
9fecd57a99 2026-10-28 arcade: /// SMTP-to-Telegram gateway
9fecd57a99 2026-10-28 arcade: #[derive(Parser, Debug)]
9fecd57a99 2026-10-28 arcade: #[command(name = "smtp2tg")]
9fecd57a99 2026-10-28 arcade: #[command(about = format!("SMTP-to-Telegram gateway v{}, (C) 2024 - 2026", env!("CARGO_PKG_VERSION")), long_about = None)]
9fecd57a99 2026-10-28 arcade: struct Args {
9fecd57a99 2026-10-28 arcade: /// Set configuration file location
9fecd57a99 2026-10-28 arcade: #[arg(short, long, default_value = "smtp2tg.toml")]
9fecd57a99 2026-10-28 arcade: config: String,
9fecd57a99 2026-10-28 arcade: }
9fecd57a99 2026-10-28 arcade:
9fecd57a99 2026-10-28 arcade: main! {
9fecd57a99 2026-10-28 arcade: /// Main asynchronous entry point for the application. Runs the gateway using
9fecd57a99 2026-10-28 arcade: /// the configuration selected on the command line.
9fecd57a99 2026-10-28 arcade: ///
9fecd57a99 2026-10-28 arcade: /// The configuration file must use owner-only permissions. Once configured,
9fecd57a99 2026-10-28 arcade: /// the SMTP server runs until it stops or encounters an error.
9fecd57a99 2026-10-28 arcade: ///
9fecd57a99 2026-10-28 arcade: /// # Errors
9fecd57a99 2026-10-28 arcade: /// Returns an error if the configuration file is missing, inaccessible,
9fecd57a99 2026-10-28 arcade: /// insecure, malformed, or contains invalid required settings.
9fecd57a99 2026-10-28 arcade: /// Also returns an error if the system hostname cannot be read or is not
9fecd57a99 2026-10-28 arcade: /// valid UTF-8, or if mail server initialisation fails.
9fecd57a99 2026-10-28 arcade: ///
9fecd57a99 2026-10-28 arcade: /// # Panics
9fecd57a99 2026-10-28 arcade: /// Panics if configuring or serving the SMTP server fails.
9fecd57a99 2026-10-28 arcade: async fn main (ex: &LocalExecutor<'_>) -> Result<()> {
9fecd57a99 2026-10-28 arcade: let args = Args::parse();
9fecd57a99 2026-10-28 arcade: let settings = {
9fecd57a99 2026-10-28 arcade: // Load configuration defaults and overrides after checking file permissions.
9fecd57a99 2026-10-28 arcade: let config_file = Path::new(&args.config);
9fecd57a99 2026-10-28 arcade: if !config_file.try_exists().stack()? {
9fecd57a99 2026-10-28 arcade: bail!("Configuration file not found: {config_file:?}\n\
9fecd57a99 2026-10-28 arcade: Hint: Ensure the file exists and the path is correct.");
9fecd57a99 2026-10-28 arcade: };
9fecd57a99 2026-10-28 arcade: {
9fecd57a99 2026-10-28 arcade: let meta = metadata(config_file).await.stack()?;
9fecd57a99 2026-10-28 arcade: if (!0o100600 & meta.permissions().mode()) > 0 {
9fecd57a99 2026-10-28 arcade: bail!("Configuration file permissions are insecure {config_file:?}\n\
9fecd57a99 2026-10-28 arcade: Current permissions: {:o}\n\
9fecd57a99 2026-10-28 arcade: Required: 0600 (owner read/write only).\n\
9fecd57a99 2026-10-28 arcade: Fix with: chmod 600 {config_file:?}",
9fecd57a99 2026-10-28 arcade: meta.permissions().mode());
9fecd57a99 2026-10-28 arcade: } }
9fecd57a99 2026-10-28 arcade: config::Config::builder()
9fecd57a99 2026-10-28 arcade: .set_default("api_gateway", "https://api.telegram.org").stack()?
9fecd57a99 2026-10-28 arcade: .set_default("fields", vec!["date", "from", "subject"]).stack()?
9fecd57a99 2026-10-28 arcade: .set_default("hostname", "smtp.2.tg").stack()?
9fecd57a99 2026-10-28 arcade: .set_default("listen_on", "0.0.0.0:1025").stack()?
9fecd57a99 2026-10-28 arcade: .set_default("domains", vec!["localhost",
9fecd57a99 2026-10-28 arcade: hostname::get().context("Failed to get current hostname")?
9fecd57a99 2026-10-28 arcade: .to_str().context("Can't convert hostname to string, bad UTF-8?")?]).stack()?
9fecd57a99 2026-10-28 arcade: .add_source(config::File::from(config_file))
9fecd57a99 2026-10-28 arcade: .build()
9fecd57a99 2026-10-28 arcade: .with_context(|| format!(
9fecd57a99 2026-10-28 arcade: "Failed to parse configuration file: {config_file:?}\n\
9fecd57a99 2026-10-28 arcade: Check syntax against smtp2tg.toml.example.\n\
9fecd57a99 2026-10-28 arcade: Common issues: missing quotes, trailing commas in inline tables, or invalid types."
9fecd57a99 2026-10-28 arcade: ))?
9fecd57a99 2026-10-28 arcade: };
9fecd57a99 2026-10-28 arcade:
9fecd57a99 2026-10-28 arcade: let listen_on = settings.get_string("listen_on").stack()?;
9fecd57a99 2026-10-28 arcade: let server_name = settings.get_string("hostname").stack()?;
9fecd57a99 2026-10-28 arcade: let core = MailServer::new(settings)?;
9fecd57a99 2026-10-28 arcade: let mut server = mailin_embedded::Server::new(core);
9fecd57a99 2026-10-28 arcade:
9fecd57a99 2026-10-28 arcade: // TODO: remove unwraps when mailin-embedded bumps with better error handling
9fecd57a99 2026-10-28 arcade: server.with_name(server_name)
9fecd57a99 2026-10-28 arcade: .with_ssl(mailin_embedded::SslConfig::None).unwrap()
9fecd57a99 2026-10-28 arcade: .with_addr(listen_on).unwrap();
9fecd57a99 2026-10-28 arcade: server.serve().unwrap();
9fecd57a99 2026-10-28 arcade:
9fecd57a99 2026-10-28 arcade: Ok(())
9fecd57a99 2026-10-28 arcade: } }