cspice 0.1.0

Safe wrapper around the NAIF CSPICE toolkit
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

//! Functions for loading and unloading SPICE Kernels.
use crate::error::get_last_error;
use crate::string::StringParam;
use crate::{with_spice_lock_or_panic, Error};
use cspice_sys::{furnsh_c, unload_c};

/// Load one or more SPICE kernels into a program.
///
/// See [furnsh_c](https://naif.jpl.nasa.gov/pub/naif/toolkit_docs/C/cspice/furnsh_c.html).
pub fn furnish<'f, F: Into<StringParam<'f>>>(file: F) -> Result<(), Error> {
    with_spice_lock_or_panic(|| {
        unsafe {
            furnsh_c(file.into().as_mut_ptr());
        };
        get_last_error()
    })
}

/// Unload a SPICE kernel.
///
/// See [unload_c](https://naif.jpl.nasa.gov/pub/naif/toolkit_docs/C/cspice/unload_c.html).
pub fn unload<'f, F: Into<StringParam<'f>>>(file: F) -> Result<(), Error> {
    with_spice_lock_or_panic(|| {
        unsafe {
            unload_c(file.into().as_mut_ptr());
        };
        get_last_error()
    })
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_furnish() {
        let error = furnish("NON_EXISTENT_FILE").err().unwrap();
        assert_eq!(error.short_message, "SPICE(NOSUCHFILE)");
    }
}