{"id":2023,"library":"farama-notifications","title":"Farama Notifications","description":"Farama-Notifications is a Python library that enables providing notifications on import to all Farama Foundation maintained packages. Its primary role is to serve as a unified mechanism for Farama projects to deliver runtime and deprecation notices consistently. The current version is 0.0.4.","status":"active","version":"0.0.4","language":"en","source_language":"en","source_url":"https://github.com/Farama-Foundation/Farama-Notifications","tags":["notifications","Farama Foundation","utility","ecosystem"],"install":[{"cmd":"pip install farama-notifications","lang":"bash","label":"Install stable version"}],"dependencies":[],"imports":[{"note":"The library exposes a module-level dictionary-like object for notifications.","symbol":"farama_notifications","correct":"import farama_notifications"}],"quickstart":{"code":"import farama_notifications\n\n# Example of how a notification might be set or retrieved\n# In a typical use case, another Farama library would set these notifications.\nNOTIFICATION_ID = 'example_event'\nNOTIFICATION_MESSAGE = 'A test event has occurred!'\n\n# Set a notification\nfarama_notifications.notifications[NOTIFICATION_ID] = NOTIFICATION_MESSAGE\n\n# Retrieve and print all notifications\nprint('Current Farama Notifications:')\nfor key, value in farama_notifications.notifications.items():\n    print(f'- {key}: {value}')\n\n# Example of checking for a specific notification\nif 'example_event' in farama_notifications.notifications:\n    print(f\"Found 'example_event': {farama_notifications.notifications['example_event']}\")","lang":"python","description":"This quickstart demonstrates how to import the `farama_notifications` library and interact with its `notifications` object. Farama libraries typically populate this object with messages upon import or during runtime."},"warnings":[{"fix":"Refer to the GitHub repository and Farama Foundation's project standards for the latest development practices and potential changes.","message":"The library is at an early development stage (version 0.0.4). While the Farama Foundation aims for semantic versioning, minor and patch releases (0.x.x) may introduce API changes. Users should review release notes for updates.","severity":"gotcha","affected_versions":"<1.0.0"},{"fix":"If directly interacting with `farama_notifications.notifications`, be aware that its structure or lifecycle might evolve with updates to Farama Foundation libraries. It's best used for inspection or advanced integration rather than as a primary messaging system for user applications.","message":"The primary intent of `farama-notifications` is for Farama Foundation libraries to internally provide runtime and deprecation notifications. Directly manipulating the `farama_notifications.notifications` object by end-users might not be the intended main public API and could be subject to internal changes in how these notifications are managed by dependent libraries.","severity":"gotcha","affected_versions":"All"},{"fix":"Exercise caution when modifying the `farama_notifications.notifications` object. If modifying, consider clear ownership, synchronization mechanisms, or careful key management to avoid conflicts in multi-threaded or complex application environments.","message":"The `farama_notifications.notifications` object is a mutable global dictionary-like state. Uncoordinated direct modification in complex applications could lead to unexpected behavior, race conditions, or overwriting of messages set by other Farama libraries or parts of your application.","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"last_verified":"2026-04-09T00:00:00.000Z","next_check":"2026-07-08T00:00:00.000Z"}