Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

testhelpers

package

Go to main page

Versions in this module

v0

v0.310.0

Feb 25, 2026

Changes in this version

+ func FixtureEmptyRuleGroups() []*rules.Group

+ func FixtureHistogramSeries() []storage.Series

+ func FixtureMultipleSeries() []storage.Series

+ func FixtureRuleGroups() []*rules.Group

+ func FixtureSeries() []storage.Series

+ func FixtureSingleSeries(metricName string, value float64) []storage.Series

+ func NewEmptyExemplarQueryable() storage.ExemplarQueryable

+ func NewEmptyQueryable() storage.SampleAndChunkQueryable

+ func NewQueryableWithSeries(series []storage.Series) storage.SampleAndChunkQueryable

+ func NewTSDBNotReadyQueryable() storage.SampleAndChunkQueryable

+ type APIConfig struct

+ AlertmanagerRetriever *LazyLoader[AlertmanagerRetriever]

+ Config func() config.Config

+ DBDir string

+ ExemplarQueryable *LazyLoader[storage.ExemplarQueryable]

+ FlagsMap map[string]string

+ Now func() time.Time

+ QueryEngine *LazyLoader[promql.QueryEngine]

+ Queryable *LazyLoader[storage.SampleAndChunkQueryable]

+ RulesRetriever *LazyLoader[RulesRetriever]

+ ScrapePoolsRetriever *LazyLoader[ScrapePoolsRetriever]

+ TSDBAdmin *LazyLoader[TSDBAdminStats]

+ TargetRetriever *LazyLoader[TargetRetriever]

+ type APIWrapper struct

+ Handler http.Handler

+ type AlertmanagerRetriever interface

+ Alertmanagers func() []*url.URL

+ DroppedAlertmanagers func() []*url.URL

+ type FakeAlertmanagerRetriever struct

+ func NewEmptyAlertmanagerRetriever() *FakeAlertmanagerRetriever

+ func (*FakeAlertmanagerRetriever) Alertmanagers() []*url.URL

+ func (*FakeAlertmanagerRetriever) DroppedAlertmanagers() []*url.URL

+ type FakeChunkQuerier struct

+ func (*FakeChunkQuerier) Close() error

+ func (f *FakeChunkQuerier) LabelNames(_ context.Context, _ *storage.LabelHints, _ ...*labels.Matcher) ([]string, annotations.Annotations, error)

+ func (f *FakeChunkQuerier) LabelValues(_ context.Context, name string, _ *storage.LabelHints, _ ...*labels.Matcher) ([]string, annotations.Annotations, error)

+ func (f *FakeChunkQuerier) Select(_ context.Context, _ bool, _ *storage.SelectHints, _ ...*labels.Matcher) storage.ChunkSeriesSet

+ type FakeChunkSeries struct

+ func (*FakeChunkSeries) Iterator(_ chunks.Iterator) chunks.Iterator

+ func (f *FakeChunkSeries) Labels() labels.Labels

+ type FakeChunkSeriesIterator struct

+ func (*FakeChunkSeriesIterator) At() chunks.Meta

+ func (*FakeChunkSeriesIterator) Err() error

+ func (*FakeChunkSeriesIterator) Next() bool

+ type FakeChunkSeriesSet struct

+ func (*FakeChunkSeriesSet) Err() error

+ func (*FakeChunkSeriesSet) Warnings() annotations.Annotations

+ func (f *FakeChunkSeriesSet) At() storage.ChunkSeries

+ func (f *FakeChunkSeriesSet) Next() bool

+ type FakeExemplarQuerier struct

+ func (*FakeExemplarQuerier) Select(_, _ int64, _ ...[]*labels.Matcher) ([]exemplar.QueryResult, error)

+ type FakeExemplarQueryable struct

+ func (*FakeExemplarQueryable) ExemplarQuerier(_ context.Context) (storage.ExemplarQuerier, error)

+ type FakeHistogramSeries struct

+ func (f *FakeHistogramSeries) Iterator(chunkenc.Iterator) chunkenc.Iterator

+ func (f *FakeHistogramSeries) Labels() labels.Labels

+ type FakeHistogramSeriesIterator struct

+ func (*FakeHistogramSeriesIterator) At() (int64, float64)

+ func (*FakeHistogramSeriesIterator) AtHistogram(*histogram.Histogram) (int64, *histogram.Histogram)

+ func (*FakeHistogramSeriesIterator) AtST() int64

+ func (*FakeHistogramSeriesIterator) Err() error

