| package main | |
| import ( | |
| "google.golang.org/protobuf/proto" | |
| "google.golang.org/protobuf/reflect/protodesc" | |
| "google.golang.org/protobuf/reflect/protoreflect" | |
| "google.golang.org/protobuf/types/descriptorpb" | |
| "google.golang.org/protobuf/types/dynamicpb" | |
| ) |
From https://www.reddit.com/r/golang/comments/1kwklgf/comment/mui4zkq/
Without a tool like buf, it's a lot of work for the consumers.
Let's say you leave the project layout exactly as in your question:
my-library/
└─ directory1/shared.proto
so downstream code can keep writing
// ProtoDiff generates an indented summary of the diff between two protos'
// YAML representations. See ProtoToYAML for documentation on rewrites.
func ProtoDiff(a, b protoutil.Message, args DiffArgs, rewrites func(interface{})) string {
toYAML := func(m protoutil.Message) string {
if m == nil {
return ""
}
str, err := ProtoToYAML(m, false /* emitDefaults */, rewrites)
If you have several tools that are very closely related, you can make them easier to use, discover, and distribute by combining them into a single tool (and a single executable binary artifact).
If you’ve got a tool that’s sufficiently complex, you can reduce its complexity by making a set of subcommands. This is also useful for sharing stuff—global flags, help text, configuration, storage mechanisms.The above guidance doesn’t help you to decide when something is unrelated and should be separated, BTW.
It is worth comparing this advice to the Command Pattern from the “Gang of Four” “Design Patterns” book, where you encapsulate an an action or a request as an object that can be parameterized. Usually, in the Command Design Pattern the invoker doesn’t know anything about the implementation details of the command or it’s receiver, it just knows the command interface and its only responsibility is to invoke the command and optionally do some bookkeeping of what commands are possible and/or valid. There are
| package main | |
| import ( | |
| "fmt" | |
| "log" | |
| "context" | |
| "cloud.google.com/go/storage" |
| package main | |
| import ( | |
| "fmt" | |
| "io/ioutil" | |
| "log" | |
| "context" | |
| "cloud.google.com/go/storage" |
| package main | |
| import ( | |
| "fmt" | |
| ) | |
| var ( | |
| ones = []string{ | |
| "zero", "one", "two", "three", "four", | |
| "five", "six", "seven", "eight", "nine", |