bedrock

Oct 16, 2026

Changes in this version

+ func Main(app App)

+ type AppFunc func(ctx context.Context, p Process) ExitStatus

+ func (f AppFunc) Run(ctx context.Context, p Process) ExitStatus

+ type Environment interface

+ Value func(name string) (string, error)

+ type ExitStatus struct

+ func Exit(code int) ExitStatus

+ func ExitWithCause(code int, cause error) ExitStatus

+ func (s ExitStatus) Cause() error

+ func (s ExitStatus) Code() int

+ type OSEnvironment struct

+ func (OSEnvironment) Value(name string) (string, error)

+ type Process struct

+ Args []string

+ Environment Environment

+ NotifyContext func(parent context.Context, signals ...os.Signal) (ctx context.Context, stop context.CancelFunc)

+ Stderr io.Writer

+ Stdin io.Reader

+ Stdout io.Writer

+ func OSProcess() Process

+ type StaticEnvironment struct

+ func NewStaticEnvironment(values map[string]string) StaticEnvironment

+ func (e StaticEnvironment) Value(name string) (string, error)

+ type ValueNotFoundError struct

+ Name string

+ func (e ValueNotFoundError) Error() string

Apr 4, 2026

Changes in this version

+ func MustBuild[T any](ctx context.Context, builder Builder[T]) T

+ type Builder interface

+ Build func(context.Context) (T, error)

+ func Bind[A, B any](builder Builder[A], binder func(context.Context, A) Builder[B]) Builder[B]

+ func BuilderOf[T any](value T) Builder[T]

+ func Map[A, B any](builder Builder[A], mapper func(context.Context, A) (B, error)) Builder[B]

+ func MemoizeBuilder[T any](builder Builder[T]) Builder[T]

+ type BuilderFunc func(context.Context) (T, error)

+ func (f BuilderFunc[T]) Build(ctx context.Context) (T, error)

+ type Runner interface

+ Run func(context.Context, Builder[T]) error

+ func DefaultRunner[T Runtime]() Runner[T]

+ func NotifyOnSignal[T Runtime](runner Runner[T], signals ...os.Signal) Runner[T]

+ func RecoverPanics[T Runtime](runner Runner[T]) Runner[T]

+ type RunnerFunc func(context.Context, Builder[T]) error

+ func (f RunnerFunc[T]) Run(ctx context.Context, builder Builder[T]) error

+ type RuntimeFunc func(context.Context) error

+ func (f RuntimeFunc) Run(ctx context.Context) error

Sep 28, 2024

Changes in this version

+ func Recover(err *error)

+ type PanicError struct

+ Value any

+ func (e PanicError) Error() string

+ func (e PanicError) Unwrap() error

Aug 15, 2024

Changes in this version

+ func Run[T any](ctx context.Context, builder AppBuilder[T], srcs ...config.Source) error

+ type AppBuildError struct

+ Cause error

+ func (e AppBuildError) Error() string

+ func (e AppBuildError) Unwrap() error

+ type AppBuilder interface

+ Build func(ctx context.Context, cfg T) (App, error)

+ type AppBuilderFunc func(context.Context, T) (App, error)

+ func (f AppBuilderFunc[T]) Build(ctx context.Context, cfg T) (App, error)

+ type AppRunError struct

+ Cause error

+ func (e AppRunError) Error() string

+ func (e AppRunError) Unwrap() error

+ type ConfigReadError struct

+ Cause error

+ func (e ConfigReadError) Error() string

+ func (e ConfigReadError) Unwrap() error

+ type ConfigUnmarshalError struct

+ Cause error

+ func (e ConfigUnmarshalError) Error() string

+ func (e ConfigUnmarshalError) Unwrap() error

Mar 22, 2024

Changes in this version

type Option

+ func ConfigTemplateFunc(name string, f any) Option

Feb 11, 2024

Changes in this version

type Lifecycle

+ func (l *Lifecycle) PreBuild(hooks ...func(context.Context) error)

Jan 23, 2024

Changes in this version

+ func ConfigFromContext(ctx context.Context) config.Manager

+ type App struct

+ func New(opts ...Option) *App

+ func (app *App) Run(args ...string) error

+ type Lifecycle struct

+ func LifecycleFromContext(ctx context.Context) *Lifecycle

+ func (l *Lifecycle) PostRun(hooks ...func(context.Context) error)

+ func (l *Lifecycle) PreRun(hooks ...func(context.Context) error)

+ type Option func(*App)

+ func Config(r io.Reader) Option

+ func Hooks(fs ...func(*Lifecycle)) Option

+ func Name(name string) Option

+ func WithRuntimeBuilder(rb RuntimeBuilder) Option

+ func WithRuntimeBuilderFunc(f func(context.Context) (Runtime, error)) Option

+ type Runtime interface

+ Run func(context.Context) error

+ type RuntimeBuilder interface

+ Build func(context.Context) (Runtime, error)

+ type RuntimeBuilderFunc func(context.Context) (Runtime, error)

+ func (f RuntimeBuilderFunc) Build(ctx context.Context) (Runtime, error)