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

vessel

package module

Go to main page

Versions in this module

v1

v1.0.5

Nov 3, 2026

Changes in this version

+ const CodeCircularDependency

+ const CodeInvalidFactory

+ const CodeScopeEnded

+ const CodeServiceAlreadyExists

+ const CodeServiceError

+ const CodeServiceNotFound

+ const CodeTypeMismatch

+ var ErrCircularDependencySentinel = errs.NewError(CodeCircularDependency, "circular dependency", nil)

+ var ErrInvalidFactory = errs.NewError(CodeInvalidFactory, "factory cannot be nil", nil)

+ var ErrScopeEnded = errs.NewError(CodeScopeEnded, "scope has ended", nil)

+ var ErrServiceNotFoundSentinel = errs.NewError(CodeServiceNotFound, "service not found", nil)

+ var ErrTypeMismatchSentinel = errs.NewError(CodeTypeMismatch, "type mismatch", nil)

+ func ErrCircularDependency(cycle []string) *errs.Error

+ func ErrServiceAlreadyExists(serviceName string) *errs.Error

+ func ErrServiceNotFound(serviceName string) *errs.Error

+ func ErrTypeMismatch(serviceName string, actual any) *errs.Error

+ func HasTypeNamed[T any](c Vessel, name string) bool

+ func HasType[T any](c Vessel) bool

+ func InjectGroup[T any](c Vessel, group string) ([]T, error)

+ func InjectNamed[T any](c Vessel, name string) (T, error)

+ func InjectType[T any](c Vessel) (T, error)

+ func Inject[T any](c Vessel) (T, error)

+ func MustInjectGroup[T any](c Vessel, group string) []T

+ func MustInjectNamed[T any](c Vessel, name string) T

+ func MustInjectType[T any](c Vessel) T

+ func MustInject[T any](c Vessel) T

+ func NewServiceError(serviceName, operation string, cause error) *errs.Error

+ func Provide(c Vessel, constructor any, opts ...ConstructorOption) error

+ func ProvideConstructor(c Vessel, constructor any, opts ...ConstructorOption) error

+ func ProvideNamed(c Vessel, name string, constructor any, opts ...ConstructorOption) error

+ func ProvideValue[T any](c Vessel, value T, opts ...ConstructorOption) error

+ func QueryNames(c Vessel, query ServiceQuery) []string

+ type ConstructorOption interface

+ func As(ifaces ...any) ConstructorOption

+ func AsGroup(group string) ConstructorOption

+ func AsScoped() ConstructorOption

+ func AsSingleton() ConstructorOption

+ func AsTransient() ConstructorOption

+ func WithAliases(names ...string) ConstructorOption

+ func WithEager() ConstructorOption

+ func WithName(name string) ConstructorOption

+ type DependencyGraph struct

+ func NewDependencyGraph() *DependencyGraph

+ func (g *DependencyGraph) AddNode(name string, dependencies []string)

+ func (g *DependencyGraph) AddNodeWithDeps(name string, deps []di.Dep)

+ func (g *DependencyGraph) GetDependencies(name string) []string

+ func (g *DependencyGraph) GetDeps(name string) []di.Dep

+ func (g *DependencyGraph) GetEagerDependencies(name string) []string

+ func (g *DependencyGraph) HasNode(name string) bool

+ func (g *DependencyGraph) TopologicalSort() ([]string, error)

+ func (g *DependencyGraph) TopologicalSortEagerOnly() ([]string, error)

+ type Factory = di.Factory

+ type FuncMiddleware struct

+ AfterResolveFunc func(ctx context.Context, name string, service any, err error) error

+ AfterStartFunc func(ctx context.Context, name string, err error) error

+ BeforeResolveFunc func(ctx context.Context, name string) error

+ BeforeStartFunc func(ctx context.Context, name string) error

+ func (f *FuncMiddleware) AfterResolve(ctx context.Context, name string, service any, err error) error

+ func (f *FuncMiddleware) AfterStart(ctx context.Context, name string, err error) error

+ func (f *FuncMiddleware) BeforeResolve(ctx context.Context, name string) error

+ func (f *FuncMiddleware) BeforeStart(ctx context.Context, name string) error

+ type In struct

+ type Lazy struct

+ func NewLazy[T any](container di.Container, name string) *Lazy[T]

+ func (l *Lazy[T]) Get() (T, error)

+ func (l *Lazy[T]) IsResolved() bool

+ func (l *Lazy[T]) MustGet() T

+ func (l *Lazy[T]) Name() string

+ type Middleware interface

+ AfterResolve func(ctx context.Context, name string, service any, err error) error

+ AfterStart func(ctx context.Context, name string, err error) error

+ BeforeResolve func(ctx context.Context, name string) error

+ BeforeStart func(ctx context.Context, name string) error

+ type OptionalLazy struct

+ func NewOptionalLazy[T any](container di.Container, name string) *OptionalLazy[T]

+ func (l *OptionalLazy[T]) Get() (T, error)

+ func (l *OptionalLazy[T]) IsFound() bool

+ func (l *OptionalLazy[T]) IsResolved() bool

+ func (l *OptionalLazy[T]) MustGet() T

+ func (l *OptionalLazy[T]) Name() string

+ type Out struct

+ type Provider struct

+ func NewProvider[T any](container di.Container, name string) *Provider[T]

+ func (p *Provider[T]) MustProvide() T

+ func (p *Provider[T]) Name() string

+ func (p *Provider[T]) Provide() (T, error)

+ type RegisterOption = di.RegisterOption

+ type Scope = di.Scope

+ type ServiceInfo = di.ServiceInfo

+ func FindByGroup(c Vessel, group string) []ServiceInfo

+ func FindByLifecycle(c Vessel, lifecycle string) []ServiceInfo

+ func FindNotStarted(c Vessel) []ServiceInfo

+ func FindStarted(c Vessel) []ServiceInfo

+ func Query(c Vessel, query ServiceQuery) []ServiceInfo

+ type ServiceQuery struct

+ Group string

+ Lifecycle string

+ Metadata map[string]string

+ Started *bool

+ type Vessel = di.Container

+ func New() Vessel

v1.0.4

Aug 1, 2026

v1.0.3

Apr 13, 2026

v1.0.2

Apr 13, 2026

v1.0.1

Apr 12, 2026

v1.0.0

Feb 27, 2026

v0

v0.0.5

Feb 16, 2026

v0.0.4

Feb 15, 2026

v0.0.3

Jan 15, 2026

v0.0.2

Jan 15, 2026

v0.0.1

Jan 11, 2026