Found during internal QA of the 1.4 release.
The tracker reference documents from isaacteleop.deviceio import FullBodyTracker with no version qualifier, but the wheel currently published on PyPI (isaacteleop 1.3.131) exports that tracker under its older name, FullBodyTrackerPico. Anyone following the published page against a pip-installed build gets an ImportError on that one line, while every other tracker import on the same page succeeds — which makes it look like a broken tracker rather than a version skew.
Repro — in a venv with the PyPI wheel:
$ pip install isaacteleop # resolves to 1.3.131
$ python -c "from isaacteleop.deviceio import HeadTracker, HandTracker, ControllerTracker, MessageChannelTracker, Generic3AxisPedalTracker"
$ python -c "from isaacteleop.deviceio import FullBodyTracker"
ImportError: cannot import name 'FullBodyTracker' from 'isaacteleop.deviceio'
The first import line exits cleanly; only FullBodyTracker fails.
Cause
1.3.131 exports FullBodyTrackerPico. The rename to FullBodyTracker is in the 1.4 line, where _DEPRECATED_ALIASES = {"FullBodyTrackerPico": "FullBodyTracker"} keeps the old name working. So the documentation is ahead of the published package rather than wrong: docs/source/device/trackers.rst L200.
Suggested fix
Note the minimum version (1.4) beside FullBodyTracker on the trackers page, and mention FullBodyTrackerPico as the former name so people on 1.3.x can find it. Publishing the 1.4 wheel resolves the immediate ImportError for new users, but the version note is worth having independently — it is the only entry on that page whose availability differs from its neighbours.
Found during internal QA of the 1.4 release.
The tracker reference documents
from isaacteleop.deviceio import FullBodyTrackerwith no version qualifier, but the wheel currently published on PyPI (isaacteleop 1.3.131) exports that tracker under its older name,FullBodyTrackerPico. Anyone following the published page against apip-installed build gets anImportErroron that one line, while every other tracker import on the same page succeeds — which makes it look like a broken tracker rather than a version skew.Repro — in a venv with the PyPI wheel:
The first import line exits cleanly; only
FullBodyTrackerfails.Cause
1.3.131exportsFullBodyTrackerPico. The rename toFullBodyTrackeris in the 1.4 line, where_DEPRECATED_ALIASES = {"FullBodyTrackerPico": "FullBodyTracker"}keeps the old name working. So the documentation is ahead of the published package rather than wrong:docs/source/device/trackers.rstL200.Suggested fix
Note the minimum version (1.4) beside
FullBodyTrackeron the trackers page, and mentionFullBodyTrackerPicoas the former name so people on 1.3.x can find it. Publishing the 1.4 wheel resolves the immediateImportErrorfor new users, but the version note is worth having independently — it is the only entry on that page whose availability differs from its neighbours.