Skip to content

[Doc] Use new canonical collector names across docs, tutorials, and SOTA#3665

Merged
vmoens merged 2 commits into
pytorch:mainfrom
vmoens:fix-collector-names
Apr 22, 2026
Merged

[Doc] Use new canonical collector names across docs, tutorials, and SOTA#3665
vmoens merged 2 commits into
pytorch:mainfrom
vmoens:fix-collector-names

Conversation

@vmoens
Copy link
Copy Markdown
Collaborator

@vmoens vmoens commented Apr 22, 2026

Summary

Replaces legacy collector class names with the new, shorter canonical names across user-facing code:

  • SyncDataCollectorCollector
  • MultiSyncDataCollectorMultiSyncCollector
  • MultiaSyncDataCollectorMultiAsyncCollector
  • aSyncDataCollectorAsyncCollector
  • _MultiDataCollectorMultiCollector
  • DataCollectorBaseBaseCollector
  • DistributedSyncDataCollectorDistributedSyncCollector

Applied to README, docs/, tutorials/, sota-implementations/, examples/, benchmarks/, a couple of test comments, and internal docstrings in torchrl/data/replay_buffers/samplers.py — 50 files total, symmetric 150/150 diff.

The legacy class definitions and re-exports in torchrl/collectors/** are preserved (backward-compatible deprecation shims), and the deprecation tables in docs/source/reference/collectors*.rst are kept intact so users can still see the old→new mapping.

Test plan

  • python -m compileall on changed .py files (all 50 compile locally)
  • Docs build (sphinx) — renames should resolve through the existing :class: cross-references since both old and new names are exported from torchrl.collectors
  • Tutorials/SOTA scripts still run end-to-end (no behavior change — pure rename)

…OTA implementations

Replaces legacy class names (SyncDataCollector, MultiSyncDataCollector,
MultiaSyncDataCollector, aSyncDataCollector, _MultiDataCollector,
DataCollectorBase, DistributedSyncDataCollector) with the new, shorter
canonical names (Collector, MultiSyncCollector, MultiAsyncCollector,
AsyncCollector, MultiCollector, BaseCollector, DistributedSyncCollector)
in README, docs, tutorials, sota-implementations, examples, benchmarks,
tests, and internal docstrings.

The legacy class definitions and re-exports in torchrl/collectors/** are
preserved for backward compatibility, along with the deprecation tables
in docs/source/reference/collectors*.rst.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@pytorch-bot
Copy link
Copy Markdown

pytorch-bot Bot commented Apr 22, 2026

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/rl/3665

Note: Links to docs will display an error until the docs builds have been completed.

❗ 1 Active SEVs

There are 1 currently active SEVs. If your PR is affected, please view them below:

❌ 1 New Failure, 1 Cancelled Job, 2 Pending

As of commit d402cc5 with merge base a8a47a0 (image):

NEW FAILURE - The following job has failed:

CANCELLED JOB - The following job was cancelled. Please retry:

This comment was automatically generated by Dr. CI and updates every 15 minutes.

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Apr 22, 2026
@vmoens vmoens merged commit 76633a5 into pytorch:main Apr 22, 2026
103 of 105 checks passed
@vmoens vmoens deleted the fix-collector-names branch April 22, 2026 20:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Benchmarks rl/benchmark changes CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. Collectors Documentation Improvements or additions to documentation Examples ReplayBuffers sota-implementations/ tutorials/

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant