Interpreter for the Haverford Educational RISC Architecture (HERA) assembly language
A toolkit for the Haverford Educational RISC Architecture (HERA) assembly language, comprising an interpreter, a debugger, an assembler, and a disassembler.
You can install hera-py with pip:
$ pip3 install hera-py
After installation, use the
hera command to run a HERA program:
$ hera main.hera
Enter the interactive debugger with the
$ hera debug main.hera
Assemble a HERA program into machine code:
$ hera assemble main.hera
Disassemble machine code back into the human-readable HERA syntax:
$ hera disassemble main.hera.lcode
You can also preprocess a HERA program without running it, to see how pseudo-instructions and labels are resolved to HERA code:
$ hera preprocess main.hera
Comparison with HERA-C and Hassem
HERA-C is the current HERA interpreter used at Haverford. It is implemented as a shell-script wrapper around a set of C++ macros that expand HERA instructions into C++ code, which is then compiled by g++.
hera-py improves on HERA-C in the following areas:
- Includes a purpose-built HERA debugger
- Concise and accurate error messages
- Ease of use
- Cross-platform and easy to install
- Configurable with command-line options
- Does not create temporary files
- Command name has six fewer letters than
hera-py also supports several features that HERA-C does not:
- Setting registers to the value of a label
- Detecting stack overflow
- Multi-precision multiplication
- Relative branching by a fixed integer value (e.g.,
- Branching by the value of a register (e.g.,
SET(R1, 20); BR(R1))
- Detecting invalid relative branches
HERA-C has a few features that hera-py does not:
- C-style #define macros (and more generally the ability to embed arbitrary C++ code in HERA programs)
hera-py generally runs faster than HERA-C on small and medium-sized programs, while HERA-C is faster for very large programs.
Hassem is the current HERA assembler used at Haverford. hera-py has better error messages than Hassem, allows the user greater control of output (e.g., with the
--stdout flag), and fixes some Hassem bugs.
Thank you to Christopher Villalta for valuable feedback on early iterations of this project.
Release history Release notifications
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size hera_py-1.0.2-py3-none-any.whl (143.7 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size hera-py-1.0.2.tar.gz (84.5 kB)||File type Source||Python version None||Upload date||Hashes View hashes|