runn

Apr 7, 2026

Changes in this version

+ type AgentRequest struct

+ ClearContext bool

+ Prompt string

+ type AgentResponse struct

+ Content string

+ type AgentRunnerConfig struct

+ Agent string

+ Interactive bool

+ Model string

+ Permissions []string

+ Provider string

+ System string

+ Tools []string

type Capturer

+ CaptureAgentRequest func(name string, req *AgentRequest)

+ CaptureAgentResponse func(name string, res *AgentResponse)

type Option

+ func AgentRunner(name string, cfg *AgentRunnerConfig) Option

type RunnerType

+ const RunnerTypeAgent

Feb 23, 2026

Changes in this version

type RunnerType

+ const RunnerTypeRunner

type StepResult

+ RunnerKey string

+ RunnerType RunnerType

Oct 20, 2025

Changes in this version

type StepResult

+ Index int

Oct 18, 2025

Changes in this version

+ type ErrUnrecoverable struct

+ func (e *ErrUnrecoverable) Error() string

+ func (e *ErrUnrecoverable) Unwrap() error

Oct 6, 2025

retracted

Changes in this version

+ func CDPTimeout(timeout string) cdpRunnerOption

May 9, 2025

retracted

Changes in this version

+ const AllowReadParent

+ const AllowReadRemote

+ const AllowRunExec

Dec 13, 2024

retracted

Changes in this version

+ func SetStdin(f *os.File) error

Nov 28, 2024

retracted

Changes in this version

type Option

+ func Secret(secrets ...string) Option

Sep 15, 2024

retracted

Changes in this version

+ var ErrFailFast = errors.New("fail fast")

Sep 1, 2024

retracted

Changes in this version

+ func SkipCircularReferenceCheck(skip bool) httpRunnerOption

Aug 22, 2024

retracted

Changes in this version

+ const DefaultTraceHeaderName

Aug 6, 2024

retracted

Changes in this version

type StepResult

+ IncludedRunResults []*RunResult

Jun 4, 2024

retracted

Changes in this version

+ func LoadEnvFile(path string) error

May 31, 2024

retracted

Changes in this version

type Loop

+ func (l *Loop) Clear()

May 20, 2024

retracted

Changes in this version

+ func EvalWithTrace(e string, store exprtrace.EvalEnv) (*exprtrace.EvalResult, error)

May 3, 2024

retracted

Changes in this version

+ func BufDir(dirs ...string) grpcRunnerOption

+ func BufModule(modules ...string) grpcRunnerOption

type Option

+ func GRPCBufDir(dirs ...string) Option

Apr 29, 2024

retracted

Changes in this version

type Option

+ func GRPCBufConfig(config string) Option

+ func GRPCBufLock(lock string) Option

+ func GRPCBufModule(modules ...string) Option

Apr 29, 2024

retracted

Changes in this version

+ func BufConfig(p string) grpcRunnerOption

+ func BufLock(p string) grpcRunnerOption

+ func BufModules(modules ...string) grpcRunnerOption

Apr 12, 2024

retracted

Changes in this version

+ func CDPFlag(flag string, tf any) cdpRunnerOption

type Option

+ func CDPRunner(name string, opts ...cdpRunnerOption) Option

Mar 8, 2024

retracted

Changes in this version

+ func OpenAPI3(l string) httpRunnerOption

+ func OpenAPI3FromData(d []byte) httpRunnerOption

Feb 28, 2024

retracted

Changes in this version

type Option

+ func Attach(enable bool) Option

Feb 20, 2024

retracted

Changes in this version

type Option

+ func WaitTimeout(d time.Duration) Option

Jan 21, 2024

retracted

Changes in this version

type Capturer

+ CaptureResultByStep func(trs Trails, result *RunResult)

Jan 11, 2024

retracted

Changes in this version

type Option

+ func HostRules(rules ...string) Option

Nov 11, 2023

retracted

Changes in this version

type Option

+ func DisableProfile(disable bool) Option

+ func RunLabel(labels ...string) Option

type RunResult

+ Elapsed time.Duration

