chassis

chassis-go

A composable Go toolkit providing standardized building blocks that services wire together explicitly. Toolkit, not framework — it never owns main().

Packages

Tier 1: Foundation

Tier 2: Transports & Clients

Usage

func main() {
    cfg := config.MustLoad[AppConfig]()
    logger := logz.New(cfg.LogLevel)

    svc := yourservice.New(
        yourservice.WithLogger(logger),
    )

    lifecycle.Run(context.Background(),
        func(ctx context.Context) error {
            errCh := make(chan error, 1)
            go func() { errCh <- httpServer.ListenAndServe() }()
            select {
            case <-ctx.Done():
                return httpServer.Shutdown(context.Background())
            case err := <-errCh:
                return err
            }
        },
        func(ctx context.Context) error {
            errCh := make(chan error, 1)
            go func() { errCh <- grpcServer.Serve(lis) }()
            select {
            case <-ctx.Done():
                grpcServer.GracefulStop()
                return nil
            case err := <-errCh:
                return err
            }
        },
    )
}

Principles

1. Toolkit, not framework — Chassis never owns main(). You call it.
2. Zero cross-dependencies — Importing config doesn't pull in grpc.
3. Consumer-owned interfaces — Libraries define what they need.
4. Visible wiring — No magic startup.
5. Fail fast — Missing config = panic on startup.

Install

go get github.com/ai8future/chassis-go

License

MIT