django-copyist
==========================================
Tool for precise and efficient copying of Django models instances.
Do you live in fear of the day when PM will come to you
and ask to implement a copy feature for your root model,
that has a lot of relations and you know that it will be a pain to implement it in a way that will work properly?
Well, fear no more, as `django-copyist` got you covered
Features
--------
- **Precision** - Copy only what you need in a way that you need with help of custom copy actions.
- **Readability** - With declarative style config - you can easily see what and how is copied, no need to hop between models and parse it in your head.
- **Efficiency** - Unlike some other solutions and naive approaches, copyist is copying your data without recursive hopping between model instances, which gives it a magnitudes of speedup on big data sets.
- **Flexibility** - Copyist covers all steps that are there for data copy, including validation of data, pre-copy and post-copy actions. Copyist also work good with de-normalized data, not judging you for your choices.
- **Interactive** - Copyist provides a way to interact with the copy process, allowing application to see what exactly is going to be done, and propagate that info to end user to decide if he wants to go through with it.
- **Reusability** - With copyist your copy flow is not nailed down to model, allowing you defining different approaches for same model, and at the same time reuse existing configurations.
Motivation
----------
This project was build as in-house tool for project with complex hierarchy of models,
where we needed to copy them in a very particular way.
Existing solutions like `django-clone <https://github.com/tj-django/django-clone>`_ were designed
in a way that didn't fit our needs, as they required to modify models and
didn't allow to have full control over the copying process.
This project aims to provide a more flexible and efficient way to copy Django models instances, while
not affecting existing codebase.
Quickstart
==========
This pages aims to get you going with django-copyist as quickly as possible.
Installation
------------
To install with pip:
.. code-block:: console
pip install django-copyist
To install with poetry:
.. code-block:: console
poetry add django-copyist
Usage
-----------
`See quickstart in docs <https://abondar.github.io/django-copyist/quickstart.html>`_
Raw data
{
"_id": null,
"home_page": "https://github.com/abondar/django-copyist",
"name": "django-copyist",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": null,
"keywords": "django, copy, clone, model",
"author": "abondar",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/7c/19/c1359eb8f0e26e536c35934dcafc74d676c04da191ffcff43c7429efc542/django_copyist-0.1.3.tar.gz",
"platform": null,
"description": "django-copyist\n==========================================\n\nTool for precise and efficient copying of Django models instances.\n\nDo you live in fear of the day when PM will come to you\nand ask to implement a copy feature for your root model,\nthat has a lot of relations and you know that it will be a pain to implement it in a way that will work properly?\n\nWell, fear no more, as `django-copyist` got you covered\n\n\nFeatures\n--------\n\n- **Precision** - Copy only what you need in a way that you need with help of custom copy actions.\n- **Readability** - With declarative style config - you can easily see what and how is copied, no need to hop between models and parse it in your head.\n- **Efficiency** - Unlike some other solutions and naive approaches, copyist is copying your data without recursive hopping between model instances, which gives it a magnitudes of speedup on big data sets.\n- **Flexibility** - Copyist covers all steps that are there for data copy, including validation of data, pre-copy and post-copy actions. Copyist also work good with de-normalized data, not judging you for your choices.\n- **Interactive** - Copyist provides a way to interact with the copy process, allowing application to see what exactly is going to be done, and propagate that info to end user to decide if he wants to go through with it.\n- **Reusability** - With copyist your copy flow is not nailed down to model, allowing you defining different approaches for same model, and at the same time reuse existing configurations.\n\nMotivation\n----------\n\nThis project was build as in-house tool for project with complex hierarchy of models,\nwhere we needed to copy them in a very particular way.\n\nExisting solutions like `django-clone <https://github.com/tj-django/django-clone>`_ were designed\nin a way that didn't fit our needs, as they required to modify models and\ndidn't allow to have full control over the copying process.\n\nThis project aims to provide a more flexible and efficient way to copy Django models instances, while\nnot affecting existing codebase.\n\nQuickstart\n==========\n\nThis pages aims to get you going with django-copyist as quickly as possible.\n\nInstallation\n------------\n\nTo install with pip:\n\n.. code-block:: console\n\n pip install django-copyist\n\nTo install with poetry:\n\n.. code-block:: console\n\n poetry add django-copyist\n\n\nUsage\n-----------\n\n`See quickstart in docs <https://abondar.github.io/django-copyist/quickstart.html>`_\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Tool for precise and efficient django model copying",
"version": "0.1.3",
"project_urls": {
"Documentation": "https://abondar.github.io/django-copyist/",
"Homepage": "https://github.com/abondar/django-copyist",
"Repository": "https://github.com/abondar/django-copyist.git"
},
"split_keywords": [
"django",
" copy",
" clone",
" model"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c8a793d561b719d3b38b86cc7a5faad836b57be0cdba4d972a16458580d76b2a",
"md5": "8f17e7f6adbaa2008e201c1516bdc88e",
"sha256": "b3a4e465db650279c215a0df8747a67d578bebf087f83c5b2094e5c512217fab"
},
"downloads": -1,
"filename": "django_copyist-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8f17e7f6adbaa2008e201c1516bdc88e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 21648,
"upload_time": "2024-04-28T13:17:45",
"upload_time_iso_8601": "2024-04-28T13:17:45.765026Z",
"url": "https://files.pythonhosted.org/packages/c8/a7/93d561b719d3b38b86cc7a5faad836b57be0cdba4d972a16458580d76b2a/django_copyist-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7c19c1359eb8f0e26e536c35934dcafc74d676c04da191ffcff43c7429efc542",
"md5": "85583ddfa32f8bb3f5932ff978eb18eb",
"sha256": "e462fc468562341789d5bdca5179e371da821a4fd5cc4e4b3ef93b8691b03f89"
},
"downloads": -1,
"filename": "django_copyist-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "85583ddfa32f8bb3f5932ff978eb18eb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 19500,
"upload_time": "2024-04-28T13:17:47",
"upload_time_iso_8601": "2024-04-28T13:17:47.001843Z",
"url": "https://files.pythonhosted.org/packages/7c/19/c1359eb8f0e26e536c35934dcafc74d676c04da191ffcff43c7429efc542/django_copyist-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-28 13:17:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "abondar",
"github_project": "django-copyist",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "django-copyist"
}
JSON
