appx

README

appx

Go library for building applications. Dramatically simple. For a CLI tool see cristalhq/acmd.

Features

• Simple API.
• Dependency-free.
• Dramatically simple.

See these docs or GUIDE.md for more details.

Install

Go version 1.18+

go get github.com/cristalhq/appx

Example

import (
	"context"
	"os"

	"github.com/cristalhq/appx"
)

func main() {
	ctx := appx.Context()

	if err := run(ctx, os.Args[1:]); err != nil {
		panic(err)
	}
}

func run(ctx context.Context, args []string) error {
	// do good things
	return nil
}

See examples: example_test.go.

License

MIT License.

Documentation

Index

• func BuildInfo() (revision string, at time.Time, isModified, ok bool)
• func Context() context.Context
• func Env() string
• func OnSignal(ctx context.Context, sig os.Signal, fn func(ctx context.Context))
• func SelfSignal(sig os.Signal) error
• func SetEnv(v string)
• func Uptime() time.Duration

Functions

func BuildInfo

func BuildInfo() (revision string, at time.Time, isModified, ok bool)

BuildInfo of the app (if -buildvcs flag provided).

func Context

func Context() context.Context

Context of the application listening SIGINT and SIGTERM signals.

func Env

func Env() string

Env returns application environment set via SetEnv func.

func OnSignal

func OnSignal(ctx context.Context, sig os.Signal, fn func(ctx context.Context))

OnSignal run fn. Function is async, context is used to close underlying goroutine.

func SelfSignal

func SelfSignal(sig os.Signal) error

SelfSignal sends signal to the current process.

func SetEnv

func SetEnv(v string)

SetEnv for the application. Can be called once, all next calls panics. This function should be called at the start of the application.

func Uptime

func Uptime() time.Duration

Uptime of the application.