Struct LocaleOverride 

pub struct LocaleOverride { /* private fields */ }

Guard that overrides DYLINT_LOCALE for the lifetime of the instance.

The guard captures any existing value and restores it when dropped. The mutation itself must be executed under a serialized test harness (for example via the serial_test::serial attribute) to ensure the unsafe environment access remains race-free.

Examples

use whitaker_common::test_support::LocaleOverride;
use serial_test::serial;

#[test]
#[serial]
fn ui_runs_in_welsh_locale() {
    let _guard = LocaleOverride::set("cy");
    // Execute lint UI harness here.
}

Implementations

impl LocaleOverride

pub fn set(locale: &str) -> Self

Sets DYLINT_LOCALE to locale, returning a guard that will restore the prior value (if any) when dropped.

pub fn clear() -> Self

Removes DYLINT_LOCALE, returning a guard that reinstates the prior value (if any) when dropped.

Examples

use whitaker_common::test_support::LocaleOverride;
use serial_test::serial;
use std::ffi::OsString;

#[test]
#[serial]
fn clears_then_restores_locale() {
    unsafe {
        std::env::set_var("DYLINT_LOCALE", "cy");
    }
    {
        let _guard = LocaleOverride::clear();
        assert!(std::env::var_os("DYLINT_LOCALE").is_none());
    }
    assert_eq!(
        std::env::var_os("DYLINT_LOCALE"),
        Some(OsString::from("cy"))
    );
}

Trait Implementations

impl Drop for LocaleOverride

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.