Metadata-Version: 2.1
Name: django-modern-user
Version: 0.2.7
Summary: An improved custom user model for django projects
Home-page: https://github.com/ChrisCrossCrash/django-modern-user
License: MIT
Author: Christopher Kumm
Author-email: chrislkumm@protonmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: django (>=3.2,<4.3)
Project-URL: Repository, https://github.com/ChrisCrossCrash/django-modern-user
Description-Content-Type: text/markdown

# Django Modern User

Django Modern User is a custom user model for Django projects that replaces the default `username` field with a case-insensitive `email` field for authentication, and removes the requirement for first and last names. This model aims to provide a more practical and modern approach to user management in Django.

## Installation

> [!IMPORTANT]
> The instructions below are intended for integrating `django-modern-user` into new projects. Incorporating this package into existing projects, especially those with existing user data, can be complex and requires careful database migrations and potentially some code adjustments. The integration into projects with existing users is beyond the scope of this documentation.

1. Install `django-modern-user` via pip:
   ```bash
   python -m pip install django-modern-user
   ```

2. Add `django_modern_user` to your `INSTALLED_APPS` in your Django settings:
   ```python
   INSTALLED_APPS = [
       # ... other apps
       'django_modern_user',
   ]
   ```

3. Create a new user model in your project by subclassing `django_modern_user.ModernUser`:
   ```python
   # In your models.py
   from django_modern_user.models import ModernUser

   class CustomUser(ModernUser):
       pass
   ```

4. Update your Django settings to use your new user model:
   ```python
   AUTH_USER_MODEL = "<your_app_name>.CustomUser"
   ```

5. To use the provided `ModernUserAdmin` class in your Django admin site, you can subclass it in your `admin.py` file:
   ```python
   from django.contrib import admin
   from django_modern_user.admin import ModernUserAdmin
   from .models import CustomUser

   @admin.register(CustomUser)
   class YourUserAdmin(ModernUserAdmin):
       pass
   ```

6. Run migrations to create the necessary database table:
   ```bash
   python manage.py migrate
   ```

This setup allows you to further customize your user model and admin interface while benefiting from the features provided by `django-modern-user`.

## Usage

With `django-modern-user`, authentication is done using the email field. The email field is case-insensitive, ensuring a user-friendly authentication process.

Here's an example of how you might create a new user:

```python
from django_modern_user.models import ModernUser

# Create a new user
user = ModernUser.objects.create_user(email='example@example.com', password='password123')

# Create a superuser
superuser = ModernUser.objects.create_superuser(email='admin@example.com', password='password123')
```

## Custom User Manager

`django-modern-user` comes with a custom user manager, `UserPlusManager`, which handles user creation and ensures the email field is used for authentication.

## Contributing

Feel free to fork the project, open a PR, or submit an issue if you find bugs or have suggestions for improvements.

## License

This project is licensed under the MIT License. See the LICENSE file for details.

