sha-crypt 0.6.0

Pure Rust implementation of the SHA-crypt password hashing algorithm based on SHA-256/SHA-512 as implemented by the POSIX crypt C library, including support for generating and verifying password hash strings in the Modular Crypt Format
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

//! Error types.

use core::fmt;

#[cfg(doc)]
use crate::Params;

/// Result type for the `sha-crypt` crate with its [`Error`] type.
pub type Result<T> = core::result::Result<T, Error>;

/// Error type.
#[derive(Clone, Copy, Debug)]
pub enum Error {
    /// Parameters are invalid (e.g. parse error)
    ParamsInvalid,

    /// `rounds=` be within range [`Params::ROUNDS_MIN`]..=[`Params::ROUNDS_MIN`]
    RoundsInvalid,
}

impl core::error::Error for Error {}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Error::ParamsInvalid => write!(f, "parameters are invalid"),
            Error::RoundsInvalid => write!(f, "rounds error"),
        }
    }
}

#[cfg(feature = "password-hash")]
impl From<Error> for password_hash::Error {
    fn from(err: Error) -> Self {
        match err {
            Error::RoundsInvalid => password_hash::Error::ParamInvalid { name: "rounds" },
            Error::ParamsInvalid => password_hash::Error::ParamsInvalid,
        }
    }
}