mix test.livebooks (ReqLLM v1.12.0)

View Source

Validates livebook files by extracting Elixir code blocks.

By default this task parses each livebook's Elixir code blocks together to verify they are syntactically valid and can be reviewed in ExDocs without obviously broken examples. Use --execute to run the combined script when a livebook is specifically written for non-interactive execution.

Usage

mix test.livebooks

Options

--verbose    Print detailed output for each livebook
--path       Specify custom path to search for livebooks (default: guides/)
--execute    Execute the combined script instead of syntax-checking it

Exit Codes

  • 0: All livebooks passed
  • 1: One or more livebooks failed

Limitations

Execution mode does not support:

  • Kino UI interactions (inputs, outputs, frames)
  • Livebook-specific features like branching or smart cells
  • Code blocks marked with ```elixir#test:skip will be skipped

Interactive livebooks should still be manually tested in Livebook.