+ func (f *FakeHistogramSeriesIterator) AtFloatHistogram(*histogram.FloatHistogram) (int64, *histogram.FloatHistogram)

+ func (f *FakeHistogramSeriesIterator) AtT() int64

+ func (f *FakeHistogramSeriesIterator) Next() chunkenc.ValueType

+ func (f *FakeHistogramSeriesIterator) Seek(t int64) chunkenc.ValueType

+ type FakeQuerier struct

+ func (*FakeQuerier) Close() error

+ func (f *FakeQuerier) LabelNames(_ context.Context, _ *storage.LabelHints, _ ...*labels.Matcher) ([]string, annotations.Annotations, error)

+ func (f *FakeQuerier) LabelValues(_ context.Context, name string, _ *storage.LabelHints, _ ...*labels.Matcher) ([]string, annotations.Annotations, error)

+ func (f *FakeQuerier) Select(_ context.Context, _ bool, _ *storage.SelectHints, _ ...*labels.Matcher) storage.SeriesSet

+ type FakeQueryable struct

+ func (f *FakeQueryable) ChunkQuerier(_, _ int64) (storage.ChunkQuerier, error)

+ func (f *FakeQueryable) Querier(_, _ int64) (storage.Querier, error)

+ type FakeRulesRetriever struct

+ func NewEmptyRulesRetriever() *FakeRulesRetriever

+ func NewRulesRetrieverWithGroups(groups []*rules.Group) *FakeRulesRetriever

+ func (f *FakeRulesRetriever) AlertingRules() []*rules.AlertingRule

+ func (f *FakeRulesRetriever) RuleGroups() []*rules.Group

+ type FakeScrapePoolsRetriever struct

+ func NewEmptyScrapePoolsRetriever() *FakeScrapePoolsRetriever

+ func (f *FakeScrapePoolsRetriever) ScrapePools() []string

+ type FakeSeries struct

+ func (f *FakeSeries) Iterator(chunkenc.Iterator) chunkenc.Iterator

+ func (f *FakeSeries) Labels() labels.Labels

+ type FakeSeriesIterator struct

+ func (*FakeSeriesIterator) AtFloatHistogram(*histogram.FloatHistogram) (int64, *histogram.FloatHistogram)

+ func (*FakeSeriesIterator) AtHistogram(*histogram.Histogram) (int64, *histogram.Histogram)

+ func (*FakeSeriesIterator) AtST() int64

+ func (*FakeSeriesIterator) Err() error

+ func (f *FakeSeriesIterator) At() (int64, float64)

+ func (f *FakeSeriesIterator) AtT() int64

+ func (f *FakeSeriesIterator) Next() chunkenc.ValueType

+ func (f *FakeSeriesIterator) Seek(t int64) chunkenc.ValueType

+ type FakeSeriesSet struct

+ func (*FakeSeriesSet) Err() error

+ func (*FakeSeriesSet) Warnings() annotations.Annotations

+ func (f *FakeSeriesSet) At() storage.Series

+ func (f *FakeSeriesSet) Next() bool

+ type FakeTSDBAdminStats struct

+ func NewEmptyTSDBAdminStats() *FakeTSDBAdminStats

+ func (*FakeTSDBAdminStats) BlockMetas() ([]tsdb.BlockMeta, error)

+ func (*FakeTSDBAdminStats) CleanTombstones() error

+ func (*FakeTSDBAdminStats) Delete(_ context.Context, _, _ int64, _ ...*labels.Matcher) error

+ func (*FakeTSDBAdminStats) Snapshot(_ string, _ bool) error

+ func (*FakeTSDBAdminStats) Stats(_ string, _ int) (*tsdb.Stats, error)

+ func (*FakeTSDBAdminStats) WALReplayStatus() (tsdb.WALReplayStatus, error)

+ type FakeTargetRetriever struct

+ func NewEmptyTargetRetriever() *FakeTargetRetriever

+ func (f *FakeTargetRetriever) ScrapePoolConfig(name string) (*config.ScrapeConfig, error)

+ func (f *FakeTargetRetriever) TargetsActive() map[string][]*scrape.Target

+ func (f *FakeTargetRetriever) TargetsDropped() map[string][]*scrape.Target

+ func (f *FakeTargetRetriever) TargetsDroppedCounts() map[string]int

+ type LazyLoader struct

+ func NewLazyLoader[T any](loader func() T) *LazyLoader[T]

+ func (l *LazyLoader[T]) Get() T

+ type NewAPIParams struct

+ AlertmanagerRetriever func(context.Context) AlertmanagerRetriever

