Skip to main content

django-eventlog stores event messages in a Django model.

Project description

https://img.shields.io/pypi/v/django-eventlog.svg https://github.com/bartTC/django-eventlog/actions/workflows/push.yml/badge.svg

📖 Full documentation: https://django-eventlog.readthedocs.io/

Compatibility Matrix:

Py/Dj

3.8

3.9

3.10

3.11

3.12

3.2 (LTS)

4.0

4.1

4.2 (LTS)

5.0

django-eventlog

django-eventlog is a very simple event logger you can use to track certain actions in your code. Events are stored in a Django model and can be viewed in the Django Admin.

Usage Example:

from eventlog import EventGroup

e = EventGroup()                       # Start a new Event Group
e.info('About to send 1000 mails.',    # Trigger an Event
       initiator='Mailer Daemon')
try:
    # ... sending 1000 mails
    e.info('All emails sent!',         # Trigger an Event in the same group,
           initiator='Mailer Daemon')  # so they are combined in the admin.
except Exception:
    e.error('There was an error sending the emails.',
            initiator='Mailer Daemon')

Events can be grouped in a “Event Group” and when hovering over one item in the admin, all events of the same group are highlighted:

https://github.com/bartTC/django-eventlog/raw/main/docs/_static/change_list.png

The details view of an event will list all other events of this group so you can track the progress:

https://github.com/bartTC/django-eventlog/raw/main/docs/_static/change_form.png

Changelog

1.4 (2024-03-05)

  • Event groups can now have arbitrary names instead of UUIDs.

  • Event comments is a textfield.

  • Fixed potential migration warnings around AutoFields.

1.3 (2023-10-04)

  • Python 3.12 compatibility

  • Django 5.0 support

  • Type Annotations

1.2 (2023-04-28)

  • Python 3.7 to 3.11 compatibility

  • Django 3.2 to 4.2 support

1.1 (2018-05-11)

  • Added ability to manually set a group id to make an EventGroup object reusable through threads.

1.0 (2018-02-13)

  • Production ready 1.0 release.

  • The details Admin view now displays all events of the group with an annotated delay, so you can see the progress of the group.

0.9 (2018-02-13)

  • Initial release.

  • Django 1.8 to 2.0 compatibility.

  • Python 2.7 to 3.6 compatibility.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-eventlog-1.4.tar.gz (889.7 kB view details)

Uploaded Source

Built Distribution

django_eventlog-1.4-py3-none-any.whl (14.4 kB view details)

Uploaded Python 3

File details

Details for the file django-eventlog-1.4.tar.gz.

File metadata

  • Download URL: django-eventlog-1.4.tar.gz
  • Upload date:
  • Size: 889.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.1

File hashes

Hashes for django-eventlog-1.4.tar.gz
Algorithm Hash digest
SHA256 e185035bfe0d82925e095df35d9744d6e4772caf898c43d03ee7a769ec20a507
MD5 f2381a2b3875438cf2fa4162e742589e
BLAKE2b-256 fa3406b52e44730b628191b7a335f2f166ca80136df4fa38d6b56151bc4d8c11

See more details on using hashes here.

File details

Details for the file django_eventlog-1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for django_eventlog-1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 bba299bf3691bca1eb1bba6273ceae64a7419ac99bfe72f4d04129d87c6fc826
MD5 c4d86aef1c87b2e7573ecadab3788da2
BLAKE2b-256 2935e83936dea3db3da820e6d732d3f1b81750c7907c607406d6d34ba8050e49

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page