@bufbuild/buf-darwin-x64
Advanced tools
Changelog
[v1.40.1] - 2024-09-06
buf lint
where comment ignores in the shape of // buf:lint:ignore <RULE_ID> <extra comment>
were not recognized due to the extra comment.Changelog
[v1.40.0] - 2024-09-04
buf config ls-{breaking,lint}-rules
. Default rules are those rules which are run if no lint
or breaking rules are explicitly configured in your buf.yaml
.DEFAULT
lint rule category to STANDARD
. With the concept of default rules being introduced,
having a category named DEFAULT
is confusing, as while it happens that all the rules in the DEFAULT
lint category are also default rules, the name has become overloaded. As with all buf
changes, this
change is backwards-compatible: the DEFAULT
lint category continues to work, and always will. We
recommend changing to STANDARD
, however.Changelog
[v1.39.0] - 2024-08-27
includes
key to module configurations in v2 buf.yaml
, accepting a list of directories.
includes
is specified, a proto file is considered in the module only if it is in one of the
directories specified.includes
and excludes
keys are specified for a module, a proto file is considered
part of this module if it is contained in any of the include paths and not in any of the exclude
paths.buf.yaml
to have the same directory path.Changelog
[v1.38.0] - 2024-08-22
--http3
flag to buf curl
which forces buf curl
to use HTTP/3 as the transport.buf.lock
files when buf dep update
does not find new dependencies
to update and there is no existing buf.lock
.buf push
to push the license file or doc file (e.g. README.md
, LICENSE
) in the
same directory as buf.yaml
if a module does not have a license file or doc file in the
module's directory.--path
flag for lint and breaking rules to avoid resolving all files
within a module. This change can result in a performance improvement for large workspaces.Changelog
[v1.37.0] - 2024-08-16
STABLE_PACKAGE_NO_IMPORT_UNSTABLE
lint rule which disallows files from stable packages
to import files from unstable packages.Changelog
[v1.36.0] - 2024-08-06
--list-services
and --list-methods
flags to buf curl
, which trigger the command to list
known services or methods in the RPC schema, instead of invoking an RPC method.clean
as a top-level option in buf.gen.yaml
, matching the buf generate --clean
flag. If
set to true, this will delete the directories, jar files, or zip files set to out
for each
plugin.buf registry login
to complete the login flow in the browser by default. This allows
users to login with their browser and have the token automatically provided to the CLI.buf registry organization {create, delete, info, update}
commands to manage BSR
organizations. Remove buf beta registry organization
commands.buf registry module {create, delete, deprecate, info, undeprecate, update}
commands to
manage BSR modules. Remove buf beta registry repository
commands.buf registry label {archive, info, list, unarchive}
commands to manage BSR module labels.
Remove buf beta registry label
commands and buf beta registry {archive, unarchive}
.buf registry commit {add-label, info, list, resolve}
to manage BSR module commits. Remove
buf beta registry commit
commands.Changelog
[v1.35.1] - 2024-07-24
ref
to align with the git
notion of a ref. This allows for the use
of branch names, tag names, and commit hashes.buf build
errors with absolute path directory inputs without workspace and/or
module configurations (e.g. buf.yaml
, buf.work.yaml
) and proto file paths set to the --path
flag.Changelog
[v1.35.0] - 2024-07-22
buf generate --clean
flag that will delete the directories, jar files, or zip files that the
plugins will write to, prior to generation. Allows cleaning of existing assets without having
to call rm -rf
.--username
flag on and username prompt on buf registry login
. A username is no longer
required to log in.Changelog
[v1.34.0] - 2024-06-21
buf config ls-modules
command to list configured modules.buf generate
would succeed on missing insertion points and
panic on empty insertion point files.buf generate
to allow the use of Editions syntax when doing local code
generation by proxying to a protoc
binary (for languages where code gen is
implemented inside of protoc
instead of in a plugin: Java, C++, Python, etc).protoc_path
property of for buf.gen.yaml
,
where the first array element is the actual path and other array elements are extra
arguments that are passed to protoc
each time it is invoked.Changelog
[v1.33.0] - 2024-06-13
--source-control-url
and --create-default-label
when using
--git-metadata
with buf push
.buf push --git-metadata
when local tags point to different objects than
the remote tags.PROTOVALIDATE
lint rule violations.buf beta registry label {create,get,list}
to replace buf beta registry {draft, tag}
commands.buf beta commit {get,list}
command outputs to display create time and stop
displaying associated tags.buf beta commit list <buf.build/owner/repository>
when the
reference is empty. It now lists commits in the repository instead of listing commits
of the default label.buf format
to canonicalize the punctuation used in message literals
in option values. The output now always uses {
and }
instead of <
and >
; it
adds :
separators between field names and message values if the source omitted them,
and it removes unnecessary separators between fields (,
and ;
are allowed, but
neither is needed).buf format -w
so that it does not touch files whose contents don't actually
change. This eliminates noisy notifications to file-system-watcher tools that are
watching the directory that contains proto sources.buf generate
to work with plugins provided by protoc for versions v24.0
to v25.3. Editions support was experimental in these releases, and the plugins
advertise incomplete support for editions, which triggers buf
to report an error.
With this fix, these plugins can be used again as long as none of the input files use
editions syntax.buf push --exclude-unnamed
flag to exclude unnamed modules when pushing to the BSR.