f3c80c4eef
Protobuf Refactoring for Multi-Module Cleanliness This commit includes the following: Moves all packages that were within proto/ to proto/private Rewrites imports to account for the packages being moved Adds in buf.work.yaml to enable buf workspaces Names the proto-public buf module so that we can override the Go package imports within proto/buf.yaml Bumps the buf version dependency to 1.14.0 (I was trying out the version to see if it would get around an issue - it didn't but it also doesn't break things and it seemed best to keep up with the toolchain changes) Why: In the future we will need to consume other protobuf dependencies such as the Google HTTP annotations for openapi generation or grpc-gateway usage. There were some recent changes to have our own ratelimiting annotations. The two combined were not working when I was trying to use them together (attempting to rebase another branch) Buf workspaces should be the solution to the problem Buf workspaces means that each module will have generated Go code that embeds proto file names relative to the proto dir and not the top level repo root. This resulted in proto file name conflicts in the Go global protobuf type registry. The solution to that was to add in a private/ directory into the path within the proto/ directory. That then required rewriting all the imports. Is this safe? AFAICT yes The gRPC wire protocol doesn't seem to care about the proto file names (although the Go grpc code does tack on the proto file name as Metadata in the ServiceDesc) Other than imports, there were no changes to any generated code as a result of this.
41 lines
1.6 KiB
Protocol Buffer
41 lines
1.6 KiB
Protocol Buffer
// Copyright 2020 Google LLC
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
syntax = "proto3";
|
|
|
|
package hashicorp.consul.internal.status;
|
|
|
|
import "google/protobuf/any.proto";
|
|
|
|
// The `Status` type defines a logical error model that is suitable for
|
|
// different programming environments, including REST APIs and RPC APIs. It is
|
|
// used by [gRPC](https://github.com/grpc). Each `Status` message contains
|
|
// three pieces of data: error code, error message, and error details.
|
|
//
|
|
// You can find out more about this error model and how to work with it in the
|
|
// [API Design Guide](https://cloud.google.com/apis/design/errors).
|
|
message Status {
|
|
// The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
|
|
int32 code = 1;
|
|
|
|
// A developer-facing error message, which should be in English. Any
|
|
// user-facing error message should be localized and sent in the
|
|
// [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
|
|
string message = 2;
|
|
|
|
// A list of messages that carry the error details. There is a common set of
|
|
// message types for APIs to use.
|
|
repeated google.protobuf.Any details = 3;
|
|
}
|