request

package
v0.48.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 27, 2026 License: Apache-2.0 Imports: 46 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func AuthSecretValues added in v0.27.2 

func AuthSecretValues(auth *restfile.AuthSpec, res *vars.Resolver) []string

func CloneRequest 

func CloneRequest(req *restfile.Request) *restfile.Request

Execution normalizes and mutates requests, so every run starts with its own working copy.

func CommandAuthSecrets added in v0.27.2 

func CommandAuthSecrets(res authcmd.Result) []string

func InjectedAuthSecrets added in v0.27.2 

func InjectedAuthSecrets(
	auth *restfile.AuthSpec,
	before *restfile.Request,
	after *restfile.Request,
) []string

func RenderRequestText 

func RenderRequestText(req *restfile.Request) string

Types

type Engine 

type Engine struct {
	// contains filtered or unexported fields
}

func New 

func New(cfg engine.Config, rt *rtrun.Runtime) *Engine

func (*Engine) ApplyPatches added in v0.44.1 

func (e *Engine) ApplyPatches(
	ctx context.Context,
	doc *restfile.Document,
	req *restfile.Request,
	env, base string,
	vv map[string]string,
	extra map[string]rts.Value,
) error

ApplyPatches runs the request's @apply directives, mutating req in place.

func (*Engine) BuildCommandAuthConfig added in v0.27.2 

func (e *Engine) BuildCommandAuthConfig(
	doc *restfile.Document,
	auth *restfile.AuthSpec,
	res *vars.Resolver,
	timeout time.Duration,
) (authcmd.Config, error)

func (*Engine) BuildOAuthConfig added in v0.27.2 

func (e *Engine) BuildOAuthConfig(
	auth *restfile.AuthSpec,
	res *vars.Resolver,
) (oauth.Config, error)

func (*Engine) CollectVariables 

func (e *Engine) CollectVariables(
	doc *restfile.Document,
	req *restfile.Request,
	env string,
	extras ...map[string]string,
) map[string]string

func (*Engine) DisplayResolver added in v0.48.1 

func (e *Engine) DisplayResolver(
	ctx context.Context,
	doc *restfile.Document,
	req *restfile.Request,
	env, base string,
	extra map[string]rts.Value,
	extras ...map[string]string,
) *vars.Resolver

DisplayResolver uses normal variable precedence for UI text but leaves out known secret values so labels and previews do not expose them.

func (*Engine) EnsureCommandAuth added in v0.27.2 

func (e *Engine) EnsureCommandAuth(
	ctx context.Context,
	doc *restfile.Document,
	req *restfile.Request,
	res *vars.Resolver,
	env string,
	timeout time.Duration,
) (authcmd.Result, error)

func (*Engine) EnsureOAuth added in v0.27.2 

func (e *Engine) EnsureOAuth(
	ctx context.Context,
	req *restfile.Request,
	res *vars.Resolver,
	opts httpclient.Options,
	env string,
	timeout time.Duration,
) error

func (*Engine) EvalCondition 

func (e *Engine) EvalCondition(
	ctx context.Context,
	doc *restfile.Document,
	req *restfile.Request,
	env, base string,
	spec *restfile.ConditionSpec,
	vv map[string]string,
	extra map[string]rts.Value,
) (bool, string, error)

func (*Engine) EvalForEachItems 

func (e *Engine) EvalForEachItems(
	ctx context.Context,
	doc *restfile.Document,
	req *restfile.Request,
	env, base string,
	spec ForEachSpec,
	vv map[string]string,
	extra map[string]rts.Value,
) ([]rts.Value, error)

func (*Engine) EvalValue 

func (e *Engine) EvalValue(
	ctx context.Context,
	doc *restfile.Document,
	req *restfile.Request,
	env, base, expr, site string,
	pos rts.Pos,
	vv map[string]string,
	extra map[string]rts.Value,
) (rts.Value, error)

func (*Engine) Execute 

func (e *Engine) Execute(
	doc *restfile.Document,
	req *restfile.Request,
	env string,
) (engine.RequestResult, error)

func (*Engine) ExecuteWith 

func (e *Engine) ExecuteWith(
	doc *restfile.Document,
	req *restfile.Request,
	env string,
	opt ExecOptions,
) (engine.RequestResult, error)

