config

Documentation

Overview

Package config is an interface for dynamic configuration.

Index

• Variables
• func AppendServiceTag(tags ...string)
• func Byte() []byte
• func Close() error
• func Fields() *field.Fields
• func Get(path ...string) reader.Value
• func Load(source ...source.Source) error
• func Scan(val Config) error
• func ServiceName() string
• func ServiceTag() []string
• func ServiceVersion() string
• func SetServiceTag(tags ...string)
• func Sync() error
• func Validate(val Config) error
• type Config
• type Configurator
  • func NewConfig(opts ...Option) Configurator
• type Option
  • func WithLoader(l loader.Loader) Option
  • func WithReader(r reader.Reader) Option
  • func WithSource(s ...source.Source) Option
  • func WithValidator(v validator.Validator) Option
• type Options
• type Source
• type Watcher
  • func Watch(path ...string) (Watcher, error)

Variables

var (
	// Default Config Manager
	Default = NewConfig(
		WithValidator(playground.New("zh")),
	)
)

Functions

func AppendServiceTag

func AppendServiceTag(tags ...string)

func Byte

func Byte() []byte

Byte return config raw data

func Close

func Close() error

Close stop the config loader/watcher

func Fields

func Fields() *field.Fields

func Get

func Get(path ...string) reader.Value

Get a value from the config

func Load

func Load(source ...source.Source) error

Load config sources

func Scan

func Scan(val Config) error

Scan config to val

func ServiceName

func ServiceName() string

func ServiceTag

func ServiceTag() []string

func ServiceVersion

func ServiceVersion() string

func SetServiceTag

func SetServiceTag(tags ...string)

func Sync

func Sync() error

Sync force a source changeset sync

func Validate

func Validate(val Config) error

Validate config to val

Types

type Config

type Config interface {
	Path() string
}

Config is set of config fields. "." is a level splitter. For example:

father.child

It means that config data's struct same as this.

{
  "father": {
    "child": {xxx}
  }
}

type Configurator

type Configurator interface {
	// Load config sources
	Load(source ...source.Source) error
	// Sync force a source change set sync
	Sync() error
	// Close stop the config loader/watcher
	Close() error
	// Bytes get merged config data
	Bytes() []byte
	// Scan to val
	Scan(val Config) error
	// Validate val
	Validate(val Config) error
	// Watch field change
	Watch(path ...string) (Watcher, error)
	// Get value through field
	Get(path ...string) reader.Value
	// Fields return scanned fields
	Fields() *field.Fields
}

Configurator is an interface abstraction for dynamic configuration

func NewConfig

func NewConfig(opts ...Option) Configurator

NewConfig returns new config

type Option

type Option func(o *Options)

func WithLoader

func WithLoader(l loader.Loader) Option

WithLoader sets the loader for manager config

func WithReader

func WithReader(r reader.Reader) Option

WithReader sets the config reader

func WithSource

func WithSource(s ...source.Source) Option

WithSource appends a source to list of sources

func WithValidator

func WithValidator(v validator.Validator) Option

WithValidator sets the loader for manager config

type Options

type Options struct {
	Loader    loader.Loader
	Reader    reader.Reader
	Validator validator.Validator
	Source    []source.Source

	// for alternative data
	Context context.Context
}

type Source

type Source struct {
	Type string `config:"type"`
	// contains filtered or unexported fields
}

type Watcher

type Watcher interface {
	Next() (reader.Value, error)
	Stop() error
}

Watcher is the config watcher

func Watch

func Watch(path ...string) (Watcher, error)

Watch a value for changes