sharedtest

package
v7.14.5 Latest Latest
Warning

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

 Go to latest Published: Jan 16, 2026 License: Apache-2.0 Imports: 18 Imported by: 0

Documentation

Overview

Package sharedtest contains types and functions used by SDK unit tests in multiple packages.

Since it is inside internal/, none of this code can be seen by application code and it can be freely changed without breaking any public APIs. Test helpers that we want to be available to application code should be in testhelpers/ instead.

It is important that no non-test code ever imports this package, so that it will not be compiled into applications as a transitive dependency.

Note that this package is not allowed to reference the "internal" package, because the tests in that package use sharedtest helpers so it would be a circular reference.

Index

Constants

View Source 
const (
	// HookStageBeforeEvaluation is the stage executed before evaluation.
	HookStageBeforeEvaluation = HookStage("beforeEvaluation")
	// HookStageAfterEvaluation is the stage executed after evaluation.
	HookStageAfterEvaluation = HookStage("afterEvaluation")
	// HookStageAfterTrack is the stage executed after track.
	HookStageAfterTrack = HookStage("afterTrack")
)
View Source 
const TestSDKKey = "test-sdk-key"

TestSDKKey is a test SDK key that can be used in test code.

Variables

This section is empty.

Functions

func BasicClientContext added in v7.9.0 

func BasicClientContext() subsystems.ClientContext

BasicClientContext returns a basic implementation of interfaces.ClientContext for use in test code.

func DataSetToMap 

func DataSetToMap(
	allData []ldstoretypes.Collection,
) map[ldstoretypes.DataKind]map[string]ldstoretypes.ItemDescriptor

DataSetToMap converts the data format for Init into a map of maps.

func ExpectFlagChangeEvents 

func ExpectFlagChangeEvents(t *testing.T, ch <-chan interfaces.FlagChangeEvent, keys ...string)

ExpectFlagChangeEvents asserts that a channel receives flag change events for the specified keys (in any order) and then does not receive any more events for the next 100ms.

func FlagDescriptor 

func FlagDescriptor(f ldmodel.FeatureFlag) ldstoretypes.ItemDescriptor

FlagDescriptor is a shortcut for creating a StoreItemDescriptor from a flag.

func NewSimpleTestContext 

func NewSimpleTestContext(sdkKey string) subsystems.ClientContext

NewSimpleTestContext returns a basic implementation of interfaces.ClientContext for use in test code.

func NewTestContext 

func NewTestContext(
	sdkKey string,
	optHTTPConfig *subsystems.HTTPConfiguration,
	optLoggingConfig *subsystems.LoggingConfiguration,
) subsystems.BasicClientContext

NewTestContext returns a basic implementation of interfaces.ClientContext for use in test code. We can't use internal.NewClientContextImpl for this because of circular references.

func NewTestLoggers 

func NewTestLoggers() ldlog.Loggers

NewTestLoggers returns a standardized logger instance used by unit tests. If you want to temporarily enable log output for tests, change testLogLevel to for instance ldlog.Debug. Note that "go test" normally suppresses output anyway unless a test fails.

func NormalizeDataSet 

func NormalizeDataSet(in []ldstoretypes.Collection) []ldstoretypes.Collection

NormalizeDataSet sorts the data set by kind and key for test determinacy.

func SegmentDescriptor 

func SegmentDescriptor(s ldmodel.Segment) ldstoretypes.ItemDescriptor

SegmentDescriptor is a shortcut for creating a StoreItemDescriptor from a segment.

func TestLoggingConfig 

func TestLoggingConfig() subsystems.LoggingConfiguration

TestLoggingConfig returns a LoggingConfiguration corresponding to NewTestLoggers().

Types

type DataSetBuilder 

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

DataSetBuilder is a helper for creating collections of flags and segments.

func NewDataSetBuilder 

func NewDataSetBuilder() *DataSetBuilder

NewDataSetBuilder creates a DataSetBuilder.

