CS 131 Fall 2022: Project Starter

Hey there! This is a template repository that contains the necessary boilerplate for CS 131's quarter-long project: making an interpreter. The project specs are as follows:

1. Project 1 Spec
2. Project 2 Spec
3. Project 3 - coming soon!

There are three stages to the project; students are currently at the second. Thus, this folder contains the necessary bootstrapping code:

• intbase.py, the base class and enum definitions for the interpreter
• a sample readme.txt, which should illustrate any known bugs/issues with the program (or, an "everything's good!")

As well as canonical solutions for Project 1 (written by Carey):

• interpreterv1.py: a top-level entrypoint: has some utility classes, finding the main function, the interpreter loop, and handlers for each token type
• env_v1.py: manages the "environment" / state for a program
• func_v1.py: manages and caches functions (will be much more useful in Project 2!)
• tokenize.py: tokenization logic

You do not have to use the canonical solutions for Project 2; in particular, since you didn't write the code, it may be confusing!

Some notes on your submission (for Project 2; we'll update this for later projects):

1. You must have a top-level, versioned interpreterv2.py file that exports the Interpreter class. If not, your code will not run on our autograder.
2. You may also submit one or more additional .py modules that your interpreter uses, if you decide to break up your solution into multiple .py files.

You can find out more about our autograder, including how to run it, in its accompanying repo.

Licensing and Attribution

This is an unlicensed repository; even though the source code is public, it is not governed by an open-source license.

This code was primarily written by Carey Nachenberg, with support from his TAs for the Fall 2022 iteration of CS 131.