Google Git
Sign in
chromium / external / github.com / protocolbuffers / txtpbfmt / 8830a5005fb0851a23c03326f258641c4709ebee
commit8830a5005fb0851a23c03326f258641c4709ebee[log] [tgz]
authortxtpbfmt team <txtpbfmt-copybara-robot@google.com>Tue Apr 26 18:23:47 2022
committertxtpbfmt team <txtpbfmt-copybara-robot@google.com>Tue Apr 26 18:24:10 2022
treeb6e488ea9c9f788704466815e83a0b7bd0df72ad
parentd629130a421733ae58684fb8a6e16e1dad62f335 [diff]
Allow sorting by a user-specified field order.

PiperOrigin-RevId: 444615649
2 files changed
tree: b6e488ea9c9f788704466815e83a0b7bd0df72ad
  1. .github/
  2. ast/
  3. cmd/
  4. docs/
  5. parser/
  6. unquote/
  7. go.mod
  8. go.sum
  9. LICENSE
  10. README.md
README.md

Text Proto Formatter

txtpbfmt parses, edits and formats text proto files in a way that preserves comments.

This saves development (read/edit/review) time and enables automated edits.

How to format existing text proto files?

Install:

$ go get -u github.com/protocolbuffers/txtpbfmt/cmd/txtpbfmt

Format files in-place:

$ ${GOPATH}/bin/txtpbfmt [FILES]

Write formatted input to stdout:

$ ${GOPATH}/bin/txtpbfmt < [FILE]

What does it do?

Main features:

main features

Is there an API to edit text proto files while preserving comments?

Yes, see ast.go.

How to disable it?

You can disable formatting for a whole file by adding a comment with “# txtpbfmt: disable” to the top of the file (before the first non-empty non-comment line), eg:

# File overview ...

# txtpbfmt: disable

content: { ... }

Which file extension should I use for my text proto files?

The .textproto extension is the most used extension inside Google (the second most popular choice is .textpb).

Which tools support it? How to format on save?

Currently there is no open source integration with any editor.