ecmd

README

Docs: GoDoc

ecmd.Args provides maps for storing commandline arguments of basic types (bool, string, int, float64), along with associated defaults and descriptions, which then set the standard library flags for parsing command line arguments.

It has functions for populating standard emergent simulation args.

Documentation

Index

• type Args
  • func (ar *Args) AddBool(name string, def bool, desc string)
  • func (ar *Args) AddFloat(name string, def float64, desc string)
  • func (ar *Args) AddInt(name string, def int, desc string)
  • func (ar *Args) AddStd()
  • func (ar *Args) AddString(name string, def string, desc string)
  • func (ar *Args) Bool(name string) bool
  • func (ar *Args) Flag()
  • func (ar *Args) Float(name string) float64
  • func (ar *Args) Init()
  • func (ar *Args) Int(name string) int
  • func (ar *Args) Parse()
  • func (ar *Args) ProcStd()
  • func (ar *Args) SetBool(name string, val bool)
  • func (ar *Args) SetFloat(name string, val float64)
  • func (ar *Args) SetInt(name string, val int)
  • func (ar *Args) SetString(name string, val string)
  • func (ar *Args) String(name string) string
  • func (ar *Args) Usage()
• type Bool
  • func NewBool(name string, def bool, desc string) *Bool
  • func (vl *Bool) Set(val bool)
• type Float
  • func NewFloat(name string, def float64, desc string) *Float
  • func (vl *Float) Set(val float64)
• type Int
  • func NewInt(name string, def int, desc string) *Int
  • func (vl *Int) Set(val int)
• type String
  • func NewString(name string, def string, desc string) *String
  • func (vl *String) Set(val string)

Types

type Args

type Args struct {
	Ints    map[string]*Int
	Bools   map[string]*Bool
	Strings map[string]*String
	Floats  map[string]*Float
	Flagged bool `inactive:"+" desc:"true when all args have been set to flag package"`
}

Args provides maps for storing commandline args.

func (*Args) AddBool

func (ar *Args) AddBool(name string, def bool, desc string)

AddBool adds a new Bool arg

func (*Args) AddFloat

func (ar *Args) AddFloat(name string, def float64, desc string)

AddFloat adds a new Float arg

func (*Args) AddInt

func (ar *Args) AddInt(name string, def int, desc string)

AddInt adds a new Int arg

func (*Args) AddStd

func (ar *Args) AddStd()

AddStd adds the standard command line args used by most sims

func (*Args) AddString

func (ar *Args) AddString(name string, def string, desc string)

AddString adds a new String arg

func (*Args) Bool

func (ar *Args) Bool(name string) bool

Bool returns bool val by name

func (*Args) Flag

func (ar *Args) Flag()

Flag sets all args to the system flag values, only if not already done.

func (*Args) Float

func (ar *Args) Float(name string) float64

Float returns float val by name

func (*Args) Init

func (ar *Args) Init()

Init must be called before use to create all the maps

func (*Args) Int

func (ar *Args) Int(name string) int

Int returns int val by name

func (*Args) Parse

func (ar *Args) Parse()

Parse parses command line args, setting values from command line Any errors will cause the program to exit with error message.

func (*Args) ProcStd

func (ar *Args) ProcStd()

ProcStd processes the standard args, after Parse has been called

func (*Args) SetBool

func (ar *Args) SetBool(name string, val bool)

SetBool sets the default and current val

func (*Args) SetFloat

func (ar *Args) SetFloat(name string, val float64)

SetFloat sets the default and current val

func (*Args) SetInt

func (ar *Args) SetInt(name string, val int)

SetInt sets the default and current val

func (*Args) SetString

func (ar *Args) SetString(name string, val string)

SetString sets the default and current val

func (*Args) String

func (ar *Args) String(name string) string

String returns string val by name

func (*Args) Usage

func (ar *Args) Usage()

Usage prints the set of command args. It is called by the help bool arg.

type Bool

type Bool struct {
	Name string `desc:"name of arg -- must be unique"`
	Desc string `desc:"description of arg"`
	Val  bool   `desc:"value as parsed"`
	Def  bool   `desc:"default initial value"`
}

Bool represents a bool valued arg

func NewBool

func NewBool(name string, def bool, desc string) *Bool

NewBool returns a new Bool arg

func (*Bool) Set

func (vl *Bool) Set(val bool)

Set sets default and current val

type Float

type Float struct {
	Name string  `desc:"name of arg -- must be unique"`
	Desc string  `desc:"description of arg"`
	Val  float64 `desc:"value as parsed"`
	Def  float64 `desc:"default initial value"`
}

Float represents a float64 valued arg

func NewFloat

func NewFloat(name string, def float64, desc string) *Float

NewFloat returns a new Float arg

func (*Float) Set

func (vl *Float) Set(val float64)

Set sets default and current val

type Int

type Int struct {
	Name string `desc:"name of arg -- must be unique"`
	Desc string `desc:"description of arg"`
	Val  int    `desc:"value as parsed"`
	Def  int    `desc:"default initial value"`
}

Int represents a int valued arg

func NewInt

func NewInt(name string, def int, desc string) *Int

NewInt returns a new Int arg

func (*Int) Set

func (vl *Int) Set(val int)

Set sets default and current val

type String

type String struct {
	Name string `desc:"name of arg -- must be unique"`
	Desc string `desc:"description of arg"`
	Val  string `desc:"value as parsed"`
	Def  string `desc:"default initial value"`
}

String represents a string valued arg

func NewString

func NewString(name string, def string, desc string) *String

NewString returns a new String arg

func (*String) Set

func (vl *String) Set(val string)

Set sets default and current val