status-go/vendor/go.uber.org/dig/CHANGELOG.md

319 lines
11 KiB
Markdown
Raw Permalink Normal View History

# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
## [1.18.0] - 2024-08-07
### Added
- Child scope constructors are now visualized via `Visualize`
- `CallbackInfo` now includes constructor/decorator run time.
Thanks to @greeflas for their contribution to this release.
[1.18.0]: https://github.com/uber-go/dig/compare/v1.17.1...v1.18.0
2024-05-15 23:15:00 +00:00
## [1.17.1] - 2023-10-19
### Added
- Suggestions for value vs. pointer elements for slice and array types.
### Fixed
- An issue where value group values were not getting decorated
by decorators within the same module when using dig.Export(true).
- A typo in docs.
- An issue where false positives in cycle detection were occurring
when providing to a child scope.
Thanks to @paullen and @lcarilla for their contributions to this release.
[1.17.1]: https://github.com/uber-go/dig/compare/v1.17.0...v1.17.1
## [1.17.0] - 2023-05-02
### Added
- Allow using `dig.As` with `dig.Group`.
- Add `FillInvokeInfo` Option and `InvokeInfo` struct to help
extract the types requested by an `Invoke` statement.
- To get visibility into constructor and decorator calls, introduce
2024-05-15 23:15:00 +00:00
`WithProviderCallback` and `WithDecoratorCallback` Options to provide callback functions.
[1.17.0]: https://github.com/uber-go/dig/compare/v1.16.1...v1.17.0
2023-05-19 20:23:55 +00:00
## [1.16.1] - 2023-01-10
### Fixed
- A panic when `DryRun` was used with `Decorate`.
[1.16.1]: https://github.com/uber-go/dig/compare/v1.16.0...v1.16.1
## [1.16.0] - 2023-01-03
### Added
- Add `RecoverFromPanics` option, which provides panic-recovery mechanism for Container.
- Add `Error` interface which enables distinguishing errors from Dig using standard `errors`
package.
Thanks to @mie998 for their contribution(s) to this release.
[1.16.0]: https://github.com/uber-go/dig/compare/v1.15.0...v1.16.0
## [1.15.0] - 2022-08-02
### Added
- Support for `soft` value groups, which specify a value group that only gets populated
with values from already-executed constructors.
### Fixed
- Fix an issue with invoke order affecting results provided by private provides
Thanks to @hbdf for their contributions to this release.
[1.15.0]: https://github.com/uber-go/dig/compare/v1.14.1...v1.15.0
## [1.14.1] - 2022-03-22
### Fixed
- Fix an issue where a dependency for a decoration supplied by another decorator in the
same scope is ignored.
- Fix a panic when submitting a single value as a value group in `Scope.Decorate`.
- Upon a provide error, make the error message contain the function named specified
by LocationForPC Option.
[1.14.1]: https://github.com/uber-go/dig/compare/v1.14.0...v1.14.1
## [1.14.0] - 2022-02-23
### Added
- Introduce `dig.Scope` which creates a scoped dependency injection
container to scope dependencies.
- Introduce `Scope.Decorate` and `Container.Decorate` which allows a
decorator to modify a dependency already provided in the dependency graph.
- Add `FillDecorateInfo` Option and `DecorateInfo` struct which exposes
information on what Dig was able to understand from the decorator provided
with `Scope.Decorate` or `Container.Decorate`.
### Changed
- The error message that appears when a cycle is detected in the dependency graph
has been changed slightly.
### Fixed
- A stack overflow bug that happens when cycles are introduced via self-pointing
dependencies with DeferAcyclicVerification.
[1.14.0]: https://github.com/uber-go/dig/compare/v1.13.0...v1.14.0
## [1.13.0] - 2021-09-21
### Added
- Introduce `As` option which supports providing a type as interface(s)
it implements to the container.
- Add `LocationForPC` option which overrides the function inspection
for a program counter address to a provided function info.
[1.13.0]: https://github.com/uber-go/dig/compare/v1.12.0...v1.13.0
## [1.12.0] - 2021-07-29
### Added
- Support for ProvideInfo and FillProvideInfo that allow the caller of
`Provide` to get info about what dig understood from the constructor.
[1.12.0]: https://github.com/uber-go/dig/compare/v1.11.0...v1.12.0
## [1.11.0] - 2021-06-09
### Added
- Support unexported fields on `dig.In` structs with the
`ignore-unexported:"true` struct tag.
[1.11.0]: https://github.com/uber-go/dig/compare/v1.10.0...v1.11.0
## [1.10.0] - 2020-06-16
### Added
- Introduce `DryRun` Option which, when set to true, disables invocation
of functions supplied to `Provide` and `Invoke`. This option will be
used to build no-op containers, for example for `fx.ValidateApp` method.
[1.10.0]: https://github.com/uber-go/dig/compare/v1.9.0...v1.10.0
## [1.9.0] - 2020-03-31
### Added
- GraphViz visualization of the graph now includes names of packages next to
constructors.
- Added a `flatten` modifier to group tags for slices to allow providing
individual elements instead of the slice for a group value. See package
doucmentation for more information.
### Changed
- Drop library dependency on `golang.org/x/lint`.
- Support printing multi-line error messages with `%+v`.
[1.9.0]: https://github.com/uber-go/dig/compare/v1.8.0...v1.9.0
## [1.8.0] - 2019-11-14
### Changed
- Migrated to Go modules.
[1.8.0]: https://github.com/uber-go/dig/compare/v1.7.0...v1.8.0
## [1.7.0] - 2019-01-04
### Added
- Added `Group` option for `Provide` to add value groups to the container without
rewriting constructors. See package doucmentation for more information.
[1.7.0]: https://github.com/uber-go/dig/compare/v1.6.0...v1.7.0
## [1.6.0] - 2018-11-06
### Changed
- When an error graph is visualized, the graph is pruned so that the graph only
contains failure nodes.
- Container visualization is now oriented from right to left.
[1.6.0]: https://github.com/uber-go/dig/compare/v1.5.1...v1.6.0
## [1.5.1] - 2018-11-01
### Fixed
- Fixed a test that was causing Dig to be unusable with Go Modules.
[1.5.1]: https://github.com/uber-go/dig/compare/v1.5.0...v1.5.1
## [1.5.0] - 2018-09-19
### Added
- Added a `DeferAcyclicVerification` container option that defers graph cycle
detection until the next Invoke.
### Changed
- Improved cycle-detection performance by 50x in certain degenerative cases.
[1.5.0]: https://github.com/uber-go/dig/compare/v1.4.0...v1.5.0
## [1.4.0] - 2018-08-16
### Added
- Added `Visualize` function to visualize the state of the container in the
GraphViz DOT format. This allows visualization of error types and the
dependency relationships of types in the container.
- Added `CanVisualizeError` function to determine if an error can be visualized
in the graph.
- Added `Name` option for `Provide` to add named values to the container
without rewriting constructors. See package documentation for more
information.
### Changed
- `name:"..."` tags on nested Result Objects will now cause errors instead of
being ignored.
[1.4.0]: https://github.com/uber-go/dig/compare/v1.3.0...v1.4.0
## [1.3.0] - 2017-12-04
### Changed
- Improved messages for errors thrown by Dig under a many scenarios to be more
informative.
[1.3.0]: https://github.com/uber-go/dig/compare/v1.2.0...v1.3.0
## [1.2.0] - 2017-11-07
### Added
- `dig.In` and `dig.Out` now support value groups, making it possible to
produce many values of the same type from different constructors. See package
documentation for more information.
[1.2.0]: https://github.com/uber-go/dig/compare/v1.1.0...v1.2.0
## [1.1.0] - 2017-09-15
### Added
- Added the `dig.RootCause` function which allows retrieving the original
constructor error that caused an `Invoke` failure.
### Changed
- Errors from `Invoke` now attempt to hint to the user a presence of a similar
type, for example a pointer to the requested type and vice versa.
[1.1.0]: https://github.com/uber-go/dig/compare/v1.0.0...v1.1.0
## [1.0.0] - 2017-07-31
First stable release: no breaking changes will be made in the 1.x series.
### Changed
- `Provide` and `Invoke` will now fail if `dig.In` or `dig.Out` structs
contain unexported fields. Previously these fields were ignored which often
led to confusion.
[1.0.0]: https://github.com/uber-go/dig/compare/v1.0.0-rc2...v1.0.0
## [1.0.0-rc2] - 2017-07-21
### Added
- Exported `dig.IsIn` and `dig.IsOut` so that consuming libraries can check if
a params or return struct embeds the `dig.In` and `dig.Out` types, respectively.
### Changed
- Added variadic options to all public APIS so that new functionality can be
introduced post v1.0.0 without introducing breaking changes.
- Functions with variadic arguments can now be passed to `dig.Provide` and
`dig.Invoke`. Previously this caused an error, whereas now the args will be ignored.
[1.0.0-rc2]: https://github.com/uber-go/dig/compare/v1.0.0-rc1...v1.0.0-rc2
## [1.0.0-rc1] - 2017-06-21
First release candidate.
[1.0.0-rc1]: https://github.com/uber-go/dig/compare/v0.5.0...v1.0.0-rc1
## [0.5.0] - 2017-06-19
### Added
- `dig.In` and `dig.Out` now support named instances, i.e.:
```go
type param struct {
dig.In
DB1 DB.Connection `name:"primary"`
DB2 DB.Connection `name:"secondary"`
}
```
### Fixed
- Structs compatible with `dig.In` and `dig.Out` may now be generated using
`reflect.StructOf`.
[0.5.0]: https://github.com/uber-go/dig/compare/v0.4.0...v0.5.0
## [0.4.0] - 2017-06-12
### Added
- Add `dig.In` embeddable type for advanced use-cases of specifying dependencies.
- Add `dig.Out` embeddable type for advanced use-cases of constructors
inserting types in the container.
- Add support for optional parameters through `optional:"true"` tag on `dig.In` objects.
- Add support for value types and many built-ins (maps, slices, channels).
### Changed
- **[Breaking]** Restrict the API surface to only `Provide` and `Invoke`.
- **[Breaking]** Update `Provide` method to accept variadic arguments.
### Removed
- **[Breaking]** Remove `Must*` funcs to greatly reduce API surface area.
- Providing constructors with common returned types results in an error.
[0.4.0]: https://github.com/uber-go/dig/compare/v0.3...v0.4.0
## [0.3] - 2017-05-02
### Added
- Add functionality to `Provide` to support constructor with `n` return
objects to be resolved into the `dig.Graph`
- Add `Invoke` function to invoke provided function and insert return
objects into the `dig.Graph`
### Changed
- Rename `RegisterAll` and `MustRegisterAll` to `ProvideAll` and
`MustProvideAll`.
[0.3]: https://github.com/uber-go/dig/compare/v0.2...v0.3
## [0.2] - 2017-03-27
### Changed
- Rename `Register` to `Provide` for clarity and to recude clash with other
Register functions.
- Rename `dig.Graph` to `dig.Container`.
### Removed
- Remove the package-level functions and the `DefaultGraph`.
[0.2]: https://github.com/uber-go/dig/compare/v0.1...v0.2
## 0.1 - 2017-03-23
Initial release.