SAPsim 1.0.1

Simulation of SAP (Simple As Possible) computer programs from COMP311 (Computer Organization) @ UNC

SAPsim

Simulation of SAP (Simple As Possible) computer programs from COMP311 (Computer Organization) @ UNC

Install

Your Python version needs to be 3.9+. Check with python --version or python3 --version, if python doesn't work.

Next, install SAPsim.

pip install SAPsim

If pip doesn't work, try pip3.

Usage

Write a SAP program in the format shown in ex2.csv. See template.csv for a blank template. You may edit the .csv files in Microsoft Excel.

Now, open a Python terminal or file. You'll pass the path to your SAP program as an argument.

from SAPsim import run
run("path/to/your/SAP/program.csv")                 # run at full speed (default)
run("path/to/your/SAP/program.csv", debug=True)     # run in debug (step) mode

Additional settings are described here.

Rules

It's easiest to just mimic the example programs above.

But if you need it, the list of rules for SAP programs is here.

SAP instruction set

Documentation

https://SAPsim.readthedocs.io