samber/cc-skills-golang / skills/golang-uber-dig
golang-uber-dig
VerifiedImplements dependency injection in Golang using uber-go/dig — reflection-based container, Provide/Invoke, dig.In/dig.Out parameter and result objects, named values, value groups, optional dependencies, scopes, and Decorate. Apply when using or adopting uber-go/dig, when the codebase imports `go.uber.org/dig`, or when wiring an application graph at startup. For higher-level lifecycle and modules, see `samber/cc-skills-golang@golang-uber-fx` skill.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.4 KB |
| evals/evals.json | config | 12.1 KB |
| references/advanced.md | markdown | 4.9 KB |
| references/recipes.md | markdown | 7.3 KB |
| references/testing.md | markdown | 3.9 KB |
references/testing.md
View on GitHub# Testing with uber-go/dig
dig containers are cheap to create. Build a fresh one per test, override what you need, drive the system with `Invoke`.
## Table of Contents
- [Per-test container](#per-test-container)
- [Shared test wiring](#shared-test-wiring)
- [Validate the production graph in CI](#validate-the-production-graph-in-ci)
- [Detecting cycles before deploy](#detecting-cycles-before-deploy)
- [Asserting a constructor's error path](#asserting-a-constructors-error-path)
- [Recovering from constructor panics](#recovering-from-constructor-panics)
## Per-test container
```go
func TestUserService_Create(t *testing.T) {
c := dig.New()
fakeDB := &fakeDatabase{}
require.NoError(t, c.Provide(func() Database { return fakeDB }))
require.NoError(t, c.Provide(NewUserService))
require.NoError(t, c.Invoke(func(s *UserService) {
err := s.Create(context.Background(), "alice@example.com")
require.NoError(t, err)
}))
require.Len(t, fakeDB.inserted, 1)
}
```
## Shared test wiring
For larger suites, factor the common providers into a helper:
```go
func newTestContainer(t *testing.T, overrides ...func(*dig.Container)) *dig.Container {
t.Helper()
c := dig.New()
require.NoError(t, c.Provide(NewTestLogger))
require.NoError(t, c.Provide(NewInMemoryCache))
require.NoError(t, c.Provide(func() Database { return &fakeDatabase{} }))
require.NoError(t, c.Provide(NewUserService))
for _, override := range overrides {
override(c)
}
return c
}
func TestUserService_NotFound(t *testing.T) {
c := newTestContainer(t, func(c *dig.Container) {
// Replace the default DB with one that returns sql.ErrNoRows.
require.NoError(t, c.Decorate(func(db Database) Database {
return ¬FoundDB{Database: db}
}))
})
require.NoError(t, c.Invoke(func(s *UserService) {
_, err := s.Get(context.Background(), "missing")
require.ErrorIs(t, err, ErrUserNotFound)
}))
}
```
`Decorate` is the cleanest way to swap a dependency in tests — the test reads almost like production wiring with one extra line.
## Validate the production graph in CI
```go
func TestProductionGraph(t *testing.T) {
c := dig.New(dig.DryRun(true))
// Replicate every Provide() from main()
require.NoError(t, registerAll(c))
// Invoke the same root the production binary does
require.NoError(t, c.Invoke(func(*http.Server, *Worker, *MetricsExporter) {}))
}
```
`DryRun(true)` skips constructor execution — the graph is validated structurally. This catches missing-provider and type-mismatch errors without spinning up real DB connections.
## Detecting cycles before deploy
A cyclic graph fails at the first `Invoke` (or at `Provide` time when `DeferAcyclicVerification` is off, which is the default):
```go
func TestNoCycles(t *testing.T) {
c := dig.New()
require.NoError(t, registerAll(c))
err := c.Invoke(func(*App) {})
require.False(t, dig.IsCycleDetected(err), "cycle in dependency graph: %v", err)
}
```
## Asserting a constructor's error path
When a constructor returns an error, dig wraps it with the dependency path. Use `dig.RootCause` to assert the original error:
```go
func TestDBProvider_BadDSN(t *testing.T) {
c := dig.New()
require.NoError(t, c.Provide(func() *Config {
return &Config{DSN: "not a dsn"}
}))
require.NoError(t, c.Provide(NewDB))
err := c.Invoke(func(*sql.DB) {})
require.Error(t, err)
require.ErrorContains(t, dig.RootCause(err), "invalid connection string")
}
```
## Recovering from constructor panics
Wrap constructors that may panic on misuse so the test reports a typed error instead of crashing the runner:
```go
c := dig.New(dig.RecoverFromPanics())
require.NoError(t, c.Provide(func() *App {
panic("intentionally broken")
}))
err := c.Invoke(func(*App) {})
var pe dig.PanicError
require.True(t, errors.As(err, &pe))
require.Contains(t, pe.Error(), "intentionally broken")
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |