Skip to content

from isaacteleop.deviceio import FullBodyTracker fails on the published 1.3.131 wheel; docs give no minimum version #891

Description

@jiwenc-nv

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    Projects

    Status
    TBD

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions