-
Notifications
You must be signed in to change notification settings - Fork 55
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[UX] Need "step 0: get Python and Hatch" on https://www.pyopensci.org/python-package-guide/tutorials/get-to-know-hatch.html #270
Comments
My recommendation is for not requiring a manual Python installation at all and rather use one of the Hatch installers or binaries. I mentioned that in the blog post for 1.8 https://hatch.pypa.io/latest/blog/2023/12/11/hatch-v180/ Installation docs: https://hatch.pypa.io/latest/install/ |
Ooh cool @ofek. I didn't realize that there were installers now. Thanks! |
TODO: go to this tutorial - https://www.pyopensci.org/python-package-guide/tutorials/get-to-know-hatch.html - the first step is "pipx install hatch" we should likely change this step to use the hatch installers which are detailed on this page let's also include a small "note" on that page that links to @ofek blog post on the hatch installers! to add a note you'd use this syntax in our theme
|
Friends - i believe we can close this issue ✅ updated the tutorial page to specify using the installers rather than pipx (which removed singificant issues we were having! NOTE:there is a nuance with the installers where somtimes they will beging to download updates when a user runs hatch --version. this was a bit confusing so we may want to add a note about this behavior given it makes the user think that hatch is not installed yet. i will open a new issue about that soon but will close this issue for the time being as completed! if anyone disagrees wtih this being completed please do feel free to reply here!! ✨ and we can reopen! |
People who aren't real familiar with what already comes with the OS, and what comes with core Python, may get stuck in step one of https://www.pyopensci.org/python-package-guide/tutorials/get-to-know-hatch.html when the recommended "pipx install hatch" command throws a "no such command
pipx
" error message.Those instructions should come with a leader reminding people that they need to have Python installed in the first place, and then that Hatch is not part of core Python and needs to be installed itself. As discussed face-to-face in the sprint, it may make sense to drop pipx entirely and just recommend "pip install hatch" for naive users.
(Related to #265)
The text was updated successfully, but these errors were encountered: