Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Getting Started

This guide will help you get started with SnapCrab for faster Rust development workflows.

Installation

SnapCrab is currently in early development. To build from source:

git clone <repository-url>
cd snapcrab
cargo build --release

Usage

SnapCrab is designed to execute small Rust programs and unit tests without compilation overhead.

Running the Main Function

Execute the main function of a Rust source file:

snapcrab <file.rs>

Running a Specific Function

Execute a specific function by name (requires fully qualified name):

snapcrab --start-fn <function_name> <file.rs>

Requirements

  • A little-endian host machine (e.g., x86-64, AArch64). SnapCrab will not compile on big-endian hosts.
  • The interpreted code must target the same machine as the host (same endianness and pointer width). Cross-interpretation is not supported.

Limitations

Current limitations in the early development phase:

  • Limited subset of Rust syntax supported
  • Small binary programs only / no cargo support yet
  • Basic language constructs
  • Little-endian host only; no cross-target interpretation

Future expansion will include external dependencies and broader Rust feature support.