Links
Comment on page

Dependency Injection

Copper uses google/wire to enable dependency injection. Check out the introductory blog post to learn more about dependency injection and Wire.
In a Copper project, each package has a wire.go file. This file is autogenerated if you use the Copper CLI to create your package directories.
$ copper scaffold:pkg <package>

Example

Let's say you have the following struct that requires rockets.Queries and clogger.Logger for its methods.
type Launcher struct {
rockets *rockets.Queries
logger clogger.Logger
}
func (l *Launcher) Launch(ctx context.Context, rocketID string) error {
// ...
}
To enable automating wiring up of all dependencies, create a constructor for the Launcher struct.
func NewLauncher(r *rockets.Queries, l clogger.Logger) *Launcher {
return &Launcher{
rockets: r,
logger: l,
}
}
Finally, add the constructor to the package's WireModule defined in the wire.go file.
var WireModule = wire.NewSet(
NewLauncher,
)
That's it! Copper + Wire will automatically pass in the correct dependencies to the NewLauncher constructor.