Registry / communication / farama-notifications

farama-notifications

library0.0.6pypypi✓ verified 25d ago

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.

communication devops

pip install farama-notifications

github ↗package ↗

INSTALL

IMPORT

SIG · FARAMA-NOTIFICATIO

farama-notifications

communicationpythonv0.0.6

Install

1.5s avg

Import

—

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.0.6 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 17.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.5s · import 0.000s · 18MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

farama_notifications

✓ import farama_notifications

The library exposes a module-level dictionary-like object for notifications.

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.

import farama_notifications # Example of how a notification might be set or retrieved # In a typical use case, another Farama library would set these notifications. NOTIFICATION_ID = 'example_event' NOTIFICATION_MESSAGE = 'A test event has occurred!' # Set a notification farama_notifications.notifications[NOTIFICATION_ID] = NOTIFICATION_MESSAGE # Retrieve and print all notifications print('Current Farama Notifications:') for key, value in farama_notifications.notifications.items(): print(f'- {key}: {value}') # Example of checking for a specific notification if 'example_event' in farama_notifications.notifications: print(f"Found 'example_event': {farama_notifications.notifications['example_event']}")

Debug

Known issues

gotchaThe 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.

fix

Refer to the GitHub repository and Farama Foundation's project standards for the latest development practices and potential changes.

affects: <1.0.0

gotchaThe 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.

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.

affects: All

gotchaThe `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.

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.

affects: All

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'farama_notifications'

The 'farama-notifications' package is not installed in your Python environment.

fix

Install the package using pip: `pip install farama-notifications`

How to disable/suppress farama-notifications warnings

Users might want to suppress the runtime or deprecation warnings issued by Farama Foundation packages via the 'farama-notifications' library to reduce console output, especially in production or testing environments.

fix

You can suppress warnings programmatically by setting warning filters in your Python code. For example, to ignore all warnings: `import warnings; warnings.filterwarnings('ignore')`. To ignore specific categories like DeprecationWarning or RuntimeWarning, you can use `warnings.filterwarnings('ignore', category=DeprecationWarning)` or set the `PYTHONWARNINGS` environment variable (e.g., `PYTHONWARNINGS=ignore` or `PYTHONWARNINGS=ignore::DeprecationWarning`).

Upgrade

Version history

0.0.6latest on PyPI · released Apr 24, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

26 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/Farama-Foundation/Farama-Notifications ↗

packagehttps://pypi.org/project/farama-notifications/ ↗