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.311.2

Apr 13, 2026

v0.311.1

Apr 7, 2026

v0.311.0

Apr 2, 2026

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