config

Documentation

Overview

Package config contains helpers for loading and dumping TOML config files

Index

• Constants
• Variables
• func Encoders() []string
• func LoadFile(filename string, v any) error
• func Prepare(v any) error
• type Autodetect
  • func (p *Autodetect) Decode(data string, v any) error
• type Decoder
  • func NewDecoder(name string) (Decoder, bool)
  • func NewDecoderByFilename(filename string) (Decoder, bool)
• type Encoder
  • func NewEncoder(name string) (Encoder, bool)
• type JSON
  • func NewJSON() *JSON
  • func (JSON) Decode(data string, v any) error
  • func (p *JSON) SetIndent(indent string) bool
  • func (p *JSON) WriteTo(v any, w io.Writer) (int64, error)
• type TOML
  • func NewTOML() *TOML
  • func (*TOML) Decode(data string, v any) error
  • func (p *TOML) SetIndent(indent string) bool
  • func (p *TOML) WriteTo(v any, w io.Writer) (int64, error)
• type YAML
  • func NewYAML() *YAML
  • func (*YAML) Decode(data string, v any) error
  • func (p *YAML) SetIndent(s string) bool
  • func (p *YAML) WriteTo(v any, w io.Writer) (int64, error)

Constants

const (
	// DefaultJSONIndent is the indentation used unless SetIndent
	// is called on the JSON Encoder
	DefaultJSONIndent = `  `
)

const (
	// DefaultTOMLIndent is the indentation used unless SetIndent
	// is called on the TOML Encoder
	DefaultTOMLIndent = `  `
)

Variables

var (
	// ErrUnknownFormat indicates we failed to identify the format of the file
	ErrUnknownFormat = errors.New("file format not identified")
)

Functions

func Encoders

func Encoders() []string

Encoders returns all the formats we know to encode

func LoadFile

func LoadFile(filename string, v any) error

LoadFile loads a config file by name, expanding environment variables, filling gaps and validating its content. LoadFile uses the file extension to determine the format.

func Prepare

func Prepare(v any) error

Prepare fills any gap in the object and validates its content.

Types

type Autodetect

type Autodetect struct{}

Autodetect is a Decoder that tries all Decoders

func (*Autodetect) Decode

func (p *Autodetect) Decode(data string, v any) error

Decode takes encoded data and tries all registered decoders. Decode returns ErrUnknownFormat if all decoders fail.

type Decoder

type Decoder interface {
	Decode(data string, v any) error
}

A Decoder uses text to populate a data structure.

func NewDecoder

func NewDecoder(name string) (Decoder, bool)

NewDecoder returns the decoder associated with a name or extension.

func NewDecoderByFilename

func NewDecoderByFilename(filename string) (Decoder, bool)

NewDecoderByFilename uses the file extension to determine the decoder.

type Encoder

type Encoder interface {
	SetIndent(indent string) bool
	WriteTo(v any, w io.Writer) (int64, error)
}

Encoder serializes a data structure

func NewEncoder

func NewEncoder(name string) (Encoder, bool)

NewEncoder returns a encoder for the specified format

type JSON

type JSON struct {
	Indent string
}

JSON is a Encoder/Decoder for JSON

func NewJSON

func NewJSON() *JSON

NewJSON creates a new JSON Encoder/Decoder with two space indentation.

func (JSON) Decode

func (JSON) Decode(data string, v any) error

Decode takes JSON encoded data to populate a data structure.

func (*JSON) SetIndent

func (p *JSON) SetIndent(indent string) bool

SetIndent specifies what to do for indenting the serialized JSON content.

func (*JSON) WriteTo

func (p *JSON) WriteTo(v any, w io.Writer) (int64, error)

WriteTo encodes data into a given io.Writer. If encoding fails, the writer won't be touched.

type TOML

type TOML struct {
	Indent string
}

TOML is a Encoder/Decoder for TOML

func NewTOML

func NewTOML() *TOML

NewTOML creates a new TOML Encoder/Decoder with two space indentation.

func (*TOML) Decode

func (*TOML) Decode(data string, v any) error

Decode takes TOML encoded data to populate a data structure

func (*TOML) SetIndent

func (p *TOML) SetIndent(indent string) bool

SetIndent specifies what to do for indenting the serialized TOML content.

func (*TOML) WriteTo

func (p *TOML) WriteTo(v any, w io.Writer) (int64, error)

WriteTo encodes data into a given io.Writer. If encoding fails, the writer won't be touched.

type YAML

type YAML struct {
	Spaces int
}

YAML is a Encoder/Decoder for YAML

func NewYAML

func NewYAML() *YAML

NewYAML creates a new YAML Encoder/Decoder with two spaces as default indentation.

func (*YAML) Decode

func (*YAML) Decode(data string, v any) error

Decode takes YAML encoded data to populate a data structure

func (*YAML) SetIndent

func (p *YAML) SetIndent(s string) bool

SetIndent specifies what to use for indenting the serialized YAML content. Tabs are expanded to 8 spaces.

func (*YAML) WriteTo

func (p *YAML) WriteTo(v any, w io.Writer) (int64, error)

WriteTo encodes data into a given io.Writer. If encoding fails, the writer won't be touched.