func (*DataSetBuilder) Build 

func (d *DataSetBuilder) Build() []ldstoretypes.Collection

Build returns the built data sest.

func (*DataSetBuilder) Flags 

func (d *DataSetBuilder) Flags(flags ...ldmodel.FeatureFlag) *DataSetBuilder

Flags adds flags to the data set.

func (*DataSetBuilder) Segments 

func (d *DataSetBuilder) Segments(segments ...ldmodel.Segment) *DataSetBuilder

Segments adds segments to the data set.

func (*DataSetBuilder) ToServerSDKData 

func (d *DataSetBuilder) ToServerSDKData() *ldservices.ServerSDKData

ToServerSDKData converts the data set to the format used by the ldservices helpers.

type HookEvalCapture added in v7.3.0 

type HookEvalCapture struct {
	GoContext               context.Context
	EvaluationSeriesContext ldhooks.EvaluationSeriesContext
	EvaluationSeriesData    ldhooks.EvaluationSeriesData
	EvaluationDetail        ldreason.EvaluationDetail
}

HookEvalCapture is used to capture the information provided to a hook during execution.

type HookExpectedCall added in v7.3.0 

type HookExpectedCall struct {
	HookStage    HookStage
	EvalCapture  HookEvalCapture
	TrackCapture HookTrackCapture
}

HookExpectedCall represents an expected call to a hook.

type HookStage added in v7.3.0 

type HookStage string

HookStage is the stage of a hook being executed.

type HookTrackCapture added in v7.12.0 

type HookTrackCapture struct {
	GoContext          context.Context
	TrackSeriesContext ldhooks.TrackSeriesContext
}

HookTrackCapture is used to capture the information provided to a hook during execution.

type TestHook added in v7.3.0 

type TestHook struct {
	ldhooks.Unimplemented

	BeforeEvaluationInject func(context.Context, ldhooks.EvaluationSeriesContext,
		ldhooks.EvaluationSeriesData) (ldhooks.EvaluationSeriesData, error)

	AfterEvaluationInject func(context.Context, ldhooks.EvaluationSeriesContext,
		ldhooks.EvaluationSeriesData, ldreason.EvaluationDetail) (ldhooks.EvaluationSeriesData, error)

	AfterTrackInject func(context.Context, ldhooks.TrackSeriesContext) error
	// contains filtered or unexported fields
}

TestHook is a hook for testing to be used only by the SDK tests.

func NewTestHook added in v7.3.0 

func NewTestHook(name string) TestHook

NewTestHook creates a new test hook.

func (TestHook) AfterEvaluation added in v7.3.0 

func (h TestHook) AfterEvaluation(
	ctx context.Context,
	seriesContext ldhooks.EvaluationSeriesContext,
	data ldhooks.EvaluationSeriesData,
	detail ldreason.EvaluationDetail,
) (ldhooks.EvaluationSeriesData, error)

AfterEvaluation testing implementation of the AfterEvaluation stage.

func (TestHook) AfterTrack added in v7.12.0 

func (h TestHook) AfterTrack(ctx context.Context, seriesContext ldhooks.TrackSeriesContext) error

AfterTrack testing implementation of the AfterTrack stage.

func (TestHook) BeforeEvaluation added in v7.3.0 

func (h TestHook) BeforeEvaluation(
	ctx context.Context,
	seriesContext ldhooks.EvaluationSeriesContext,
	data ldhooks.EvaluationSeriesData,
) (ldhooks.EvaluationSeriesData, error)

BeforeEvaluation testing implementation of the BeforeEvaluation stage.

func (TestHook) Metadata added in v7.3.0 

func (h TestHook) Metadata() ldhooks.Metadata

Metadata gets the meta-data for the hook.

func (TestHook) Verify added in v7.3.0 

func (h TestHook) Verify(t *testing.T, calls ...HookExpectedCall)

Verify is used to verify that the hook received calls it expected.

