servicedef

Documentation

Overview

Package servicedef contains definitions for the REST protocol that test services must implement. See the top-level README.md for more details.

The package is used by the test harness, but can also be imported by any test service code that is Go-based.

Index

• Constants
• type BigSegmentStoreStatusResponse
• type CommandParams
• type ContextBuildMultiParams
• type ContextBuildParams
• type ContextBuildResponse
• type ContextBuildSingleParams
• type ContextConvertParams
• type CreateInstanceParams
• type CustomEventParams
• type EvaluateAllFlagsParams
• type EvaluateAllFlagsResponse
• type EvaluateFlagParams
• type EvaluateFlagResponse
• type IdentifyEventParams
• type SDKConfigBigSegmentsParams
• type SDKConfigEventParams
• type SDKConfigParams
• type SDKConfigPersistentDataStoreParams
• type SDKConfigStreamingParams
• type SDKConfigTagsParams
• type StatusRep
• type ValueType

Constants

const (
	CommandEvaluateFlag             = "evaluate"
	CommandEvaluateAllFlags         = "evaluateAll"
	CommandIdentifyEvent            = "identifyEvent"
	CommandCustomEvent              = "customEvent"
	CommandAliasEvent               = "aliasEvent"
	CommandFlushEvents              = "flushEvents"
	CommandGetBigSegmentStoreStatus = "getBigSegmentStoreStatus"
	CommandContextBuild             = "contextBuild"
	CommandContextConvert           = "contextConvert"
)

const (
	ValueTypeBool   = "bool"
	ValueTypeInt    = "int"
	ValueTypeDouble = "double"
	ValueTypeString = "string"
	ValueTypeAny    = "any"
)

const (
	CapabilityClientSide    = "client-side"
	CapabilityServerSide    = "server-side"
	CapabilityStronglyTyped = "strongly-typed"

	CapabilityAllFlagsWithReasons                = "all-flags-with-reasons"
	CapabilityAllFlagsClientSideOnly             = "all-flags-client-side-only"
	CapabilityAllFlagsDetailsOnlyForTrackedFlags = "all-flags-details-only-for-tracked-flags"

	CapabilityPersistentDataStore = "persistent-data-store"
	CapabilityBigSegments         = "big-segments"
	CapabilityTags                = "tags"
)

Types

type BigSegmentStoreStatusResponse

type BigSegmentStoreStatusResponse struct {
	Available bool `json:"available"`
	Stale     bool `json:"stale"`
}

type CommandParams

type CommandParams struct {
	Command        string                  `json:"command"`
	Evaluate       *EvaluateFlagParams     `json:"evaluate,omitempty"`
	EvaluateAll    *EvaluateAllFlagsParams `json:"evaluateAll,omitempty"`
	CustomEvent    *CustomEventParams      `json:"customEvent,omitempty"`
	IdentifyEvent  *IdentifyEventParams    `json:"identifyEvent,omitempty"`
	ContextBuild   *ContextBuildParams     `json:"contextBuild,omitempty"`
	ContextConvert *ContextConvertParams   `json:"contextConvert,omitempty"`
}

type ContextBuildMultiParams

type ContextBuildMultiParams struct {
	Kinds []ContextBuildSingleParams `json:"kinds,omitempty"`
}

type ContextBuildParams

type ContextBuildParams struct {
	Single *ContextBuildSingleParams `json:"single,omitempty"`
	Multi  *ContextBuildMultiParams  `json:"multi,omitempty"`
}

type ContextBuildResponse

type ContextBuildResponse struct {
	Output string `json:"output"`
	Error  string `json:"error"`
}

type ContextBuildSingleParams

type ContextBuildSingleParams struct {
	Kind      *string                  `json:"kind,omitempty"`
	Key       string                   `json:"key"`
	Name      *string                  `json:"name,omitempty"`
	Transient *bool                    `json:"transient,omitempty"`
	Secondary *string                  `json:"secondary,omitempty"`
	Private   []string                 `json:"private,omitempty"`
	Custom    map[string]ldvalue.Value `json:"custom,omitempty"`
}

type ContextConvertParams

type ContextConvertParams struct {
	Input string `json:"input"`
}

type CreateInstanceParams

type CreateInstanceParams struct {
	Configuration SDKConfigParams `json:"configuration"`
	Tag           string          `json:"tag"`
}

type CustomEventParams

