Skip to main content

Automated merges of User accounts.

Project description


Django-transplant is an app for performing easy merges of django user accounts. It should play nicely with any third party social authentication backend.


Django-transplant requires:

  • Django 1.2.5 or higher.

If you plan to develop, or run the test suite you should also install:

  • Mock

This dependency will not be installed automatically via pip.


To install with pip into site-packages issue:

pip install django-transplant

To install with pip into src folder (as git repo) issue:

pip install -e \


Add 'transplant' to your INSTALLED_APPS. If you plan to run the test suite you should also add 'transplant.tests':

        'transplant.tests', # this is optional

For your convenience django-transplant provides a default view for performing User merges. You can use it like any FormView, and it’s name is transplant_merge. It expects a default template in ‘transplant/merge.html’.

To hook it up just add it to your urlconf at any URL:

urplatterns = patterns('',
        url(r'^accounts/merge/$', include('transplant.urls')),

You should be now able to get the merge form and submit it, but it will have no effect. To utilize default merges you must set TRANSPLANT_OPERATIONS in your

        {'user_field': 'owner'}
        {'manager': 'unread'}

TRANSPLANT_OPERATIONS consists of triples, each one of them specifies:

  1. Path to model class to be merged.

  2. Path to Surgeon class to be used during the merge.

  3. Extra arguments.

Currently supported extra arguments are:

  • user_field - name of the user field that will be used by the Surgeon during the merge (defaults to ‘user’).

  • manager - name of Manager used during the merge. In the example above only messages accessible via the ‘unread’ manager will be merged.

You may be happy with the behavior of DefaultSurgeon which is:

  • set field given as ‘user_field’ to the user that performs the merge

  • call save() on each entity (so that all signals are triggered)

  • set the is_active to False on the user that is merged

If you want additional functionality consult the docs.


Documentation is available at



  • Addidional Surgeon class BatchSurgeon pefrorming batch updates

  • Added UserMergeForm used by default by provided view


  • Surgery class

  • Surgeon classes - NopSurgeon class that does basically nothing - DefaultSurgeon class for default merging behavior

  • Default view provide for convenience

  • Urls provided for conveniene

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-transplant-0.0.2.tar.gz (9.4 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page