nut-client

A Network UPS Tools (NUT) client library for Rust.

• Connect to upsd/nut-server using TCP
• Login with with username and password
• List UPS devices

⚠️ Safety Goggles Required ⚠️

Do not use this library with critical UPS devices. This library is in early development and I cannot guarantee that it won't mess up your UPS configurations, and potentially cause catastrophic failure to your hardware.

Be careful and stay safe!

Example

Check out the examples directory for more advanced examples.

```rust use std::env; use std::net::ToSocketAddrs;

use nutclient::{Auth, ConfigBuilder, Host}; use nutclient::blocking::Connection;

fn main() -> nutclient::Result<()> { // The TCP host:port for upsd/nut-server let addr = env::var("NUTADDR") .unwraporelse(|| "localhost:3493".into()) .tosocket_addrs() .unwrap() .next() .unwrap();

// Username and password (optional)
let username = env::var("NUT_USER").ok();
let password = env::var("NUT_PASSWORD").ok();
let auth = username.map(|username| Auth::new(username, password));

// Build the config
let config = ConfigBuilder::new()
    .with_host(Host::Tcp(addr))
    .with_auth(auth)
    .build();

// Open a connection and login
let mut conn = Connection::new(config)?;

// Print a list of all UPS devices
println!("Connected UPS devices:");
for (id, description) in conn.list_ups()? {
    println!("\t- ID: {}", id);
    println!("\t  Description: {}", description);
}

Ok(())

} ```