{
    "baseUrl": "http://localhost:8080",
    "flows": {
        "user-auth": {
            "steps": [
                {
                    "name": "register",
                    "request": {
                        "method": "POST",
                        "path": "/api/auth/v3/register",
                        "json": {
                            "email": "user+{{RUN_ID}}@example.com", // RUN ID injectable
                            "password": "secret"
                        }
                    },
                    "assert": {
                        "status": 201,
                        "all": [
                            { "jsonpath": "$.data.username", "exists": true }
                        ]
                    },
                    "exports": { "username": "$.data.username" } // Export variable for next requests
                },
                {
                    "name": "login", // auth headers/cookies are persisted automatically
                    "request": {
                        "method": "POST",
                        "path": "/api/auth/v3/login",
                        "json": {
                            "username": "{{bind:username}}", // Use a defined var
                            "password": "secret"
                        }
                    },
                    "assert": {
                        "status": 200,
                        "all": [
                            {
                                "jsonpath": "$.data.email",
                                "contains": "{{RUN_ID}}"
                            }
                        ]
                    }
                }
            ]
        }
    }
}

go install github.com/okira-e/veriflow@latest

veriflow init

veriflow run

veriflow run user-onboarding

{
    "projectName": "my-api-tests",
    "baseUrl": "http://localhost:3000",
    "beforeRun": ["echo 'Starting tests'"],
    "afterRun": ["echo 'Tests complete'"],
    "flows": [
        {
            "name": "user-onboarding",
            "steps": [...]
        }
    ]
}

{
    "user_id": "$.data.user.id",
    "token": "$.data.token"
}

{
    "user_id": "/response/data/user/id",
    "token": "/response/data/token"
}

veriflow init

# Anything can be non interactive with required flags
veriflow init --base-url "https://base.com" --non-interactive

# Run all flows
veriflow run

# Run specific flow(s)
veriflow run user-onboarding checkout

# Run a specific step
veriflow run user-onboarding/register

# Mixed targets. Specific flows with specific steps
veriflow run user-onboarding checkout/payment

# Run veriflow against a specific config
veriflow run --config veriflow-configs/seeding-flows.json

# Override base URL
veriflow run --base-url http://staging.example.com

# Skip specific tests
veriflow run --skip user-onboarding/register --skip checkout

# Continue on failures
veriflow run --keep-going

# CI mode
veriflow run --json-output --no-color --non-interactive

# Export entire flow as curl commands
veriflow export user-onboarding

# Export specific step
veriflow export user-onboarding/register

# Export multiple targets (outputs JSON array)
veriflow export user-onboarding checkout/payment

# Export to file
veriflow export user-onboarding --out requests.json

# Override base URL
veriflow export user-onboarding --base-url http://staging.example.com

# Explicit format (curl is default)
veriflow export --to curl user-onboarding

# Export step with file upload
veriflow export user-onboarding/upload-avatar
# Output: curl -X 'POST' 'https://api.example.com/users/avatar' -F 'avatar=@test-files/avatar.jpg'

veriflow tui

# Interactive
veriflow flow add

# With name
veriflow flow add user-onboarding

# Interactive
veriflow flow delete

# With name
veriflow flow delete user-onboarding

# Interactive
veriflow step add

# With name
veriflow step add register

# Fully specified (for scripts/CI)
veriflow step add register \
  --flow user-onboarding \
  --method POST \
  --path /auth/register \
  --json '{"email": "test@example.com"}' \
  --status 201 \
  --assert "exists $.data.id" \
  --assert "equals $.data.email test@example.com" \
  --assert "isNot $.data.status PENDING" \
  --assert "length $.data.roles 2" \
  --export "user_id $.data.id" \
  --non-interactive

# With file upload
veriflow step add upload-avatar \
  --flow user-onboarding \
  --method POST \
  --path /users/avatar \
  --file "avatar:test-files/avatar.jpg" \
  --status 200

# With custom headers
veriflow step add protected-endpoint \
  --flow user-onboarding \
  --method GET \
  --path /api/protected \
  --header "Authorization:Bearer token123" \
  --header "X-API-Key:secret" \
  --status 200

exists <path>
equals <path> <value>
isNot  <path> <value>
contains <path> <value>
length <path> <value>

<varname> <path>

# JSON API
veriflow step add get-user \
  --flow users \
  --method GET \
  --path /api/users/1 \
  --status 200 \
  --assert "exists $.data.id" \
  --assert "equals $.data.name John" \
  --assert "length $.data.tags 3" \
  --export "user_id $.data.id"

# XML API
veriflow step add get-user-xml \
  --flow users \
  --method GET \
  --path /api/users/1 \
  --status 200 \
  --assert "exists /user/id" \
  --assert "equals /user/name John" \
  --export "user_id /user/id"

# XML request
veriflow step add create-user \
  --flow users \
  --method POST \
  --path /api/users \
  --xml '<user><name>John</name></user>' \
  --status 201

{
    "email": "test-{{RUN_ID}}@example.com",
    "code": "{{RAND_DIGIT}}{{RAND_DIGIT}}{{RAND_DIGIT}}{{RAND_DIGIT}}"
}

{
    "name": "register",
    "exports": {
        "user_id": "$.data.id"
    }
}

{
    "name": "get-user",
    "request": {
        "path": "/users/{{bind:user_id}}"
    }
}

{
    "beforeRun": ["docker-compose up -d", "sleep 2"],
    "afterRun": ["docker-compose down"]
}

{
    "took": "1.23s",
    "success": true,
    "ran": 5,
    "ranHooks": true,
    "total": 5,
    "code": "",
    "message": ""
}