Skip to main content

Crate ratasm

Crate ratasm 

Source
Expand description

ratasm is a terminal IDE and debugger for x86_64 assembly.

The crate is organised so that state, rendering, process management and the debugger protocol stay independent of one another:

  • ui owns terminal lifecycle, layout and widgets and never mutates application state.
  • command names every action; nothing bypasses it.
  • assembler drives the toolchain and parses what it says.
  • debugger speaks GDB/MI and never touches the terminal.
  • disassembler decodes machine code without needing a debugger.
  • editor is pure text state with no rendering dependency.
  • instruction holds static ISA knowledge shared by every panel.
  • syscall embeds the Linux system call table taken from the kernel headers.
  • process runs external tools without a shell and without zombies.
  • logging redirects diagnostics to a file so the TUI keeps stdout.

Every subsystem is usable without a terminal attached, which is what makes the parsers, the build pipeline and the debugger testable in isolation.

Modulesยง

app
Application state and the loop that drives it.
assembler
Assembling and linking: running the toolchain and interpreting its output.
command
Every action the application can perform.
config
User configuration: settings and key bindings.
debugger
Debugging: the GDB/MI transport, the session state machine and the models behind the register, memory and breakpoint panels.
disassembler
Decoding machine code back into instructions.
editor
The text editor: buffers, cursor movement, history and language support.
event
Turning terminal input into state changes.
instruction
Architectural knowledge: registers, flags, conditions and instruction semantics.
learning
Guided material: short lessons and questions with worked answers.
logging
File-based diagnostic logging.
process
Running external programs safely.
project
Project discovery, configuration and scaffolding.
scratchpad
Trying one instruction without making a project.
syscall
The Linux x86-64 system call database.
ui
Terminal user interface: lifecycle, layout, widgets and theming.