libpfs3 0.1.3

Pure Rust PFS3 (Amiga) filesystem library — read, write, format, and check
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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

// SPDX-License-Identifier: GPL-3.0-only
// Copyright (C) 2025 Fabian Schmieder

//! Deldir listing and undelete roundtrip tests.

use std::path::{Path, PathBuf};
use std::sync::atomic::{AtomicU32, Ordering};

use libpfs3::format::{self, FormatOptions};
use libpfs3::io::FileBlockDevice;
use libpfs3::volume::Volume;
use libpfs3::writer::Writer;

static COUNTER: AtomicU32 = AtomicU32::new(17000);

fn fresh_image_with_deldir(blocks: u64) -> PathBuf {
    let n = COUNTER.fetch_add(1, Ordering::Relaxed);
    let path = std::env::temp_dir().join(format!("pfs3_deldir_{}.img", n));
    let dev = FileBlockDevice::create(&path, 512, blocks).unwrap();
    let opts = FormatOptions {
        volume_name: "DelTest".into(),
        enable_deldir: true,
    };
    format::format_with_size(&dev, blocks, &opts).unwrap();
    drop(dev);
    path
}

fn fresh_image(blocks: u64) -> PathBuf {
    let n = COUNTER.fetch_add(1, Ordering::Relaxed);
    let path = std::env::temp_dir().join(format!("pfs3_deldir_nd_{}.img", n));
    let dev = FileBlockDevice::create(&path, 512, blocks).unwrap();
    let opts = FormatOptions {
        volume_name: "NoDel".into(),
        enable_deldir: false,
    };
    format::format_with_size(&dev, blocks, &opts).unwrap();
    drop(dev);
    path
}

fn open_writer(path: &Path) -> Writer {
    let dev = FileBlockDevice::open_rw(path, 512, 0, 0).unwrap();
    let vol = Volume::from_device(Box::new(dev)).unwrap();
    Writer::open(vol).unwrap()
}

fn reopen(path: &Path) -> Volume {
    Volume::open(path, 0).unwrap()
}

#[test]
fn deldir_empty_on_fresh_volume() {
    let path = fresh_image_with_deldir(4096);
    let mut vol = reopen(&path);
    let entries = vol.list_deldir().unwrap();
    assert!(entries.is_empty());
    std::fs::remove_file(&path).ok();
}

#[test]
fn deleted_file_appears_in_deldir() {
    let path = fresh_image_with_deldir(4096);
    let mut w = open_writer(&path);
    w.write_file("deleteme.txt", b"precious data").unwrap();
    w.delete("deleteme.txt").unwrap();
    let entries = w.vol.list_deldir().unwrap();
    if !entries.is_empty() {
        assert!(entries.iter().any(|e| e.filename.starts_with("deleteme")));
    }
    std::fs::remove_file(&path).ok();
}

#[test]
fn undelete_restores_file_content() {
    let path = fresh_image_with_deldir(4096);
    let mut w = open_writer(&path);
    w.write_file("restore.txt", b"restore me please").unwrap();
    w.delete("restore.txt").unwrap();

    let entries = w.vol.list_deldir().unwrap();
    if entries.is_empty() {
        std::fs::remove_file(&path).ok();
        return;
    }

    let idx = entries
        .iter()
        .position(|e| e.filename.starts_with("restore"))
        .unwrap();
    w.undelete(idx, "restored.txt").unwrap();
    drop(w);

    let mut vol = reopen(&path);
    let data = vol.read_file("restored.txt").unwrap();
    assert_eq!(data, b"restore me please");
    std::fs::remove_file(&path).ok();
}

#[test]
fn deldir_not_enabled_returns_empty() {
    let path = fresh_image(4096);
    let mut vol = reopen(&path);
    let entries = vol.list_deldir().unwrap();
    assert!(entries.is_empty());
    std::fs::remove_file(&path).ok();
}