gcfg

Documentation

Overview

Package gcfg provides reading, caching and managing for configuration.

Index

• Constants
• func ClearContent()
• func GetContent(file ...string) string
• func RemoveConfig(file ...string)
• func SetContent(content string, file ...string)
• type Config
  • func Instance(name ...string) *Config
  • func New(file ...string) *Config
  • func (c *Config) AddPath(path string) error
  • func (c *Config) Clear()
  • func (c *Config) Contains(pattern string) bool
  • func (c *Config) FilePath(file ...string) (path string)
  • func (c *Config) Get(pattern string, def ...interface{}) interface{}
  • func (c *Config) GetArray(pattern string, def ...interface{}) []interface{}
  • func (c *Config) GetBool(pattern string, def ...interface{}) bool
  • func (c *Config) GetDuration(pattern string, def ...interface{}) time.Duration
  • func (c *Config) GetFileName() string
  • func (c *Config) GetFilePath(file ...string) (path string)
  • func (c *Config) GetFloat32(pattern string, def ...interface{}) float32
  • func (c *Config) GetFloat64(pattern string, def ...interface{}) float64
  • func (c *Config) GetFloats(pattern string, def ...interface{}) []float64
  • func (c *Config) GetGTime(pattern string, format ...string) *gtime.Time
  • func (c *Config) GetInt(pattern string, def ...interface{}) int
  • func (c *Config) GetInt16(pattern string, def ...interface{}) int16
  • func (c *Config) GetInt32(pattern string, def ...interface{}) int32
  • func (c *Config) GetInt64(pattern string, def ...interface{}) int64
  • func (c *Config) GetInt8(pattern string, def ...interface{}) int8
  • func (c *Config) GetInterfaces(pattern string, def ...interface{}) []interface{}
  • func (c *Config) GetInts(pattern string, def ...interface{}) []int
  • func (c *Config) GetMap(pattern string, def ...interface{}) map[string]interface{}
  • func (c *Config) GetString(pattern string, def ...interface{}) string
  • func (c *Config) GetStrings(pattern string, def ...interface{}) []string
  • func (c *Config) GetStruct(pattern string, pointer interface{}, mapping ...map[string]string) error
  • func (c *Config) GetStructDeep(pattern string, pointer interface{}, mapping ...map[string]string) error
  • func (c *Config) GetStructs(pattern string, pointer interface{}, mapping ...map[string]string) error
  • func (c *Config) GetStructsDeep(pattern string, pointer interface{}, mapping ...map[string]string) error
  • func (c *Config) GetTime(pattern string, format ...string) time.Time
  • func (c *Config) GetToStruct(pattern string, pointer interface{}) error
  • func (c *Config) GetUint(pattern string, def ...interface{}) uint
  • func (c *Config) GetUint16(pattern string, def ...interface{}) uint16
  • func (c *Config) GetUint32(pattern string, def ...interface{}) uint32
  • func (c *Config) GetUint64(pattern string, def ...interface{}) uint64
  • func (c *Config) GetUint8(pattern string, def ...interface{}) uint8
  • func (c *Config) GetVar(pattern string, def ...interface{}) *gvar.Var
  • func (c *Config) Reload()
  • func (c *Config) SetFileName(name string)
  • func (c *Config) SetPath(path string) error
  • func (c *Config) SetViolenceCheck(check bool)

Constants

const (
	// DEFAULT_CONFIG_FILE is the default configuration file name.
	DEFAULT_CONFIG_FILE = "config.toml"
)

const (
	// Default group name for instance usage.
	DEFAULT_GROUP_NAME = "default"
)

Functions

func ClearContent

func ClearContent()

ClearContent removes all global configuration contents.

func GetContent

func GetContent(file ...string) string

GetContent returns customized configuration content for specified <file>. The <file> is unnecessary param, default is DEFAULT_CONFIG_FILE.

func RemoveConfig

func RemoveConfig(file ...string)

RemoveConfig removes the global configuration with specified group. If <name> is not passed, it removes configuration of the default group name.

func SetContent

func SetContent(content string, file ...string)

SetContent sets customized configuration content for specified <file>. The <file> is unnecessary param, default is DEFAULT_CONFIG_FILE.

Types

type Config

type Config struct {
	// contains filtered or unexported fields
}

Configuration struct.

func Instance

func Instance(name ...string) *Config

Instance returns an instance of Config with default settings. The parameter <name> is the name for the instance.

func New

func New(file ...string) *Config

New returns a new configuration management object. The parameter <file> specifies the default configuration file name for reading.

func (*Config) AddPath

func (c *Config) AddPath(path string) error

AddPath adds a absolute or relative path to the search paths.

func (*Config) Clear

