ibapi 5.5.0

An unofficial Rust client for the Interactive Brokers TWS API: market data, orders, and account data, with async (Tokio) and blocking clients for TWS and IB Gateway.
Documentation 
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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

use std::sync::Arc;
use std::thread;
use std::time::{Duration, Instant};

use super::*;

#[test]
fn wait_connected_returns_immediately_while_connected() {
    let signal = ConnectionSignal::default();
    assert!(signal.is_connected());

    let start = Instant::now();
    assert!(signal.wait_connected().is_ok());
    assert!(start.elapsed() < Duration::from_secs(5), "connected wait must not block");
}

#[test]
fn wait_connected_returns_when_the_session_comes_back() {
    let signal = Arc::new(ConnectionSignal::default());
    signal.set_disconnected();
    assert!(!signal.is_connected());

    let waker = Arc::clone(&signal);
    thread::spawn(move || {
        thread::sleep(Duration::from_millis(20));
        waker.set_connected();
    });

    let start = Instant::now();
    assert!(signal.wait_connected().is_ok());
    assert!(signal.is_connected());
    assert!(start.elapsed() < Duration::from_secs(5), "wait_connected did not return on reconnect");
}

#[test]
fn wait_connected_returns_shutdown_when_requested_during_the_wait() {
    let signal = Arc::new(ConnectionSignal::default());
    signal.set_disconnected();

    let waker = Arc::clone(&signal);
    thread::spawn(move || {
        thread::sleep(Duration::from_millis(20));
        waker.shutdown();
    });

    let start = Instant::now();
    assert!(matches!(signal.wait_connected(), Err(Error::Shutdown)));
    assert!(start.elapsed() < Duration::from_secs(5), "wait_connected did not return on shutdown");
}

#[test]
fn shutdown_is_terminal() {
    let signal = ConnectionSignal::default();
    signal.shutdown();

    signal.set_connected();

    assert!(!signal.is_connected(), "a late reconnect must not revive a shut-down session");
    assert!(matches!(signal.wait_connected(), Err(Error::Shutdown)));
}

/// The signal tracks the session through a failed reconnect; which error
/// each state maps to is `SessionState`'s, tested in `common_tests`.
#[test]
fn check_follows_the_session_through_a_failed_reconnect() {
    let signal = ConnectionSignal::default();
    assert!(signal.check().is_ok());
    assert!(signal.check_ended().is_ok());

    signal.set_disconnected();
    assert!(matches!(signal.check(), Err(Error::ConnectionReset)));
    assert!(signal.check_ended().is_ok(), "reconnecting is not ended");

    signal.fail();
    assert!(matches!(signal.check(), Err(Error::ConnectionFailed)));
    assert!(matches!(signal.check_ended(), Err(Error::ConnectionFailed)));
}

#[test]
fn wait_connected_returns_connection_failed_when_the_reconnect_gives_up() {
    let signal = Arc::new(ConnectionSignal::default());
    signal.set_disconnected();

    let waker = Arc::clone(&signal);
    thread::spawn(move || {
        thread::sleep(Duration::from_millis(20));
        waker.fail();
    });

    let start = Instant::now();
    assert!(matches!(signal.wait_connected(), Err(Error::ConnectionFailed)));
    assert!(start.elapsed() < Duration::from_secs(5), "wait_connected did not return on failure");
}

/// The dispatcher latches `Failed` and then shuts the bus down; the shutdown
/// must not replace why the session ended.
#[test]
fn failed_survives_the_following_shutdown_and_a_late_reconnect() {
    let signal = ConnectionSignal::default();
    signal.set_disconnected();
    signal.fail();

    signal.shutdown();
    signal.set_connected();

    assert!(!signal.is_connected());
    assert!(matches!(signal.wait_connected(), Err(Error::ConnectionFailed)));
}