pascaldekloe / goe

enterprise tooling
Creative Commons Zero v1.0 Universal
13 stars 4 forks source link

Go Enterprise

Common enterprise features for the Go programming language.

This is free and unencumbered software released into the public domain.

Build Status

Expression Language API

GoEL expressions provide error free access to Go types. It serves as a lightweigth alternative to unified EL, SpEL or even XPath, CSS selectors and friends.

func FancyOneLiners() {
    // Single field selection:
    upper, applicable := el.Bool(`/CharSet[0x1F]/isUpperCase`, x)

    // Escape path separator slash:
    warnings := el.Strings(`/Report/Stats["I\x2fO"]/warn[*]`, x)

    // Data modification:
    el.Assign(x, `/Nodes[7]/Cache/TTL`, 3600)

Performance

The implementation is optimized for performance. No need to precompile expressions.

goos: darwin
goarch: arm64
pkg: github.com/pascaldekloe/goe/el
BenchmarkLookups-8       4037929           268.3 ns/op
BenchmarkAssigns-8       2855529           419.9 ns/op

Metrics API

Yet another StatsD implementation.

var Metrics = metrics.NewDummy()

func GetSomething(w http.ResponseWriter, r *http.Request) {
    Metrics.Seen("http.something.gets", 1)
    defer Metrics.Took("http.something.get", time.Now())

Verification API

Test assertions on big objects can be cumbersome with reflect.DeepEqual and "Got %#v, want %#v". Package verify offers convenience with reporting. For example verify.Values(t, "character", got, want) might print:

--- FAIL: TestValuesDemo (0.00s)
    demo_test.go:72: verification for character:
        /Novel[6]/Title: Got "Gold Finger", want "Goldfinger"
                                  ^
        /Film[20]/Year: Got 1953 (0x7a1), want 2006 (0x7d6)