django-mz-users

The user model and user management for Django projects of the django-mz family (projects whose admin drives an API and a Vue frontend). It is a small, plain Django app that any project can use.

Status: alpha (0.1.0a2). The API may change before 1.0.

Why a custom user model from the start

Django recommends a custom user model for every new project: switching AUTH_USER_MODEL later, on a live database, is hard. mz_users.User is Django's standard user (AbstractUser) in its own app, so projects can share it and extend it later without that switch.

Installation

pip install django-mz-users

INSTALLED_APPS = [..., 'django.contrib.auth', 'mz_users', ...]
AUTH_USER_MODEL = 'mz_users.User'

Set it before the first migrate of the project. The app label is mz_users (table mz_users_user).

What is included

• mz_users.User – the user model (AbstractUser), Czech labels included

• admin registration with Django's UserAdmin: the new-user form asks for the password twice

• optional integration with django-allauth (mz_users.accounts), see below

Self-registration, e-mail verification, password reset and social login are django-allauth's job (its headless API works with this model as is).

With django-allauth

pip install django-mz-users[allauth]

With mandatory e-mail verification (ACCOUNT_EMAIL_VERIFICATION = 'mandatory') allauth lets in only users with a verified e-mail. Users created outside allauth (the admin, createsuperuser, commands, scripts) are trusted: with the adapters below their e-mail becomes a verified primary address whenever they are saved. Sign-ups and provider logins still verify their address through allauth.

ACCOUNT_ADAPTER = 'mz_users.accounts.AccountAdapter'
SOCIALACCOUNT_ADAPTER = 'mz_users.accounts.SocialAccountAdapter'  # with allauth.socialaccount

The adapters mark the users allauth creates; without them nothing is verified automatically (that would let sign-ups skip verification). Subclass them for your own adapters. A project that adopts allauth with existing users verifies their e-mails once:

python manage.py mz_users_verify_emails

Development

uv run --package django-mz-users pytest

License

MIT