Stability

This crate is currently pre-1.0. We will do our best to minimize breaking changes to the library, but there is still many parts of the cat-dev we have not fully figured out. As such we're very hesitant to make any promises about the stability of these APIs, or that we'll follow SEM-VER until we've at the very least figured all of that out. If you are ever affected by this, or concerned about this please reach out on our codeberg repository. We do want to try, and make it as smooth as possible.

Usage

Basic uses of this crate may look like the following:

Listing all Serial Ports:

use cat_dev_serial::SyncSerialPort;
use tracing::error;

let ports = match SyncSerialPort::available_ports() {
	Ok(ports) => ports,
	Err(cause) => {
		error!(
			?cause,
			"failed to enumerate serial-ports",
		);
		std::process::exit(1);
	}
};

if ports.is_empty() {
	error!(
		"os returned 0 serial ports being found"
	);
	std::process::exit(2);
}

for port in ports {
	info!(
		port = %port.display(),
		"found a serial port",
	);
}

Reading Lines from a Serial Port:

use cat_dev_serial::{AsyncSerialPort, SerialLines};

async fn async_lines() {
	let serial = AsyncSerialPort::new("/dev/my-cool-serial-ports").expect("Failed to load serial port!");
	let lines = SerialLines::new(serial);
	while let Some(line) = lines.next_line().await? {
		eprintln!("Got serial line:\n  {line}");
	}
}