virtualbox_rs

Crates.iovirtualbox_rs
lib.rsvirtualbox_rs
version0.2.2
sourcesrc
created_at2024-10-01 10:00:17.906572
updated_at2024-10-25 14:46:30.185258
descriptionA Rust library for interacting with VirtualBox, providing a safe and idiomatic interface to the VirtualBox API.
homepage
repository
max_upload_size
id1392683
size1,307,528
Mykola (khodorovskyi)

documentation

README

virtualbox_rs

is a Rust library for interacting with VirtualBox through its SDK.

This library provides a comprehensive set of bindings to manage VirtualBox VMs, including creating, deleting, and modifying virtual machines, handling snapshots, and configuring various VM settings such as network adapters, audio settings, and encryption.

Features

  • Create and manage VirtualBox VMs
  • Handle VM snapshots
  • Configure VM settings (network, audio, encryption, etc.)
  • Support for different VirtualBox API versions (6.1 and 7.0) !

Example

use virtualbox_rs::{Session, VirtualBox};
use virtualbox_rs::enums::SessionType;

fn main() {
    let vbox = VirtualBox::init().unwrap();
    let mut session = Session::init().unwrap();
    let machine = vbox.find_machines("Freebsd_14").unwrap();
    machine.lock_machine(&mut session, SessionType::Shared).unwrap();

    let machine_mut = session.get_machine().unwrap();
    let progress = machine_mut.delete_snapshot_and_all_children("278ef54a-2e75-4aba-b212-551af4c69725").unwrap();
    progress.wait_for_completion(-1).unwrap();
}

Supported Platforms

This library has been tested on:

  • FreeBSD 14.0
  • Ubuntu 24.04

Note

Not everything has been implemented yet. The library emphasizes providing examples for each method, which should simplify its usage.

Commit count: 0

cargo fmt