Skip to content
QangLang Docs

Qang Run

The qang run command executes QangLang scripts.

Usage

Section titled “Usage”
Terminal window
qang run <path> [options]

Arguments

Section titled “Arguments”
  • <path> - Path to the QangLang script file to execute (required)

Options

Section titled “Options”
  • --debug / -d - Enable debug output during script execution
  • --heap / -m - Dump compiled bytecode and heap contents before execution
  • --eformat / -e - Error message format (default: verbose)
    • minimal - Shows minimal error information
    • compact - Shows compact error messages
    • verbose - Shows detailed error messages with full context

Examples

Section titled “Examples”

Basic Script Execution

Section titled “Basic Script Execution”
Terminal window
qang run script.ql

Run with Debug Output

Section titled “Run with Debug Output”
Terminal window
qang run script.ql --debug

Show Bytecode and Heap

Section titled “Show Bytecode and Heap”

Useful for understanding how your code is compiled:

Terminal window
qang run script.ql --heap

Use Compact Error Messages

Section titled “Use Compact Error Messages”
Terminal window
qang run script.ql --eformat compact

Error Formats

Section titled “Error Formats”

Minimal

Section titled “Minimal”

Shows just the error message without additional context.

Compact

Section titled “Compact”

Shows the error message with basic location information.

Verbose (Default)

Section titled “Verbose (Default)”

Shows detailed error messages including:

  • Full source code context
  • Line and column numbers
  • Highlighted error location
  • Detailed error description