vissue-core 0.9.2

Plain-text issue tracking over per-project orgmode files: model, store, queries, and org projection
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

//! Process environment with a thread-local overlay for tests.
//!
//! Production reads `std::env`. Tests call [`override_var`] so they never
//! need `set_var` / `remove_var`, which are unsafe in edition 2024.

use std::cell::RefCell;
use std::collections::HashMap;
use std::env::VarError;

thread_local! {
    static OVERLAY: RefCell<HashMap<String, Option<String>>> = RefCell::new(HashMap::new());
}

/// Read `key`, honouring a test overlay if one is set on this thread.
///
/// # Errors
///
/// Returns [`VarError::NotPresent`] when the overlay unsets `key` or when
/// the real process environment has no such variable.
pub fn var(key: &str) -> Result<String, VarError> {
    if let Some(over) = OVERLAY.with(|m| m.borrow().get(key).cloned()) {
        return over.ok_or(VarError::NotPresent);
    }
    std::env::var(key)
}

/// Pretend `key` is `value` (`None` means unset) on this thread.
///
/// Used by tests. Production code never calls this.
pub fn override_var(key: &str, value: Option<&str>) {
    OVERLAY.with(|m| {
        m.borrow_mut()
            .insert(key.to_string(), value.map(str::to_string));
    });
}

/// Drop the overlay for `key` so later reads use the real process environment.
pub fn clear_override(key: &str) {
    OVERLAY.with(|m| {
        m.borrow_mut().remove(key);
    });
}