Getting started on a new python program can be a bit intimidating at first. Here are step-by-step instructions to editing, saving, and running a program.
Getting lab assigment directories and starting point files
to get the next lab assignment starting point files.
The first time you run update21
it will create subdirectories for
all lab assignments. Subsequent runs will copy over starting point files
for each weekly lab assignment. You will cd into the specific lab number
subdirectory and do all your work in that directory.
Here is example output from the very first run (note $
is the unix
course directory does not exist
Initial setup complete
type 'cd cs21' to see files
$ ls # ls list the contents of the current directory
$ cd cs21 # change into the cs21 subirectory
$ pwd # pwd prints the path of the current directory
Getting to the right directory
The first step is to open a terminal and get to the proper directory where you want to save the file. Start by opening a terminal window by clicking on the terminal icon
on the center toolbar. You will automatically be placed in your home directory. Typically you do not want to put files here, but rather you want to edit files in a cs21
sub-directory. Use the cd
command to get to proper directory. For example, for lab 01, you need to save files in the cs21/labs/01
$ cd # starting from your home directory
$ cd cs21/labs/01/
Use TAB-completion to help navigate the directories quickly.
If you get a No such file or directory error when you
type cd, try some of the following:
- double check your spelling
- check that you are in the directory you think you are
(using pwd and ls to see where you are and
cd to change directories)
- if you do not have a labs/01 subdirectory, run update21 to
- For code that is not part of the labs (like in-class examples) you will
use mkdir to create the directory that is missing.
Instructions for using mkdir will be posted on the in-class
If you get a Not a directory error when you type cd, you went one level too far. See a sample error and fix below:
Desktop/ Documents/ cs21/
$ cd cs21/labs/00/bio.txt
-bash: cd: cs21/labs/00/bio.txt: Not a directory
$ cd cs21/labs/00/
Edit the file
Once you are in the proper directory, use vim
to edit the file. The easiest way to call vim
is to specify the filename after the vim command.
$ vim acres_to_yards.py
If the file already exists, the above command will edit the file. If the file does not exists, the file will be created the first time you save your vim session. Press i
to start editing in vim
. When you would like to save, type <ESC>:w
. To go back to editing, type i
Remember the key elements of a basic program:
- A block comment in triple quotes describing in plain english what the program does at a high level, your name, and the date
- A function definition that will contain as a body your main program
- A call to the function defined above so that your program will actually do
something when run
A full sample program is shown below:
A sample python program
(Tia Newhall, 1/16/2017)
print("welcome to cs21")
Run your progam
I prefer to have one terminal window open for editing in vim
and one terminal for running my program in python. Click on the
on the center toolbar again to open a second terminal window. Use cd
as described above to navigate to the same directory as the file you are editing. Once in the proper directory, type python
followed by the name of your program.
$ python acres_to_yards.py
If there are errors or things you would like to change, go to your vim
window and make changes. Don't forget to save your changes before trying to run the program again using python.
Clean up and handin21
When you are done editing your python file, remember to quit vim
. Run handin21
from the linux prompt to submit your work to your instructor. You can run handin21
as often as you like, but the program will only keep the latest copy. handin21
will submit all files in the current lab directory (e.g. cs21/labs/01),and only these files, so be sure your files are in the right directory as outlined in this document.
$ vim acres_to_yards.py
$ handin21 # handin21 lists newly changed files
Submitting the following files: # since your last handin21 run:
You can also run handin21 with -v
to list recent submissions:
$ handin21 -v
Updates in the past week:
At the due date and time, we grab the most recent version of your lab solution that you submitted via handin21. We strongly encourge you to not
run handin21 after the due date just in case you forget to run handin21we can verify the date of your solution by the file modification date (but remember to run handin21).
Logging out and xlock
Always remember to log out when you are done working in the lab.
To log out, choose the
icon from the center toolbar to get the log out menu. PLEASE
logout (don't reboot or shutdown the machine).
If you are going to step out of the lab for a few minutes, it is a good
idea to run xlock your machine. You can do this by typing in xlock
at the shell prompt, or by choosing the icon on the center toolbar.
You should not xlock a machine for more than about 10 minutes so that
other students can use the machine; xlock is for a short break.