+ Labels []string

type StepResult

+ Elapsed time.Duration

+ ID string

type Trail

+ LoopIndex *int

type TrailType

+ const TrailTypeLoop

Nov 1, 2023

retracted

Changes in this version

+ const ScopeAllowReadParent

+ const ScopeAllowReadRemote

+ const ScopeAllowRunExec

+ const ScopeDenyReadParent

+ const ScopeDenyReadRemote

+ const ScopeDenyRunExec

+ var ErrInvalidScope = errors.New("invalid scope")

+ var ErrNilBook = errors.New("runbook is nil")

type Option

+ func Scopes(scopes ...string) Option

Oct 26, 2023

retracted

Changes in this version

+ func DBTrace(trace bool) dbRunnerOption

+ func GRPCTrace(trace bool) grpcRunnerOption

+ func HTTPTrace(trace bool) httpRunnerOption

type Option

+ func DBRunnerWithOptions(name, dsn string, opts ...dbRunnerOption) Option

Oct 25, 2023

retracted

Changes in this version

+ func Trace(trace bool) httpRunnerOption

type Trail

+ StepIndex *int

Oct 19, 2023

retracted

Changes in this version

type Option

+ func HTTPOpenApi3s(locations []string) Option

Oct 8, 2023

retracted

Changes in this version

+ type Coverage struct

+ Specs []*SpecCoverage

type Option

+ func HTTPOpenApi3(l string) Option

+ type SpecCoverage struct

+ Coverages map[string]int

+ Key string

Sep 23, 2023

retracted

Changes in this version

+ const MediaTypeApplicationOctetStream

Aug 23, 2023

retracted

Changes in this version

type RunResult

+ func (rr *RunResult) OutFailure(out io.Writer) error

Aug 8, 2023

retracted

Changes in this version

+ func EvalAny(e any, store any) (any, error)

Aug 6, 2023

retracted

Changes in this version

type StepResult

+ IncludedRunResult *RunResult

Jul 27, 2023

retracted

Changes in this version

type Capturer

+ SetCurrentTrails func(trs Trails)

type Option

+ func RunID(id string) Option

type RunResult

+ ID string

+ type Trail struct

+ Desc string

+ FuncIndex int

+ RunbookID string

+ RunbookPath string

+ StepKey string

+ StepRunnerKey string

+ StepRunnerType RunnerType

+ Type TrailType

+ func (tr Trail) String() string

+ type TrailType string

+ const TrailTypeAfterFunc

+ const TrailTypeBeforeFunc

+ const TrailTypeRunbook

+ const TrailTypeStep

+ type Trails []Trail

Jul 23, 2023

retracted

Changes in this version

+ func UseCookie(use bool) httpRunnerOption

Jul 17, 2023

retracted

Changes in this version

+ func HTTPTimeout(timeout string) httpRunnerOption

Jun 8, 2023

retracted

Changes in this version

+ func ImportPaths(paths []string) grpcRunnerOption

+ func Protos(protos []string) grpcRunnerOption

type Option

+ func GRPCImportPaths(paths []string) Option

+ func GRPCProtos(protos []string) Option

Jun 7, 2023

retracted

Changes in this version

+ func HTTPSkipVerify(skip bool) httpRunnerOption

Apr 24, 2023

Changes in this version

+ func SprintMultilinef(lineformat, format string, a ...any) string

type Capturer

+ CaptureResult func(ids IDs, result *RunResult)

type RunResult

+ StepResults []*StepResult

+ type StepResult struct

+ Desc string

+ Err error

+ Key string

+ Skipped bool

Apr 3, 2023

Changes in this version

type Option

+ func Force(enable bool) Option

+ func GrpcRunnerWithOptions(name, target string, opts ...grpcRunnerOption) Option

Mar 11, 2023

Changes in this version

type Option

+ func RunConcurrent(enable bool, max int64) Option

Feb 27, 2023

Changes in this version

type Option

+ func LoadOnly() Option

Feb 13, 2023

Changes in this version

+ func IdentityKey(k []byte) sshRunnerOption

Feb 10, 2023

