Skip to content

fix(deps): don't require coal on Windows, fix stale install docs#531

Open
petercorke wants to merge 2 commits into
mainfrom
fix/coal-windows-install-docs
Open

fix(deps): don't require coal on Windows, fix stale install docs#531
petercorke wants to merge 2 commits into
mainfrom
fix/coal-windows-install-docs

Conversation

@petercorke

Copy link
Copy Markdown
Owner

Summary

  • coal has no Windows wheels on PyPI and its sdist can't build there (needs cmeel-assimp>=6.0.5, unavailable for Windows) — this was hard-failing pip install .[dev] on every Windows CI job. Mark coal sys_platform != 'win32' in the collision/dev/all extras.
  • Collision tests already skip gracefully when coal is absent (skip_no_collision_checking marker + lazy _require_coal()), so no test changes needed.
  • Fixed README's install/extras section, which still described a bullet/pybullet-based collision extra that no longer exists in pyproject.toml (drifted when the backend moved to coal).
  • Added docs/source/install.rst (+ toctree entry) — the Sphinx docs had no install page at all.
  • Logged remaining known drift (intro.rst still narrates PyBullet as the collision backend) and the Windows/coal tradeoff analysis in tech-debt.md for later.

Test plan

  • CI: Windows Install package step succeeds (previously failed on coal/cmeel-assimp)
  • CI: Windows Test step runs and collision tests are skipped, not failed
  • Docs build picks up new install.rst page

🤖 Generated with Claude Code

petercorke and others added 2 commits July 3, 2026 16:40
coal has no Windows wheels on PyPI and its sdist can't build there
either (needs cmeel-assimp>=6.0.5, unavailable for Windows), so
pip install .[dev] hard-failed on every Windows CI job. Mark coal
sys_platform != 'win32' in the collision/dev/all extras; the test
suite already skips collision tests gracefully when coal is absent.

Also fixes README's install/extras section, which still described a
bullet/pybullet-based collision extra that no longer exists in
pyproject.toml, and adds docs/source/install.rst since the Sphinx
docs had no install page at all.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…r plan

Captures the release-please single-branch/single-package limitation, the
stacked-PRs-on-red-main failure mode from today's CI work, the no-approval
-gate fact about the pypi deployment environment, and the queued rtb-data
-> packages/rtb-data move.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
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.

1 participant