configfile

Documentation

Overview

Package configfile handles all the base configuration-file routines. This package also holds the conifiguration for the webserver and notifiarr packages. In here you will find config file parsing, validation, and creation. The application can re-write its own config file from a built-in template, complete with comments. In some circumstances the application writes a brand new empty config on startup.

Index

• Constants
• Variables
• func CheckPort(addr string) (string, error)
• func CopyFile(src, dst string) error
• func Funcs() template.FuncMap
• type AllowedIPs
  • func MakeIPs(upstreams []string) (a AllowedIPs)
  • func (n AllowedIPs) Contains(ip string) bool
  • func (n AllowedIPs) String() (s string)
• type Config
  • func NewConfig(logger *logs.Logger) *Config
  • func (c *Config) CopyConfig() (*Config, error)
  • func (c *Config) FindAndReturn(configFile string, write bool) (string, bool, string)
  • func (c *Config) Get(flag *Flags) (*notifiarr.Config, error)
  • func (c *Config) Write(file string) (string, error)
• type CryptPass
  • func (p CryptPass) IsCrypted() bool
  • func (p *CryptPass) Set(pass string) error
  • func (p CryptPass) Valid(pass string) bool
  • func (p CryptPass) Webauth() bool
• type Flags
  • func (f *Flags) ParseArgs(args []string)

Constants

const (
	MsgNoConfigFile = "Using env variables only. Config file not found."
	MsgConfigFailed = "Using env variables only. Could not create config file: "
	MsgConfigCreate = "Created new config file: "
	MsgConfigFound  = "Using Config File: "
)

Return prefixes from FindAndReturn.

Variables

var ForceAllTmpl = false // nolint:gochecknoglobals

ForceAllTmpl allows you to force some specific settings. Used to build a default template.

var Template = template.Must(template.New("config").Funcs(Funcs()).Parse(tmpl))

Template is the config file template. nolint: gochecknoglobals

Functions

func CheckPort

func CheckPort(addr string) (string, error)

CheckPort attempts to bind to a port to check if it's in use or not. We use this to check the port before starting the webserver.

func CopyFile

func CopyFile(src, dst string) error

CopyFile can be used to make a config file backup.

func Funcs

func Funcs() template.FuncMap

Funcs returns our template functions.

Types

type AllowedIPs

type AllowedIPs []*net.IPNet

AllowedIPs determines who can set x-forwarded-for.

func MakeIPs

func MakeIPs(upstreams []string) (a AllowedIPs)

MakeIPs turns a list of CIDR strings (or plain IPs) into a list of net.IPNet. This "allowed" list is later used to check incoming IPs from web requests.

func (AllowedIPs) Contains

func (n AllowedIPs) Contains(ip string) bool

Contains returns true if an IP is allowed.

func (AllowedIPs) String

func (n AllowedIPs) String() (s string)

String turns a list of allowedIPs into a printable masterpiece.

type Config

type Config struct {
	UIPassword CryptPass           `json:"uiPassword" toml:"ui_password" xml:"ui_password" yaml:"uiPassword"`
	BindAddr   string              `json:"bindAddr" toml:"bind_addr" xml:"bind_addr" yaml:"bindAddr"`
	SSLCrtFile string              `json:"sslCertFile" toml:"ssl_cert_file" xml:"ssl_cert_file" yaml:"sslCertFile"`
	SSLKeyFile string              `json:"sslKeyFile" toml:"ssl_key_file" xml:"ssl_key_file" yaml:"sslKeyFile"`
	AutoUpdate string              `json:"autoUpdate" toml:"auto_update" xml:"auto_update" yaml:"autoUpdate"`
	MaxBody    int                 `json:"maxBody" toml:"max_body" xml:"max_body" yaml:"maxBody"`
	Mode       string              `json:"mode" toml:"mode" xml:"mode" yaml:"mode"`
	Upstreams  []string            `json:"upstreams" toml:"upstreams" xml:"upstreams" yaml:"upstreams"`
	Timeout    cnfg.Duration       `json:"timeout" toml:"timeout" xml:"timeout" yaml:"timeout"`
	Serial     bool                `json:"serial" toml:"serial" xml:"serial" yaml:"serial"`
	Retries    int                 `json:"retries" toml:"retries" xml:"retries" yaml:"retries"`
	Plex       *plex.Server        `json:"plex" toml:"plex" xml:"plex" yaml:"plex"`
	Snapshot   *snapshot.Config    `json:"snapshot" toml:"snapshot" xml:"snapshot" yaml:"snapshot"`
	Services   *services.Config    `json:"services" toml:"services" xml:"services" yaml:"services"`
	Service    []*services.Service `json:"service" toml:"service" xml:"service" yaml:"service"`
	EnableApt  bool                `json:"apt" toml:"apt" xml:"apt" yaml:"apt"`
	*logs.LogConfig
	*apps.Apps
	Allow AllowedIPs `json:"-" toml:"-" xml:"-" yaml:"-"`
}

Config represents the data in our config file.

func NewConfig

func NewConfig(logger *logs.Logger) *Config

NewConfig returns a fresh config with only defaults and a logger ready to go.

func (*Config) CopyConfig

func (c *Config) CopyConfig() (*Config, error)

CopyConfig returns a copy of the configuration data. Useful for writing a config file with different values than what's running.

func (*Config) FindAndReturn

func (c *Config) FindAndReturn(configFile string, write bool) (string, bool, string)

FindAndReturn return a config file. Write one if requested.

func (*Config) Get

func (c *Config) Get(flag *Flags) (*notifiarr.Config, error)

Get parses a config file and environment variables. Sometimes the app runs without a config file entirely. You should only run this after getting a config with NewConfig().

func (*Config) Write

func (c *Config) Write(file string) (string, error)

Write config to a file.

type CryptPass

type CryptPass string

CryptPass allows us to validate an input password easily.

func (CryptPass) IsCrypted

func (p CryptPass) IsCrypted() bool

IsCrypted checks if a password string is already encrypted.

func (*CryptPass) Set

func (p *CryptPass) Set(pass string) error

Set sets a crypted password.

func (CryptPass) Valid

func (p CryptPass) Valid(pass string) bool

Valid checks if a password is valid.

func (CryptPass) Webauth

func (p CryptPass) Webauth() bool

type Flags

type Flags struct {
	*flag.FlagSet `json:"-"`
	VerReq        bool     `json:"verReq"`
	Restart       bool     `json:"restart"`
	AptHook       bool     `json:"aptHook"`
	Updated       bool     `json:"updated"`
	PSlist        bool     `json:"pslist"`
	Write         string   `json:"wrte"`
	Curl          string   `json:"curl"`
	ConfigFile    string   `json:"configFile"`
	ExtraConf     []string `json:"extraConf"`
	EnvPrefix     string   `json:"envPrefix"`
	Headers       []string `json:"headers"`
	Assets        string   `json:"staticDif"`
}

Flags are our CLI input flags.

func (*Flags) ParseArgs

func (f *Flags) ParseArgs(args []string)

ParseArgs stores the cli flag data into the Flags pointer.