Struct DefaultUser 

pub struct DefaultUser {

    pub id: Uuid,
    pub username: String,
    pub email: String,
    pub first_name: String,
    pub last_name: String,
    pub password_hash: Option<String>,
    pub last_login: Option<DateTime<Utc>>,
    pub is_active: bool,
    pub is_staff: bool,
    pub is_superuser: bool,
    pub date_joined: DateTime<Utc>,
    pub user_permissions: Vec<String>,
    pub groups: Vec<String>,
}

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

Available on crate features auth and argon2-hasher only.

DefaultUser struct - Django’s AbstractUser equivalent

A complete, ready-to-use user model that combines BaseUser, FullUser, and PermissionsMixin. This is the default user model provided by Reinhardt, suitable for most applications.

Relationship with Django

This struct is equivalent to Django’s django.contrib.auth.models.AbstractUser. It provides a full-featured user model with:

• Username-based authentication
• Email address
• First and last name
• Password hashing (Argon2id by default)
• Active/staff/superuser flags
• Timestamps (last_login, date_joined)
• Permissions and groups

Database Schema

The default table name is auth_user with the following columns:

• id (UUID, primary key)
• username (String, unique)
• email (String)
• first_name (String)
• last_name (String)
• password_hash (Option<String>)
• last_login (Option<DateTime<Utc>>)
• is_active (bool)
• is_staff (bool)
• is_superuser (bool)
• date_joined (DateTime<Utc>)
• user_permissions (Vec<String>)
• groups (Vec<String>)

Examples

Creating a new user with automatic Argon2id password hashing:

use reinhardt_auth::{BaseUser, DefaultUser};
use uuid::Uuid;
use chrono::Utc;

let mut user = DefaultUser {
    id: Uuid::new_v4(),
    username: "alice".to_string(),
    email: "alice@example.com".to_string(),
    first_name: "Alice".to_string(),
    last_name: "Smith".to_string(),
    password_hash: None,
    last_login: None,
    is_active: true,
    is_staff: false,
    is_superuser: false,
    date_joined: Utc::now(),
    user_permissions: Vec::new(),
    groups: Vec::new(),
};

// Password is automatically hashed with Argon2id
user.set_password("securepass123").unwrap();

// Verify password
assert!(user.check_password("securepass123").unwrap());
assert!(!user.check_password("wrongpass").unwrap());

Using with permissions:

use reinhardt_auth::{DefaultUser, PermissionsMixin};
use uuid::Uuid;
use chrono::Utc;

let mut user = DefaultUser {
    id: Uuid::new_v4(),
    username: "bob".to_string(),
    email: "bob@example.com".to_string(),
    first_name: "Bob".to_string(),
    last_name: "Johnson".to_string(),
    password_hash: None,
    last_login: None,
    is_active: true,
    is_staff: true,
    is_superuser: false,
    date_joined: Utc::now(),
    user_permissions: vec![
        "blog.add_post".to_string(),
        "blog.change_post".to_string(),
    ],
    groups: vec!["editors".to_string()],
};

// Check permissions
assert!(user.has_perm("blog.add_post"));
assert!(user.has_perm("blog.change_post"));
assert!(!user.has_perm("blog.delete_post"));
assert!(user.has_module_perms("blog"));

Fields

id: Uuid

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

Unique identifier (primary key)

username: String

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

Username (unique, used for login)

email: String

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

Email address

first_name: String

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

First name

last_name: String

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

Last name

password_hash: Option<String>

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

Password hash (hashed with Argon2id by default)

last_login: Option<DateTime<Utc>>

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

Last login timestamp

is_active: bool

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

Whether this user account is active

is_staff: bool

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

Whether this user can access the admin site

is_superuser: bool

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

Whether this user has all permissions (superuser)

date_joined: DateTime<Utc>

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

When this user account was created

user_permissions: Vec<String>

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

List of permissions (format: “app_label.permission_name”)

groups: Vec<String>

👎Deprecated since 0.1.0-rc.15:

Use the user attribute macro to define your own user struct instead

List of groups this user belongs to

Trait Implementations

impl User for DefaultUser

fn id(&self) -> String

👎Deprecated since 0.1.0-rc.15:

Use AuthIdentity + BaseUser/FullUser + PermissionsMixin instead

Returns the unique identifier for this user

fn username(&self) -> &str

👎Deprecated since 0.1.0-rc.15:

Use AuthIdentity + BaseUser/FullUser + PermissionsMixin instead

Returns the username for this user

fn get_username(&self) -> &str

👎Deprecated since 0.1.0-rc.15:

Use AuthIdentity + BaseUser/FullUser + PermissionsMixin instead

Returns the username (alias for username())

fn is_authenticated(&self) -> bool

👎Deprecated since 0.1.0-rc.15:

Use AuthIdentity + BaseUser/FullUser + PermissionsMixin instead

Returns whether this user is authenticated

fn is_active(&self) -> bool

👎Deprecated since 0.1.0-rc.15:

Use AuthIdentity + BaseUser/FullUser + PermissionsMixin instead

Returns whether this user account is active

fn is_admin(&self) -> bool

👎Deprecated since 0.1.0-rc.15:

Use AuthIdentity + BaseUser/FullUser + PermissionsMixin instead

Returns whether this user is an administrator

fn is_staff(&self) -> bool

👎Deprecated since 0.1.0-rc.15:

Use AuthIdentity + BaseUser/FullUser + PermissionsMixin instead

Returns whether this user is a staff member

fn is_superuser(&self) -> bool

👎Deprecated since 0.1.0-rc.15:

