Skip to content
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

Add pipx installation instructions #38

Closed
OpenBagTwo opened this issue Oct 6, 2023 · 0 comments
Closed

Add pipx installation instructions #38

OpenBagTwo opened this issue Oct 6, 2023 · 0 comments
Labels
documentation Improvements or additions to documentation
Milestone

Comments

@OpenBagTwo
Copy link
Owner

GIVEN Steve wants to install gsb on his system

WHEN he goes to the installation instructions page

THEN the recommended instructions should be to install gsb via pipx

SO that he doesn't have to worry about managing virtual environments

Notes

Note that gsb requires Python 3.11 or newer, and a lot (most?) systems still ship with Python 3.10 or older. A quick audit of my Linux boxes has the system Python as:

  • Ubuntu 22.04: Python 3.10.12
  • elementary OS 7.1: Python 3.10.12 (makes sense--it's based on 22.04)
  • DietPi v8.21.1 / Debian GNU/Linux 12 (bookworm) (dietPi): 3.11.2
  • SteamOS 3.4.10: 3.10.8 😬
  • macOS 12.4: Python 3.8.9 🤣

(with my Arch machines waiting for a non-AUR 3.12 package)

So with that specified, the installation guide should be structured as a flowchart:

  1. Open a terminal.
  2. Run the command python3 -V
    • If you get 3.11 or later, install and use pipx
    • If you get 3.10 or older, use conda
    • If your terminal tells you that Python isn't installed on your system, install 3.11 or later using brew, conda or whatever
@OpenBagTwo OpenBagTwo added the documentation Improvements or additions to documentation label Oct 6, 2023
@OpenBagTwo OpenBagTwo added this to the v0.0.3 milestone Oct 6, 2023
OpenBagTwo added a commit that referenced this issue Oct 16, 2023
OpenBagTwo added a commit that referenced this issue Oct 19, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

1 participant