Directories ¶
Path | Synopsis |
---|---|
Package app has the static app info
|
Package app has the static app info |
Package async has helper utilities for running async code with proper tracing.
|
Package async has helper utilities for running async code with proper tracing. |
Package box implements the definitions of a box configuration file and tools to access it.
|
Package box implements the definitions of a box configuration file and tools to access it. |
package caller provides info on the caller
|
package caller provides info on the caller |
Package cfg manages config for outreach go services Every go app or package that needs config should define a strongly typed struct for it Example type HoneycombConfig struct { Disable bool `yaml:"Disable"` Dataset string `yaml:"Dataset"` APIHost string `yaml:"APIHost"` SampleRate float64 `yaml:"SampleRate"` Key cfg.Secret `yaml:"Key"` } func (x someComponent) someFunc(ctx context.Context) error { var hcConfig HoneycombConfig if err := cfg.Load("honeycomb.yaml", &hcConfig); err != nil { return err } ...
|
Package cfg manages config for outreach go services Every go app or package that needs config should define a strongly typed struct for it Example type HoneycombConfig struct { Disable bool `yaml:"Disable"` Dataset string `yaml:"Dataset"` APIHost string `yaml:"APIHost"` SampleRate float64 `yaml:"SampleRate"` Key cfg.Secret `yaml:"Key"` } func (x someComponent) someFunc(ctx context.Context) error { var hcConfig HoneycombConfig if err := cfg.Load("honeycomb.yaml", &hcConfig); err != nil { return err } ... |
Package cleanup provides helpers to make it easy to do cleanups.
|
Package cleanup provides helpers to make it easy to do cleanups. |
codec contains encoding/decoding utilities.
|
codec contains encoding/decoding utilities. |
Package differs contains custom diffing test utilities See the example for how to use them
|
Package differs contains custom diffing test utilities See the example for how to use them |
env provides environment specific overrides All the functions provided by this package are meant to be called at app initialization and will effectively not do anything at all in production.
|
env provides environment specific overrides All the functions provided by this package are meant to be called at app initialization and will effectively not do anything at all in production. |
Package events defines the standard logging event structures This is based on https://docs.google.com/document/d/1V1py1iXX9B9NAb30veHYNGOuymZ9o_C2pYSU9E6qmsg/edit# and https://outreach-io.atlassian.net/wiki/spaces/EN/pages/691405109/Logging+Standards
|
Package events defines the standard logging event structures This is based on https://docs.google.com/document/d/1V1py1iXX9B9NAb30veHYNGOuymZ9o_C2pYSU9E6qmsg/edit# and https://outreach-io.atlassian.net/wiki/spaces/EN/pages/691405109/Logging+Standards |
Package log implements standard go logging For logging: log.Info(ctx, "message", log.F{field: 42}) log.Error(...) log.Debug(...) log.Fatal(...) By default, log.Debug is not emitted but instead it is cached.
|
Package log implements standard go logging For logging: log.Info(ctx, "message", log.F{field: 42}) log.Error(...) log.Debug(...) log.Fatal(...) By default, log.Debug is not emitted but instead it is cached. |
logtest
logtest provides the ability to test logs Usage: func MyTestFunc(t *testing.T) { logs := logTest.NewLogRecorder(t) defer logs.Close() .....
|
logtest provides the ability to test logs Usage: func MyTestFunc(t *testing.T) { logs := logTest.NewLogRecorder(t) defer logs.Close() ..... |
Package metrics implements the outreach metrics API This consists of the Count and Latency functions
|
Package metrics implements the outreach metrics API This consists of the Count and Latency functions |
ometrics
module
|
|
Package orerr implements outreach specific error utilities.
|
Package orerr implements outreach specific error utilities. |
Package orio implements IO utilities.
|
Package orio implements IO utilities. |
Package secrets manages secrets config for outreach applications All secrets are assumed to be stored securely in the filesystem.
|
Package secrets manages secrets config for outreach applications All secrets are assumed to be stored securely in the filesystem. |
Package shuffler primarily provides the Suite struct that functions as a test runner and randomizer when embedded in your test struct.
|
Package shuffler primarily provides the Suite struct that functions as a test runner and randomizer when embedded in your test struct. |
Package sshhelper is a toolkit for common ssh-related operations.
|
Package sshhelper is a toolkit for common ssh-related operations. |
Package tester implements a test runner compatible with testing.T Usage: t := tester.New() tester.Run(t, "testA", func(t *tester.T) { ...
|
Package tester implements a test runner compatible with testing.T Usage: t := tester.New() tester.Run(t, "testA", func(t *tester.T) { ... |
Package trace wraps standard tracing for outreach.
|
Package trace wraps standard tracing for outreach. |
Click to show internal directories.
Click to hide internal directories.