* Add .cache to gitignore (for the nlohmann::json library) * Fix the project name * Update the readme
27 lines
772 B
Markdown
27 lines
772 B
Markdown
# hack-assembler
|
|
|
|
An implementation of a hack assembler in C++, based on the project 6 of the [nand2tetris course](https://www.nand2tetris.org/https://b1391bd6-da3d-477d-8c01-38cdf774495a.filesusr.com/ugd/44046b_89a8e226476741a3b7c5204575b8a0b2.pdf).
|
|
|
|
## Compilation
|
|
|
|
```bash
|
|
cmake -S . -B build
|
|
cmake --build build
|
|
```
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
cat <input_file.asm> | ./hack-assembler > ./out/<output_file.hack>
|
|
```
|
|
|
|
## Testing
|
|
|
|
In order to check the assembler, you can generate the .hack files from the asm-samples directory. And test those within [nand2tetris CPU emulator](https://nand2tetris.github.io/web-ide/cpu/).
|
|
|
|
## References
|
|
- [nand2tetris course](https://www.nand2tetris.org/)
|
|
|
|
## License
|
|
This project is under the WTFPL License. See [LICENSE](LICENSE) for details.
|