Skip to main content

django-auditlog

[![Build Status](https://travis-ci.org/jjkester/django-auditlog.svg?branch=master)](https://travis-ci.org/jjkester/django-auditlog) [![Docs](https://readthedocs.org/projects/django-auditlog/badge/?version=latest)](http://django-auditlog.readthedocs.org/en/latest/?badge=latest)

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.

Metadata

Release files for auditlog 0.0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for auditlog 0.0.5
File Size Uploaded Provenance Actions
auditlog-0.0.5.tar.gz 12.8 kB Without provenance Details for auditlog-0.0.5.tar.gz

Release files / auditlog-0.0.5.tar.gz

Download URL auditlog-0.0.5.tar.gz
Size 12.8 kB
Tags Source
SHA-256 checksum
How to use checksums
0721fd1ea5b866cfe55ddd6e8d60a034ddecf95ab1b3a4e83930fccf11e48c51
BLAKE2b-256 checksum
How to use checksums
88c33ddf7aa7522081d068745dc8768d5b5965ecfdcad58e4fb83cc74ae3b918
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.1.0 requests-toolbelt/0.9.1 tqdm/4.33.0 CPython/2.7.12

Security for auditlog 0.0.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page