nukopy-hack-assembler 0.0.3

Software for Nand2Tetris
Documentation
  • Coverage
  • 0%
    0 out of 3 items documented0 out of 2 items with examples
  • Size
  • Source code size: 5.21 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 1.01 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Links
  • Homepage
  • nukopy/nand2tetris
    0 0 0
  • crates.io
  • Dependencies
    • —
  • Versions
  • Owners
  • nukopy

nand2tetris

Table of Contents

  • Part I: Hardware
    • Project 01: Boolean Logic ブール論理
    • Project 02: Boolean Arithmetic ブール算術
    • Project 03: Memory メモリ
    • Project 04: Machine Language 機械語
    • Project 05: Computer Architecture コンピュータアーキテクチャ
    • Project 06: Assembler アセンブラ
  • Part II: Software
    • Project 07: VM I: Stack Arithmetic 仮想マシン I: スタック操作
    • Project 08: VM II: Program Control 仮想マシン II: プログラム制御
    • Project 09: High-Level Language 高水準言語
    • Project 10: Compiler I: Syntax Analysis コンパイラ I: 構文解析
    • Project 11: Compiler II: Code Generation コンパイラ II: コード生成
    • Project 12: Operating System オペレーティングシステム（OS）

Environment

  • OS: macOS Sonoma 14.7
  • Chip: Apple M3 Max
  • Rust 1.85.1 (4eb161250 2025-03-15)
  • just 1.40.0
  • cargo-workspaces 0.4.0
  • gh version 2.67.0 (2025-02-11)

Commands

Part I: Hardware

  • Run handware simulator
sh ./tools/HardwareSimulator.sh
  • Run CPU emulator
sh ./tools/CPUEmulator.sh

Part II: Software

TBD

for Coursera

  • Create a submission for Coursera
sh ./scripts/create-coursera-submission-zip.sh <project_directory>

For example, to create a submission for Project 2, run:

sh ./scripts/create-coursera-submission-zip.sh ./projects/2
Found the following .hdl files:
 - ./projects/2/HalfAdder.hdl
 - ./projects/2/Identity.hdl
 - ./projects/2/ALU.hdl
 - ./projects/2/Xor16.hdl
 - ./projects/2/FullAdder.hdl
 - ./projects/2/Identity16.hdl
 - ./projects/2/Inc16.hdl
 - ./projects/2/Add16.hdl
  adding: HalfAdder.hdl (deflated 41%)
  adding: Identity.hdl (deflated 26%)
  adding: ALU.hdl (deflated 69%)
  adding: Xor16.hdl (deflated 67%)
  adding: FullAdder.hdl (deflated 39%)
  adding: Identity16.hdl (deflated 71%)
  adding: Inc16.hdl (deflated 67%)
  adding: Add16.hdl (deflated 65%)
Created ./submissions/project2.zip with HDL files.

for Cargo

Install tools

  • Install just
cargo install just
  • Install cargo-workspaces
cargo install cargo-workspaces

Testing

  • Run tests for all workspaces
cargo test --workspace
  • Run tests for a specific package (= member of the workspace)
cargo test -p hack-assembler

cargo-workspaces commands

ref: https://github.com/pksunkara/cargo-workspaces

  • Create a new workspace
cargo workspaces create <hoge>

# for short:
cargo ws create <hoge>
  • List workspaces: output the name of each workspace in this project
cargo ws list
# jack-compiler
# hack-assembler

cargo ws version [major|minor|patch]

# dry run
cargo ws publish --dry-run

for release

# tagging on local git repository
just version

# pushing the tag to remote repository & generate release notes
just release <tag>

# publish to crates.io
just publish

Links