tj-django/django-clone

Python	Django	Downloads	Code Style

PyPI	Test	Vulnerabilities	Coverage	Code Quality	Pre-Commit

django-clone

Create copies of a model instance with explicit control on how the instance should be duplicated (limiting fields or related objects copied) with unique field detection.

This solves the problem introduced by using instance.pk = None and instance.save() which results in copying more object state than required.

Features

• 100% test coverage.
• More control over how a model instance should be duplicated
• Multi Database support i.e Create duplicates on one or more databases.
• Restrict fields used for creating a duplicate instance.
• Detects unique fields and naively adds a suffix copy {count} to each duplicate instance (for supported fields only).
• Optionally differentiate between a duplicate instance and the original by appending a copy suffix to non unique fields (for supported fields only).

Table of Contents

• Installation
  • pip
  • poetry
• Usage
  • Subclassing the CloneModel
  • Using the CloneMixin
  • Using the CloneModel
  • Duplicating a model instance
  • Bulk cloning a model
  • Creating clones without subclassing CloneMixin.
  • CloneMixin attributes
    • Explicit (include only these fields)
    • Implicit (include all except these fields)
  • Django Admin
    • Duplicating Models from the Django Admin view.
      • List View
      • Change View
    • CloneModelAdmin class attributes
• Advanced Usage
  • Signals
    • pre_clone_save, post_clone_save
  • Multi-database support
• Compatibility
• Running locally
• Found a Bug?
• Contributors ✨

Installation

pip

pip install django-clone

poetry

poetry add django-clone

Usage

Subclassing the CloneModel

Using the CloneMixin

Using the CloneModel

Duplicating a model instance

Bulk cloning a model

Creating clones without subclassing CloneMixin.

NOTE: ⚠️

• This method won't copy over related objects like Many to Many/One to Many relationships.
• Ensure that required fields skipped from being cloned are passed in using the attrs kwargs.

CloneMixin attributes

Explicit (include only these fields)

Implicit (include all except these fields)

NOTE: ⚠️

• Ensure to either set _clone_excluded_* or _clone_*. Using both would raise errors.

Django Admin

Duplicating Models from the Django Admin view.

List View

Change View

CloneModelAdmin class attributes

NOTE: ⚠️

• Ensure that model_clone is placed before django.contrib.admin

INSTALLED_APPS = [
    'model_clone',
    'django.contrib.admin',
    '...',
]

Advanced Usage

Signals

pre_clone_save, post_clone_save

Multi-database support

Compatibility

Running locally

$ git clone [email protected]:tj-django/django-clone.git
$ make default-user
$ make run

Spins up a django server running the demo app.

Visit http://127.0.0.1:8000

Found a Bug?

To file a bug or submit a patch, please head over to django-clone on github.

If you feel generous and want to show some extra appreciation:

Support me with a ⭐

Contributors ✨

Thanks goes to these wonderful people:

Gerben Neven 🐛 ⚠️ 💻	Sebastian Kapunkt 💻 🐛 ⚠️	Andrés Portillo 🐛	WhiteSource Renovate 🚧	Yuekui 💻 🐛 ⚠️ 📖 🚧	Take Weiland ⚠️ 🐛 💻	Patrick 🐛 💻
Amiel Kollek 💻 🐛 ⚠️	Eric Theise 📖	Daniel Schaffer 💻 ⚠️

This project follows the all-contributors specification. Contributions of any kind welcome!