test

package
v9.0.0 Latest Latest
Warning

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

Go to latest
Published: Apr 17, 2025 License: Apache-2.0 Imports: 12 Imported by: 0

Documentation

Overview

Test a query ruleset. Evaluate match criteria against a query ruleset to identify the rules that would match that criteria.

Index

Constants

This section is empty.

Variables

View Source
var ErrBuildPath = errors.New("cannot build path, check for missing path parameters")

ErrBuildPath is returned in case of missing parameters within the build of the request.

Functions

This section is empty.

Types

type NewTest

type NewTest func(rulesetid string) *Test

NewTest type alias for index.

func NewTestFunc

func NewTestFunc(tp elastictransport.Interface) NewTest

NewTestFunc returns a new instance of Test with the provided transport. Used in the index of the library this allows to retrieve every apis in once place.

type Request

type Request struct {

	// MatchCriteria The match criteria to apply to rules in the given query ruleset.
	// Match criteria should match the keys defined in the `criteria.metadata` field
	// of the rule.
	MatchCriteria map[string]json.RawMessage `json:"match_criteria"`
}

Request holds the request body struct for the package test

https://github.com/elastic/elasticsearch-specification/blob/52c473efb1fb5320a5bac12572d0b285882862fb/specification/query_rules/test/QueryRulesetTestRequest.ts#L24-L57

func NewRequest

func NewRequest() *Request

NewRequest returns a Request

func (*Request) FromJSON

func (r *Request) FromJSON(data string) (*Request, error)

FromJSON allows to load an arbitrary json into the request structure

type Response

type Response struct {
	MatchedRules      []types.QueryRulesetMatchedRule `json:"matched_rules"`
	TotalMatchedRules int                             `json:"total_matched_rules"`
}

Response holds the response body struct for the package test

https://github.com/elastic/elasticsearch-specification/blob/52c473efb1fb5320a5bac12572d0b285882862fb/specification/query_rules/test/QueryRulesetTestResponse.ts#L23-L28

func NewResponse

func NewResponse() *Response

NewResponse returns a Response

type Test

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

func New

Test a query ruleset. Evaluate match criteria against a query ruleset to identify the rules that would match that criteria.

https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-query-rules-test

func (*Test) AddMatchCriterion

func (r *Test) AddMatchCriterion(key string, value json.RawMessage) *Test

func (Test) Do

func (r Test) Do(providedCtx context.Context) (*Response, error)

Do runs the request through the transport, handle the response and returns a test.Response

func (*Test) ErrorTrace

func (r *Test) ErrorTrace(errortrace bool) *Test

ErrorTrace When set to `true` Elasticsearch will include the full stack trace of errors when they occur. API name: error_trace

func (*Test) FilterPath

func (r *Test) FilterPath(filterpaths ...string) *Test

FilterPath Comma-separated list of filters in dot notation which reduce the response returned by Elasticsearch. API name: filter_path

func (*Test) Header

func (r *Test) Header(key, value string) *Test

Header set a key, value pair in the Test headers map.

func (*Test) HttpRequest

func (r *Test) HttpRequest(ctx context.Context) (*http.Request, error)

HttpRequest returns the http.Request object built from the given parameters.

func (*Test) Human

func (r *Test) Human(human bool) *Test

Human When set to `true` will return statistics in a format suitable for humans. For example `"exists_time": "1h"` for humans and `"eixsts_time_in_millis": 3600000` for computers. When disabled the human readable values will be omitted. This makes sense for responses being consumed only by machines. API name: human

func (*Test) MatchCriteria

func (r *Test) MatchCriteria(matchcriteria map[string]json.RawMessage) *Test

The match criteria to apply to rules in the given query ruleset. Match criteria should match the keys defined in the `criteria.metadata` field of the rule. API name: match_criteria

func (Test) Perform

func (r Test) Perform(providedCtx context.Context) (*http.Response, error)

Perform runs the http.Request through the provided transport and returns an http.Response.

func (*Test) Pretty

func (r *Test) Pretty(pretty bool) *Test

Pretty If set to `true` the returned JSON will be "pretty-formatted". Only use this option for debugging only. API name: pretty

func (*Test) Raw

func (r *Test) Raw(raw io.Reader) *Test

Raw takes a json payload as input which is then passed to the http.Request If specified Raw takes precedence on Request method.

func (*Test) Request

func (r *Test) Request(req *Request) *Test

Request allows to set the request property with the appropriate payload.