cranpose_core/
test_scratch.rs

1//! Where a test writes real files.
2//!
3//! Enabled by the `test-helpers` feature. Every crate in the workspace that
4//! needs a file on disk during a test asks here, so there is one answer to
5//! where those files go rather than one per crate that drifts from the rest.
6
7use std::{
8    path::{Path, PathBuf},
9    sync::atomic::{AtomicU32, Ordering},
10};
11
12/// A unique, empty directory under the workspace `target/test-output`.
13///
14/// Never the system temporary directory: on Linux that is tmpfs, so a test
15/// writing a payload there writes it to RAM, and a failure leaves nothing
16/// under `target` to look at afterwards.
17/// `apps/desktop-demo/tests/source_hygiene_aliases.rs` enforces that across
18/// the workspace.
19///
20/// `manifest_dir` is the caller's own `env!("CARGO_MANIFEST_DIR")`. Its last
21/// component names the subdirectory, so two crates asking for the same `tag`
22/// get different directories; the workspace root is found by walking up to
23/// the directory holding `Cargo.lock` rather than by counting `..` hops,
24/// which differ per crate and are wrong the moment one moves.
25pub fn test_scratch_dir(manifest_dir: &str, tag: &str) -> PathBuf {
26    static COUNTER: AtomicU32 = AtomicU32::new(0);
27    let unique = COUNTER.fetch_add(1, Ordering::Relaxed);
28    let manifest = PathBuf::from(manifest_dir);
29    let owner = manifest.file_name().map_or_else(
30        || "workspace".to_string(),
31        |name| name.to_string_lossy().into_owned(),
32    );
33    let path = workspace_root(&manifest)
34        .join("target/test-output")
35        .join(owner)
36        .join(format!("{tag}-{}-{unique}", std::process::id()));
37    let _ = std::fs::remove_dir_all(&path);
38    std::fs::create_dir_all(&path).expect("a scratch directory under target/test-output");
39    path
40}
41
42fn workspace_root(manifest: &Path) -> PathBuf {
43    manifest
44        .ancestors()
45        .find(|directory| directory.join("Cargo.lock").is_file())
46        .unwrap_or(manifest)
47        .to_path_buf()
48}
49
50#[cfg(test)]
51#[path = "tests/test_scratch_tests.rs"]
52mod tests;
cranpose_core/test_scratch.rs

cranpose_core/
test_scratch.rs
