X-Git-Url: https://git.josue.xyz/?a=blobdiff_plain;f=pyenv%2FREADME.md;h=85a7eae29b0fbf8b33ac3eb0b1c3c3e43e256fd5;hb=ca7a838c6fde6052124947ff442aa9e6056f5e28;hp=31d86fe7ef26122b700185de9853baa3a6018196;hpb=bec1c7f807231f3a13f2b1ff88a00495956c1491;p=webi-installers%2F.git

diff --git a/pyenv/README.md b/pyenv/README.md
index 31d86fe..85a7eae 100644
--- a/pyenv/README.md
+++ b/pyenv/README.md
@@ -5,21 +5,87 @@ tagline: |
   pyenv: Simple Python Version Management
 ---
 
-### Updating `pyenv`
+To update run `pyenv update`.
+
+### How to Install pyenv on macOS
+
+Make sure that you already have Xcode tools installed:
+
+```bash
+xcode-select --install
+```
+
+### How to Install pyenv on Linux
+
+Make sure that you already have the necessary build tools installed:
 
 ```bash
-pyenv update
+# required
+sudo apt update
+sudo apt install -y build-essential zlib1g-dev libssl-dev
+
+# recommended
+sudo apt install -y libreadline-dev libbz2-dev libsqlite3-dev
 ```
 
 ## Cheat Sheet
 
-### List available python versions:
+> `pyenv` lets you install and switch between different versions of `python` as
+> the logged in user. It doesn't require admin permissions, and doesn't
+> interfere with your system version of python.
+
+Be sure to **follow the onscreen instructions** after the install (and the
+pre-requisites above).
+
+Here's how you can check for the latest version:
 
 ```bash
-pyenv install -l
+pyenv install --list | grep -v -- - | tail -n 1
+#>   3.9.1
 ```
 
-### Install Python versions:
+And install it:
+
+```bash
+pyenv install -v 3.9.1
+#> Installed Python-3.9.1 to ~/.pyenv/versions/3.9.1
+```
+
+And use it:
+
+```bash
+pyenv global 3.9.1
+python --version
+#> Python 3.9.1
+```
+
+Revert back to your system python:
+
+```bash
+pyenv global system
+```
+
+### List all available python version
+
+```bash
+pyenv install --list
+```
+
+```txt
+  3.9.1
+  activepython-3.6.0
+  anaconda3-2020.11
+  graalpython-20.3.0
+  ironpython-2.7.7
+  jython-2.7.2
+  micropython-1.13
+  miniforge3-4.9.2
+  pypy3.7-7.3.3
+  pyston-0.6.1
+  stackless-3.7.5
+```
+
+### Install Python versions
 
 ```bash
 pyenv install <version>
@@ -29,23 +95,29 @@ pyenv rehash
 ### pyenv versions
 
 List installed versions:
+
 ```bash
 pyenv versions
 ```
 
 ### pyenv local
 
-Sets a local application-specific Python version:
+Pin an application to a specific Python version:
+
 ```bash
 pyenv local 2.7.6
 ```
 
 Unset the local version:
+
 ```bash
 pyenv local --unset
 ```
 
+(setting the version works per-folder)
+
 ### List existing virtualenvs
+
 ```bash
 pyenv virtualenvs
 ```
@@ -53,14 +125,18 @@ pyenv virtualenvs
 ### Create virtualenv
 
 From current version with name "venv35":
+
 ```bash
 pyenv virtualenv venv35
 ```
+
 From version 2.7.10 with name "venv27":
+
 ```bash
-pyenv virtualenv 2.7.10 
+pyenv virtualenv 2.7.10
 venv27
 ```
+
 ### Activate/deactivate
 
 ```bash
@@ -69,6 +145,7 @@ pyenv deactivate
 ```
 
 ### Delete existing virtualenv
+
 ```bash
 pyenv uninstall venv27
-``` 
\ No newline at end of file
+```