How nxthingbutv0id/simpleassembler works
Simple Assembler is a Rust command-line assembler for BatPU-2 source. Its main workflow reads one or more assembly files, parses instructions, lays out and resolves the program, evaluates it, encodes instructions, and writes a binary file. The graph keeps the ISA model and operand types distinct from those processing stages. Relationships between the pipeline stages are explicit in src/lib.rs; some internal dependencies are based only on the SOURCE INDEX, so unsampled behavior is not expanded beyond those references.
Main entry points: instruction.rs Instruction model · lib.rs Assembler · tokens.rs Token parsers · encode.rs Instruction encoder
Components 20
Assembly pipeline
- Assembler
src/lib.rs - Program layout
src/layout.rs - Label resolution
src/resolve.rs - Program evaluation
src/eval.rs - Instruction encoder
src/encode.rs - Assembly printer
src/print.rs
Assembly syntax
- File parser
src/parser/mod.rs - Token parsers
src/parser/tokens.rs - Instruction parsers
src/parser/wrappers.rs
BatPU-2 model
- Instruction model
src/architecture/batpu2/instruction.rs - Opcode set
src/architecture/batpu2/opcode.rs
Operand types
- Conditions
src/architecture/batpu2/operand/condition.rs - Definitions
src/architecture/batpu2/operand/definition.rs - Immediate values
src/architecture/batpu2/operand/immediate.rs - Labels
src/architecture/batpu2/operand/label.rs - I/O ports
src/architecture/batpu2/operand/port.rs - Registers
src/architecture/batpu2/operand/register.rs
Other components
- Assembly author
- CLI
src/main.rs - Binary file
Connections 29
- Assembly author → CLI: runs assembler
readme.md - CLI → Assembler: invokes
- Assembler → File parser: parses files
src/lib.rs - File parser → Instruction parsers: dispatches parsers
src/parser/mod.rs - Instruction parsers → Instruction model: builds instructions
src/parser/wrappers.rs - Token parsers → Opcode set: parses opcodes
src/parser/tokens.rs - Token parsers → Conditions: parses conditions
src/parser/tokens.rs - Token parsers → Definitions: parses definitions
src/parser/tokens.rs - Token parsers → Immediate values: parses values
src/parser/tokens.rs - Token parsers → Labels: parses labels
src/parser/tokens.rs - Token parsers → I/O ports: parses ports
src/parser/tokens.rs - Token parsers → Registers: parses registers
src/parser/tokens.rs - Assembler → Program layout: lays out program
src/lib.rs - Assembler → Label resolution: resolves symbols
src/lib.rs - Assembler → Program evaluation: evaluates program
src/lib.rs - Assembler → Instruction encoder: encodes instructions
src/lib.rs - Assembler → Binary file: writes binary
src/lib.rs - Assembler → Assembly printer: prints assembly
src/lib.rs - Instruction encoder → Instruction model: encodes
src/encode.rs - Instruction encoder → Opcode set: encodes opcodes
src/encode.rs - Instruction encoder → Immediate values: encodes values
src/encode.rs - Instruction encoder → Labels: encodes addresses
src/encode.rs - Instruction model → Opcode set: stores opcode
src/architecture/batpu2/instruction.rs - Instruction model → Conditions: stores operands
src/architecture/batpu2/instruction.rs - Instruction model → Definitions: stores operands
src/architecture/batpu2/instruction.rs - Instruction model → Immediate values: stores operands
src/architecture/batpu2/instruction.rs - Instruction model → Labels: stores operands
src/architecture/batpu2/instruction.rs - Instruction model → I/O ports: stores operands
src/architecture/batpu2/instruction.rs - Instruction model → Registers: stores operands
src/architecture/batpu2/instruction.rs