+ BuildInfo *PrometheusVersion

+ ConfigFunc func() config.Config

+ DBDir string

+ ExemplarQueryable storage.ExemplarQueryable

+ FlagsMap map[string]string

+ Gatherer prometheus.Gatherer

+ Logger *slog.Logger

+ NotificationsGetter func() []notifications.Notification

+ NotificationsSub func() (<-chan notifications.Notification, func(), bool)

+ QueryEngine promql.QueryEngine

+ Queryable storage.SampleAndChunkQueryable

+ ReadyFunc func(http.HandlerFunc) http.HandlerFunc

+ Registerer prometheus.Registerer

+ RulesRetriever func(context.Context) RulesRetriever

+ RuntimeInfoFunc func() (RuntimeInfo, error)

+ ScrapePoolsRetriever func(context.Context) ScrapePoolsRetriever

+ TSDBAdmin TSDBAdminStats

+ TargetRetriever func(context.Context) TargetRetriever

+ func PrepareAPI(t *testing.T, cfg APIConfig) NewAPIParams

+ type PrometheusVersion struct

+ Branch string

+ BuildDate string

+ BuildUser string

+ GoVersion string

+ Revision string

+ Version string

+ type Response struct

+ Body string

+ JSON map[string]any

+ StatusCode int

+ func GET(t *testing.T, api *APIWrapper, path string, queryParams ...string) *Response

+ func POST(t *testing.T, api *APIWrapper, path string, bodyParams ...string) *Response

+ func (r *Response) DebugJSON() *Response

+ func (r *Response) RequireArrayContains(path string, expected any) *Response

+ func (r *Response) RequireContainsSubstring(substring string) *Response

+ func (r *Response) RequireEquals(path string, expected any) *Response

+ func (r *Response) RequireError() *Response

+ func (r *Response) RequireField(path string) any

+ func (r *Response) RequireFieldType(path, expectedType string) *Response

+ func (r *Response) RequireJSONArray(path string) *Response

+ func (r *Response) RequireJSONPathExists(path string) *Response

+ func (r *Response) RequireJSONPathNotExists(path string) *Response

+ func (r *Response) RequireLenAtLeast(path string, minLen int) *Response

+ func (r *Response) RequireMatrixResult() *Response

+ func (r *Response) RequireRulesGroupNamed(name string) *Response

+ func (r *Response) RequireScalarResult() *Response

+ func (r *Response) RequireSome(path string, predicate func(any) bool) *Response

+ func (r *Response) RequireStatusCode(expectedCode int) *Response

+ func (r *Response) RequireSuccess() *Response

+ func (r *Response) RequireTargetCount(minCount int) *Response

+ func (r *Response) RequireVectorResult() *Response

+ func (r *Response) ValidateOpenAPI() *Response

+ type RulesRetriever interface

+ AlertingRules func() []*rules.AlertingRule

+ RuleGroups func() []*rules.Group

+ type RuntimeInfo struct

+ CWD string

+ CorruptionCount int64

+ GODEBUG string

+ GOGC string

+ GOMAXPROCS int

+ GOMEMLIMIT int64

+ GoroutineCount int

+ Hostname string

+ LastConfigTime time.Time

+ ReloadConfigSuccess bool

+ ServerTime time.Time

+ StartTime time.Time

+ StorageRetention string

+ type ScrapePoolsRetriever interface

+ ScrapePools func() []string

+ type TSDBAdminStats interface

+ BlockMetas func() ([]tsdb.BlockMeta, error)

+ CleanTombstones func() error

+ Delete func(ctx context.Context, mint, maxt int64, ms ...*labels.Matcher) error

+ Snapshot func(dir string, withHead bool) error

+ Stats func(statsByLabelName string, limit int) (*tsdb.Stats, error)

+ WALReplayStatus func() (tsdb.WALReplayStatus, error)

+ type TSDBNotReadyQueryable struct

+ func (*TSDBNotReadyQueryable) ChunkQuerier(_, _ int64) (storage.ChunkQuerier, error)

+ func (*TSDBNotReadyQueryable) Querier(_, _ int64) (storage.Querier, error)

+ type TargetRetriever interface

+ ScrapePoolConfig func(string) (*config.ScrapeConfig, error)

+ TargetsActive func() map[string][]*scrape.Target

+ TargetsDropped func() map[string][]*scrape.Target

+ TargetsDroppedCounts func() map[string]int

v0.310.0-rc.1

Feb 19, 2026

v0.310.0-rc.0

Feb 17, 2026