Hopiu/django-auditlog
1
0
Fork 0
mirror of https://github.com/jazzband/django-auditlog.git synced 2026-03-16 22:20:26 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
A Django app that keeps a log of changes made to an object.
304 commits 7 branches 77 tags 2.5 MiB
Python 97.4%
HTML 1.6%
Makefile 0.5%
Shell 0.5%
Find a file
Alieh Rymašeŭski 2b536fc87e Bump version to 0.6.7
2020-04-22 16:09:27 +03:00
docs Bump version to 0.6.7 2020-04-22 16:09:27 +03:00
src Display timestamps in server timezone 2020-04-22 16:03:01 +03:00
.gitignore Chore -- Update testing (#126) 2017-07-05 09:32:27 -04:00
.travis.yml Use Travis CI deployment v2 2019-12-16 11:21:35 +01:00
LICENSE Update references to the maintainer 2019-08-22 16:31:08 +03:00
MANIFEST Add a missing line to manifest 2020-04-07 11:17:39 +03:00
README.md (docs) Update README to include steps to release (#185) 2018-09-17 14:56:44 -04:00
requirements-test.txt Move signal management to a context manager 2019-05-11 18:25:08 +03:00
requirements.txt Fixes #93 - Add 'changes_display_dict' property to 'LogEntry' model to display diff in a more human readable format (#94) 2017-09-13 10:57:47 -04:00
setup.py Bump version to 0.6.7 2020-04-22 16:09:27 +03:00
tox.ini Add python3.7 to tox and classifiers 2019-08-22 16:31:08 +03:00

README.md

django-auditlog

Build Status Docs

Please remember that this app is still in development. Test this app before deploying it in production environments.

django-auditlog (Auditlog) is a reusable app for Django that makes logging object changes a breeze. Auditlog tries to use as much as Python and Django’s built in functionality to keep the list of dependencies as short as possible. Also, Auditlog aims to be fast and simple to use.

Auditlog is created out of the need for a simple Django app that logs changes to models along with the user who made the changes (later referred to as actor). Existing solutions seemed to offer a type of version control, which was found excessive and expensive in terms of database storage and performance.

The core idea of Auditlog is similar to the log from Django’s admin. Unlike the log from Django’s admin (django.contrib.admin) Auditlog is much more flexible. Also, Auditlog saves a summary of the changes in JSON format, so changes can be tracked easily.

Documentation

The documentation for django-auditlog can be found on http://django-auditlog.readthedocs.org. The source files are available in the docs folder.

License

Auditlog is licensed under the MIT license (see the LICENSE file for details).

Contribute

If you have great ideas for Auditlog, or if you like to improve something, feel free to fork this repository and/or create a pull request. I'm open for suggestions. If you like to discuss something with me (about Auditlog), please open an issue.

Releases

  1. Make sure all tests on master are green.
  2. Create a new branch vX.Y.Z from master for that specific release.
  3. Bump versions in setup.py and docs/source/conf.py (docs have 2 places where the versions need to be changed!)
  4. Pull request vX.Y.Z -> stable. Merging policy is very strict. This triggers a new release.
  5. Pull request stable -> master. Now everything is back in sync.

Opening a pull request from master directly to stable is discouraged as master may be updated while the PR is open, thus changing the contents of the release.