Semi-persistent, scoped test directories
Added tag v0.5.2 for changeset 61b7aa032138
Bump version for new cargo release
Depend on git version of heim


browse log
browse .tar.gz



#Semi-persistent, scoped test directories

This crate aims to make it easier to use temporary directories in tests, primarily by calling the testdir!() macro somewhere in a test function. The direcetories are structured per-scope and per-test and will be available for inspection after the test has finished. On subsequent test runs older generations of test directories will be cleaned up.

If you've ever used pytest's tmp_path or tmpdir fixtures this pattern should be similar.

By default test directories are created in cargo's target directory:


Here $N is an integer generation number increasing with each cargo test invocation. Generations older than the 8 most recent ones are removed on the next cargo test run.

There is also a symlink pointing to the most recent generation:

target/testdir-current -> testdir-$N`


Even when executing this with cargo test --jobs=1 these tests will pass as each gets their own unique directory:

// E.g. in

mod tests {
    use std::path::PathBuf;
    use testdir::testdir;

    fn test_write() {
        let dir: PathBuf = testdir!();
        let path = dir.join("hello.txt");
        std::fs::write(&path, "hi there").ok();
    fn test_read() {
        let dir: PathBuf = testdir!();
        let path = dir.join("hello.txt");

Afterwards you can inspect the directories and they should look something like this:

$ tree target/
+- testdir-0
|    +- cratename
|         +- tests
|              +- test_read
|              +- test_write
|                   +- hello.txt
+- testdir-current -> testdir-0

#Feedback and contributing

The code lives in a mercurial repository at from which you can clone the repository.

For any feedback, bug reports or patches please send an email to ~flub/ (or use if your mail client does not accept the former).

The mailing list archive can be browsed at