Orcraft tutorial overview

This tutorial follows Orcraft's test development experience by hand. It begins by building suites with the Test Framework so you can understand Orcraft's principles, structure and approach, then runs and inspects those suites from the controller's GUI, drives them from the CLI, and wires them into a CI pipeline.

Once those foundations are clear, the same work can be handed to an AI agent. It writes suites in the same plain-Python structure introduced here, runs them on the machines you name and reads the logs, so you can inspect, run and extend what it wrote in exactly the same way.

It is based on the Orcraft Tutorial test suite. Before proceeding, complete the Getting started guide to install the controller and clone the tutorial suite as described there.

All code examples that appear in this tutorial also appear in the tutorial suite so you can follow along in the same project, run them locally, and inspect the resulting behavior.

After the tutorial, the Examples section holds complete suites for real test setups, a network performance suite and a hardware suite, each explained with a full run.

This tutorial covers the framework's most common usages. For complete framework documentation, see Framework.

To complete the tutorial and see Orcraft's full capabilities, register at least three endpoints beforehand - see Adding endpoints. Without them, several distributed and multi-endpoint features covered later in the tutorial will not be available to try out.