Struct PasswordWorker

pub struct PasswordWorker<H: Hasher> { /* private fields */ }

A worker that handles password hashing and verification using a rayon thread pool and crossbeam-channel.

The PasswordWorker struct provides asynchronous password hashing and verification operations.

Implementations

impl PasswordWorker<Argon2id>

pub fn new_argon2id( max_threads: usize, ) -> Result<Self, PasswordWorkerError<Argon2id>>

Available on crate feature rust-argon2 only.

This constructor creates a new argon2id instance

impl PasswordWorker<Bcrypt>

pub fn new_bcrypt( max_threads: usize, ) -> Result<Self, PasswordWorkerError<Bcrypt>>

Available on crate feature bcrypt only.

This constructor creates a new bcrypt instance

impl<H: Hasher> PasswordWorker<H>

pub fn new(max_threads: usize) -> Result<Self, PasswordWorkerError<H>>

Creates a new PasswordWorker with the given maximum number of threads.

The max_threads parameter specifies the maximum number of threads the worker can use.

Examples

use password_worker::{Bcrypt, PasswordWorker};

let max_threads = 4; // rayon thread pool max threads
let password_worker: PasswordWorker<Bcrypt> = PasswordWorker::new(max_threads)?;

pub async fn hash( &self, password: impl Into<String>, cost: H::Config, ) -> Result<String, PasswordWorkerError<H>>

Asynchronously hashes the given password using its hashing algorithm.

Example

use password_worker::{Bcrypt, BcryptConfig, PasswordWorker};

let password = "hunter2";
let cost = 12; // bcrypt cost value
let max_threads = 4; // rayon thread pool max threads
let password_worker = PasswordWorker::<Bcrypt>::new(max_threads)?;

let hashed_password = password_worker.hash(password, BcryptConfig { cost }).await?;
println!("Hashed password: {:?}", hashed_password);

pub async fn verify( &self, password: impl Into<String>, hash: impl Into<String>, ) -> Result<bool, PasswordWorkerError<H>>

Asynchronously verifies a password against a hash string.

Example

use password_worker::{Bcrypt, BcryptConfig, PasswordWorker};

let password = "hunter2";
let cost = 12; // bcrypt cost value
let max_threads = 4; // rayon thread pool max threads
let password_worker = PasswordWorker::<Bcrypt>::new(max_threads)?;
let hashed_password = password_worker.hash(password, BcryptConfig { cost }).await?;

let is_valid = password_worker.verify(password, hashed_password).await?;
println!("Verification result: {:?}", is_valid);

Trait Implementations

impl<H: Clone + Hasher> Clone for PasswordWorker<H>

fn clone(&self) -> PasswordWorker<H>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<H: Debug + Hasher> Debug for PasswordWorker<H>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.