#temp-dir #dropping

outdir-tempdir

A crate for cargo-test to create temporary directories in the OUT_DIR

2 unstable releases

0.2.0 Aug 26, 2023
0.1.0 Feb 10, 2023

#667 in Testing

Download history 33/week @ 2024-12-09 10/week @ 2024-12-16 6/week @ 2025-01-20 1/week @ 2025-01-27 32/week @ 2025-02-03 19/week @ 2025-02-10 2/week @ 2025-02-17 5/week @ 2025-02-24 46/week @ 2025-03-03 39/week @ 2025-03-10 6/week @ 2025-03-17 2/week @ 2025-03-24

94 downloads per month
Used in 2 crates

MIT license

14KB
182 lines

OUTDIR-TEMPDIR

A crate for cargo-test to create temporary directories.
The temporary directories are always created in the OUT_DIR.

Usage

Add dependency to your Cargo.toml.

[dev-dependencies]
outdir-tempdir = "0.2"

Examples

Create a temporary directory with automatic removal.

use outdir_tempdir::TempDir;

#[test]
fn test_something() {
    // Create a randomly named temporary directory
    // and automatically remove it upon dropping
    let dir = TempDir::new().autorm();

    // Get temporary directory
    // (/path/to/crate/target/(debug|release)/build/outdir-tempdir-<random>/out/test-<random>)
    let tempdir = dir.path();

    // Test your code using `tempdir`
    // ...

    // Remove the temporary directory when the `dir` variable is dropped
}

Create a temporary directory without automatic removal.

use outdir_tempdir::TempDir;

#[test]
fn test_something() {
    // Create a randomly named temporary directory
    let dir = TempDir::new();

    // Get temporary directory
    // (/path/to/crate/target/(debug|release)/build/outdir-tempdir-<random>/out/test-<random>)
    let tempdir = dir.path();

    // Test your code using `tempdir`
    // ...

    // The temporary directory will not be deleted even when the `dir` variable is dropped
}

Create a temporary directory using the specified path.

use outdir_tempdir::TempDir;

#[test]
fn test_something() {
    // Create a temporary directory with a specified path 'foo/bar/baz'
    // and automatically remove it upon dropping
    let dir = TempDir::with_path("foo/bar/baz").autorm();

    // Get temporary directory
    // (/path/to/crate/target/(debug|release)/build/outdir-tempdir-<random>/out/foo/bar/baz)
    let tempdir = dir.path();

    // Test your code using `tempdir`
    // ...

    // Remove the temporary directory when the `dir` variable is dropped
}

Dependencies

~1.5MB
~22K SLoC