windows-env 0.3.0

Easily manage Windows environment variables permanently.
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

//! Error types of this crate.

use std::io;

use thiserror::Error;

/// Error type of this crate.
#[derive(Debug, Error)]
pub enum Error {
    /// The variable name is empty or contains `;` or NUL.
    #[error("invalid variable name {0:?}: must be non-empty and contain no `;` or NUL")]
    InvalidVarName(String),

    /// The list value is empty or contains `;` or NUL.
    #[error("invalid list value {0:?}: must be non-empty and contain no `;` or NUL")]
    InvalidListValue(String),

    /// The value contains a NUL character.
    #[error("invalid value: must not contain NUL")]
    InvalidValue,

    /// An error from the underlying registry or Win32 call.
    #[error(transparent)]
    Registry(#[from] io::Error),
}

impl From<Error> for io::Error {
    /// Convert into [`io::Error`] so that callers using `io::Result` can keep
    /// using `?`. An inner [`io::Error`] is extracted as-is to avoid double
    /// wrapping; validation errors become [`io::ErrorKind::InvalidInput`].
    fn from(err: Error) -> Self {
        match err {
            Error::Registry(inner) => inner,
            other => io::Error::new(io::ErrorKind::InvalidInput, other),
        }
    }
}

/// Result alias of this crate.
pub type Result<T> = std::result::Result<T, Error>;