eject

Crates.ioeject
lib.rseject
version0.1.1
sourcesrc
created_at2022-08-31 07:46:49.048846
updated_at2022-09-05 08:10:51.42078
descriptionA crate to control the tray of your CD drive
homepage
repositoryhttps://github.com/matix64/eject-rs
max_upload_size
id655535
size41,180
Matias (matix64)

documentation

README

Eject

crates.io version crates.io downloads docs.rs

A Rust library to control the tray of your CD drive.

Currently supporting Windows and Linux.

Features

  • Find installed drives.
  • Open, close and lock the tray.
  • Query current tray position and whether there's a disc inside.

Examples

Basic usage

use eject::{device::Device, discovery::cd_drives};

// Open the drive at this path
let cdrom = Device::open("/dev/cdrom")?;
// Or get the first one available
let cdrom_path = cd_drives().next().unwrap();
let cdrom = Device::open(&cdrom_path)?;
// Open the tray
cdrom.eject()?;

Find all CD drives

use eject::{device::Device, discovery::cd_drives};

// Get the paths of all CD drives
for path in cd_drives() {
    // Print the path
    println!("{:?}", path);
    // Access the drive
    let drive = Device::open(path)?;
    // Close its tray
    drive.retract()?;
}

Get drive status

use eject::{device::{Device, DriveStatus}, discovery::cd_drives};

// Open a drive
let drive = Device::open("/dev/cdrom")?;
// Print its status
match drive.status()? {
    DriveStatus::Empty =>
        println!("The tray is closed and no disc is inside"),
    DriveStatus::TrayOpen =>
        println!("The tray is open"),
    DriveStatus::NotReady =>
        println!("This drive is not ready yet"),
    DriveStatus::Loaded =>
        println!("There's a disc inside"),
}
Commit count: 46

cargo fmt