1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

//! A versatile websocket client that supports many cryptocurrency exchanges.
//!
//! ## Example
//!
//! ```
//! use crypto_ws_client::{BinanceSpotWSClient, WSClient};
//!
//! fn main() {
//!     let mut ws_client = BinanceSpotWSClient::init(|msg| println!("{}", msg));
//!     let channels = vec!["btcusdt@aggTrade".to_string(), "btcusdt@depth".to_string(),];
//!     ws_client.subscribe(&channels);
//!     ws_client.run();
//!     ws_client.close();
//! }
//! ```

mod clients;

pub use clients::binance::*;
pub use clients::huobi::*;
pub use clients::okex::*;

/// The public interface of every WebSocket client.
pub trait WSClient {
    /// Exchange specific WebSocket client.
    type Exchange;

    /// Create a new client.
    ///
    /// # Arguments
    ///
    /// * `on_msg` - The message handler
    /// * `url` - Optional server url, usually you don't need specify it
    fn init(on_msg: fn(String), url: Option<&str>) -> Self::Exchange;

    /// Subscribe channels.
    fn subscribe(&mut self, channels: &[String]);

    /// Unsubscribe channels.
    fn unsubscribe(&mut self, channels: &[String]);

    /// Start the infinite loop until the server closes the connection.
    fn run(&mut self);

    /// Close the client.
    fn close(&mut self);
}