Skip to content

Revise install handouts for 2021 course offering #2

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.

Sign up for GitHub

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

Merged
cooper-mj merged 5 commits into from
Mar 30, 2021
Merged

Revise install handouts for 2021 course offering #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
ea16c85
Remove virtualenvwrapper tutorial from MacOS setup instructions
cooper-mj Mar 28, 2021
f285a83
MacOS 3.9.2 install updates, updated terminal I/O to mirror 2021 setup
cooper-mj Mar 28, 2021
f577fa6
Minor tweaks - remove CS 41 link and command line consistency
cooper-mj Mar 28, 2021
e286be6
Update linux install instructions
cooper-mj Mar 29, 2021
5ffe9ef
Update Windows install instructions
cooper-mj Mar 29, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 7 additions & 21 deletions installing-python-linux.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,25 +10,17 @@ In this course, you'll be writing lots of Python code, so it's important to get

Throughout this document, we will:

1. Install Python 3.8.0
1. Install Python 3.9.2
2. Create a virtual environment using this version of Python.
3. Inside this environment, install useful packages.

This approach works well and is straightforward to set up, but has its drawbacks. For those who feel more comfortable with the command line, we also provide instructions for a better solution involving a tool named `virtualenvwrapper`. In this portion, we will

1. Reset our environment to the default state.
2. Use Python 3.8.0's `pip` to install `virtualenvwrapper`
3. Use `virtualenvwrapper` to create a managed virtual environment.
4. Inside this environment, install useful packages.
5. Modify the shell startup script to activate this virtual environment.

Let's get started!

## Prerequisite

We assume that you have a basic familiarity with the command line. We understand that not everyone will feel comfortable with the command line, because it is covered starting in CS107. However, I highly recommend using Nick Troccoli's amazing [CS107 resources](https://web.stanford.edu/class/archive/cs/cs107/cs107.1194/resources/) for this quarter if you feel less experienced, particular the section titled "Common Unix Commands."

## Install Python 3.8.0
## Install Python 3.9.2

On different Linux systems, there are a couple of different ways to install and manage packages. We'll cover `apt-get` here, as well as how you can install from source.

Expand All @@ -39,25 +31,25 @@ On different Linux systems, there are a couple of different ways to install and
```
$ sudo add-apt-repository ppa:deadsnakes/ppa
$ sudo apt-get update
$ sudo apt-get install python3.8
$ sudo apt-get install python3.8-venv
$ sudo apt-get install python3.9
$ sudo apt-get install python3.9-venv
```

On Debian, we'll just have to `sudo apt-get install python3` and hope for the best. Also note that this might install a different version of Python 3.8, but we won't worry about that here.
On Debian, we'll just have to `sudo apt-get install python3` and hope for the best. Also note that this might install a different version of Python 3.9, but we won't worry about that here.

### Installing with `yum` (RedHat, CentOS)

Other Linux distributions use a different package manager, `yum`. We don't have any test devices with these Linux distributions, so you're on your own here. There is a reasonably good tutorial for CentOS [here](https://www.digitalocean.com/community/tutorials/how-to-install-python-3-and-set-up-a-local-programming-environment-on-centos-7).

### Other Linux package managers

The world of Linux distributions is unfathomably large. If you can pull off a Python 3.8 install on your distribution of choice, more power to you. However, we recommend building from source.
The world of Linux distributions is unfathomably large. If you can pull off a Python 3.9 install on your distribution of choice, more power to you. However, we recommend building from source.

### Installing from source

Installing Python from source follows the same pattern as most other source installations.

First, download the source tarball (either [gzipped](https://www.python.org/ftp/python/3.8.0/Python-3.8.0.tgz) or [XZ compressed](https://www.python.org/ftp/python/3.8.0/Python-3.8.0.tar.xz)). Unzip the files and `cd` into the unzipped directory.
First, download the source tarball (either [gzipped](https://www.python.org/ftp/python/3.9.2/Python-3.9.2.tgz) or [XZ compressed](https://www.python.org/ftp/python/3.9.2/Python-3.9.2.tar.xz)). Unzip the files and `cd` into the unzipped directory.

To build Python, just execute the usual commands:

Expand All @@ -76,11 +68,5 @@ More information on the actual installation process can be found in the tarball'

From here, the instructions are almost exactly the same as the [macOS](https://github.com/stanfordpython/python-handouts/blob/master/installing-python-macos.md) instructions. Follow those instructions, with the following differences.

### Finding `virtualenvwrapper.sh`

If you choose to use `virtualenvwrapper`, it will be installed in a platform-specific location. You will need to find this file. You can use the `find` command described in the linked document to search your computer for the downloaded file.

If other unexpected differences come up between those instructions and your operating system, please let us know on Piazza so that we can update these instructions with distribution-specific dependencies.

## Credit
Much of this handout was based on a similar handout written by Sam Redmond (@samredmond)
Loading