do - Dependency Injection

⚙️ A dependency injection toolkit based on Go 1.18+ Generics.

This library implements the Dependency Injection design pattern. It may replace the fantastic uber/dig package. samber/do uses Go 1.18+ generics and therefore offers a type‑safe API.

See also:

• samber/lo: A Lodash-style Go library based on Go 1.18+ Generics
• samber/mo: Monads based on Go 1.18+ Generics (Option, Result, Either...)

Why this name?

I love the short name for such a utility library. This name is the sum of DI and Go and no Go package uses this name.

💡 Features

• 📒 Service registration
• Register by type
• Register by name
• Register multiple services from a package at once
• 🪃 Service invocation
• Eager loading
• Lazy loading
• Transient loading
• Tag-based invocation
• Circular dependency detection
• 🧙‍♂️ Service aliasing
• Implicit (provide struct, invoke interface)
• Explicit (provide struct, bind interface, invoke interface)
• 🔁 Service lifecycle
• Health check
• Graceful unload (shutdown)
• Dependency-aware parallel shutdown
• Lifecycle hooks
• 📦 Scope (a.k.a module) tree
• Visibility control
• Dependency grouping
• 📤 Container
• Dependency graph resolution and visualization
• Default container
• Container cloning
• Service override
• 🧪 Debugging & introspection
• Explain APIs: scope tree and service dependencies
• Web UI & HTTP middleware (std, Gin, Fiber, Echo, Chi)
• 🌈 Lightweight, no dependencies
• 🔅 No code generation
• 😷 Type‑safe API

🚀 Install

# v2 (latest)
go get github.com/samber/do@v2

# v1
go get github.com/samber/do

This library is v2 and follows SemVer strictly.

No breaking changes will be made to exported APIs before v3.0.0.

This library has no dependencies except the Go std lib.

🔥 Migration from v1 to v2

Documentation here

🤠 Documentation

• GoDoc: https://godoc.org/github.com/samber/do/v2
• Documentation
• Examples
• Project templates

🤝 Contributing

• Ping me on Twitter @samuelberthe (DMs, mentions, whatever :))
• Fork the project
• Fix open issues or request new features

Don't hesitate ;)

# Install some dev dependencies
make tools

# Run tests
make test
# or
make watch-test

👤 Contributors

💫 Show your support

Give a ⭐️ if this project helped you!

📝 License

Copyright © 2022 Samuel Berthe.

This project is MIT licensed.