Use AuthIdentity + BaseUser/FullUser + PermissionsMixin instead

Returns whether this user is a superuser

impl BaseUser for DefaultUser

type PrimaryKey = Uuid

The type of the primary key (e.g., Uuid, i64)

type Hasher = Argon2Hasher

The password hasher to use (e.g., Argon2Hasher)

fn get_username_field() -> &'static str

Returns the name of the username field

fn get_username(&self) -> &str

Returns the username value

fn password_hash(&self) -> Option<&str>

Returns the hashed password, if set

fn set_password_hash(&mut self, hash: String)

Sets the hashed password

fn last_login(&self) -> Option<DateTime<Utc>>

Returns the last login time

fn set_last_login(&mut self, time: DateTime<Utc>)

Sets the last login time

fn is_active(&self) -> bool

Returns whether the user account is active

fn normalize_username(username: &str) -> String

Normalizes the username for consistent storage

fn set_password(&mut self, password: &str) -> Result<(), Error>

Sets the password, hashing it first

fn check_password(&self, password: &str) -> Result<bool, Error>

Checks if the given password is correct

fn set_unusable_password(&mut self)

Sets an unusable password (user cannot log in with password)

fn has_usable_password(&self) -> bool

Returns whether the user has a usable password

fn get_session_auth_hash(&self, secret: &str) -> String

Returns a hash of the session authentication credentials

impl BaseUserManager<DefaultUser> for DefaultUserManager

fn create_user<'life0, 'life1, 'life2, 'async_trait>( &'life0 mut self, username: &'life1 str, password: Option<&'life2 str>, extra: HashMap<String, Value>, ) -> Pin<Box<dyn Future<Output = Result<DefaultUser, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, DefaultUserManager: 'async_trait,

Creates a new user with the given username and password

fn create_superuser<'life0, 'life1, 'life2, 'async_trait>( &'life0 mut self, username: &'life1 str, password: Option<&'life2 str>, extra: HashMap<String, Value>, ) -> Pin<Box<dyn Future<Output = Result<DefaultUser, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, DefaultUserManager: 'async_trait,

Creates a new superuser with the given username and password

fn normalize_email(email: &str) -> String

Normalizes an email address

impl Clone for DefaultUser

fn clone(&self) -> DefaultUser

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DefaultUser

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

Formats the value using the given formatter.

impl Default for DefaultUser

fn default() -> DefaultUser

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DefaultUser

fn deserialize<__D>( __deserializer: __D, ) -> Result<DefaultUser, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FullUser for DefaultUser

fn username(&self) -> &str

Returns the username

fn email(&self) -> &str

Returns the email address

fn first_name(&self) -> &str

Returns the first name

fn last_name(&self) -> &str

Returns the last name

fn is_staff(&self) -> bool

Returns whether the user is a staff member

fn is_superuser(&self) -> bool

Returns whether the user is a superuser

fn date_joined(&self) -> DateTime<Utc>

Returns when the user account was created

fn get_full_name(&self) -> String

Returns the full name (first name + last name)

fn get_short_name(&self) -> &str

Returns the short name (first name only)

impl Model for DefaultUser

type PrimaryKey = Uuid

The primary key type

type Fields = DefaultUserFields

Type-safe field selector

fn table_name() -> &'static str

Get the table name

fn new_fields() -> <DefaultUser as Model>::Fields

Create a new field selector instance

fn primary_key(&self) -> Option<<DefaultUser as Model>::PrimaryKey>

Get the primary key value

fn set_primary_key(&mut self, value: <DefaultUser as Model>::PrimaryKey)

Set the primary key value

fn primary_key_field() -> &'static str

Get the primary key field name

fn app_label() -> &'static str

Get the app label for this model

fn composite_primary_key() -> Option<CompositePrimaryKey>

Get composite primary key definition if this model uses composite PK

fn get_composite_pk_values(&self) -> HashMap<String, PkValue>

Get composite primary key values for this instance

fn field_metadata() -> Vec<FieldInfo>

Get field metadata for inspection

fn relationship_metadata() -> Vec<RelationInfo>

Get relationship metadata for inspection

fn index_metadata() -> Vec<IndexInfo>

Get index metadata for inspection

fn constraint_metadata() -> Vec<ConstraintInfo>

Get constraint metadata for inspection

fn objects() -> Manager<Self>

where Self: Sized,

Django-style objects manager accessor

fn save(&mut self) -> impl Future<Output = Result<(), Error>> + Send

where Self: Sized,

Save the model instance to the database with event dispatching

fn delete(&self) -> impl Future<Output = Result<(), Error>> + Send

where Self: Sized,

Delete the model instance from the database with event dispatching

impl PermissionsMixin for DefaultUser

fn is_superuser(&self) -> bool

Returns whether this user is a superuser

fn user_permissions(&self) -> &[String]

Returns the list of permissions directly assigned to this user

fn groups(&self) -> &[String]

Returns the list of groups this user belongs to

fn get_user_permissions(&self) -> HashSet<String>

Returns all permissions directly assigned to this user

fn get_group_permissions(&self) -> HashSet<String>

Returns all permissions from groups this user belongs to

fn get_all_permissions(&self) -> HashSet<String>

Returns all permissions for this user (user permissions + group permissions)

fn has_perm(&self, perm: &str) -> bool

Checks if this user has a specific permission

fn has_perms(&self, perms: &[&str]) -> bool

Checks if this user has all of the specified permissions

fn has_module_perms(&self, app_label: &str) -> bool

Checks if this user has any permission for a specific app/module

impl Serialize for DefaultUser

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.