xii

README

xii

My take on 12 Factor

Usage

AsBool

development, err := xii.AsBool("DEVELOPMENT", xii.BoolOpts{DefaultValue: false})
if err != nil {
	log.Fatal(err)
}
log.Printf("[xii] %-30s == %v\n", "DEVELOPMENT", development)

AsInt

port, err := xii.AsInt("PORT", xii.IntOpts{DefaultValue: 8080})
if err != nil {
	log.Fatal(err)
}
log.Printf("[xii] %-30s == %d\n", "PORT", port)

AsString

appRoot, err := xii.AsString("APPROOT", xii.StringOpts{DefaultValue: "./"})
if err != nil {
	log.Fatal(err)
}
log.Printf("[xii] %-30s == %q\n", "APPROOT", appRoot)

Documentation

Overview

Package xii contains helpers for 12 Factor.

Index

• Constants
• func AsBool(key string, opts BoolOpts) (bool, error)
• func AsInt(key string, opts IntOpts) (int, error)
• func AsString(key string, opts StringOpts) (string, error)
• type BoolOpts
• type IntOpts
• type StringOpts

Constants

const (
	ExtraSpaces    = constError("must not contain leading or trailing spaces")
	InvalidBoolean = constError("must be either true or false")
	InvalidInteger = constError("must be a valid integer")
	IsBlank        = constError("must not be blank")
	NotExported    = constError("must be exported")
)

Errors used by the package.

Functions

func AsBool

func AsBool(key string, opts BoolOpts) (bool, error)

AsBool retrieves a boolean value from the environment. Returns an error if the value is missing or invalid.

func AsInt

func AsInt(key string, opts IntOpts) (int, error)

AsInt is retrieves an integer value from the environment. Returns an error if the value is missing or invalid.

func AsString

func AsString(key string, opts StringOpts) (string, error)

AsString retrieves a string from the environment. Returns an error if the string is not set.

Types

type BoolOpts

type BoolOpts struct {
	Required     bool
	DefaultValue bool
	Help         string // short help message if required and not found
}

BoolOpts specifies if a value is required or has a default value.

type IntOpts

type IntOpts struct {
	Required     bool
	DefaultValue int
	Help         string // short help message if required and not found
}

IntOpts is

type StringOpts

type StringOpts struct {
	Required     bool
	DefaultValue string
	Help         string // short help message if required and not found
}

StringOpts is