rust-spice 1.0.1

WOW! The complete NASA/NAIF Spice toolkit is actually usable on Rust.
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

//! The CSPICE error state, and its translation into a Rust `Result`.

use crate::common;

#[test]
#[serial]
fn a_failing_call_is_reported() {
    common::load();
    spice::errors::quiet();

    assert!(!spice::errors::failed());
    assert!(spice::errors::check().is_ok());

    spice::furnsh("no-such-kernel.tm");
    assert!(spice::errors::failed());

    let error = spice::errors::check().expect_err("furnsh should have failed");
    assert_eq!(error.short, "SPICE(NOSUCHFILE)");
    assert!(
        error.long.contains("no-such-kernel.tm"),
        "got {:?}",
        error.long
    );
    assert!(!error.traceback.is_empty());
    assert!(error.to_string().contains("SPICE(NOSUCHFILE)"));

    // `check` resets the state on its way out.
    assert!(!spice::errors::failed());
    assert!(spice::errors::check().is_ok());

    common::unload();
}

#[test]
#[serial]
fn getmsg_and_reset() {
    common::load();
    spice::errors::quiet();

    spice::furnsh("no-such-kernel.tm");
    assert_eq!(spice::errors::getmsg("SHORT"), "SPICE(NOSUCHFILE)");
    assert!(spice::errors::getmsg("LONG").contains("no-such-kernel.tm"));

    spice::errors::reset();
    assert!(!spice::errors::failed());
    assert!(spice::errors::getmsg("SHORT").is_empty());

    common::unload();
}

#[test]
#[serial]
fn qcktrc() {
    common::load();
    spice::errors::quiet();

    // Nothing has failed, so the traceback holds no active routine.
    assert!(spice::errors::qcktrc().is_empty());

    spice::furnsh("no-such-kernel.tm");
    assert!(spice::errors::qcktrc().contains("FURNSH"));

    spice::errors::reset();
    common::unload();
}

#[test]
#[serial]
fn the_action_and_device_can_be_read_back() {
    common::load();

    spice::errors::quiet();
    assert_eq!(spice::errors::erract("GET", ""), "RETURN");
    assert_eq!(spice::errors::errdev("GET", ""), "NULL");

    spice::errors::erract("SET", "REPORT");
    assert_eq!(spice::errors::erract("GET", ""), "REPORT");

    // The list of reported items is settable too.
    spice::errors::errprt("SET", "SHORT");
    assert!(spice::errors::errprt("GET", "").contains("SHORT"));

    // `loud` restores the CSPICE defaults; put the guard back afterwards so that a later failure
    // does not take the test runner down with it.
    spice::errors::loud();
    assert_eq!(spice::errors::erract("GET", ""), "ABORT");
    assert_eq!(spice::errors::errdev("GET", ""), "SCREEN");
    spice::errors::quiet();

    common::unload();
}

#[test]
#[serial]
fn numbers_in_a_message() {
    common::reset();
    spice::errors::quiet();

    // The markers are filled in by the `err*` routines, in the order they are called.
    spice::setmsg("the value was # over # tries");
    spice::errdp("#", 1.5);
    spice::errint("#", 7);
    spice::sigerr("SPICE(TESTVALUE)");

    let error = spice::errors::check().expect_err("sigerr should have failed");
    assert_eq!(error.short, "SPICE(TESTVALUE)");
    assert!(
        error.long.starts_with("the value was 1.5"),
        "got {:?}",
        error.long
    );
    assert!(error.long.ends_with("over 7 tries"), "got {:?}", error.long);

    spice::errors::loud();
}