-
Notifications
You must be signed in to change notification settings - Fork 5
Open
Description
The first-time setup workflow as of initial public release is effectively:
make deps, which will error if Homebrew isn't found.- User must manually
make install-homebrewto install Homebrew, then runmake depsagain
- User must manually
make deps, viadeps-brewwill install deps from Homebrew including pyenvmake deps, viainstall-pythonviadeps-py, will install Python from pyenv, which will error ifpyenvisn't found- User must manually add
pyenvloading code to shell rcfile, then runmake depsagain
- User must manually add
make deps, viainstall-poetryviadeps-py, will install Poetry using pyenv-installed Python or system Python, whichever it detects first, and only ifpoetryisn't available as of the start of the current run ofmake.make deps, viapoetry-installviadeps-py, will install Python deps using Poetry, which will error ifpoetryisn't found- User must manually add
~/.local/bin, Poetry's default installation path, to their PATH in shell rcfile, then runmake depsagain.
- User must manually add
- Complete 🎉
There are some steps I skipped in here related to telling Poetry which Python to use (it generally just works) and sync'ing Peru (also generally just works).
These one-time setup steps ("user must manually…") are annoying. While some tasks tell the user that they need to read command output, too many users just… don't.
Possible solutions:
- Document most generic thing to pre-add to a user's shellrc file in
README.mdor at the end ofmake deps. - Create a task
make wreck-my-rcfileor maybe more nicelymake setup-rcfile-oncethat modifies the shellrc with what should be put there carefully manually. - No action: let the user suffer having ignored the nudge to read command output.
Bonythomasv
Metadata
Metadata
Assignees
Labels
No labels