The best way of working with Protocol Buffers.
APACHE-2.0 License
Bot releases are visible (Hide)
Published by bufdev about 3 years ago
java_package_prefix
support to managed mode.:main
was appended for errors containing references to modules.Published by bufdev about 3 years ago
buf generate --include-imports
would end up generating files for certain imports twice.buf.mod
and buf.yaml
are present. buf.mod
was briefly used as the new default name for buf.yaml
, but we've reverted back to buf.yaml
.Return error for all invocations of protoc-gen-buf-check-breaking
and protoc-gen-buf-check-lint
.
As one of the few changes buf will ever make, protoc-gen-buf-check-breaking
and protoc-gen-buf-check-lint
were deprecated and scheduled for removal for v1.0 in January 2021. In preparation for v1.0, instead of just printing out a message notifying users of this, these commands now return an error for every invocation and will be completely removed when v1.0 is released.
The only migration necessary is to change your installation and invocation from protoc-gen-buf-check-breaking
to protoc-gen-buf-breaking
andprotoc-gen-buf-check-lint
to protoc-gen-buf-lint
. These can be installed in the exact same manner, whether from GitHub Releases, Homebrew, AUR, or direct Go installation:
# instead of go get github.com/bufbuild/buf/cmd/protoc-gen-buf-check-breaking
go get github.com/bufbuild/buf/cmd/protoc-gen-buf-breaking
# instead of curl -sSL https://github.com/bufbuild/buf/releases/download/v0.52.0/protoc-gen-buf-check-breaking-Linux-x86_64
curl -sSL https://github.com/bufbuild/buf/releases/download/v0.52.0/protoc-gen-buf-breaking-Linux-x86_64
There is no change in functionality.
Published by bufdev about 3 years ago
Published by bufdev about 3 years ago
v\d+alpha
and v\d+beta
as packages with valid versions. These will be considered unstable packages for the purposes of linting and breaking change detection if ignore_unstable_packages
is set.Published by bufdev about 3 years ago
buf generate --include-imports
that also generates all imports except for the Well-Known Types.PACKAGE
category was used and ignore_unstable_packages
was set.Published by bufdev about 3 years ago
FIELD_SAME_TYPE
breaking change rule into FIELD_SAME_TYPE, FIELD_WIRE_COMPATIBLE_TYPE, FIELD_WIRE_JSON_COMPATIBLE_TYPE
in v1
. See https://github.com/bufbuild/buf/pull/400 for details.buf export
.Published by robbertvanginkel about 3 years ago
Published by bufdev about 3 years ago
-c
on git
parent command instead of --config
on git fetch
.ruby_package
to managed mode.Published by bufdev about 3 years ago
buf export
. buf export
will export the files from the specified input (default "."
) to the given directory in a manner that is buildable by protoc
without any -I
flags. It also has options --exclude-imports
, which excludes imports (and won't result in a buildable set of files), and --path
, which filters to the specific paths.Published by bufdev about 3 years ago
git init && git fetch
rather than git clone
. git clone
is limited to local branches on the remote, whereas git fetch
we can fetch any references on the remote including remote branches.php_namespace
managed mode handling.java_string_check_utf8
managed mode handling.Published by bufdev about 3 years ago
buf login
and buf logout
to login and logout from the Buf Schema Registry.buf
largely works on Windows.Published by bufdev about 3 years ago
buf.mod
to buf.yaml
. Note that both continue to work.buf.work
to buf.work.yaml
. Note that both continue to work.buf beta push
to buf push
. Note that buf beta push
continues to work.buf beta mod
commands to buf mod
. Note that all buf beta mod
commands continue to work.--only
flag to buf mod update
.buf.yaml
contains dependencies that are not represented in the buf.lock
file.--version
flag to buf config ls-{breaking,lint}-rules
.SYNTAX_SPECIFIED
lint rule to BASIC, DEFAULT
categories for v1 configuration.IMPORT_USED
lint rule to BASIC, DEFAULT
categories for v1 configuration.objc_class_prefix
, csharp_namespace
.Published by bufdev over 3 years ago
buf protoc -I
by a directory separator.protoc
plugins when using buf generate
or buf protoc
. Note that Windows remains officially unsupported as we have not set up testing, but largely works.protoc
3.17.3 support.buf.yaml
to buf.mod
. Note that buf.yaml
continues to work.v1
configuration specification.v1
configuration specification.v1
module configuration specification in beta - please continue to use v1beta1
until the v1
configuration specification is rolled out.buf config migrate-v1beta1
.Published by bufdev over 3 years ago
Published by bufdev over 3 years ago
protoc
namespace resolution diff change.Published by bufdev over 3 years ago
buf:lint:ignore
directives as valid comments for the COMMENT_.*
lint rules.protoc
3.17.1 support.protoc
.Published by bufdev over 3 years ago
arm64
to aarch64
to match the output of uname -m
on Linux.Published by bufdev over 3 years ago
Published by amckinney over 3 years ago
MESSAGE_SAME_REQUIRED_FIELDS
breaking change rule. This checks to make sure no required
fields are added or deleted from existing messages.FileAnnotation
errors.