Opened 7 years ago

Last modified 7 years ago

#28461 new Cleanup/optimization

Clarify how UserManager.create_superuser() must be implemented with a ForeignKey in REQUIRED_FIELDS

Reported by: Kirill B. Owned by: nobody
Component: Documentation Version: 1.11
Severity: Normal Keywords:
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description (last modified by Kirill B.)

These are my models:

from uuid import uuid4

from django.contrib.auth.models import AbstractUser
from django.db import models

class Company(models.Model):
    name = models.CharField(max_length=64, primary_key=True)

class User(AbstractUser):
    uuid = models.UUIDField(primary_key=True, editable=False, default=uuid4)
    company = models.ForeignKey(Company)

    REQUIRED_FIELDS = ['email', 'company']

When I run createsuperuser I got this result:

Username: superuser
Email address:
Company ( TEST
Password (again): 
Traceback (most recent call last):
  File "", line 22, in <module>
  File "/Users/ookami/venv/swportal/lib/python3.5/site-packages/django/core/management/", line 363, in execute_from_command_line
  File "/Users/ookami/venv/swportal/lib/python3.5/site-packages/django/core/management/", line 355, in execute
  File "/Users/ookami/venv/swportal/lib/python3.5/site-packages/django/core/management/", line 283, in run_from_argv
    self.execute(*args, **cmd_options)
  File "/Users/ookami/venv/swportal/lib/python3.5/site-packages/django/contrib/auth/management/commands/", line 63, in execute
    return super(Command, self).execute(*args, **options)
  File "/Users/ookami/venv/swportal/lib/python3.5/site-packages/django/core/management/", line 330, in execute
    output = self.handle(*args, **options)
  File "/Users/ookami/venv/swportal/lib/python3.5/site-packages/django/contrib/auth/management/commands/", line 183, in handle
  File "/Users/ookami/venv/swportal/lib/python3.5/site-packages/django/contrib/auth/", line 170, in create_superuser
    return self._create_user(username, email, password, **extra_fields)
  File "/Users/ookami/venv/swportal/lib/python3.5/site-packages/django/contrib/auth/", line 151, in _create_user
    user = self.model(username=username, email=email, **extra_fields)
  File "/Users/ookami/venv/swportal/lib/python3.5/site-packages/django/contrib/auth/", line 68, in __init__
    super(AbstractBaseUser, self).__init__(*args, **kwargs)
  File "/Users/ookami/venv/swportal/lib/python3.5/site-packages/django/db/models/", line 554, in __init__
    _setattr(self,, rel_obj)
  File "/Users/ookami/venv/swportal/lib/python3.5/site-packages/django/db/models/fields/", line 216, in __set__
ValueError: Cannot assign "'TEST'": "" must be a "Company" instance.


Attachments (1)

local_history.patch (889 bytes ) - added by Kirill B. 7 years ago.
Possible solution

Download all attachments as: .zip

Change History (12)

by Kirill B., 7 years ago

Attachment: local_history.patch added

Possible solution

comment:1 by Kirill B., 7 years ago

Has patch: set

comment:2 by Tim Graham, 7 years ago

Patch needs improvement: set
Summary: Can't create superuser with ForeignKey required fieldcreate_superuser crashes with a ForeignKey to a CharField in REQUIRED_FIELDS
Triage Stage: UnreviewedAccepted

I can reproduce the crash, however, the proposed patch breaks the test_fields_with_fk_interactive test from #21832.

comment:3 by Tim Graham, 7 years ago

Summary: create_superuser crashes with a ForeignKey to a CharField in REQUIRED_FIELDScreatesuperuser crashes with a ForeignKey to a CharField in REQUIRED_FIELDS

comment:4 by Kirill B., 7 years ago

Description: modified (diff)
Has patch: unset
Patch needs improvement: unset

comment:5 by Kirill B., 7 years ago

The problem is not in CharField – actually any ForeignKey will fail. Current tests are using customized UserManager, where ForeignKey is resolved manually. I've created new test where custom user is inherited from default User model.

I've created PR with my proposal to fix this problem.

comment:6 by Kirill B., 7 years ago

Has patch: set

comment:7 by Tim Graham, 7 years ago

Do you see a downside to documenting that UserManager.create_superuser() must be implemented as it is now in the tests? The proposed change will break currently working code (as the change in CustomUserWithFKManager.create_superuser() demonstrates).

comment:8 by Kirill B., 7 years ago

Yeah, I think this moment should be clarified in docs, but I'm in doubt what exactly should go there.

I guess there are 2 places where this can be described: createsuperuser management command docs and models.CustomUserManager.create_superuser section in auth/customizing.txt.

comment:9 by Tim Graham, 7 years ago

Component: contrib.authDocumentation
Has patch: unset
Summary: createsuperuser crashes with a ForeignKey to a CharField in REQUIRED_FIELDSClarify how UserManager.create_superuser() must be implemented with a ForeignKey in REQUIRED_FIELDS
Type: BugCleanup/optimization

I think I'd put a note in UserManager.create_superuser() as you mentioned and also in the docs for REQUIRED_FIELDS intopics/auth/customizing.txt. In the latter place, there's already a note there about ForeignKey that could be elaborated upon.

comment:10 by Kirill B., 7 years ago

I thought you meant to update documentation in addition to this change. The problem is that the current implementation of createsuperuser management command doesn't work with the default implementation of UserManager (see the code in my first post). So either the implementation of default UserManager.create_superuser() or createsuperuser management command should be changed.

comment:11 by Tim Graham, 7 years ago

I understand your point and am not completely convinced about which way to go, however, technically, I think your code doesn't conform to the documentation which says:

If your user model defines [the same fields] as Django’s default user, you can just install Django’s UserManager; however, if your user model defines different fields, you’ll need to define a custom manager that extends BaseUserManager providing two additional methods:
The prototype of create_superuser() should accept the username field, plus all required fields as arguments.

Since you added 'company' in REQUIRED_FIELDS, the documentation suggests that a custom manager must be added for this situation.

Note: See TracTickets for help on using tickets.
Back to Top