rust-tg-bot-raw 1.0.0-rc.1

use super::{push_opt, push_opt_str, Bot, Result};
use crate::request::request_parameter::RequestParameter;
use crate::types::{
    bot_command, bot_command_scope, bot_description, bot_name, chat_administrator_rights,
    menu_button,
};

#[allow(dead_code)]
impl Bot {
    // ======================================================================
    // Chat menu & commands
    // ======================================================================

    /// Use this method to change the bot's menu button in a private chat, or the default menu button.
    ///
    /// Calls the Telegram `setChatMenuButton` API method.
    pub async fn set_chat_menu_button_raw(
        &self,
        chat_id: Option<i64>,
        menu_button: Option<menu_button::MenuButton>,
    ) -> Result<bool> {
        let mut params = Vec::new();
        push_opt(&mut params, "chat_id", &chat_id)?;
        push_opt(&mut params, "menu_button", &menu_button)?;
        self.do_post("setChatMenuButton", params).await
    }

    /// Use this method to get the current value of the bot's menu button in a private chat.
    ///
    /// Calls the Telegram `getChatMenuButton` API method.
    pub async fn get_chat_menu_button_raw(
        &self,
        chat_id: Option<i64>,
    ) -> Result<menu_button::MenuButton> {
        let mut params = Vec::new();
        push_opt(&mut params, "chat_id", &chat_id)?;
        self.do_post("getChatMenuButton", params).await
    }

    /// Use this method to change the list of the bot's commands.
    ///
    /// Calls the Telegram `setMyCommands` API method.
    pub async fn set_my_commands_raw(
        &self,
        commands: Vec<bot_command::BotCommand>,
        scope: Option<bot_command_scope::BotCommandScope>,
        language_code: Option<&str>,
    ) -> Result<bool> {
        let mut params = vec![RequestParameter::new(
            "commands",
            serde_json::to_value(&commands)?,
        )];
        push_opt(&mut params, "scope", &scope)?;
        push_opt_str(&mut params, "language_code", language_code);
        self.do_post("setMyCommands", params).await
    }

    /// Use this method to get the current list of the bot's commands.
    ///
    /// Calls the Telegram `getMyCommands` API method.
    pub async fn get_my_commands_raw(
        &self,
        scope: Option<bot_command_scope::BotCommandScope>,
        language_code: Option<&str>,
    ) -> Result<Vec<bot_command::BotCommand>> {
        let mut params = Vec::new();
        push_opt(&mut params, "scope", &scope)?;
        push_opt_str(&mut params, "language_code", language_code);
        self.do_post("getMyCommands", params).await
    }

    /// Use this method to delete the list of the bot's commands for a given scope and language.
    ///
    /// Calls the Telegram `deleteMyCommands` API method.
    pub async fn delete_my_commands_raw(
        &self,
        scope: Option<bot_command_scope::BotCommandScope>,
        language_code: Option<&str>,
    ) -> Result<bool> {
        let mut params = Vec::new();
        push_opt(&mut params, "scope", &scope)?;
        push_opt_str(&mut params, "language_code", language_code);
        self.do_post("deleteMyCommands", params).await
    }

    /// Use this method to change the default administrator rights requested by the bot.
    ///
    /// Calls the Telegram `setMyDefaultAdministratorRights` API method.
    pub async fn set_my_default_administrator_rights_raw(
        &self,
        rights: Option<chat_administrator_rights::ChatAdministratorRights>,
        for_channels: Option<bool>,
    ) -> Result<bool> {
        let mut params = Vec::new();
        push_opt(&mut params, "rights", &rights)?;
        push_opt(&mut params, "for_channels", &for_channels)?;
        self.do_post("setMyDefaultAdministratorRights", params)
            .await
    }

    /// Use this method to get the current default administrator rights of the bot.
    ///
    /// Calls the Telegram `getMyDefaultAdministratorRights` API method.
    pub async fn get_my_default_administrator_rights_raw(
        &self,
        for_channels: Option<bool>,
    ) -> Result<chat_administrator_rights::ChatAdministratorRights> {
        let mut params = Vec::new();
        push_opt(&mut params, "for_channels", &for_channels)?;
        self.do_post("getMyDefaultAdministratorRights", params)
            .await
    }

    // ======================================================================
    // Bot description and name
    // ======================================================================

    /// Use this method to change the bot's description.
    ///
    /// Calls the Telegram `setMyDescription` API method.
    pub async fn set_my_description_raw(
        &self,
        description: Option<&str>,
        language_code: Option<&str>,
    ) -> Result<bool> {
        let mut params = Vec::new();
        push_opt_str(&mut params, "description", description);
        push_opt_str(&mut params, "language_code", language_code);
        self.do_post("setMyDescription", params).await
    }

    /// Use this method to get the current bot description.
    ///
    /// Calls the Telegram `getMyDescription` API method.
    pub async fn get_my_description_raw(
        &self,
        language_code: Option<&str>,
    ) -> Result<bot_description::BotDescription> {
        let mut params = Vec::new();
        push_opt_str(&mut params, "language_code", language_code);
        self.do_post("getMyDescription", params).await
    }

    /// Use this method to change the bot's short description.
    ///
    /// Calls the Telegram `setMyShortDescription` API method.
    pub async fn set_my_short_description_raw(
        &self,
        short_description: Option<&str>,
        language_code: Option<&str>,
    ) -> Result<bool> {
        let mut params = Vec::new();
        push_opt_str(&mut params, "short_description", short_description);
        push_opt_str(&mut params, "language_code", language_code);
        self.do_post("setMyShortDescription", params).await
    }

    /// Use this method to get the current bot short description.
    ///
    /// Calls the Telegram `getMyShortDescription` API method.
    pub async fn get_my_short_description_raw(
        &self,
        language_code: Option<&str>,
    ) -> Result<bot_description::BotShortDescription> {
        let mut params = Vec::new();
        push_opt_str(&mut params, "language_code", language_code);
        self.do_post("getMyShortDescription", params).await
    }

    /// Use this method to change the bot's name.
    ///
    /// Calls the Telegram `setMyName` API method.
    pub async fn set_my_name_raw(
        &self,
        name: Option<&str>,
        language_code: Option<&str>,
    ) -> Result<bool> {
        let mut params = Vec::new();
        push_opt_str(&mut params, "name", name);
        push_opt_str(&mut params, "language_code", language_code);
        self.do_post("setMyName", params).await
    }

    /// Use this method to get the current bot name.
    ///
    /// Calls the Telegram `getMyName` API method.
    pub async fn get_my_name_raw(&self, language_code: Option<&str>) -> Result<bot_name::BotName> {
        let mut params = Vec::new();
        push_opt_str(&mut params, "language_code", language_code);
        self.do_post("getMyName", params).await
    }
}