func (TestHook) VerifyNoCalls added in v7.3.0 

func (h TestHook) VerifyNoCalls(t *testing.T)

VerifyNoCalls will assert if the hook has received any calls.

type TestPlugin added in v7.11.0 

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

TestPlugin is a plugin for testing to be used only by the SDK tests.

func NewTestPlugin added in v7.11.0 

func NewTestPlugin(name string, hooks []ldhooks.Hook) TestPlugin

NewTestPlugin creates a new test plugin.

func (TestPlugin) ExpectGetHooksCalled added in v7.11.0 

func (p TestPlugin) ExpectGetHooksCalled(t *testing.T, expectedMetadata ldplugins.EnvironmentMetadata)

ExpectGetHooksCalled asserts that GetHooks was called with the given arguments.

func (TestPlugin) ExpectRegisterCalled added in v7.11.0 

func (p TestPlugin) ExpectRegisterCalled(
	t *testing.T,
	expectedClient interfaces.LDClientInterface,
	expectedMetadata ldplugins.EnvironmentMetadata,
)

ExpectRegisterCalled asserts that Register was called with the given arguments.

func (TestPlugin) GetHooks added in v7.11.0 

func (p TestPlugin) GetHooks(metadata ldplugins.EnvironmentMetadata) []ldhooks.Hook

GetHooks testing implementation of the GetHooks method.

func (TestPlugin) Metadata added in v7.11.0 

func (p TestPlugin) Metadata() ldplugins.Metadata

Metadata gets the meta-data for the plugin.

func (TestPlugin) Register added in v7.11.0 

func (p TestPlugin) Register(client interfaces.LDClientInterface, metadata ldplugins.EnvironmentMetadata)

Register testing implementation of the Register method.

type TestPluginHook added in v7.11.0 

type TestPluginHook struct {
	ldhooks.Unimplemented
	// contains filtered or unexported fields
}

TestPluginHook is a plugin hook for testing to be used only by the SDK tests.

This differs from TestHook in that we only care if the evaluation hook methods are called and not about testing evaluation hook logic itself.

func NewTestPluginHook added in v7.11.0 

func NewTestPluginHook(name string) TestPluginHook

NewTestPluginHook creates a new test plugin hook.

func (TestPluginHook) AfterEvaluation added in v7.11.0 

func (h TestPluginHook) AfterEvaluation(
	ctx context.Context,
	seriesContext ldhooks.EvaluationSeriesContext,
	data ldhooks.EvaluationSeriesData,
	detail ldreason.EvaluationDetail,
) (ldhooks.EvaluationSeriesData, error)

AfterEvaluation testing implementation of the AfterEvaluation stage.

func (TestPluginHook) BeforeEvaluation added in v7.11.0 

func (h TestPluginHook) BeforeEvaluation(
	ctx context.Context,
	seriesContext ldhooks.EvaluationSeriesContext,
	data ldhooks.EvaluationSeriesData,
) (ldhooks.EvaluationSeriesData, error)

BeforeEvaluation testing implementation of the BeforeEvaluation stage.

func (TestPluginHook) ExpectAfterEvaluationCalled added in v7.11.0 

func (h TestPluginHook) ExpectAfterEvaluationCalled(t *testing.T)

ExpectAfterEvaluationCalled asserts that AfterEvaluation was called.

func (TestPluginHook) ExpectBeforeEvaluationCalled added in v7.11.0 

func (h TestPluginHook) ExpectBeforeEvaluationCalled(t *testing.T)

ExpectBeforeEvaluationCalled asserts that BeforeEvaluation was called.

func (TestPluginHook) Metadata added in v7.11.0 

func (h TestPluginHook) Metadata() ldhooks.Metadata

Metadata gets the meta-data for the plugin hook.

Source Files

View all Source files

Directories

Path Synopsis
Package mocks contains mocks/spies used within SDK unit tests.
 Package mocks contains mocks/spies used within SDK unit tests.

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.