Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

runtime

package

Go to main page

Versions in this module

v0

v0.3.2

Nov 3, 2026

v0.3.1

Oct 21, 2026

v0.3.0

Oct 17, 2026

v0.2.3

Sep 13, 2026

v0.2.2

Aug 21, 2026

v0.2.1

Aug 20, 2026

v0.2.0

Aug 20, 2026

v0.1.5

Jun 16, 2026

v0.1.4

Jun 2, 2026

v0.1.3

May 22, 2026

v0.1.2

May 22, 2026

v0.1.1

May 21, 2026

v0.1.0

May 20, 2026

Changes in this version

+ const ContainerKey

+ const CronKey

+ const CronRuntimeConfiguratorKey

+ const GRPCRuntimeBuilderKey

+ const HTTPRuntimeConfiguratorKey

+ const HostKey

+ const RootKey

+ var ErrCircularDependency = errors.New("circular dependency detected")

+ var ErrContainerDestroyed = errors.New("container is destroyed")

+ type AppService interface

+ type CircularDependencyError struct

+ Chain []string

+ Key string

+ func (e *CircularDependencyError) Error() string

+ func (e *CircularDependencyError) Is(target error) bool

+ func (e *CircularDependencyError) Unwrap() error

+ type Container interface

+ Bind func(key string, factory Factory, singleton bool)

+ DebugPrint func() string

+ Destroy func() error

+ IsBind func(key string) bool

+ IsBindNamed func(name, key string) bool

+ Make func(key string) (any, error)

+ MakeNamed func(name, key string) (any, error)

+ MustMake func(key string) any

+ MustMakeNamed func(name, key string) any

+ NamedBind func(name, key string, factory Factory, singleton bool)

+ ProviderDAG func() ProviderDAG

+ RegisterCloser func(key string, closer io.Closer)

+ RegisterProvider func(p ServiceProvider) error

+ RegisterProviders func(providers ...ServiceProvider) error

+ RegisteredProviders func() []ProviderInfo

+ type Cron interface

+ Add func(spec string, fn func(ctx context.Context) error) (entryID int, err error)

+ AddNamed func(name, spec string, fn func(ctx context.Context) error) (entryID int, err error)

+ Jobs func() []CronJobEntry

+ Start func()

+ Stop func() context.Context

+ type CronJobEntry struct

+ ID int

+ LastDuration time.Duration

+ LastError string

+ LastRunTime time.Time

+ Name string

+ NextRunTime time.Time

+ Spec string

+ Status CronJobStatus

+ type CronJobStatus string

+ const CronJobStatusError

+ const CronJobStatusPending

+ const CronJobStatusRunning

+ const CronJobStatusSuccess

+ type CronRuntimeConfigurator interface

+ ConfigureCronRuntime func(Container) (int, error)

+ type DAGEdge struct

+ From string

+ Key string

+ To string

+ type Factory func(Container) (any, error)

+ type GRPCRuntimeBuilder interface

+ BuildGRPCServer func() *grpc.Server

+ type HTTPRuntimeConfigurator interface

+ ConfigureHTTPRuntime func(Container) error

+ type Host interface

+ RegisterService func(name string, service Hostable) error

+ Services func() []string

+ Shutdown func(ctx context.Context) error

+ Start func(ctx context.Context) error

+ Stop func(ctx context.Context) error

+ type Hostable interface

+ Name func() string

+ Start func(ctx context.Context) error

+ Stop func(ctx context.Context) error

+ type Lifecycle interface

+ OnStarted func(ctx context.Context) error

+ OnStarting func(ctx context.Context) error

+ OnStopped func(ctx context.Context) error

+ OnStopping func(ctx context.Context) error

+ type ProviderDAG struct

+ Cycles [][]string

+ Edges []DAGEdge

+ LoadOrder []string

+ Nodes []ProviderDAGNode

+ type ProviderDAGNode struct

+ Booted bool

+ DependsOn []string

+ IsDefer bool

+ Loaded bool

+ Name string

+ Provides []string

+ type ProviderInfo struct

+ Booted bool

+ IsDefer bool

+ Loaded bool

+ Name string

+ type Root interface

+ BasePath func() string

+ ConfigPath func() string

+ LogPath func() string

+ RuntimePath func() string

+ StoragePath func() string

+ TempPath func() string

+ type ServiceProvider interface

+ Boot func(c Container) error

+ DependsOn func() []string

+ IsDefer func() bool

+ Name func() string

+ Provides func() []string

+ Register func(c Container) error

+ type UnitOfWork interface

+ Do func(ctx context.Context, fn func(ctx context.Context) error) error