fudisks 0.1.0

High-level wrapper for the udisks2 crate
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

# fudisks

A high-level wrapper around the udisks2 crate. A work in progress!

## Example: List Devices
```bash
cargo run --example list_devices
```

## Example: Format a Partition (DANGEROUS)
```bash
ALLOW_DESTRUCTIVE=1 cargo run --example format_partition -- <udisks_object_path>
```

## Quick Start
```rust
use fudisks::{Udisks, FormatOptions, JobEvent};
use futures_util::StreamExt;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let ud = Udisks::connect_system().await?;

    // Choose a partition object path from list_devices output
    let part = "/org/freedesktop/UDisks2/block_devices/sdb1";

    let opts = FormatOptions::Exfat { label: Some("USB".into()), cluster_size: None, quick: true };
    let handle = ud.format_partition(part, &opts).await?;

    let mut stream = handle.watch();
    while let Some(evt) = stream.next().await {
        match evt {
            JobEvent::Percent(p) => println!("{p:.1}%"),
            JobEvent::RateBytesPerSec(r) => println!("{r} B/s"),
            JobEvent::Completed(res) => match res {
                Ok(()) => break,
                Err(e) => { eprintln!("error: {}", e); return Err(e.into()); }
            }
        }
    }
    Ok(())
}
```

Format a whole disk using GPT (default) or DOS/MBR (DANGEROUS):

```bash
ALLOW_DESTRUCTIVE=1 cargo run --example format_disk -- <disk_object_path> gpt
ALLOW_DESTRUCTIVE=1 cargo run --example format_disk -- <disk_object_path> dos
```