ibapi 5.3.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
109
110
111
112
113
114
115
116
117

use std::sync::Arc;
use std::time::Duration;

use super::*;

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

    tokio::time::timeout(Duration::from_secs(5), signal.wait_connected())
        .await
        .expect("connected wait must not block")
        .expect("wait_connected");
}

#[tokio::test]
async 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);
    tokio::spawn(async move {
        tokio::time::sleep(Duration::from_millis(20)).await;
        waker.set_connected();
    });

    tokio::time::timeout(Duration::from_secs(5), signal.wait_connected())
        .await
        .expect("wait_connected did not return on reconnect")
        .expect("wait_connected");
    assert!(signal.is_connected());
}

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

    let waker = Arc::clone(&signal);
    tokio::spawn(async move {
        tokio::time::sleep(Duration::from_millis(20)).await;
        waker.shutdown();
    });

    let result = tokio::time::timeout(Duration::from_secs(5), signal.wait_connected())
        .await
        .expect("wait_connected did not return on shutdown");
    assert!(matches!(result, Err(Error::Shutdown)), "got {result:?}");
}

#[tokio::test]
async 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");
    let result = tokio::time::timeout(Duration::from_secs(5), signal.wait_connected())
        .await
        .expect("wait_connected blocked after shutdown");
    assert!(matches!(result, Err(Error::Shutdown)), "got {result:?}");
}

/// The signal tracks the session through a failed reconnect; which error
/// each state maps to is `SessionState`'s, tested in `common_tests`.
#[tokio::test]
async 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)));
}

#[tokio::test]
async 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);
    tokio::spawn(async move {
        tokio::time::sleep(Duration::from_millis(20)).await;
        waker.fail();
    });

    let result = tokio::time::timeout(Duration::from_secs(5), signal.wait_connected())
        .await
        .expect("wait_connected did not return on failure");
    assert!(matches!(result, Err(Error::ConnectionFailed)), "got {result:?}");
}

/// The dispatcher latches `Failed` and then `retire` shuts the bus down; the
/// shutdown must not replace why the session ended.
#[tokio::test]
async 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());
    let result = tokio::time::timeout(Duration::from_secs(5), signal.wait_connected())
        .await
        .expect("wait_connected blocked after failure");
    assert!(matches!(result, Err(Error::ConnectionFailed)), "got {result:?}");
}