buf beta convert update

[joshcarp]

The form of buf beta convert will be updated in order to reduce ambiguity and simplify usage.

The changes being made are:

• The --input flag is being renamed to --from
• The --output flag is being renamed to --to
• Fully qualified type names in the form buf.build/<org>/<name>#<TypeName> are no longer supported for the --type flag

The current structure of buf beta convert is:

buf beta convert <source> --type=<type> --input=<payload> --output=<output>

The new structure is now

buf beta convert <input> --type=<type-within-input> --from=<payload> --to=<output>

This new structure clarifies that the argument can be the same input as any other buf command, including BSR modules and built binaries. The --from and --to flags hold the same symmetry as the current flags but there is no overlap of --input with inputs to other buf commands.

Along with this change fully qualified type names are being removed:

Fully qualified type names are in the form buf.build/<org>/<name>#<TypeName> and can currently be passed into the --type field. Instead the input argument should be populated with the desired module buf.build/<org>/<name> and the --type flag should be populated with <TypeName>

Old command examples vs new command examples

- buf beta convert <source> --input=<payload> --output=<output>
+ buf beta convert <input> --from=<payload> --to=<output>

- buf beta convert buf.proto --type=buf.Foo --input=payload.bin
+ buf beta convert buf.proto --type=buf.Foo --from=payload.bin

- buf beta convert buf.proto --type=buf.Foo --input=payload.json
+ buf beta convert buf.proto --type=buf.Foo --from=payload.json

- buf beta convert buf.proto --type=buf.Foo --input -#format=json
+ buf beta convert buf.proto --type=buf.Foo --from -#format=json

- buf beta convert buf.proto --type=buf.Foo --input -#format=bin
+ buf beta convert buf.proto --type=buf.Foo --from -#format=bin

- buf beta convert buf.proto --type=buf.Foo --input -#format=json --output -#format=json
+ buf beta convert buf.proto --type=buf.Foo --from -#format=json --to -#format=json

- cat image.bin | buf beta convert --type=buf.Foo - --input=payload.bin --output -#format=json
+ cat image.bin | buf beta convert --type=buf.Foo - --from=payload.bin --to -#format=json

- buf beta convert image.bin --type=buf.Foo --input -#format=bin --output -#format=json
+ buf beta convert image.bin --type=buf.Foo --from -#format=bin --to -#format=json

- buf beta convert image.bin --type=buf.Foo --output -#format=json
+ buf beta convert image.bin --type=buf.Foo --to -#format=json

- buf beta convert image.bin --type=buf.Foo --input -#format=json --output -#format=bin
+ buf beta convert image.bin --type=buf.Foo --from -#format=json --to -#format=bin

- cat image.bin | buf beta convert --type=buf.Foo -#format=json --input=payload.json --output -#format=bin
+ cat image.bin | buf beta convert --type=buf.Foo -#format=json --from=payload.json --to -#format=bin

- buf beta convert --type=buf.build/org/repo#buf.Foo -#format=json --input=payload.json --output -#format=bin
+ buf beta convert buf.build/org/repo --type=buf.Foo -#format=json --input=payload.json --output -#format=bin