5c5c92a1c5
An unfortunate bug caused a number of packages in old x/tools versions to fail to build with Go 1.25 (https://go.dev/issue/74462). Fix this minimally by updating to the lowest patched version with the fix: v0.24.1. This should allow wire to continue building with the same range of Go versions as it could build with before (down to 1.19). Also: - Update the go.mod go directive to Go 1.19 to allow for module graph pruning, and to be consistent with the minimum build version. - Fix a test that is broken in recent Go versions due to an error message change. - Update tests to run on Go 1.25.x (the most recent version of Go). - Remove coverage, since coverage upload wasn't working anyway. Fixes #431
60 lines
1.8 KiB
Markdown
60 lines
1.8 KiB
Markdown
# Wire: Automated Initialization in Go
|
|
|
|
[](https://github.com/google/wire/actions)
|
|
[][godoc]
|
|
|
|
|
|
Wire is a code generation tool that automates connecting components using
|
|
[dependency injection][]. Dependencies between components are represented in
|
|
Wire as function parameters, encouraging explicit initialization instead of
|
|
global variables. Because Wire operates without runtime state or reflection,
|
|
code written to be used with Wire is useful even for hand-written
|
|
initialization.
|
|
|
|
For an overview, see the [introductory blog post][].
|
|
|
|
[dependency injection]: https://en.wikipedia.org/wiki/Dependency_injection
|
|
[introductory blog post]: https://blog.golang.org/wire
|
|
[godoc]: https://godoc.org/github.com/google/wire
|
|
[travis]: https://travis-ci.com/google/wire
|
|
|
|
## Installing
|
|
|
|
Install Wire by running:
|
|
|
|
```shell
|
|
go install github.com/google/wire/cmd/wire@latest
|
|
```
|
|
|
|
and ensuring that `$GOPATH/bin` is added to your `$PATH`.
|
|
|
|
## Documentation
|
|
|
|
- [Tutorial][]
|
|
- [User Guide][]
|
|
- [Best Practices][]
|
|
- [FAQ][]
|
|
|
|
[Tutorial]: ./_tutorial/README.md
|
|
[Best Practices]: ./docs/best-practices.md
|
|
[FAQ]: ./docs/faq.md
|
|
[User Guide]: ./docs/guide.md
|
|
|
|
## Project status
|
|
|
|
As of version v0.3.0, Wire is *beta* and is considered feature complete. It
|
|
works well for the tasks it was designed to perform, and we prefer to keep it
|
|
as simple as possible.
|
|
|
|
We'll not be accepting new features at this time, but will gladly accept bug
|
|
reports and fixes.
|
|
|
|
## Community
|
|
|
|
For questions, please use [GitHub Discussions](https://github.com/google/wire/discussions).
|
|
|
|
This project is covered by the Go [Code of Conduct][].
|
|
|
|
[Code of Conduct]: ./CODE_OF_CONDUCT.md
|
|
[go-cloud mailing list]: https://groups.google.com/forum/#!forum/go-cloud
|