The best way of working with Protocol Buffers.
APACHE-2.0 License
Bot releases are hidden (Show)
Published by doriable 12 months ago
buf build
and other commands may fail when handling certainPublished by saquibmian about 1 year ago
--path
did not work with workspaces under certain scenarios.Published by elliotmjackson over 1 year ago
buf generate --include-types
with buf generate --type
for consistency. --include-types
is now deprecated but continues to work, consistent with our compability guarantee.google.protobuf.Any
messages in option values when filtering on type, e.g. with buf build --type
or buf generate --type
.protoc
path in buf.gen.yaml
when using protoc
's built-in plugins via the new protoc_path
option.buf.gen.yaml
. You can now do e.g. path: ["go, "run", ./cmd/protoc-gen-foo]
in addition to path: protoc-gen-foo
.buf mod init
, e.g. buf mod init buf.build/owner/foobar
.php_metadata_namespace
file option in managed mode.Published by elliotmjackson almost 2 years ago
enabled: false
now no longer fails buf generate
and instead prints a warning log and ignores managed mode options.csharp_namespace
option to managed mode, allowing except
, which excludes modules from managed mode, and override
, which specifies csharp_namespace
values per module, overriding the default value. By default, when managed mode is enabled, csharp_namespace
is set to the package name with each package sub-name capitalized.buf convert
to stable, keep buf beta convert
aliased in the beta command.Types
filter to buf generate
command to specify types (message, enum, service) that should be included in the image. When specified, the resulting image will only include descriptors to describe the requested types.Published by jhump about 2 years ago
LICENSE
file in the module on buf push
.buf beta convert
flags have changed from --input
to --from
and --output
/-o
to --to
input
argument and --type
flag separatelyPublished by njhale about 2 years ago
--origin
flag of buf beta studio-agent
to https://studio.buf.build
--timeout
flag of buf beta studio-agent
to 0
(no timeout). Before it was 2m
(the default for all the other buf
commands).plugin:
key in buf.gen.yaml
.buf format
.junit
format errors with --error-format
.Published by doriable about 2 years ago
--draft
flag to buf push
.buf beta registry draft {list,delete}
commands.Published by doriable over 2 years ago
// buf:lint:ignore
comment ignores did not work for the ENUM_FIRST_VALUE_ZERO
rule.buf beta studio-agent
command to support the upcoming Buf Studio.Published by doriable over 2 years ago
protoc
3.20.1 support.buf
would fail if two or more roots contained a file with the same name, but with different file types (i.e. a regular file vs. a directory).PACKAGE_SERVICE_NO_DELETE
to detect deleted services.buf beta registry track
.buf beta registry branch
.Published by doriable over 2 years ago
buf beta registry repository update
command which supports updating repository visibility (public vs private). As with all beta commands, this is likely to change in the future.Published by amckinney over 2 years ago
--config
flag to be set when targeting a module within a workspace.buf format
's file option order so that default file options are sorted before custom options.buf format
to write adjacent string literals across multiple lines.buf format
so that the output directory (if any) is created if and only if the input is successfully formatted.Published by doriable over 2 years ago
--exit code
flag to buf format
to exit with a non-zero exit code if the files were not already formatted.Published by amckinney over 2 years ago
buf format
edge cases.Published by amckinney over 2 years ago
buf format
command to format .proto
files.command-line-arguments
pseudo-package when building binaries and re-introduce checking for proper usage of private packages.Published by doriable over 2 years ago
Published by doriable over 2 years ago
--type
flag to the build
command to create filtered images containing only the specified types and their required dependencies.buf registry login
.buf beta convert
.Published by doriable over 2 years ago
buf registry login
.buf mod open
that opens a module's homepage in a browser.buf completion
command to generate auto-completion scripts in commonly used shells.--disable-symlinks
flag to the breaking, build, export, generate, lint, ls-files, push
commands. By default, the CLI will follow symlinks except on Windows, and this disables following symlinks.--include-wkt
flag to buf generate
. When this flag is specified alongside --include-imports
, this will result in the Well-Known Types being generated as well. Most language runtimes have the Well-Known Types included as part of the core library, making generating the Well-Known Types separately undesirable.buf protoc
. This was a pre-v1.0 demonstration to show that buf
compilation produces equivalent results to mainline protoc
, however buf
is working on building a better Protobuf future that provides easier mechanics than our former protoc
-based world. buf protoc
itself added no benefit over mainline protoc
beyond being considerably faster and allowing parallel compilation. If protoc
is required, move back to mainline protoc
until you can upgrade to buf
. See #915 for more details.buf registry login
to properly check the user provided token without the token being overriden by the CLI interceptor.buf config init
command in favor of buf mod init
.buf config ls-breaking-rules
command in favor of buf mod ls-breaking-rules
.buf config ls-lint-rules
command in favor of buf mod ls-lint-rules
.buf config migrate-v1beta1
command in favor of buf beta migrate-v1beta1
.buf beta decode
command to decode message with provided image source and message type.--config
flag for workspaces.v1beta1
to v1
.Published by doriable over 2 years ago
default
, except
and override
to java_package_prefix
.b3
digest.protoc
3.19.4 support.branch
field from buf.lock
.Published by bufdev almost 3 years ago
protoc
3.19.3 support.PACKAGE_NO_IMPORT_CYCLE
lint rule to detect package import cycles.buf beta registry {plugin,template} {deprecate,undeprecate}
.digest
, and created_at
fields from the buf.lock
. This will temporarily create a new commit when pushing the same contents to an existing repository, since the ModulePin
has been reduced down.buf
.Published by doriable almost 3 years ago