Added pyenv notes to virtual environments (#29135)
This commit is contained in:
		
				
					committed by
					
						
						Christopher McCormack
					
				
			
			
				
	
			
			
			
						parent
						
							c38173c976
						
					
				
				
					commit
					24f8f9ad11
				
			@@ -218,6 +218,81 @@ If you want to remove an environment from Conda use:
 | 
				
			|||||||
conda remove --name my-env
 | 
					conda remove --name my-env
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Pyenv
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					[`Pyenv`](https://github.com/pyenv/pyenv) is a package that lets you manage multiple versions of Python.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					To use Pyenv to manage our virtual environments we are going to install two additional extensions below:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					brew install pyenv
 | 
				
			||||||
 | 
					brew install pyenv-virtualenv
 | 
				
			||||||
 | 
					brew install pyenv-virtualenvwrapper
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Update .bashrc
 | 
				
			||||||
 | 
					Add this command to your .bashrc file to make sure your virtual environment is initialized everytime you start a new terminal session. 
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					For example using Vim I open up terminal and type:
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					vim ~/.bashrc
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					Then I add the below command to the file:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					eval "$(pyenv init -)"
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Install Python versions
 | 
				
			||||||
 | 
					It's usually good to have at least both a Python 2 and Python 3 environment
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					pyenv install 3.6.0
 | 
				
			||||||
 | 
					pyenv install 2.7.13
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Create an Environment
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					To create a virtual environment with Python 3 as the base with the name "my_cool_app":
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					pyenv virtualenv 3.6.0 my_cool_app
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					It's that easy. Another example using the Python 2.7.13 base that we created earlier:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					pyenv virtualenv 2.7.13 my_cool_app
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Activate an Environment
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Before you can start using the environment you need to activate it:
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					pyenv activate my_cool_app
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Install Packages
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					First activate your virtual environment and then use pip like normal
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					pyenv activate my_cool_app
 | 
				
			||||||
 | 
					pip install requests
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Deactivate an Environment
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					If you are done working with the virtual environment you can deactivate it with:
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					pyenv deactivate
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Remove an Environment
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					If you want to remove the Python 2.7.13:
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					pyenv uninstall 2.7.13
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
#### More Information:
 | 
					#### More Information:
 | 
				
			||||||
* `virtualenv` [official website](https://virtualenv.pypa.io/en/stable/)
 | 
					* `virtualenv` [official website](https://virtualenv.pypa.io/en/stable/)
 | 
				
			||||||
* `pipenv` [official website](https://pipenv.readthedocs.io/en/latest/)
 | 
					* `pipenv` [official website](https://pipenv.readthedocs.io/en/latest/)
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user