Django app which handles ORM objects' versions.
Project description
ognajDv0.2.4
Django app which handles ORM objects' versions.
Description
ognajD is Django-compactible application which handles versionning for ORM models. Main feature is for ognjaD to be a "plug-in" Django application, thus capable to work with "little-to-no" configuring and changes to Django project.
Features
ognajd stores objects' versions in own table, relied on contenttypes
application.
ognajD @ v0.2.4 can:
- catch object's save / update signals
- store snapshot of object in DB with:
- timestamp
- serialized version
- hash
- object version may be serialized (currently, only JSON) as:
- diff with previous version (by default)
- raw dumps
- inline with versione for admin models
Usage example
sample-project
is a showcase django project, based on famous
polls
application.
You can reference to it for usage cases, examples, testing.You must never deploy sample_project
in
production due to exposed SECRET_KEY
.
Getting Started
Dependencies
Python packages
django~=3.2.7
might work on lesser versions, not testedjsondiff~=1.3.0
might work on lesser versions, not tested
Django applications
contenttypes
Installing
Using Python Package Index
-
make sure to use latest
pip
:python3 -m pip install --upgrade pip
-
install
django-ognajd
:python3 -m pip install django-ognajd
OR download package from releases
-
download release asset (
.tar.gz
or.whl
) -
make sure to use latest
pip
:python3 -m pip install --upgrade pip
-
install
django-ognajd
from file:python3 -m pip install /path/to/downloaded/asset.tar.gz # or .whl
OR clone from repository
-
clone project:
git clone \ --depth=1 \ --branch=master \ git@github.com:omelched/django-ognajd.git \ </path/to/downloads>
-
move
/django-ognajd/ognajd
solely to folder containing django appsmv </path/to/downloads>/django-ognajd/ognajd \ </path/to/django/project/apps>
-
remove leftovers
rm -rf </path/to/downloads>/django-ognajd
Configuring
Installing application
Add ognajd
to INSTALLED_APPS
in your Django project settings.py
.
Make sure it is installed before django.contrib.admin
.
If you installed package the third way, </path/to/django/project/apps>
must be added to PYTHONPATH
. If you not sure add code below in your Django project manage.py
before calling main()
:
sys.path.append('</path/to/django/project/apps>')
Registering models
To register your model as eligible for versioning add attribute-class VersioningMeta
to model class definition.
For typing, linters, autocompletion tyou can inherit from ognajd.models.VersioningMeta
.
Then set preferred options.
e.g:
# .../your_app/models.py
from django.db import models
from ognajd.models import VersioningMeta
class Question(models.Model):
class VersioningMeta(VersioningMeta):
store_diff = False
... # fields' definitions
VersioningMeta
options
Name | Description | Type | Default |
---|---|---|---|
enabled |
True : if model will be versioned False : if will not |
bool |
True |
store_diff |
True : model's history will be stored as diffs False : as dumps |
bool |
True |
save_empty_changes |
True : if empty changes will be registered False : if will not |
bool |
True |
Authors
@omelched (Denis Omelchenko)
Contributors
Changelist
ognajD version history and changelist available at releases page.
License
This project is licensed under the GNU APGLv3 License - see the LICENSE file for details.
Acknowledgments
Inspiration, code snippets, etc.
- polls showcase app code from sample-django
- index incrementer at model save from
tinfoilboy
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file django_ognajd-0.2.4.tar.gz
.
File metadata
- Download URL: django_ognajd-0.2.4.tar.gz
- Upload date:
- Size: 22.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | c36535f7635cb92909190396d49516c7b7a95eeba74c760934df60e889c3eeb3 |
|
MD5 | ecd743f4fb907b51452b1ddcd2d885fd |
|
BLAKE2b-256 | 55c1b38f9fb109ad4f656535a66ea4681a25d035b6028649966ad01de7c5805e |
File details
Details for the file django_ognajd-0.2.4-py3-none-any.whl
.
File metadata
- Download URL: django_ognajd-0.2.4-py3-none-any.whl
- Upload date:
- Size: 32.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b839dca2a641e4cd2ee744de8626c5c3045a34e2de2d0628271de69014d9ecff |
|
MD5 | 4d1e29e4bdedef700b873b285bbaeff2 |
|
BLAKE2b-256 | 9520d1eb9eb6e753753ff4d5f7c969a1d6b0784b6f90eb05a0bb5c601ce45478 |