Changes in this version

+ func LocalForward(l string) sshRunnerOption

Feb 3, 2023

Changes in this version

+ func HTTPCACert(path string) httpRunnerOption

+ func HTTPCert(path string) httpRunnerOption

+ func HTTPKey(path string) httpRunnerOption

Jan 27, 2023

Changes in this version

+ func NewLoadtResult(rc int, w, d time.Duration, c int, r *or.Result) (*loadtResult, error)

Jan 6, 2023

Changes in this version

+ func CheckThreshold(threshold string, d time.Duration, r *or.Result) error

Dec 23, 2022

Changes in this version

+ func RemoveCacheDir() error

+ func SetCacheDir(dir string) error

Nov 30, 2022

Changes in this version

type Option

+ func Stderr(w io.Writer) Option

+ func Stdout(w io.Writer) Option

Nov 29, 2022

Changes in this version

+ func Host(h string) sshRunnerOption

+ func Hostname(h string) sshRunnerOption

+ func IdentityFile(p string) sshRunnerOption

+ func KeepSession(enable bool) sshRunnerOption

+ func Port(p int) sshRunnerOption

+ func SSHConfig(p string) sshRunnerOption

+ func User(u string) sshRunnerOption

type Option

+ func SSHRunnerWithOptions(name string, opts ...sshRunnerOption) Option

Nov 28, 2022

Changes in this version

type Capturer

+ CaptureSSHCommand func(command string)

+ CaptureSSHStderr func(stderr string)

+ CaptureSSHStdout func(stdout string)

type Option

+ func SSHRunner(name string, client *ssh.Client) Option

type RunnerType

+ const RunnerTypeSSH

Nov 25, 2022

Changes in this version

+ func Eval(e string, store interface{}) (interface{}, error)

+ func EvalCond(cond string, store interface{}) (bool, error)

+ func EvalCount(count string, store interface{}) (int, error)

+ func EvalExpand(in, store interface{}) (interface{}, error)

type Option

+ func AfterFuncIf(fn func(*RunResult) error, ifCond string) Option

type RunResult

+ Store map[string]interface{}

Nov 18, 2022

Changes in this version

+ const MediaTypeMultipartFormData

+ func MultipartBoundary(b string) httpRunnerOption

+ func ParseRunbook(in io.Reader) (*runbook, error)

type Capturer

+ CaptureFailure func(ids IDs, bookPath, desc string, err error)

type RunResult

+ Skipped bool

Nov 14, 2022

Changes in this version

+ type AfterFuncError struct

+ func (e AfterFuncError) Error() string

+ func (e AfterFuncError) Unwrap() error

+ type BeforeFuncError struct

+ func (e BeforeFuncError) Error() string

+ func (e BeforeFuncError) Unwrap() error

+ type RunResult struct

+ Desc string

+ Err error

+ Path string

Nov 8, 2022

Changes in this version

+ var CDPFnMap = map[string]CDPFn

+ type CDPAction struct

+ Args map[string]interface{}

+ Fn string

+ type CDPActions []CDPAction

+ type CDPArgType string

+ const CDPArgTypeArg

+ const CDPArgTypeRes

+ type CDPFn struct

+ Aliases []string

+ Args CDPFnArgs

+ Desc string

+ Fn interface{}

+ type CDPFnArg struct

+ Example string

+ Key string

+ Typ CDPArgType

+ type CDPFnArgs []CDPFnArg

+ func (args CDPFnArgs) ArgArgs() CDPFnArgs

+ func (args CDPFnArgs) ResArgs() CDPFnArgs

type Capturer

+ CaptureCDPAction func(a CDPAction)

+ CaptureCDPEnd func(name string)

+ CaptureCDPResponse func(a CDPAction, res map[string]interface{})

+ CaptureCDPStart func(name string)

type RunnerType

+ const RunnerTypeCDP

Nov 2, 2022

Changes in this version

type Option

+ func RunRandom(n int) Option

Oct 31, 2022

Changes in this version

+ func ShortenPath(p string) string

+ type ID struct

+ Desc string

