This model will have everything in auth.User, as well as all the fields in add_fields. Since I defined replaces_module as auth.users, it actually replaces the auth.User model. If replaces_module was not defined, it would just be a separate users model, though it would still have all the same fields.

I haven't tried ignore_fields yet, but I presume that it will cause specified fields to be removed from the model. It looks like it takes a list of field names.

Notice also that I've redefined admin above to include the extra fields. Be sure to do that if you want them to show up in the admin interface.

Gotchas

Replacing auth.User in this way breaks createsuperuser. You'll have to add an inital superuser to the database manually.

If your other model classes have foreign, or many to many relationships with User, make sure its to your redefined User class, not auth.User, otherwise the user objects will not have the expected get_otherthing() methods.