# 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.