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:
uiowns terminal lifecycle, layout and widgets and never mutates application state.commandnames every action; nothing bypasses it.assemblerdrives the toolchain and parses what it says.debuggerspeaks GDB/MI and never touches the terminal.disassemblerdecodes machine code without needing a debugger.editoris pure text state with no rendering dependency.instructionholds static ISA knowledge shared by every panel.syscallembeds the Linux system call table taken from the kernel headers.processruns external tools without a shell and without zombies.loggingredirects 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.