Buf v0.17.0 is released - remove branch/tag requirement and add ref and depth option to git inputs

[bufbuild-announce]

We have released Buf v0.17.0.

This release removes the requirement to specify the branch or tag when using git inputs. For example, it's now possible to do the following:

$ buf check lint --input https://github.com/bufbuild/buf.git

When no branch or tag is specified, the default branch on the remote will be used.

This release also adds the new ref and depth options for git inputs. The ref option is used to identify a specific git reference to compare against. A ref is defined as anything that is a valid input to git checkout. This option can also be used together with the branch option, to specify a branch to clone before performing the checkout. The depth option controls how deep the clone should be. This defaults to 50 when ref is used, and otherwise to 1, for speed. The ref option cannot be used together with the tag option. The following are some examples of things you can do with the new ref and depth options:

$ buf check lint --input https://github.com/bufbuild/buf.git#ref=7c0dc2fee4d20dcee8a982268ce35e66fc19cac8

$ buf check lint --input https://github.com/bufbuild/buf.git#ref=833e1da048711023bca59dea606c970b6c0ff2a4,depth=200

$ buf check lint --input https://github.com/bufbuild/buf.git#ref=refs/tags/v0.17.0

The brew tap and documentation have also been updated.