#directory #random #testing

random-dir

Create directories and files with random contents in tests

2 releases

new 0.2.4 Dec 8, 2024
0.2.3 Dec 8, 2024

#536 in Filesystem

Download history 198/week @ 2024-12-03

198 downloads per month
Used in 3 crates

MIT license

17KB
359 lines

random-dir

Crates.io Version Docs dependency status

Introduction

random-dir is a library that helps create directories with random contents. The intended usage is to generate random directory, feed this directory as an input to some function, and then compare the output of this function to the expected output.

This crate is particularly useful to test archiver crates like kpea.

Example

use random_dir::list_dir_all;
use random_dir::Dir;
use arbtest::arbtest;

fn test_pack_unpack_symmetry() {
    arbtest(|u| {
        let directory: Dir = u.arbitrary()?;
        // Pack the directory to a temporary archive file.
        // Unpack the temporary archive file to `/tmp/unpack-dir`.
        let files1 = list_dir_all(directory.path()).unwrap();
        let files2 = list_dir_all("/tmp/unpack-dir").unwrap();
        assert_eq!(files1, files2);
        Ok(())
    });
}

Dependencies

~2–10MB
~131K SLoC