django-mz-users 0.1.0a1__tar.gz

django_mz_users-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Miroslav Zvolský
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

django_mz_users-0.1.0a1/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: django-mz-users
+Version: 0.1.0a1
+Summary: Custom user model and user management for Django projects of the django-mz family
+Keywords: django,users,user-model,auth,accounts
+Author: Miroslav Zvolský
+Author-email: Miroslav Zvolský <zvolsky@seznam.cz>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5.2
+Classifier: Framework :: Django :: 6.0
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Dist: django>=5.2
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# 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.0a1). 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
+
+```console
+pip install django-mz-users
+```
+
+```python
+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
+
+Planned: self-registration, password reset by e-mail and other user management, as API views for the frontend.
+
+## Development
+
+```console
+uv run --package django-mz-users pytest
+```
+
+## License
+
+MIT

django_mz_users-0.1.0a1/README.md

@@ -0,0 +1,42 @@
+# 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.0a1). 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
+
+```console
+pip install django-mz-users
+```
+
+```python
+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
+
+Planned: self-registration, password reset by e-mail and other user management, as API views for the frontend.
+
+## Development
+
+```console
+uv run --package django-mz-users pytest
+```
+
+## License
+
+MIT

django_mz_users-0.1.0a1/pyproject.toml

@@ -0,0 +1,50 @@
+[project]
+name = "django-mz-users"
+version = "0.1.0a1"
+description = "Custom user model and user management for Django projects of the django-mz family"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+dependencies = ["django>=5.2"]
+keywords = [
+    "django",
+    "users",
+    "user-model",
+    "auth",
+    "accounts",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Framework :: Django",
+    "Framework :: Django :: 5.2",
+    "Framework :: Django :: 6.0",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+]
+
+[[project.authors]]
+name = "Miroslav Zvolský"
+email = "zvolsky@seznam.cz"
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-django>=4.9",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.13,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "mz_users"
+
+[tool.pytest.ini_options]
+DJANGO_SETTINGS_MODULE = "tests.settings"
+pythonpath = ["."]
+testpaths = ["tests"]

django_mz_users-0.1.0a1/pyproject.toml.orig

@@ -0,0 +1,45 @@
+[project]
+name = "django-mz-users"
+version = "0.1.0a1"
+description = "Custom user model and user management for Django projects of the django-mz family"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Miroslav Zvolský", email = "zvolsky@seznam.cz" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "django>=5.2",
+]
+keywords = ["django", "users", "user-model", "auth", "accounts"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Framework :: Django",
+    "Framework :: Django :: 5.2",
+    "Framework :: Django :: 6.0",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-django>=4.9",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.13,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "mz_users"
+
+[tool.pytest.ini_options]
+DJANGO_SETTINGS_MODULE = "tests.settings"
+pythonpath = ["."]
+testpaths = ["tests"]

django_mz_users-0.1.0a1/src/mz_users/__init__.py

@@ -0,0 +1 @@
+"""Custom user model and user management for Django projects of the django-mz family."""

django_mz_users-0.1.0a1/src/mz_users/admin.py

@@ -0,0 +1,7 @@
+from django.contrib import admin
+from django.contrib.auth.admin import UserAdmin
+
+from .models import User
+
+# the new-user form of UserAdmin asks for the password twice (fields of the form only, not of the model)
+admin.site.register(User, UserAdmin)

django_mz_users-0.1.0a1/src/mz_users/apps.py

@@ -0,0 +1,9 @@
+from django.apps import AppConfig
+from django.utils.translation import gettext_lazy as _
+
+
+class MzUsersConfig(AppConfig):
+    name = 'mz_users'
+    label = 'mz_users'
+    verbose_name = _('Users')
+    default_auto_field = 'django.db.models.BigAutoField'

django_mz_users-0.1.0a1/src/mz_users/locale/cs/LC_MESSAGES/django.po

@@ -0,0 +1,17 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: django-mz-users\n"
+"Language: cs\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=4; plural=(n == 1 && n % 1 == 0) ? 0 : (n >= 2 && n <= 4 && n % 1 == 0) ? 1: (n % 1 != 0 ) ? 2 : 3;\n"
+
+msgid "Users"
+msgstr "Uživatelé"
+
+msgid "user"
+msgstr "uživatel"
+
+msgid "users"
+msgstr "uživatelé"

django_mz_users-0.1.0a1/src/mz_users/migrations/0001_initial.py

@@ -0,0 +1,45 @@
+# Generated by Django 6.1.1 on 2026-11-02 16:08
+
+import django.contrib.auth.models
+import django.contrib.auth.validators
+import django.utils.timezone
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('auth', '0012_alter_user_first_name_max_length'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='User',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('password', models.CharField(max_length=128, verbose_name='password')),
+                ('last_login', models.DateTimeField(blank=True, null=True, verbose_name='last login')),
+                ('is_superuser', models.BooleanField(default=False, help_text='Designates that this user has all permissions without explicitly assigning them.', verbose_name='superuser status')),
+                ('username', models.CharField(error_messages={'unique': 'A user with that username already exists.'}, help_text='Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.', max_length=150, unique=True, validators=[django.contrib.auth.validators.UnicodeUsernameValidator()], verbose_name='username')),
+                ('first_name', models.CharField(blank=True, max_length=150, verbose_name='first name')),
+                ('last_name', models.CharField(blank=True, max_length=150, verbose_name='last name')),
+                ('email', models.EmailField(blank=True, max_length=254, verbose_name='email address')),
+                ('is_staff', models.BooleanField(default=False, help_text='Designates whether the user can log into this admin site.', verbose_name='staff status')),
+                ('is_active', models.BooleanField(default=True, help_text='Designates whether this user should be treated as active. Unselect this instead of deleting accounts.', verbose_name='active')),
+                ('date_joined', models.DateTimeField(default=django.utils.timezone.now, verbose_name='date joined')),
+                ('groups', models.ManyToManyField(blank=True, help_text='The groups this user belongs to. A user will get all permissions granted to each of their groups.', related_name='user_set', related_query_name='user', to='auth.group', verbose_name='groups')),
+                ('user_permissions', models.ManyToManyField(blank=True, help_text='Specific permissions for this user.', related_name='user_set', related_query_name='user', to='auth.permission', verbose_name='user permissions')),
+            ],
+            options={
+                'verbose_name': 'user',
+                'verbose_name_plural': 'users',
+                'abstract': False,
+                'swappable': 'AUTH_USER_MODEL',
+            },
+            managers=[
+                ('objects', django.contrib.auth.models.UserManager()),
+            ],
+        ),
+    ]

django_mz_users-0.1.0a1/src/mz_users/models.py

@@ -0,0 +1,14 @@
+"""
+The project's user model (``AUTH_USER_MODEL = 'mz_users.User'``). It starts as Django's standard user, so a project
+can later add fields or behaviour here without the painful switch of the user model on a live database.
+"""
+
+from django.contrib.auth.models import AbstractUser
+from django.utils.translation import gettext_lazy as _
+
+
+class User(AbstractUser):
+    class Meta(AbstractUser.Meta):
+        swappable = 'AUTH_USER_MODEL'
+        verbose_name = _('user')
+        verbose_name_plural = _('users')