config

Documentation

Index

• Variables
• type Config
  • func Get(i *Input) (*Config, error)
  • func (c *Config) Settings() *Settings
  • func (c *Config) Start()
  • func (c *Config) Stop()
  • func (c *Config) Update(settings *Settings) *Settings
  • func (c *Config) Write(settings *Settings) error
• type Input
• type Settings

Variables

var ErrEmptyInput = fmt.Errorf("input must have at least name or path")

Types

type Config

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

Config provides an interface to read and write config values, thread safe.

func Get

func Get(i *Input) (*Config, error)

Get opens/reads or creates/writes a config file.

func (*Config) Settings

func (c *Config) Settings() *Settings

func (*Config) Start

func (c *Config) Start()

func (*Config) Stop

func (c *Config) Stop()

func (*Config) Update

func (c *Config) Update(settings *Settings) *Settings

Update merges in a new config.

func (*Config) Write

func (c *Config) Write(settings *Settings) error

Write writes the config file and updates the running settings.

type Input

type Input struct {
	// File path to config file. Optional.
	// Name and Dir are not used for config file path if this is provided.
	File string
	// Application name. Used to construct a config file path.
	// Also used for log file names. Overrides what's in config file.
	Name string
	// Sub-directory to put the config file into. Optional.
	Dir string
}

Input data to open a config file. If Dir!="" then config is placed in a sub directory.

type Settings

type Settings struct {
	logs.LogConfig
	Dark    bool
	DevMode bool
	Updates string
	File    string // should not be changed.
}

Settings is the data read and written to/from the Settings file. Avoid pointers and complex types.