Annotation For src/main.rs
Logged in as anonymous

Origin for each line in src/main.rs from check-in ac6ac8c108:

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