https://github.com/eld/hackassembler

Assembler for the nand2tetris Hack platform
https://github.com/eld/hackassembler

Last synced: about 2 months ago
JSON representation

Assembler for the nand2tetris Hack platform

• Host: GitHub
• URL: https://github.com/eld/hackassembler
• Owner: ELD
• Created: 2015-02-06T17:54:04.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2015-05-01T00:25:17.000Z (over 9 years ago)
• Last Synced: 2024-10-15T11:45:56.397Z (3 months ago)
• Language: C++
• Homepage:
• Size: 1.27 MB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Hack Assembler from Nand2tetris

### README:

###### You may look at the code, but you should not use it. Don’t deprive yourself of the opportunity to write the assembler yourslf as part of the nand2tetris course.

This is the Hack Assembler from the nand2tetris. It was written in standard C++ with the tests leveraging the Boost

Unit Test Framework.

The Makefile has a few different targets. Simply typing `make -j[N]` where `-j[N]` is the number of threads

you want to build with (the more threads, the faster it compiles; the Makefile supports incremental builds)

builds the core project. The core project

only relies on a C++11 compliant compiler with the latest STL (support `std::regex`). Once the project has been

built, the executable will be placed in the `target/` directory with a name of `hackasm`. In order to run the

assembler simply type `./target/hackasm [filename]`. The assembler will accept any path anywhere in the

filesystem and will place the assembled `.hack` file in the same directory location. For example, if you

invoked the assembler as such: `./target/hackasm ../pong/Pong.asm` the resulting `Pong.hack` file would be

created in `../pong/Pong.hack`.

The other targets pertain to testing and experimental code. The assembler comes with a battery of unit tests

written with the helpt of the Boost Unit Test Framework. These, while not necessary to build, are built with

the `tester` target. When compiling the tests, an environment variable `$BOOST_LIBS` is required to be set

and point to the root directory where the Boost libraries are installed. The `experimental` target

doesn't require anything other than a standard C++11 compliant compiler.

The project was developed on a 15" Retina Macbook Pro running Mac OSX Yosemite and compiled with Clang 3.5.

The project has been test built an an Ubuntu 14.04 virtual machine running GCC 4.9 and no extra libraries

(the core project builds fine without the Boost libraries). Let me know if you have any unseen difficulties

building the project.