testcase-builder

Robot Framework Test Case Builder

Create test cases in Robot Framework syntax from structured input. Output JSON only.

Input (JSON)

Provide input via --input or stdin. Example:

{
  "style": "keyword-driven",
  "tests": [
    {
      "name": "User can create account",
      "documentation": "Happy path account creation.",
      "tags": ["smoke"],
      "setup": {"keyword": "Open Browser", "args": ["${URL}", "chromium"]},
      "teardown": {"keyword": "Close Browser"},
      "steps": [
        {"keyword": "Go To Sign Up"},
        {"keyword": "Create User", "args": ["${username}", "${role}"]},
        {"keyword": "User Should Be Logged In"}
      ]
    }
  ]
}

Template-driven test:

{
  "style": "template",
  "tests": [
    {
      "name": "Login works",
      "template": "Login Should Succeed",
      "data_rows": [
        ["alice", "pass"],
        ["bob", "pass"]
      ]
    }
  ]
}

Command

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/testcase_builder.py" --input tests.json

Flags

• --allow-control -- Suppress warnings when control structures (FOR, IF, WHILE, TRY, etc.) appear in test steps. Without this flag the builder emits a warning for each control keyword found, encouraging you to move control logic into user keywords.
• --input FILE -- Path to the JSON input file (alternative to stdin).
• --full-suite -- Wrap the output in a *** Test Cases *** section so the artifact is a directly saveable, runnable .robot file. Without it (the default) the artifact is a section fragment — the test case block(s) only, no header — meant to be embedded into an existing suite (e.g. one that already has *** Settings ***/*** Keywords ***).

Timeout support

Add "timeout" to a test object to render a [Timeout] setting:

{
  "name": "Slow Operation",
  "timeout": "30s",
  "steps": [{"keyword": "Long Running Task"}]
}

Output (JSON)

• artifact: test case block(s). A *** Test Cases *** section fragment by default; a full saveable suite when --full-suite is passed.
• full_suite: whether the artifact includes the section header.
• warnings and suggestions