Skip to content

Commit

Permalink
Split info messages into different files
Browse files Browse the repository at this point in the history
  • Loading branch information
bufdev committed Sep 28, 2024
1 parent 2b4dc9e commit 195e9be
Show file tree
Hide file tree
Showing 3 changed files with 74 additions and 30 deletions.
34 changes: 34 additions & 0 deletions buf/plugin/info/v1/doc.proto
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
// Copyright 2024 Buf Technologies, Inc.
//
// 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 buf.plugin.info.v1;

import "buf/validate/validate.proto";

option go_package = "buf.build/gen/go/bufbuild/bufplugin/protocolbuffers/go/buf/plugin/info/v1";

// Documentation for a plugin.
message Doc {
// A short string describing the plugin.
//
// This is required.
string short = 1 [(buf.validate.field).required = true];
// A long string providing more details on using the plugin.
//
// When producing documentation for the plugin, this will be concatenated with
// the value from short with a newline separating short and long.
string long = 2;
}
32 changes: 2 additions & 30 deletions buf/plugin/info/v1/info.proto
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@ syntax = "proto3";

package buf.plugin.info.v1;

import "buf/plugin/info/v1/doc.proto";
import "buf/plugin/info/v1/license.proto";
import "buf/validate/validate.proto";

option go_package = "buf.build/gen/go/bufbuild/bufplugin/protocolbuffers/go/buf/plugin/info/v1";
Expand All @@ -31,33 +33,3 @@ message Info {
// Documentation for a plugin.
Doc doc = 3;
}

// A plugin license.
message License {
// The SPDX license ID.
//
// See https://spdx.org/licenses.
string spdx_license_id = 1;
// The source of a license is either raw text, or a URL that contains the license.
oneof source {
option (buf.validate.oneof).required = true;

// The raw text of the license.
string text = 2;
// The url that contains the license
string url = 3 [(buf.validate.field).string.uri = true];
}
}

// Documentation for a plugin.
message Doc {
// A short string describing the plugin.
//
// This is required.
string short = 1 [(buf.validate.field).required = true];
// A long string providing more details on using the plugin.
//
// When producing documentation for the plugin, this will be concatenated with
// the value from short with a newline separating short and long.
string long = 2;
}
38 changes: 38 additions & 0 deletions buf/plugin/info/v1/license.proto
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
// Copyright 2024 Buf Technologies, Inc.
//
// 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 buf.plugin.info.v1;

import "buf/validate/validate.proto";

option go_package = "buf.build/gen/go/bufbuild/bufplugin/protocolbuffers/go/buf/plugin/info/v1";

// A plugin license.
message License {
// The SPDX license ID.
//
// See https://spdx.org/licenses.
string spdx_license_id = 1;
// The source of a license is either raw text, or a URL that contains the license.
oneof source {
option (buf.validate.oneof).required = true;

// The raw text of the license.
string text = 2;
// The url that contains the license
string url = 3 [(buf.validate.field).string.uri = true];
}
}

0 comments on commit 195e9be

Please sign in to comment.