{"id":21311,"library":"event-tracking","title":"Event Tracking","description":"A simple event tracking system for Python applications, commonly used in the Open edX platform. Current version 4.0.0, release cadence: irregular.","status":"active","version":"4.0.0","language":"python","source_language":"en","source_url":"https://github.com/openedx/event-tracking","tags":["event-tracking","openedx","django","analytics"],"install":[{"cmd":"pip install event-tracking","lang":"bash","label":"default"}],"dependencies":[],"imports":[{"note":"Old import path with underscore is deprecated; use 'eventtracking' (no underscore).","wrong":"from event_tracking.django import EventTrackingConfig","symbol":"EventTrackingConfig","correct":"from eventtracking.django import EventTrackingConfig"},{"note":"The correct import is 'from eventtracking import tracker' and use it as 'event_tracker'. Avoid bare 'Tracker' class import as it's not exposed directly.","wrong":"from eventtracking import tracker","symbol":"Tracker","correct":"from eventtracking import tracker as event_tracker"}],"quickstart":{"code":"from eventtracking import tracker\ntracker = tracker.get_tracker()\ntracker.send({'name': 'my_event', 'data': {'key': 'value'}})\nprint('Event sent')","lang":"python","description":"Basic event sending using the default tracker."},"warnings":[{"fix":"Add 'eventtracking.django.EventTrackingConfig' to INSTALLED_APPS in your Django settings.","message":"In v4.0.0, the Django integration requires explicitly adding 'eventtracking.django.EventTrackingConfig' to INSTALLED_APPS. Failure to do so causes AppRegistryNotReady errors.","severity":"breaking","affected_versions":">=4.0.0"},{"fix":"Use 'import eventtracking' or 'from eventtracking import ...'","message":"The module name is 'eventtracking' (no underscore), not 'event_tracking'. Many users mistakenly use underscore-based imports.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade Python to 3.9 or higher.","message":"Support for Python 3.8 was dropped in v3.0.0. Python 3.9+ required.","severity":"deprecated","affected_versions":">=3.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"pip install event-tracking, then use 'import eventtracking' (no underscore).","cause":"Using underscore instead of correct module name 'eventtracking'.","error":"ModuleNotFoundError: No module named 'event_tracking'"},{"fix":"Ensure only one entry for 'eventtracking.django.EventTrackingConfig' in INSTALLED_APPS.","cause":"Duplicate app config due to multiple installations or manual entry in INSTALLED_APPS.","error":"django.core.exceptions.ImproperlyConfigured: Application labels aren't unique, duplicates: EventTrackingConfig"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}