Struct NewUser 

#[non_exhaustive]
pub struct NewUser {
    pub username: String,
    pub password: Option<String>,
}

Inputs needed to create a user account.

Use the passwordless constructor for embedded or single-user applications where login latency matters and the surrounding process is already trusted; use with_password for multi-user deployments where the root key must be encrypted at rest.

The struct is marked #[non_exhaustive] so we can add fields (key algorithm, locale, initial roles, etc.) without a breaking API change. Construct it through the provided helpers rather than struct literal syntax.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

username: String

Login identifier for the user. Must be unique within the instance.

password: Option<String>

Optional password. None produces a passwordless user whose root key is stored unencrypted (fine for embedded apps where the host process is the trust boundary); Some(_) produces an Argon2id-derived encryption key under which the root signing key is AES-256-GCM encrypted at rest.

Implementations

impl NewUser

pub fn passwordless(name: impl Into<String>) -> Self

Create a passwordless user. The root signing key will be stored unencrypted in the user’s credentials.

pub fn with_password( name: impl Into<String>, password: impl Into<String>, ) -> Self

Create a password-protected user. The root signing key will be encrypted with an Argon2id-derived key at rest; the password is required for every login.

Trait Implementations

impl Clone for NewUser

fn clone(&self) -> NewUser

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NewUser

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

Formats the value using the given formatter.