spanvalue

Jun 12, 2026

Changes in this version

+ var ErrEmptyFormatComplexPlugins = errors.New("empty format complex plugins")

+ var ErrUnhandledValue = errors.New("no plugin handled value")

type FormatComplexFunc

+ func LiteralValuePlugin(opts LiteralFormatOptions) FormatComplexFunc

+ func PluginForNullable[T NullableValue](f func(T) (string, error)) FormatComplexFunc

Jun 12, 2026

Changes in this version

+ var ErrArrayFormatRequired = errors.New("array format required")

+ var ErrScalarFormatterRequired = errors.New("scalar formatter required")

+ var ErrStructFormatRequired = errors.New("struct format required")

type FormatComplexFunc

+ func PluginForArray(join FormatArrayFunc) FormatComplexFunc

+ func PluginForStruct(...) FormatComplexFunc

+ func PluginForType(match func(*sppb.Type) bool, plugin FormatComplexFunc) FormatComplexFunc

+ func PluginForTypeCode(code sppb.TypeCode, plugin FormatComplexFunc) FormatComplexFunc

+ func PluginFromNullable(f FormatNullableFunc) FormatComplexFunc

+ func PluginSkippingNull(plugin FormatComplexFunc) FormatComplexFunc

type FormatConfig

+ func NewFormatConfig(opts ...FormatConfigOption) (*FormatConfig, error)

+ type FormatConfigOption func(*formatConfigBuilder)

+ func WithArrayFormat(join FormatArrayFunc) FormatConfigOption

+ func WithNullString(s string) FormatConfigOption

+ func WithPlugin(p FormatComplexFunc) FormatConfigOption

+ func WithScalarFormatter(f FormatNullableFunc) FormatConfigOption

+ func WithStructFormat(...) FormatConfigOption

type FormatNullableFunc

+ func NullableFormatterFor[T NullableValue](f func(T) (string, error)) FormatNullableFunc

Jun 11, 2026

Changes in this version

+ var ErrMalformedWire = errors.New("malformed wire value")

Jun 9, 2026

Changes in this version

type FormatConfig

+ func (fc *FormatConfig) WithComplexPlugin(plugin FormatComplexFunc) *FormatConfig

Jun 8, 2026

Changes in this version

+ var ErrEmptyNullString = errors.New("empty null string")

+ var ErrFormatNullableRequired = errors.New("format nullable required")

+ var ErrNilFormatArray = errors.New("nil format array callback")

+ var ErrNilFormatComplexPlugin = errors.New("nil format complex plugin")

+ var ErrNilFormatConfig = errors.New("nil format config")

+ var ErrNilFormatStructField = errors.New("nil format struct field callback")

+ var ErrNilFormatStructParen = errors.New("nil format struct paren callback")

type FormatConfig

+ func (fc *FormatConfig) Validate() error

Jun 4, 2026

Changes in this version

type FormatConfig

+ Literal LiteralFormatOptions

+ func LiteralFormatConfigWithOptions(opts ...LiteralOption) *FormatConfig

+ func LiteralFormatConfigWithQuote(cfg LiteralQuoteConfig) *FormatConfig

+ func LiteralFormatConfigWithSingleQuotedLiterals() *FormatConfig

+ type LiteralFormatOptions struct

+ Quote LiteralQuoteConfig

+ type LiteralOption interface

+ func WithLiteralQuote(cfg LiteralQuoteConfig) LiteralOption

+ type LiteralQuoteConfig struct

+ PreferredQuote PreferredQuote

+ Strategy QuoteStrategy

+ type PreferredQuote uint8

+ const PreferredDoubleQuote

+ const PreferredSingleQuote

+ func (p PreferredQuote) String() string

+ type QuoteStrategy uint8

+ const QuoteAlways

+ const QuoteLegacy

+ const QuoteMinEscape

+ func (s QuoteStrategy) String() string

May 30, 2026

Changes in this version

+ func FormatLiteralValue(formatter Formatter, value spanner.GenericColumnValue, _ bool) (string, error)

+ func FormatSimpleValue(formatter Formatter, value spanner.GenericColumnValue, _ bool) (string, error)

+ func FormatSpannerCLIValue(formatter Formatter, value spanner.GenericColumnValue, _ bool) (string, error)

type FormatConfig

+ func FormatConfigWithoutScalarPlugins(fc *FormatConfig) *FormatConfig

May 28, 2026

Changes in this version

type FormatStruct

+ func TypedStructFormat() FormatStruct

type FormatStructParenFunc

+ func JSONObjectStructFormat(namer UnnamedFieldNamer) FormatStructParenFunc

May 28, 2026

Changes in this version

type FormatConfig

+ func (fc *FormatConfig) Clone() *FormatConfig

Apr 28, 2026

Changes in this version

+ var ErrEmptyTypeFQN = errors.New("empty type FQN")

+ var ErrNilRow = errors.New("nil row")

+ var ErrNilStructField = errors.New("nil struct field descriptor")

+ var ErrUnexpectedComplexValueKind = errors.New("unexpected complex value kind")

