a104dffcb6
Uses https://en.wikipedia.org/wiki/Wikipedia:Lists_of_common_misspellings/For_machines to find likely typos, with https://github.com/bwignall/typochecker to help automate the checking.
337 lines
10 KiB
Protocol Buffer
337 lines
10 KiB
Protocol Buffer
// Protocol Buffers - Google's data interchange format
|
|
// Copyright 2008 Google Inc. All rights reserved.
|
|
// https://developers.google.com/protocol-buffers/
|
|
//
|
|
// Redistribution and use in source and binary forms, with or without
|
|
// modification, are permitted provided that the following conditions are
|
|
// met:
|
|
//
|
|
// * Redistributions of source code must retain the above copyright
|
|
// notice, this list of conditions and the following disclaimer.
|
|
// * Redistributions in binary form must reproduce the above
|
|
// copyright notice, this list of conditions and the following disclaimer
|
|
// in the documentation and/or other materials provided with the
|
|
// distribution.
|
|
// * Neither the name of Google Inc. nor the names of its
|
|
// contributors may be used to endorse or promote products derived from
|
|
// this software without specific prior written permission.
|
|
//
|
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
// Author: benjy@google.com (Benjy Weinberger)
|
|
// Based on original Protocol Buffers design by
|
|
// Sanjay Ghemawat, Jeff Dean, and others.
|
|
//
|
|
// A proto file used to test the "custom options" feature of google.protobuf.
|
|
|
|
// This file is based on unittest_custom_options.proto in
|
|
// src/google/protobuf, but is modified for proto3. It could
|
|
// potentially be moved into src/google/protobuf, but currently C#
|
|
// is the only language that really needs it, as we don't support
|
|
// proto2 syntax. It's cut down significantly as proto3 only supports
|
|
// extensions for options.
|
|
|
|
|
|
syntax = "proto3";
|
|
|
|
// A custom file option (defined below).
|
|
option (file_opt1) = 9876543210;
|
|
|
|
import "google/protobuf/descriptor.proto";
|
|
|
|
// We don't put this in a package within proto2 because we need to make sure
|
|
// that the generated code doesn't depend on being in the proto2 namespace.
|
|
package protobuf_unittest;
|
|
option csharp_namespace = "UnitTest.Issues.TestProtos";
|
|
|
|
// Some simple test custom options of various types.
|
|
|
|
extend google.protobuf.FileOptions {
|
|
uint64 file_opt1 = 7736974;
|
|
}
|
|
|
|
extend google.protobuf.MessageOptions {
|
|
int32 message_opt1 = 7739036;
|
|
}
|
|
|
|
extend google.protobuf.FieldOptions {
|
|
fixed64 field_opt1 = 7740936;
|
|
}
|
|
|
|
extend google.protobuf.OneofOptions {
|
|
int32 oneof_opt1 = 7740111;
|
|
}
|
|
|
|
extend google.protobuf.EnumOptions {
|
|
sfixed32 enum_opt1 = 7753576;
|
|
}
|
|
|
|
extend google.protobuf.EnumValueOptions {
|
|
int32 enum_value_opt1 = 1560678;
|
|
}
|
|
|
|
extend google.protobuf.ServiceOptions {
|
|
sint64 service_opt1 = 7887650;
|
|
}
|
|
|
|
enum MethodOpt1 {
|
|
METHODOPT1_UNSPECIFIED = 0;
|
|
METHODOPT1_VAL1 = 1;
|
|
METHODOPT1_VAL2 = 2;
|
|
}
|
|
|
|
extend google.protobuf.MethodOptions {
|
|
MethodOpt1 method_opt1 = 7890860;
|
|
}
|
|
|
|
// A test message with custom options at all possible locations (and also some
|
|
// regular options, to make sure they interact nicely).
|
|
message TestMessageWithCustomOptions {
|
|
option message_set_wire_format = false;
|
|
|
|
option (message_opt1) = -56;
|
|
|
|
string field1 = 1 [ctype=CORD,
|
|
(field_opt1)=8765432109];
|
|
|
|
oneof AnOneof {
|
|
option (oneof_opt1) = -99;
|
|
int32 oneof_field = 2;
|
|
}
|
|
|
|
enum AnEnum {
|
|
option (enum_opt1) = -789;
|
|
ANENUM_UNSPECIFIED = 0;
|
|
ANENUM_VAL1 = 1;
|
|
ANENUM_VAL2 = 2 [(enum_value_opt1) = 123];
|
|
}
|
|
}
|
|
|
|
|
|
// A test RPC service with custom options at all possible locations (and also
|
|
// some regular options, to make sure they interact nicely).
|
|
message CustomOptionFooRequest {
|
|
}
|
|
|
|
message CustomOptionFooResponse {
|
|
}
|
|
|
|
message CustomOptionFooClientMessage {
|
|
}
|
|
|
|
message CustomOptionFooServerMessage {
|
|
}
|
|
|
|
service TestServiceWithCustomOptions {
|
|
option (service_opt1) = -9876543210;
|
|
|
|
rpc Foo(CustomOptionFooRequest) returns (CustomOptionFooResponse) {
|
|
option (method_opt1) = METHODOPT1_VAL2;
|
|
}
|
|
}
|
|
|
|
|
|
|
|
// Options of every possible field type, so we can test them all exhaustively.
|
|
|
|
message DummyMessageContainingEnum {
|
|
enum TestEnumType {
|
|
TEST_OPTION_ENUM_UNSPECIFIED = 0;
|
|
TEST_OPTION_ENUM_TYPE1 = 22;
|
|
TEST_OPTION_ENUM_TYPE2 = -23;
|
|
}
|
|
}
|
|
|
|
message DummyMessageInvalidAsOptionType {
|
|
}
|
|
|
|
extend google.protobuf.MessageOptions {
|
|
bool bool_opt = 7706090;
|
|
int32 int32_opt = 7705709;
|
|
int64 int64_opt = 7705542;
|
|
uint32 uint32_opt = 7704880;
|
|
uint64 uint64_opt = 7702367;
|
|
sint32 sint32_opt = 7701568;
|
|
sint64 sint64_opt = 7700863;
|
|
fixed32 fixed32_opt = 7700307;
|
|
fixed64 fixed64_opt = 7700194;
|
|
sfixed32 sfixed32_opt = 7698645;
|
|
sfixed64 sfixed64_opt = 7685475;
|
|
float float_opt = 7675390;
|
|
double double_opt = 7673293;
|
|
string string_opt = 7673285;
|
|
bytes bytes_opt = 7673238;
|
|
DummyMessageContainingEnum.TestEnumType enum_opt = 7673233;
|
|
DummyMessageInvalidAsOptionType message_type_opt = 7665967;
|
|
}
|
|
|
|
message CustomOptionMinIntegerValues {
|
|
option (bool_opt) = false;
|
|
option (int32_opt) = -0x80000000;
|
|
option (int64_opt) = -0x8000000000000000;
|
|
option (uint32_opt) = 0;
|
|
option (uint64_opt) = 0;
|
|
option (sint32_opt) = -0x80000000;
|
|
option (sint64_opt) = -0x8000000000000000;
|
|
option (fixed32_opt) = 0;
|
|
option (fixed64_opt) = 0;
|
|
option (sfixed32_opt) = -0x80000000;
|
|
option (sfixed64_opt) = -0x8000000000000000;
|
|
}
|
|
|
|
message CustomOptionMaxIntegerValues {
|
|
option (bool_opt) = true;
|
|
option (int32_opt) = 0x7FFFFFFF;
|
|
option (int64_opt) = 0x7FFFFFFFFFFFFFFF;
|
|
option (uint32_opt) = 0xFFFFFFFF;
|
|
option (uint64_opt) = 0xFFFFFFFFFFFFFFFF;
|
|
option (sint32_opt) = 0x7FFFFFFF;
|
|
option (sint64_opt) = 0x7FFFFFFFFFFFFFFF;
|
|
option (fixed32_opt) = 0xFFFFFFFF;
|
|
option (fixed64_opt) = 0xFFFFFFFFFFFFFFFF;
|
|
option (sfixed32_opt) = 0x7FFFFFFF;
|
|
option (sfixed64_opt) = 0x7FFFFFFFFFFFFFFF;
|
|
}
|
|
|
|
message CustomOptionOtherValues {
|
|
option (int32_opt) = -100; // To test sign-extension.
|
|
option (float_opt) = 12.3456789;
|
|
option (double_opt) = 1.234567890123456789;
|
|
option (string_opt) = "Hello, \"World\"";
|
|
option (bytes_opt) = "Hello\0World";
|
|
option (enum_opt) = TEST_OPTION_ENUM_TYPE2;
|
|
}
|
|
|
|
message SettingRealsFromPositiveInts {
|
|
option (float_opt) = 12;
|
|
option (double_opt) = 154;
|
|
}
|
|
|
|
message SettingRealsFromNegativeInts {
|
|
option (float_opt) = -12;
|
|
option (double_opt) = -154;
|
|
}
|
|
|
|
// Options of complex message types, themselves combined and extended in
|
|
// various ways.
|
|
|
|
message ComplexOptionType1 {
|
|
int32 foo = 1;
|
|
int32 foo2 = 2;
|
|
int32 foo3 = 3;
|
|
repeated int32 foo4 = 4;
|
|
}
|
|
|
|
message ComplexOptionType2 {
|
|
ComplexOptionType1 bar = 1;
|
|
int32 baz = 2;
|
|
|
|
message ComplexOptionType4 {
|
|
int32 waldo = 1;
|
|
|
|
extend google.protobuf.MessageOptions {
|
|
ComplexOptionType4 complex_opt4 = 7633546;
|
|
}
|
|
}
|
|
|
|
ComplexOptionType4 fred = 3;
|
|
repeated ComplexOptionType4 barney = 4;
|
|
}
|
|
|
|
message ComplexOptionType3 {
|
|
int32 qux = 1;
|
|
}
|
|
|
|
extend google.protobuf.MessageOptions {
|
|
protobuf_unittest.ComplexOptionType1 complex_opt1 = 7646756;
|
|
ComplexOptionType2 complex_opt2 = 7636949;
|
|
ComplexOptionType3 complex_opt3 = 7636463;
|
|
}
|
|
|
|
// Note that we try various different ways of naming the same extension.
|
|
message VariousComplexOptions {
|
|
option (.protobuf_unittest.complex_opt1).foo = 42;
|
|
option (protobuf_unittest.complex_opt1).foo4 = 99;
|
|
option (protobuf_unittest.complex_opt1).foo4 = 88;
|
|
option (complex_opt2).baz = 987;
|
|
option (complex_opt2).bar.foo = 743;
|
|
option (ComplexOptionType2.ComplexOptionType4.complex_opt4).waldo = 1971;
|
|
option (complex_opt2).fred.waldo = 321;
|
|
option (complex_opt2).barney = { waldo: 101 };
|
|
option (complex_opt2).barney = { waldo: 212 };
|
|
option (protobuf_unittest.complex_opt3).qux = 9;
|
|
}
|
|
|
|
// ------------------------------------------------------
|
|
// Definitions for testing aggregate option parsing.
|
|
// See descriptor_unittest.cc.
|
|
|
|
// A helper type used to test aggregate option parsing
|
|
message Aggregate {
|
|
int32 i = 1;
|
|
string s = 2;
|
|
|
|
// A nested object
|
|
Aggregate sub = 3;
|
|
}
|
|
|
|
// Allow Aggregate to be used as an option at all possible locations
|
|
// in the .proto grammar.
|
|
extend google.protobuf.FileOptions { Aggregate fileopt = 15478479; }
|
|
extend google.protobuf.MessageOptions { Aggregate msgopt = 15480088; }
|
|
extend google.protobuf.FieldOptions { Aggregate fieldopt = 15481374; }
|
|
extend google.protobuf.EnumOptions { Aggregate enumopt = 15483218; }
|
|
extend google.protobuf.EnumValueOptions { Aggregate enumvalopt = 15486921; }
|
|
extend google.protobuf.ServiceOptions { Aggregate serviceopt = 15497145; }
|
|
extend google.protobuf.MethodOptions { Aggregate methodopt = 15512713; }
|
|
|
|
// Try using AggregateOption at different points in the proto grammar
|
|
option (fileopt) = {
|
|
s: 'FileAnnotation'
|
|
// Also test the handling of comments
|
|
/* of both types */ i: 100
|
|
|
|
sub { s: 'NestedFileAnnotation' }
|
|
};
|
|
|
|
message AggregateMessage {
|
|
option (msgopt) = { i:101 s:'MessageAnnotation' };
|
|
int32 fieldname = 1 [(fieldopt) = { s:'FieldAnnotation' }];
|
|
}
|
|
|
|
service AggregateService {
|
|
option (serviceopt) = { s:'ServiceAnnotation' };
|
|
rpc Method (AggregateMessage) returns (AggregateMessage) {
|
|
option (methodopt) = { s:'MethodAnnotation' };
|
|
}
|
|
}
|
|
|
|
enum AggregateEnum {
|
|
option (enumopt) = { s:'EnumAnnotation' };
|
|
UNSPECIFIED = 0;
|
|
VALUE = 1 [(enumvalopt) = { s:'EnumValueAnnotation' }];
|
|
}
|
|
|
|
// Test custom options for nested type.
|
|
message NestedOptionType {
|
|
message NestedMessage {
|
|
option (message_opt1) = 1001;
|
|
int32 nested_field = 1 [(field_opt1) = 1002];
|
|
}
|
|
enum NestedEnum {
|
|
UNSPECIFIED = 0;
|
|
option (enum_opt1) = 1003;
|
|
NESTED_ENUM_VALUE = 1 [(enum_value_opt1) = 1004];
|
|
}
|
|
}
|