Add rich text formatting features (#6)

* Add rich formatting to `/help`
* Create `EscapableInTelegramHTML` trait and implement it for types where `String: From<T>`
* Add rich formatting to `/reminder`
* Add rich formatting to `/whoami`
* Add rich formatting to the launch message

src/services/telegram/commands/help.rs

@@ -2,17 +2,18 @@ use anyhow::Context;
 use teloxide::Bot;
 use teloxide::payloads::SendMessageSetters;
 use teloxide::requests::Requester;
-use teloxide::types::{BotCommand, Message};
+use teloxide::types::{BotCommand, Message, ParseMode};
 use teloxide::utils::command::BotCommands;
 use super::{CommandResult};
 
 pub async fn handler_all(bot: &Bot, message: &Message) -> CommandResult {
 	let descriptions = super::Command::descriptions().to_string();
 
-	let text = format!("❓ Sono disponibili i seguenti comandi:\n\n{descriptions}");
+	let text = format!("❔ <b>Comandi disponibili</b>\n\n{descriptions}");
 
 	let _reply = bot
 		.send_message(message.chat.id, text)
+		.parse_mode(ParseMode::Html)
 		.reply_to_message_id(message.id)
 		.await
 		.context("Non è stato possibile inviare la risposta.")?;
@@ -62,10 +63,11 @@ pub async fn handler_specific(bot: &Bot, message: &Message, target: &str) -> Com
 		true => "",
 	};
 
-	let text = format!("❓ Il comando {}{}:\n\n{}", target.command, display_suffix, target.description);
+	let text = format!("❔ <b>Comando {}{}</b>\n\n{}", target.command, display_suffix, target.description);
 
 	let _reply = bot
 		.send_message(message.chat.id, text)
+		.parse_mode(ParseMode::Html)
 		.reply_to_message_id(message.id)
 		.await
 		.context("Non è stato possibile inviare la risposta.")?;

src/services/telegram/commands/reminder.rs

@@ -3,10 +3,11 @@ use anyhow::Context;
 use teloxide::Bot;
 use teloxide::payloads::SendMessageSetters;
 use teloxide::requests::Requester;
-use teloxide::types::{Message};
+use teloxide::types::{Message, ParseMode};
 use parse_datetime::parse_datetime_at_date;
 use once_cell::sync::Lazy;
 use regex::Regex;
+use crate::services::telegram::escape::EscapableInTelegramHTML;
 use super::{CommandResult};
 
 
@@ -55,14 +56,17 @@ impl FromStr for ReminderArgs {
 
 pub async fn handler(bot: &Bot, message: &Message, ReminderArgs { target, reminder}: ReminderArgs) -> CommandResult {
 	let text = format!(
-		"🕒 Promemoria per {} impostato\n\
+		"🕒 <b>Promemoria impostato</b>\n\
+		<i>{}</i>\n\
+		\n\
 		{}",
-		target.format("%c"),
-		reminder
+		target.format("%c").to_string().escape_telegram_html(),
+		reminder.clone().escape_telegram_html()
 	);
 
 	let _reply = bot
 		.send_message(message.chat.id, text)
+		.parse_mode(ParseMode::Html)
 		.reply_to_message_id(message.id)
 		.await
 		.context("Non è stato possibile inviare la conferma.")?;
@@ -72,14 +76,17 @@ pub async fn handler(bot: &Bot, message: &Message, ReminderArgs { target, remind
 	tokio::time::sleep(wait_duration).await;
 
 	let text = format!(
-		"🕒 Promemoria per {} attivato\n\
+		"🕒 <b>Promemoria attivato</b>\n\
+		<i>{}</i>\n\
+		\n\
 		{}",
-		target.format("%c"),
-		reminder
+		target.format("%c").to_string().escape_telegram_html(),
+		reminder.escape_telegram_html()
 	);
 
 	let _reply = bot
 		.send_message(message.chat.id, text)
+		.parse_mode(ParseMode::Html)
 		.reply_to_message_id(message.id)
 		.await
 		.context("Non è stato possibile inviare il promemoria.")?;

src/services/telegram/commands/whoami.rs

@@ -2,8 +2,9 @@ use anyhow::Context;
 use teloxide::Bot;
 use teloxide::payloads::SendMessageSetters;
 use teloxide::requests::Requester;
-use teloxide::types::{Message};
+use teloxide::types::{Message, ParseMode};
 use crate::database::models::{RoyalnetUser};
+use crate::services::telegram::escape::EscapableInTelegramHTML;
 use super::{CommandResult};
 
 pub async fn handler(bot: &Bot, message: &Message) -> CommandResult {
@@ -34,11 +35,13 @@ pub async fn handler(bot: &Bot, message: &Message) -> CommandResult {
 	let username = &royalnet_user.username;
 
 	let text = format!(
-		"👤 Nel database RYG, tu hai l'username «{username}»."
+		"👤 Nel database RYG, tu hai l'username <code>{}</code>.",
+		username.escape_telegram_html(),
 	);
 
 	let _reply = bot
 		.send_message(message.chat.id, text)
+		.parse_mode(ParseMode::Html)
 		.reply_to_message_id(message.id)
 		.await
 		.context("Non è stato possibile inviare la risposta.")?;

src/services/telegram/escape.rs

@@ -0,0 +1,15 @@
+pub trait EscapableInTelegramHTML {
+	fn escape_telegram_html(self) -> String;
+}
+
+impl<T> EscapableInTelegramHTML for T
+	where String: From<T>
+{
+	fn escape_telegram_html(self) -> String {
+		let s: String = String::from(self);
+		let s = s.replace("<", "&lt;");
+		let s = s.replace(">", "&gt;");
+		let s = s.replace("&", "&amp;");
+		s
+	}
+}

src/services/telegram/mod.rs

@@ -4,13 +4,16 @@ use anyhow::{Context, Error, Result};
 use regex::Regex;
 use teloxide::dispatching::{DefaultKey, Dispatcher, HandlerExt, UpdateFilterExt};
 use teloxide::dptree::entry;
+use teloxide::payloads::SendMessageSetters;
 use teloxide::requests::Requester;
-use teloxide::types::{Me, Message, Update};
+use teloxide::types::{Me, Message, ParseMode, Update};
+use crate::services::telegram::escape::EscapableInTelegramHTML;
 use super::RoyalnetService;
 
 #[allow(clippy::needless_pub_self)]
 pub(self) mod config;
 mod commands;
+pub(self) mod escape;
 
 pub struct BotService {
 	pub bot: Bot
@@ -32,12 +35,19 @@ impl BotService {
 		let id = &me.user.id;
 
 		let text = format!(
-			"💠 Servizio Telegram avviato\n\
-				Royalnet v{version}\n\
-				@{username} ({id})",
+			"💠 <b>Servizio Telegram avviato</b>\n\
+				\n\
+				Royalnet <a href='https://github.com/RYGhub/royalnet/releases/tag/v{}'>v{}</a>\n\
+				\n\
+				@{} [<code>{}</code>]",
+			version.escape_telegram_html(),
+			version.escape_telegram_html(),
+			username.escape_telegram_html(),
+			id.to_string().escape_telegram_html(),
 		);
 
 		self.bot.send_message(chat_id, text)
+			.parse_mode(ParseMode::Html)
 			.await
 			.context("Invio della notifica di avvio non riuscito.")?;