Files
hack-assembler/README.md
lejulien 4afdcd1660 Cleanup the project
* Add .cache to gitignore (for the nlohmann::json library)
* Fix the project name
* Update the readme
2026-06-03 10:17:03 +02:00

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.