Docs for swappable model option

[me@…]

Used by auth user model.

[Preston Holmes]

At this time, the swappable machinery used for swappable user models is a private API, intentionally undocumented.

User models are the pilot program and will let us understand what challenges exist with such an API - providing the chance to make changes before this API is made public.

If you want to experiment with your API - you can do so, but at your own risk. However if you do experiment, and have feedback on how the design works, by all means share it on the mailing list.

In other words, consider this a stealth alpha feature.

[Omer Katz]

​https://github.com/wq/django-swappable-models provides both docs and API for swappable models.

[Justin Michalicek]

I found this today after fighting with getting swappable models working for an app, digging through the source to find the undocumented Meta.swappable for models, and then further finding places in the swappable model code specifically looking for AUTH_USER_MODEL.

I'm very curious as to if there's any plan to complete this functionality. Currently, it seems to work as long as your settings actually have the setting specified in swappable on your model, which is of course not great when relying on the default models, but means it's apparently close to being functional. I saw a few other things when looking at existing migrations on the app I am working with which looked like they had the potential to go awry but I haven't tested yet to see.

I had noticed the app mentioned above, but ignored it initially assuming it was outdated and no longer needed. For now, I will of course give it a try since it is still actively maintained.