+ FuncIndex int

+ RunbookID string

+ RunbookPath string

+ StepKey string

+ StepRunnerKey string

+ StepRunnerType RunnerType

+ Type IDType

+ func (id ID) String() string

+ type IDType string

+ const IDTypeAfterFunc

+ const IDTypeBeforeFunc

+ const IDTypeRunbook

+ const IDTypeStep

+ type IDs []ID

+ type RunnerType string

+ const RunnerTypeBind

+ const RunnerTypeDB

+ const RunnerTypeDump

+ const RunnerTypeExec

+ const RunnerTypeGRPC

+ const RunnerTypeHTTP

+ const RunnerTypeInclude

+ const RunnerTypeTest

Oct 27, 2022

Changes in this version

+ type Querier interface

+ type TxQuerier interface

+ BeginTx func(ctx context.Context, opts *nest.TxOptions) (*nest.Tx, error)

Oct 23, 2022

Changes in this version

+ func LoadRunbook(in io.Reader) (*runbook, error)

Oct 20, 2022

Changes in this version

+ func CreateHTTPStepMapSlice(key string, req *http.Request) (yaml.MapSlice, error)

+ func NewRunbook(desc string) *runbook

type Option

+ func GRPCNoTLS(noTLS bool) Option

Oct 16, 2022

Changes in this version

+ func NewCmdOut(out io.Writer) *cmdOut

type Capturer

+ CaptureFailed func(ids []string, bookPath, desc string, err error)

+ CaptureSkipped func(ids []string, bookPath, desc string)

+ CaptureSuccess func(ids []string, bookPath, desc string)

type Option

+ func RunParallel(enable bool, max int64) Option

+ func RunShuffle(enable bool, seed int64) Option

Oct 6, 2022

Changes in this version

+ func NotFollowRedirect(nf bool) httpRunnerOption

Sep 28, 2022

Changes in this version

type Option

+ func Overlay(path string) Option

+ func Underlay(path string) Option

Sep 19, 2022

Changes in this version

type Capturer

+ CaptureGRPCClientClose func()

+ type GRPCOp string

+ const GRPCOpClose

+ const GRPCOpMessage

+ const GRPCOpReceive

+ type GRPCType string

+ const GRPCBidiStreaming

+ const GRPCClientStreaming

+ const GRPCServerStreaming

+ const GRPCUnary

Sep 12, 2022

Changes in this version

type Capturer

+ CaptureEnd func(ids []string, bookPath string)

+ CaptureStart func(ids []string, bookPath string)

Sep 7, 2022

Changes in this version

+ func NewDebugger(out io.Writer) *debugger

+ type Capturer interface

+ CaptureDBResponse func(res *DBResponse)

+ CaptureDBStatement func(stmt string)

+ CaptureExecCommand func(command string)

+ CaptureExecStderr func(stderr string)

+ CaptureExecStdin func(stdin string)

+ CaptureExecStdout func(stdin string)

+ CaptureGRPCEnd func(service, method string)

+ CaptureGRPCRequestHeaders func(h map[string][]string)

+ CaptureGRPCRequestMessage func(m map[string]interface{})

+ CaptureGRPCResponseHeaders func(h map[string][]string)

+ CaptureGRPCResponseMessage func(m map[string]interface{})

+ CaptureGRPCResponseStatus func(status int)

+ CaptureGRPCResponseTrailers func(t map[string][]string)

+ CaptureGRPCStart func(service, method string)

+ CaptureHTTPRequest func(req *http.Request)

+ CaptureHTTPResponse func(res *http.Response)

+ Errs func() error

+ SetCurrentIDs func(ids []string)

+ type DBResponse struct

+ Columns []string

+ LastInsertID int64

+ Rows []map[string]interface{}

+ RowsAffected int64

type Option

+ func Capture(c Capturer) Option

Aug 20, 2022

Changes in this version

+ type Loop struct

+ Count string

+ Interval *float64

+ Jitter *float64

+ MaxInterval *float64

+ MinInterval *float64

+ Multiplier *float64

+ Until string

