#4412·buf

添加 `buf source migrate` 命令

作者: doriable创建于 2026年3月24日更新于 2026年3月24日
标签Feature

特性

buf config 迁移 ' 类似,后者迁移/升级了buf.{yaml,gen.yaml}-config文件,在buf source'中有一个命令是好的,它能够迁移/升级原源的语法/编辑。

□ 实例 UX

buf 源迁移<输入> [- syntax, --diff]
  • 输入默认为.',如未指明,否则是一种源输入(dir'/on-disk模块/工作空间或`protofileref'),行为与我们拥有的其他命令相同。
  • 用户可选择指定-语法',例如-语法=proto3'或`-语法=2024'(第2024版)。 如果没有指定语法,我们将使用CLI版本当前所依赖的最新已执行版本的编译器(https://GitHub.com/bufbuilt/protocompile/blob/aa1a63ac3dac8c2eb5bbebf21d6a8b5c0b8f8e5b/eximmental/ast/syntax/editions.go#L24).
  • 如果源已经在指定的语法上和(或)源已经在最新的语法上,则源文件中的禁用
  • -diff'只产生任何diff输出,而不在原地写作。 默认行为在正处写入 。 这与buf config 迁移 ' 相同的UX(虽然我愿意偏离,但只是想使用现有的参照基准来保持一致性)