Gommon is inspired by many awesome libraries. However, we chose to reinvent the wheel for most of them. Doing so allow us to shrink codebase, introduce break changes frequently, unify error handling and logging.
- pkg/errors it can not introduce breaking change, but
WithMessageandWithStackis annoying- see #54 and errors/doc about other error packages
- pkg/errors#122 for check existing stack before attach new one
- uber-go/multierr#21 for return bool after append
- hashicorp/go-multierror for
ErrorOrNil
- sirupsen/logrus for structured logging
- log v1 is entirely modeled after logrus, entry contains log information with methods like
Info,Infof
- log v1 is entirely modeled after logrus, entry contains log information with methods like
- apex/log for log handlers
- log v2's handler is inspired by apex/log, but we didn't use entry struct and chose to pass multiple parameters to explicitly state what a handler should handle. This can avoid the problem of adding extra context and ignored silently by existing handler implementations.
- uber-go/zap for serialize log fields without using
fmt.Sprintfand usestrconvdirectly- we didn't go that extreme as Zap or ZeroLog for zero allocation, performance is currently not measured
- GeertJohan/go.rice
- we implemented
.gitignorelike feature but the upstream didn't respond for the feature request #83 - we put data into generated code file while go.rice and append zip to existing go binary
- we implemented
- spf13/cast for cast, it is used by Viper
- spf13/viper for config
- looking up config via string key makes type system useless, so we always marshal entire config file to a single struct
- it also makes refactor easier
- we only use YAML, might add RCL
- looking up config via string key makes type system useless, so we always marshal entire config file to a single struct
- python requests for requests
- hashicorp/go-cleanhttp for using non default http transport and client
- benbjohnson/tmpl for go template based generator
- first saw it in influxdata/influxdb
- we put template data in
gommon.yml, so we don't need to pass data as json via cli. Using YAML instead of cli is inspired by docker-compose