Skip to content

Conversation

@August-murr
Copy link
Contributor

Adds a minimal trl.experimental namespace for fast iteration on unstable features plus pytest tooling so experimental tests never block unrelated PRs.

Key Changes

  • New package: trl/experimental/__init__.py with import warning (silence via TRL_EXPERIMENTAL_SILENCE=1).
  • Docs: docs/source/experimental.md + toctree entry; simplified promotion path & FAQ.
  • README: New "Experimental Namespace" section.
  • Testing infra: @pytest.mark.experimental + custom flag --run-experimental in tests/conftest.py (experimental tests skipped by default).
  • Smoke test: tests/test_experimental_namespace.py (marked experimental) ensures namespace imports.

Usage

Default (skip experimental):

pytest

Run all including experimental:

pytest --run-experimental

Only experimental tests:

pytest -m experimental --run-experimental

Silence import warning:

export TRL_EXPERIMENTAL_SILENCE=1

Copy link
Member

@qgallouedec qgallouedec left a comment

Choose a reason for hiding this comment

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

🧪🧪🧪

@qgallouedec qgallouedec changed the title Add trl.experimental Namespace and Opt-In Experimental Tests 🧪 Add trl.experimental Submodule Sep 12, 2025
@HuggingFaceDocBuilderDev

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

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.

3 participants