+ func (r *Loop) Loop(ctx context.Context) bool

Aug 18, 2022

Changes in this version

type Option

+ func Profile(profile bool) Option

Jul 15, 2022

Changes in this version

+ func CACert(path string) grpcRunnerOption

+ func CACertFromData(b []byte) grpcRunnerOption

+ func Cert(path string) grpcRunnerOption

+ func CertFromData(b []byte) grpcRunnerOption

+ func Key(path string) grpcRunnerOption

+ func KeyFromData(b []byte) grpcRunnerOption

+ func TLS(useTLS bool) grpcRunnerOption

Jul 9, 2022

Changes in this version

type Option

+ func GrpcRunner(name string, cc *grpc.ClientConn) Option

Jul 3, 2022

Changes in this version

type Option

+ func RunShard(n, i int) Option

Jun 20, 2022

Changes in this version

type Option

+ func RunMatch(m string) Option

+ func RunPart(i, n int) Option

+ func RunSample(n int) Option

Jun 3, 2022

Changes in this version

type Option

+ func AfterFunc(fn func() error) Option

+ func BeforeFunc(fn func() error) Option

+ func SkipTest(enable bool) Option

May 30, 2022

Changes in this version

type Option

+ func SkipIncluded(enable bool) Option

May 30, 2022

Changes in this version

type Option

+ func Func(k string, v interface{}) Option

May 24, 2022

Changes in this version

+ type UnsupportedError struct

+ Cause error

+ func (e *UnsupportedError) Error() string

+ func (e UnsupportedError) Unwrap() error

May 23, 2022

Changes in this version

+ type Retry struct

+ Count *int

+ Interval *float64

+ Jitter *float64

+ MaxInterval *float64

+ MinInterval *float64

+ Multiplier *float64

+ Until string

+ func (r *Retry) Retry(ctx context.Context) bool

Mar 28, 2022

Changes in this version

+ func NewHttpValidator(c *RunnerConfig) (httpValidator, error)

+ func NewNopValidator() *nopValidator

+ func NewOpenApi3Validator(c *RunnerConfig) (*openApi3Validator, error)

+ type RunnerConfig struct

+ Endpoint string

+ OpenApi3DocLocation string

+ SkipValidateRequest bool

+ SkipValidateResponse bool

+ type RunnerOption func(*RunnerConfig) error

+ func OpenApi3(l string) RunnerOption

+ func OpenApi3FromData(d []byte) RunnerOption

+ func SkipValidateRequest(skip bool) RunnerOption

+ func SkipValidateResponse(skip bool) RunnerOption

Mar 18, 2022

Changes in this version

+ const MediaTypeApplicationFormUrlencoded

+ const MediaTypeTextPlain

Mar 17, 2022

Changes in this version

type Option

+ func FailFast(enable bool) Option

Mar 16, 2022

Changes in this version

type Option

+ func Interval(d time.Duration) Option

Mar 11, 2022

Changes in this version

type Option

+ func HTTPRunnerWithHandler(name string, h http.Handler) Option

Mar 9, 2022

Changes in this version

+ func GetDesc(opt Option) string

+ func Paths(pathp string) ([]string, error)

type Option

+ func Books(pathp string) ([]Option, error)

+ func Var(k string, v interface{}) Option

Mar 8, 2022

Changes in this version

type Option

+ func Debug(debug bool) Option

Mar 8, 2022

Changes in this version

+ func Load(path string, opts ...Option) (operators, error)

Mar 8, 2022

Changes in this version

+ const MediaTypeApplicationJSON

+ var Runbook = Book

+ var T = AsTestHelper

+ func LoadBook(in io.Reader) (*book, error)

+ func LoadBookFile(path string) (*book, error)

+ func New(opts ...Option) (*operator, error)

+ type Option func(*book) error

+ func AsTestHelper(t *testing.T) Option

+ func Book(path string) Option

+ func DBRunner(name string, client *sql.DB) Option

+ func Desc(desc string) Option

+ func HTTPRunner(name, endpoint string, client *http.Client) Option

+ func Runner(name, dsn string) Option