func (c *Config) Clear()

Clear removes all parsed configuration files content cache, which will force reload configuration content from file.

func (*Config) Contains

func (c *Config) Contains(pattern string) bool

func (*Config) FilePath

func (c *Config) FilePath(file ...string) (path string)

GetFilePath returns the absolute path of the specified configuration file. If <file> is not passed, it returns the configuration file path of the default name. If the specified configuration file does not exist, an empty string is returned.

func (*Config) Get

func (c *Config) Get(pattern string, def ...interface{}) interface{}

func (*Config) GetArray

func (c *Config) GetArray(pattern string, def ...interface{}) []interface{}

func (*Config) GetBool

func (c *Config) GetBool(pattern string, def ...interface{}) bool

func (*Config) GetDuration

func (c *Config) GetDuration(pattern string, def ...interface{}) time.Duration

func (*Config) GetFileName

func (c *Config) GetFileName() string

GetFileName returns the default configuration file name.

func (*Config) GetFilePath

func (c *Config) GetFilePath(file ...string) (path string)

GetFilePath is alias of FilePath. Deprecated.

func (*Config) GetFloat32

func (c *Config) GetFloat32(pattern string, def ...interface{}) float32

func (*Config) GetFloat64

func (c *Config) GetFloat64(pattern string, def ...interface{}) float64

func (*Config) GetFloats

func (c *Config) GetFloats(pattern string, def ...interface{}) []float64

func (*Config) GetGTime

func (c *Config) GetGTime(pattern string, format ...string) *gtime.Time

func (*Config) GetInt

func (c *Config) GetInt(pattern string, def ...interface{}) int

func (*Config) GetInt16

func (c *Config) GetInt16(pattern string, def ...interface{}) int16

func (*Config) GetInt32

func (c *Config) GetInt32(pattern string, def ...interface{}) int32

func (*Config) GetInt64

func (c *Config) GetInt64(pattern string, def ...interface{}) int64

func (*Config) GetInt8

func (c *Config) GetInt8(pattern string, def ...interface{}) int8

func (*Config) GetInterfaces

func (c *Config) GetInterfaces(pattern string, def ...interface{}) []interface{}

func (*Config) GetInts

func (c *Config) GetInts(pattern string, def ...interface{}) []int

func (*Config) GetMap

func (c *Config) GetMap(pattern string, def ...interface{}) map[string]interface{}

func (*Config) GetString

func (c *Config) GetString(pattern string, def ...interface{}) string

func (*Config) GetStrings

func (c *Config) GetStrings(pattern string, def ...interface{}) []string

func (*Config) GetStruct

func (c *Config) GetStruct(pattern string, pointer interface{}, mapping ...map[string]string) error

func (*Config) GetStructDeep

func (c *Config) GetStructDeep(pattern string, pointer interface{}, mapping ...map[string]string) error

func (*Config) GetStructs

func (c *Config) GetStructs(pattern string, pointer interface{}, mapping ...map[string]string) error

func (*Config) GetStructsDeep

func (c *Config) GetStructsDeep(pattern string, pointer interface{}, mapping ...map[string]string) error

func (*Config) GetTime

func (c *Config) GetTime(pattern string, format ...string) time.Time

func (*Config) GetToStruct

func (c *Config) GetToStruct(pattern string, pointer interface{}) error

Deprecated.

func (*Config) GetUint

func (c *Config) GetUint(pattern string, def ...interface{}) uint

func (*Config) GetUint16

func (c *Config) GetUint16(pattern string, def ...interface{}) uint16

func (*Config) GetUint32

func (c *Config) GetUint32(pattern string, def ...interface{}) uint32

func (*Config) GetUint64

func (c *Config) GetUint64(pattern string, def ...interface{}) uint64

func (*Config) GetUint8

func (c *Config) GetUint8(pattern string, def ...interface{}) uint8

func (*Config) GetVar

func (c *Config) GetVar(pattern string, def ...interface{}) *gvar.Var

func (*Config) Reload

func (c *Config) Reload()

Reload is alias of Clear. Deprecated.

func (*Config) SetFileName

func (c *Config) SetFileName(name string)

SetFileName sets the default configuration file name.

func (*Config) SetPath

func (c *Config) SetPath(path string) error

SetPath sets the configuration directory path for file search. The parameter <path> can be absolute or relative path, but absolute path is strongly recommended.

func (*Config) SetViolenceCheck

func (c *Config) SetViolenceCheck(check bool)

SetViolenceCheck sets whether to perform hierarchical conflict check. This feature needs to be enabled when there is a level symbol in the key name. The default is off. Turning on this feature is quite expensive, and it is not recommended to allow separators in the key names. It is best to avoid this on the application side.