btx

Documentation

Overview

Package btx implements the BTX (Braintrust Cross-language) test runner for the Go SDK. It validates SDK instrumentation against YAML spec files from braintrustdata/braintrust-spec.

Index

• type FnMatcher
• type LlmSpanSpec
• type OrMatcher
• type StartsWithMatcher

Types

type FnMatcher

type FnMatcher struct {
	Expr string
}

FnMatcher represents a !fn custom YAML tag.

type LlmSpanSpec

type LlmSpanSpec struct {
	Name                    string
	Type                    string
	Provider                string
	Endpoint                string
	Headers                 map[string]string
	Requests                []map[string]any
	ExpectedBrainstoreSpans []map[string]any
	SourcePath              string
	DisplayName             string // "provider/name"
}

LlmSpanSpec represents a parsed YAML spec file for an LLM span test.

type OrMatcher

type OrMatcher struct {
	Alternatives []any
}

OrMatcher represents a !or custom YAML tag.

type StartsWithMatcher

type StartsWithMatcher struct {
	Prefix string
}

StartsWithMatcher represents a !starts_with custom YAML tag.