type CustomEventParams struct {
	EventKey     string            `json:"eventKey"`
	Context      ldcontext.Context `json:"context"`
	Data         ldvalue.Value     `json:"data,omitempty"`
	OmitNullData bool              `json:"omitNullData"`
	MetricValue  *float64          `json:"metricValue,omitempty"`
}

type EvaluateAllFlagsParams

type EvaluateAllFlagsParams struct {
	Context                    ldcontext.Context `json:"context"`
	WithReasons                bool              `json:"withReasons"`
	ClientSideOnly             bool              `json:"clientSideOnly"`
	DetailsOnlyForTrackedFlags bool              `json:"detailsOnlyForTrackedFlags"`
}

type EvaluateAllFlagsResponse

type EvaluateAllFlagsResponse struct {
	State map[string]ldvalue.Value `json:"state"`
}

type EvaluateFlagParams

type EvaluateFlagParams struct {
	FlagKey      string            `json:"flagKey"`
	Context      ldcontext.Context `json:"context"`
	ValueType    ValueType         `json:"valueType"`
	DefaultValue ldvalue.Value     `json:"defaultValue"`
	Detail       bool              `json:"detail"`
}

type EvaluateFlagResponse

type EvaluateFlagResponse struct {
	Value          ldvalue.Value              `json:"value"`
	VariationIndex *int                       `json:"variationIndex,omitempty"`
	Reason         *ldreason.EvaluationReason `json:"reason,omitempty"`
}

type IdentifyEventParams

type IdentifyEventParams struct {
	Context ldcontext.Context `json:"context"`
}

type SDKConfigBigSegmentsParams

type SDKConfigBigSegmentsParams struct {
	CallbackURI          string                     `json:"callbackUri"`
	UserCacheSize        ldvalue.OptionalInt        `json:"userCacheSize,omitempty"`
	UserCacheTimeMS      ldtime.UnixMillisecondTime `json:"userCacheTimeMs,omitempty"`
	StatusPollIntervalMS ldtime.UnixMillisecondTime `json:"statusPollIntervalMs,omitempty"`
	StaleAfterMS         ldtime.UnixMillisecondTime `json:"staleAfterMs,omitempty"`
}

type SDKConfigEventParams

type SDKConfigEventParams struct {
	BaseURI                 string                     `json:"baseUri,omitempty"`
	Capacity                ldvalue.OptionalInt        `json:"capacity,omitempty"`
	EnableDiagnostics       bool                       `json:"enableDiagnostics"`
	AllAttributesPrivate    bool                       `json:"allAttributesPrivate,omitempty"`
	GlobalPrivateAttributes []string                   `json:"globalPrivateAttributes,omitempty"`
	FlushIntervalMS         ldtime.UnixMillisecondTime `json:"flushIntervalMs,omitempty"`
}

type SDKConfigParams

type SDKConfigParams struct {
	Credential          string                              `json:"credential"`
	StartWaitTimeMS     ldtime.UnixMillisecondTime          `json:"startWaitTimeMs,omitempty"`
	InitCanFail         bool                                `json:"initCanFail,omitempty"`
	Streaming           *SDKConfigStreamingParams           `json:"streaming,omitempty"`
	Events              *SDKConfigEventParams               `json:"events,omitempty"`
	PersistentDataStore *SDKConfigPersistentDataStoreParams `json:"persistentDataStore,omitempty"`
	BigSegments         *SDKConfigBigSegmentsParams         `json:"bigSegments,omitempty"`
	Tags                *SDKConfigTagsParams                `json:"tags,omitempty"`
}

type SDKConfigPersistentDataStoreParams

type SDKConfigPersistentDataStoreParams struct {
	CallbackURI string `json:"callbackURI"`
}

type SDKConfigStreamingParams

type SDKConfigStreamingParams struct {
	BaseURI             string                      `json:"baseUri,omitempty"`
	InitialRetryDelayMs *ldtime.UnixMillisecondTime `json:"initialRetryDelayMs,omitempty"`
}

type SDKConfigTagsParams

type SDKConfigTagsParams struct {
	ApplicationID      ldvalue.OptionalString `json:"applicationId,omitempty"`
	ApplicationVersion ldvalue.OptionalString `json:"applicationVersion,omitempty"`
}

type StatusRep

type StatusRep struct {
	harness.TestServiceInfo
	ClientVersion string `json:"clientVersion"`
}

type ValueType

type ValueType string