envfile

Documentation

Overview

Package envfile provides tools to read and load environment variables from files.

Index

• func Load(filename string) error
• func LoadFS(fsys fs.FS, filename string) error
• func Overload(filename string) error
• func OverloadFS(fsys fs.FS, filename string) error
• func Write(filename string, v any) error
• type Encoder
  • func Create(filename string) (*Encoder, error)
  • func NewEncoder(f *os.File) *Encoder
  • func (fe *Encoder) Close() error
• type Reader
  • func NewReader(f fs.File) *Reader
  • func Open(filename string) (*Reader, error)
  • func OpenFS(fsys fs.FS, filename string) (*Reader, error)
  • func (f *Reader) Close() error

Functions

func Load

func Load(filename string) error

Load reads from filename and sets the environment variables using env.Load.

func LoadFS

func LoadFS(fsys fs.FS, filename string) error

LoadFS reads from filename and sets the environment variables using env.Load.

func Overload

func Overload(filename string) error

Overload reads from filename and sets and overwrites the environment variables using env.Overload.

func OverloadFS

func OverloadFS(fsys fs.FS, filename string) error

OverloadFS reads from filename and sets and overwrites the environment variables using env.Overload.

func Write

func Write(filename string, v any) error

Types

type Encoder

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

func Create

func Create(filename string) (*Encoder, error)

func NewEncoder

func NewEncoder(f *os.File) *Encoder

func (*Encoder) Close

func (fe *Encoder) Close() error

Close closes the underlying os.File.

type Reader

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

func NewReader

func NewReader(f fs.File) *Reader

NewReader returns a Reader which looks up environment variables from the provided fs.File.

dec := env.NewDecoder(envfile.NewReader(file))

func Open

func Open(filename string) (*Reader, error)

Open opens filename for reading using os.Open and returns a new *Reader. It is the caller's responsibility to close the Reader when finished. If there is an error, it will be of type *os.PathError.

func OpenFS

func OpenFS(fsys fs.FS, filename string) (*Reader, error)

OpenFS opens filename for reading from fsys and returns a new *Reader. It is the caller's responsibility to close the Reader when finished. If there is an error, it will be of type *os.PathError.

func (*Reader) Close

func (f *Reader) Close() error

Close closes the underlying fs.File.