binance-sdk 44.0.1

pub mod rest_api;
pub mod websocket_api;
pub mod websocket_streams;

use crate::common::{
    config::{ConfigurationRestApi, ConfigurationWebsocketApi, ConfigurationWebsocketStreams},
    constants::{
        SPOT_REST_API_DEMO_URL, SPOT_REST_API_PROD_URL, SPOT_REST_API_TESTNET_URL,
        SPOT_WS_API_DEMO_URL, SPOT_WS_API_PROD_URL, SPOT_WS_API_TESTNET_URL,
        SPOT_WS_STREAMS_DEMO_URL, SPOT_WS_STREAMS_PROD_URL, SPOT_WS_STREAMS_TESTNET_URL,
    },
    utils::build_user_agent,
};

/// Represents the Spot REST API client for interacting with the Binance Spot REST API.
///
/// This struct provides methods to create REST API clients for production , demo and testnet environments.
pub struct SpotRestApi {}

impl SpotRestApi {
    /// Creates a REST API client with the given configuration.
    ///
    /// If no base path is specified in the configuration, defaults to the production Spot REST API URL.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the REST API client
    ///
    /// # Returns
    ///
    /// A new REST API client configured with the provided settings
    #[must_use]
    pub fn from_config(mut config: ConfigurationRestApi) -> rest_api::RestApi {
        config.user_agent = build_user_agent("spot");
        if config.base_path.is_none() {
            config.base_path = Some(SPOT_REST_API_PROD_URL.to_string());
        }
        rest_api::RestApi::new(config)
    }

    /// Creates a REST API client configured for the production environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the REST API client
    ///
    /// # Returns
    ///
    /// A new REST API client configured for the production environment
    #[must_use]
    pub fn production(mut config: ConfigurationRestApi) -> rest_api::RestApi {
        config.base_path = Some(SPOT_REST_API_PROD_URL.to_string());
        SpotRestApi::from_config(config)
    }

    /// Creates a REST API client configured for the testnet environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the REST API client
    ///
    /// # Returns
    ///
    /// A new REST API client configured for the testnet environment
    #[must_use]
    pub fn testnet(mut config: ConfigurationRestApi) -> rest_api::RestApi {
        config.base_path = Some(SPOT_REST_API_TESTNET_URL.to_string());
        SpotRestApi::from_config(config)
    }

    /// Creates a REST API client configured for the demo environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the REST API client
    ///
    /// # Returns
    ///
    /// A new REST API client configured for the demo environment
    #[must_use]
    pub fn demo(mut config: ConfigurationRestApi) -> rest_api::RestApi {
        config.base_path = Some(SPOT_REST_API_DEMO_URL.to_string());
        SpotRestApi::from_config(config)
    }
}

/// Represents the Spot WebSocket API client for interacting with the Binance Spot WebSocket API.
///
/// This struct provides methods to create WebSocket API clients for production , demo and testnet environments.
pub struct SpotWsApi {}

impl SpotWsApi {
    /// Creates a WebSocket API client with the given configuration.
    ///
    /// If no WS URL is specified in the configuration, defaults to the production Spot WebSocket API URL.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the WebSocket API client
    ///
    /// # Returns
    ///
    /// A new WebSocket API client configured with the provided settings
    #[must_use]
    pub fn from_config(mut config: ConfigurationWebsocketApi) -> websocket_api::WebsocketApiHandle {
        config.user_agent = build_user_agent("spot");
        if config.ws_url.is_none() {
            config.ws_url = Some(SPOT_WS_API_PROD_URL.to_string());
        }
        websocket_api::WebsocketApiHandle::new(config)
    }

    /// Creates a WebSocket API client configured for the production environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the WebSocket API client
    ///
    /// # Returns
    ///
    /// A new WebSocket API client configured for the production environment
    #[must_use]
    pub fn production(mut config: ConfigurationWebsocketApi) -> websocket_api::WebsocketApiHandle {
        config.ws_url = Some(SPOT_WS_API_PROD_URL.to_string());
        SpotWsApi::from_config(config)
    }

    /// Creates a WebSocket API client configured for the testnet environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the WebSocket API client
    ///
    /// # Returns
    ///
    /// A new WebSocket API client configured for the testnet environment
    #[must_use]
    pub fn testnet(mut config: ConfigurationWebsocketApi) -> websocket_api::WebsocketApiHandle {
        config.ws_url = Some(SPOT_WS_API_TESTNET_URL.to_string());
        SpotWsApi::from_config(config)
    }

    /// Creates a WebSocket API client configured for the demo environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the WebSocket API client
    ///
    /// # Returns
    ///
    /// A new WebSocket API client configured for the demo environment
    #[must_use]
    pub fn demo(mut config: ConfigurationWebsocketApi) -> websocket_api::WebsocketApiHandle {
        config.ws_url = Some(SPOT_WS_API_DEMO_URL.to_string());
        SpotWsApi::from_config(config)
    }
}

/// Represents the Spot WebSocket Streams client for interacting with the Binance Spot WebSocket Streams.
///
/// This struct provides methods to create WebSocket Streams clients for production , demo and testnet environments.
pub struct SpotWsStreams {}

impl SpotWsStreams {
    /// Creates a WebSocket streams client configured with the given settings.
    ///
    /// If no WS URL is specified in the configuration, defaults to the production Spot WebSocket Streams URL.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the WebSocket streams client
    ///
    /// # Returns
    ///
    /// A new WebSocket streams client configured with the provided settings
    #[must_use]
    pub fn from_config(
        mut config: ConfigurationWebsocketStreams,
    ) -> websocket_streams::WebsocketStreamsHandle {
        config.user_agent = build_user_agent("spot");
        if config.ws_url.is_none() {
            config.ws_url = Some(SPOT_WS_STREAMS_PROD_URL.to_string());
        }
        websocket_streams::WebsocketStreamsHandle::new(config)
    }

    /// Creates a WebSocket streams client configured for the production environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the WebSocket streams client
    ///
    /// # Returns
    ///
    /// A new WebSocket streams client configured for the production environment
    #[must_use]
    pub fn production(
        mut config: ConfigurationWebsocketStreams,
    ) -> websocket_streams::WebsocketStreamsHandle {
        config.ws_url = Some(SPOT_WS_STREAMS_PROD_URL.to_string());
        SpotWsStreams::from_config(config)
    }

    /// Creates a WebSocket streams client configured for the testnet environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the WebSocket streams client
    ///
    /// # Returns
    ///
    /// A new WebSocket streams client configured for the testnet environment
    #[must_use]
    pub fn testnet(
        mut config: ConfigurationWebsocketStreams,
    ) -> websocket_streams::WebsocketStreamsHandle {
        config.ws_url = Some(SPOT_WS_STREAMS_TESTNET_URL.to_string());
        SpotWsStreams::from_config(config)
    }

    /// Creates a WebSocket streams client configured for the demo environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the WebSocket streams client
    ///
    /// # Returns
    ///
    /// A new WebSocket streams client configured for the demo environment
    #[must_use]
    pub fn demo(
        mut config: ConfigurationWebsocketStreams,
    ) -> websocket_streams::WebsocketStreamsHandle {
        config.ws_url = Some(SPOT_WS_STREAMS_DEMO_URL.to_string());
        SpotWsStreams::from_config(config)
    }
}