Skip to content

docs: install from the repository, not a nonexistent PyPI package - #2

Merged
joepetjr merged 1 commit into
mainfrom
fix/readme-install-command
Aug 7, 2026
Merged

joepetjr merged 1 commit into
mainfrom
fix/readme-install-command

Conversation

@joepetjr

@joepetjr joepetjr commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Summary

The README told readers to run pip install pycube-lut and pip install "pycube-lut[hald]". Neither can work — https://pypi.org/pypi/pycube-lut/json returns 404, so the package has never been published to that index. Replaced both with git+ forms, matching what the headlessmode site already publishes for this tool.

The hald extra is real (pyproject.toml:30, hald = ["pillow>=9.0"]), so the extras variant is preserved using PEP 508 direct-reference syntax rather than dropped. The prose reference in the Limitations section repeated the same bad command and is fixed too. The Development section's editable install from a clone is correct and untouched.

Test plan

  • curl -s -o /dev/null -w "%{http_code}" https://pypi.org/pypi/pycube-lut/json → 404 (the finding, re-verified before editing).
  • Both replacement commands run in throwaway venvs:
    • pip install "git+https://github.com/Back-Road-Creative/pycube-lut" → installed pycube-lut-0.1.0, numpy-2.5.1; import pycube_lut works.
    • pip install "pycube-lut[hald] @ git+https://github.com/Back-Road-Creative/pycube-lut" → additionally installed pillow-12.3.0; import pycube_lut, PIL works.
  • Grepped the whole README for pypi, badge, shields.io, pip install — no other occurrence implies a PyPI release.

pycube-lut is not published on PyPI (pypi.org/pypi/pycube-lut/json returns 404), so
the README's pip install pycube-lut and pycube-lut[hald] extras commands cannot
work. Replace both with the git+https install form, matching what the
headlessmode site already publishes for this tool. Verified the hald extra
exists in pyproject.toml and both install forms succeed in throwaway venvs.
@joepetjr
joepetjr merged commit 88a6d76 into main Aug 7, 2026
5 checks passed
@joepetjr
joepetjr deleted the fix/readme-install-command branch August 7, 2026 15:06
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