Embedding in Go programs

import "github.com/deepblue-phoenix/gligabao"

cfg, err := gligabao.LoadConfig("gligabao.toml") // or gligabao.DefaultConfig()
if err != nil { /* ... */ }
err = gligabao.Serve(ctx, cfg, gligabao.ServeOptions{DBPath: "data/gligabao.db"})

​

API

​

Mounting on your own HTTP server

mux := http.NewServeMux() // the host's mux, with the host's own routes
release, err := gligabao.Mount(ctx, cfg, gligabao.ServeOptions{DBPath: "data/gligabao.db"}, gligabao.MountOptions{
    Mux: mux,
    Wrap: func(next http.Handler) http.Handler { return requireAuth(next) }, // optional
})
if err != nil { /* ... */ }
defer release()
// ... http.ListenAndServe(":8080", mux), and call release after the host's server has shut down

• It takes the same Config and ServeOptions as Serve (providers, deployers, hooks, admin extensions, directories, …). Mount does the whole setup itself (databases, sidecar check, remember manager, …) and returns once the handlers are registered, so call it before the host starts serving. It does not block and does not handle SIGINT/SIGTERM: the host owns the process.
• All routes are registered as one subtree, gligabao.MountPrefix (/v1/gb/): the API and, when the config enables them, the admin UI (/v1/gb/admin/) and the eval and training endpoints. They are registered per method (GET /v1/gb/, POST /v1/gb/, …), so they do not conflict with a host’s GET /. The host must not have routes of its own under /v1/gb/: Mount returns an error, not a panic, if it has.
• gligabao’s own /, /health and /version are not registered, they belong to the host, and an unknown path under /v1/gb/ is a plain 404. The config’s port is not used.
• release stops the remember manager and closes the databases. It is idempotent, and is also called when ctx is cancelled. Call it after the host’s server has shut down; after it the mounted routes answer 503. The Hooks and App of ServeOptions are installed until then.
• MountOptions.Wrap wraps the whole handler before it is registered.