Expose latest matched version

[radeksimko]

Background

When installing a latest version e.g. via

• releases.LatestVersion
• checkpoint.LatestVersion

or even when discovering existing installation e.g. via fs.Version

it is currently impossible for the consumer to tell what version was installed after calling Install, Ensure or Find without executing the binary while the library internally already has the knowledge of the matched version.

Proposal

Expose matched version for the consumer

Considerations

This may require some breaking changes, e.g. returning a struct { ExecPath string, Version *version.Version } instead of just string (exec path) from the various methods like Install, Ensure and Find per https://pkg.go.dev/github.com/hashicorp/[email protected]/src