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

CLI Reference

Synopsis

qasmfmt [OPTIONS] [FILES...]

Options

OptionShortDescription
--checkCheck if files are formatted (exit 1 if not)
--diffShow diff instead of writing
--help-hPrint help
--version-VPrint version

Behavior

  • Default: Format files in-place
  • No files given: Read from stdin, write to stdout
  • With --check: Exit with 1 if files would be reformatted
  • With --diff: Show diff, do not modify files

Examples

# Format files in place
qasmfmt input.qasm
qasmfmt src/*.qasm

# Check if formatted (for CI)
qasmfmt --check input.qasm

# Show diff
qasmfmt --diff input.qasm

# Format from stdin
cat input.qasm | qasmfmt
echo "OPENQASM 3.0;qubit q;" | qasmfmt

# Format all QASM files recursively
find . -name "*.qasm" | xargs qasmfmt

Exit Codes

CodeMeaning
0Success
1Would reformat (with --check)
2Error (parse error, IO error)