+ func QuoteIdentifier(dialect databasepb.DatabaseDialect, name string) string

+ func QuoteQualifiedIdentifier(dialect databasepb.DatabaseDialect, name string) string

Apr 5, 2026

Changes in this version

+ var ErrMismatchedFields = errors.New("mismatched struct value/field count")

+ var ErrUnknownType = errors.New("unknown type")

Mar 28, 2026

Changes in this version

+ func ColumnNames(fields []*sppb.StructType_Field, namer UnnamedFieldNamer) []string

+ func FormatRowColumns(fc *FormatConfig, columnNames []string, values []spanner.GenericColumnValue) ([]string, error)

+ func FormatRowJSONObjectFromColumns(fc *FormatConfig, columnNames []string, values []spanner.GenericColumnValue, ...) (string, error)

+ func IsNull(gcv spanner.GenericColumnValue) bool

type FormatConfig

+ func (fc *FormatConfig) GetNullString() string

type Formatter

+ GetNullString func() string

Mar 27, 2026

Changes in this version

+ var FormatJSONObjectStruct = NewJSONObjectStructFormatter(nil)

+ func FormatCompactArray(_ *sppb.Type, _ bool, elemStrings []string) string

+ func FormatJSONSimpleValue(_ Formatter, value spanner.GenericColumnValue, _ bool) (string, error)

+ func FormatRowJSONObject(fc *FormatConfig, row *spanner.Row, namer UnnamedFieldNamer) (string, error)

+ func IndexedUnnamedFieldNamer(index int) string

type FormatConfig

+ func JSONFormatConfig() *FormatConfig

type FormatStructParenFunc

+ func NewJSONObjectStructFormatter(namer UnnamedFieldNamer) FormatStructParenFunc

+ type UnnamedFieldNamer func(index int) string

Jan 20, 2025

Changes in this version

+ var ErrFallthrough = errors.New("fallthrough")

Dec 18, 2024

Changes in this version

+ var FormatTypedStruct = FormatStruct

+ var LiteralFormatConfig = &FormatConfig

+ var SimpleFormatConfig = FormatConfig

+ var SpannerCLICompatibleFormatConfig = FormatConfig

+ func FormatBracketStruct(typ *spannerpb.Type, toplevel bool, fieldStrings []string) string

+ func FormatColumnLiteral(value spanner.GenericColumnValue) (string, error)

+ func FormatColumnSpannerCLICompatible(value spanner.GenericColumnValue) (string, error)

+ func FormatEnumAsCast(formatter Formatter, value spanner.GenericColumnValue, toplevel bool) (string, error)

+ func FormatNullableSpannerCLICompatible(value NullableValue) (string, error)

+ func FormatOptionallyTypedArray(typ *spannerpb.Type, toplevel bool, elemStrings []string) string

+ func FormatProtoAsCast(formatter Formatter, value spanner.GenericColumnValue, toplevel bool) (string, error)

+ func FormatRowLiteral(value *spanner.Row) ([]string, error)

+ func FormatRowSpannerCLICompatible(row *spanner.Row) ([]string, error)

+ func FormatSimpleStructField(fc *FormatConfig, field *spannerpb.StructType_Field, value *structpb.Value) (string, error)

+ func FormatTupleStruct(typ *spannerpb.Type, toplevel bool, fieldStrings []string) string

+ func FormatTypelessStructField(fc *FormatConfig, field *spannerpb.StructType_Field, value *structpb.Value) (string, error)

+ func FormatUntypedArray(typ *spannerpb.Type, toplevel bool, elemStrings []string) string

+ type FormatArrayFunc func(typ *spannerpb.Type, toplevel bool, elemStrings []string) string

+ type FormatComplexFunc = func(formatter Formatter, value spanner.GenericColumnValue, toplevel bool) (string, error)

+ type FormatConfig struct

+ FormatArray FormatArrayFunc

+ FormatComplexPlugins []FormatComplexFunc

+ FormatNullable FormatNullableFunc

+ FormatStruct FormatStruct

+ NullString string

+ func (fc *FormatConfig) FormatColumn(value spanner.GenericColumnValue, toplevel bool) (string, error)

+ func (fc *FormatConfig) FormatRow(row *spanner.Row) ([]string, error)

+ func (fc *FormatConfig) FormatToplevelColumn(value spanner.GenericColumnValue) (string, error)

+ type FormatNullableFunc = func(value NullableValue) (string, error)

+ type FormatStruct struct

+ FormatStructField FormatStructFieldFunc

+ FormatStructParen FormatStructParenFunc

+ type FormatStructFieldFunc func(fc *FormatConfig, field *spannerpb.StructType_Field, value *structpb.Value) (string, error)

+ type FormatStructParenFunc func(typ *spannerpb.Type, toplevel bool, fieldStrings []string) string

+ type Formatter interface

+ FormatColumn func(value spanner.GenericColumnValue, toplevel bool) (string, error)

+ type NullBytes []byte

+ func (n NullBytes) IsNull() bool

+ func (n NullBytes) String() string

+ type NullableValue interface