package envconfig

import "github.com/kelseyhightower/envconfig"

Package envconfig implements decoding of environment variables based on a user defined specification. A typical use is using environment variables for configuration settings.

Index ¶

• Variables
• func MustProcess(prefix string, spec interface{})
• func Process(prefix string, spec interface{}) error
• type Decoder
• type ParseError
• func (e *ParseError) Error() string
• type Setter

Variables ¶

var ErrInvalidSpecification = errors.New("specification must be a struct pointer")

ErrInvalidSpecification indicates that a specification is of the wrong type.

Functions ¶

func MustProcess ¶

func MustProcess(prefix string, spec interface{})

MustProcess is the same as Process but panics if an error occurs

func Process ¶

func Process(prefix string, spec interface{}) error

Process populates the specified struct based on environment variables

Types ¶

type Decoder ¶

type Decoder interface {
	Decode(value string) error
}

Decoder has the same semantics as Setter, but takes higher precedence. It is provided for historical compatibility.

type ParseError ¶

type ParseError struct {
	KeyName   string
	FieldName string
	TypeName  string
	Value     string
	Err       error
}

A ParseError occurs when an environment variable cannot be converted to the type required by a struct field during assignment.

func (*ParseError) Error ¶

func (e *ParseError) Error() string

type Setter ¶

type Setter interface {
	Set(value string) error
}

Setter is implemented by types can self-deserialize values. Any type that implements flag.Value also implements Setter.

Source Files ¶

doc.go env_syscall.go envconfig.go