comcast / libstorage

rust storage server helper utilities

libstorage

Library for all our storage systems

libstorage is a collection of helper functions written in RUST to make interfacing with storage servers easier. Under the src/ directory there is a module for each storage system the library supports.

---

To start using libstorage

libstorage is easy to use in your project. Just include the dependency in your Cargo.toml and you're ready to roll. The isilon library has been put behind a cargo feature flag because it's so large and the feature has to be enabled during the build.

Example

The following example shows a sample use of the hitachi module:

use libstorage::hitachi::HitachiConfig;
use reqwest::Client;

fn main() -> Result<(), libstorage::Error>> {
    let web_client = reqwest::Client::new();
    let hitachi_config = HitachiConfig {
        endpoint: "server".into(),
        user: "username".into(),
        password: "password".into(),
        region: "region".into(),
    };

    // 1. Get the host:instance list with /AgentForRAID
    let agents = get_agent_for_raid(&web_client, &hitachi_config)?;
    println!("items: {} {:?}", agents.items.len(), agents);

    Ok(())
}

Support and Contributions

If you need support, start by checking the issues page. If that doesn't answer your questions, or if you think you found a bug, please file an issue.

That said, if you have questions, reach out to us communication.

Want to contribute to libstorage? Awesome! Check out the contributing guide.

libstorage's Issues

Use indexmap instead of hashmap to maintain tspoint order

The iter order of hashmap is arbitrary and can cause problems. This might be a good alternative: https://crates.io/crates/indexmap

Change over to a more OO approach

I'd like it better if there was a struct in each module that held onto the reqwest client and the configuration information.

Rust 1.33 warnings

Just making a note of this so i don't forget.

   --> src/error.rs:116:48
    |
116 |             StorageError::CsvError(ref e) => e.cause(),
    |                                                ^^^^^

warning: use of deprecated item 'core::str::<impl str>::trim_left': superseded by `trim_start`
  --> src/telegraf.rs:98:68
   |
98 |                 let counter_value = line[end_index.unwrap() + 1..].trim_left();
   |                                                                    ^^^^^^^^^

warning: use of deprecated item 'core::str::<impl str>::trim_left': superseded by `trim_start`
  --> src/telegraf.rs:98:68
   |
98 |                 let counter_value = line[end_index.unwrap() + 1..].trim_left();
   |                                                                    ^^^^^^^^^

Move <Storage>Config structs to lib.rs

Move all Config structs in each module to lib.rs and update documentation of how/when to use them