func (*Engine) ExprEval added in v0.44.1 

func (e *Engine) ExprEval(
	ctx context.Context,
	doc *restfile.Document,
	req *restfile.Request,
	env, base string,
	vv map[string]string,
	extra map[string]rts.Value,
) vars.ExprEval

ExprEval returns a {{= expr }} evaluator bound to vv with default policy. Callers own the variable set (full for execution, secret-stripped for preview).

func (*Engine) ExprEvalWithOptions added in v0.44.1 

func (e *Engine) ExprEvalWithOptions(
	ctx context.Context,
	doc *restfile.Document,
	req *restfile.Request,
	env, base string,
	vv map[string]string,
	extra map[string]rts.Value,
	opt ExprEvalOptions,
) vars.ExprEval

ExprEvalWithOptions is ExprEval with an explicit evaluation policy.

func (*Engine) PosForLine 

func (e *Engine) PosForLine(doc *restfile.Document, req *restfile.Request, line int) rts.Pos

func (*Engine) PrepareCommandAuth added in v0.27.2 

func (e *Engine) PrepareCommandAuth(
	doc *restfile.Document,
	auth *restfile.AuthSpec,
	res *vars.Resolver,
	env string,
	timeout time.Duration,
) (authcmd.Prepared, error)

func (*Engine) PrepareExplainAuthPreview added in v0.27.2 

func (e *Engine) PrepareExplainAuthPreview(
	doc *restfile.Document,
	req *restfile.Request,
	res *vars.Resolver,
	env string,
) (ExplainAuthPreviewResult, error)

func (*Engine) ResolveInheritedAuth added in v0.27.2 

func (e *Engine) ResolveInheritedAuth(doc *restfile.Document, req *restfile.Request)

func (*Engine) ResolveOAuthConfig added in v0.27.2 

func (e *Engine) ResolveOAuthConfig(
	auth *restfile.AuthSpec,
	res *vars.Resolver,
	env string,
) (oauth.Config, error)

func (*Engine) RunPreRequest added in v0.44.1 

func (e *Engine) RunPreRequest(
	ctx context.Context,
	doc *restfile.Document,
	req *restfile.Request,
	env, base string,
	vv map[string]string,
	globals map[string]vars.GlobalMutation,
) (prerequest.Output, error)

RunPreRequest runs the request's @rts pre-request scripts.

func (*Engine) SeedLast added in v0.44.1 

func (e *Engine) SeedLast(resp *httpclient.Response, grpc *grpcclient.Response)

The UI can replace or finish a response outside ExecuteWith. SeedLast keeps RTS values such as resp and trace aligned with that UI state.

func (*Engine) SetConfig 

func (e *Engine) SetConfig(cfg engine.Config)

func (*Engine) ValueString 

func (e *Engine) ValueString(ctx context.Context, pos rts.Pos, v rts.Value) (string, error)

type ExecMode 

type ExecMode uint8
const (
	ExecModeSend ExecMode = iota
	ExecModePreview
)

type ExecOptions 

type ExecOptions struct {
	Extra      map[string]string
	Values     map[string]rts.Value
	Record     bool
	Ctx        context.Context
	Mode       ExecMode
	OnWarning  func(Warning)
	AttachSSE  func(*httpclient.StreamHandle, *restfile.Request)
	AttachWS   func(*httpclient.WebSocketHandle, *restfile.Request)
	AttachGRPC func(*stream.Session, *restfile.Request)
}

type ExplainAuthPreviewResult added in v0.27.2 

type ExplainAuthPreviewResult struct {
	Status       xplain.StageStatus
	Summary      string
	Notes        []string
	ExtraSecrets []string
}

type ExprEvalOptions added in v0.44.1 

type ExprEvalOptions struct {
	// OmitSecretGlobals drops secret global values from the runtime so preview
	// and status evaluation cannot expose them.
	OmitSecretGlobals bool
}

ExprEvalOptions tunes how a {{= expr }} evaluator treats the RTS runtime.

type ForEachSpec 

type ForEachSpec struct {
	Expr string
	Var  string
	Line int
}

type Warning added in v0.48.1 

type Warning string
const WarningSSHHostKeyVerificationDisabled Warning = "@ssh strict_hostkey=false (insecure)"

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.