Skip to content

Bump black_death_v3 to black_death_v4 - #266

Open
teddytennant wants to merge 1 commit into
Farama-Foundation:mainfrom
teddytennant:bump-black-death-v4
Open

Bump black_death_v3 to black_death_v4#266
teddytennant wants to merge 1 commit into
Farama-Foundation:mainfrom
teddytennant:bump-black-death-v4

Conversation

@teddytennant

Copy link
Copy Markdown
Contributor

Follow-on to #265, as requested — bumps the wrapper version for the behavior change that PR made.

Why

#265 changed black_death's done semantics: the episode is now reported as done when every agent is terminated or truncated, where before it required both, so an episode that ended purely by truncation never reported done. That's a behavior change to a versioned wrapper, so it gets a new version.

What

black_death_v3black_death_v4, updated at the definition, both __init__.py re-exports, and the four test modules that use it.

No new deprecation plumbing is needed — supersuit.__getattr__ derives it from the version suffix automatically:

>>> import supersuit
>>> supersuit.black_death_v3
DeprecatedWrapper: black_death_v3 is now deprecated, use black_death_v4 instead

Testing

pytest test/ → 115 passed, 46 skipped. The 2 collection errors are pre-existing missing optional deps locally (multi_agent_ale_py, stable_baselines3) and error identically on main.

The wrapper's behavior changed in Farama-Foundation#265: it now reports the episode as done
when every agent is terminated OR truncated, where before it required both,
so an episode that ended purely by truncation never reported done.

Per the SuperSuit convention that a behavior change gets a new version, this
renames the wrapper to black_death_v4. supersuit.__getattr__ picks the bump up
automatically:

    >>> supersuit.black_death_v3
    DeprecatedWrapper: black_death_v3 is now deprecated, use black_death_v4 instead

Follow-on to Farama-Foundation#265, as requested.
Copilot AI review requested due to automatic review settings July 13, 2026 12:23

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants