github.com/gogo/protobuf@v1.3.2/proto/test_proto/test.proto (about)

     1  // Go support for Protocol Buffers - Google's data interchange format
     2  //
     3  // Copyright 2010 The Go Authors.  All rights reserved.
     4  // https://github.com/golang/protobuf
     5  //
     6  // Redistribution and use in source and binary forms, with or without
     7  // modification, are permitted provided that the following conditions are
     8  // met:
     9  //
    10  //     * Redistributions of source code must retain the above copyright
    11  // notice, this list of conditions and the following disclaimer.
    12  //     * Redistributions in binary form must reproduce the above
    13  // copyright notice, this list of conditions and the following disclaimer
    14  // in the documentation and/or other materials provided with the
    15  // distribution.
    16  //     * Neither the name of Google Inc. nor the names of its
    17  // contributors may be used to endorse or promote products derived from
    18  // this software without specific prior written permission.
    19  //
    20  // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
    21  // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
    22  // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
    23  // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
    24  // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    25  // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
    26  // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
    27  // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
    28  // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
    29  // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
    30  // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    31  
    32  // A feature-rich test file for the protocol compiler and libraries.
    33  
    34  syntax = "proto2";
    35  
    36  package test_proto;
    37  
    38  option go_package = "github.com/gogo/protobuf/proto/test_proto";
    39  
    40  enum FOO { FOO1 = 1; };
    41  
    42  message GoEnum {
    43    required FOO foo = 1;
    44  }
    45  
    46  message GoTestField {
    47    required string Label = 1;
    48    required string Type = 2;
    49  }
    50  
    51  message GoTest {
    52    // An enum, for completeness.
    53    enum KIND {
    54      VOID = 0;
    55  
    56      // Basic types
    57      BOOL = 1;
    58      BYTES = 2;
    59      FINGERPRINT = 3;
    60      FLOAT = 4;
    61      INT = 5;
    62      STRING = 6;
    63      TIME = 7;
    64  
    65      // Groupings
    66      TUPLE = 8;
    67      ARRAY = 9;
    68      MAP = 10;
    69  
    70      // Table types
    71      TABLE = 11;
    72  
    73      // Functions
    74      FUNCTION = 12;  // last tag
    75    };
    76  
    77    // Some typical parameters
    78    required KIND Kind = 1;
    79    optional string Table = 2;
    80    optional int32 Param = 3;
    81  
    82    // Required, repeated and optional foreign fields.
    83    required GoTestField RequiredField = 4;
    84    repeated GoTestField RepeatedField = 5;
    85    optional GoTestField OptionalField = 6;
    86  
    87    // Required fields of all basic types
    88    required bool F_Bool_required = 10;
    89    required int32 F_Int32_required = 11;
    90    required int64 F_Int64_required = 12;
    91    required fixed32 F_Fixed32_required = 13;
    92    required fixed64 F_Fixed64_required = 14;
    93    required uint32 F_Uint32_required = 15;
    94    required uint64 F_Uint64_required = 16;
    95    required float F_Float_required = 17;
    96    required double F_Double_required = 18;
    97    required string F_String_required = 19;
    98    required bytes F_Bytes_required = 101;
    99    required sint32 F_Sint32_required = 102;
   100    required sint64 F_Sint64_required = 103;
   101    required sfixed32 F_Sfixed32_required = 104;
   102    required sfixed64 F_Sfixed64_required = 105;
   103  
   104    // Repeated fields of all basic types
   105    repeated bool F_Bool_repeated = 20;
   106    repeated int32 F_Int32_repeated = 21;
   107    repeated int64 F_Int64_repeated = 22;
   108    repeated fixed32 F_Fixed32_repeated = 23;
   109    repeated fixed64 F_Fixed64_repeated = 24;
   110    repeated uint32 F_Uint32_repeated = 25;
   111    repeated uint64 F_Uint64_repeated = 26;
   112    repeated float F_Float_repeated = 27;
   113    repeated double F_Double_repeated = 28;
   114    repeated string F_String_repeated = 29;
   115    repeated bytes F_Bytes_repeated = 201;
   116    repeated sint32 F_Sint32_repeated = 202;
   117    repeated sint64 F_Sint64_repeated = 203;
   118    repeated sfixed32 F_Sfixed32_repeated = 204;
   119    repeated sfixed64 F_Sfixed64_repeated = 205;
   120  
   121    // Optional fields of all basic types
   122    optional bool F_Bool_optional = 30;
   123    optional int32 F_Int32_optional = 31;
   124    optional int64 F_Int64_optional = 32;
   125    optional fixed32 F_Fixed32_optional = 33;
   126    optional fixed64 F_Fixed64_optional = 34;
   127    optional uint32 F_Uint32_optional = 35;
   128    optional uint64 F_Uint64_optional = 36;
   129    optional float F_Float_optional = 37;
   130    optional double F_Double_optional = 38;
   131    optional string F_String_optional = 39;
   132    optional bytes F_Bytes_optional = 301;
   133    optional sint32 F_Sint32_optional = 302;
   134    optional sint64 F_Sint64_optional = 303;
   135    optional sfixed32 F_Sfixed32_optional = 304;
   136    optional sfixed64 F_Sfixed64_optional = 305;
   137  
   138    // Default-valued fields of all basic types
   139    optional bool F_Bool_defaulted = 40 [default=true];
   140    optional int32 F_Int32_defaulted = 41 [default=32];
   141    optional int64 F_Int64_defaulted = 42 [default=64];
   142    optional fixed32 F_Fixed32_defaulted = 43 [default=320];
   143    optional fixed64 F_Fixed64_defaulted = 44 [default=640];
   144    optional uint32 F_Uint32_defaulted = 45 [default=3200];
   145    optional uint64 F_Uint64_defaulted = 46 [default=6400];
   146    optional float F_Float_defaulted = 47 [default=314159.];
   147    optional double F_Double_defaulted = 48 [default=271828.];
   148    optional string F_String_defaulted = 49 [default="hello, \"world!\"\n"];
   149    optional bytes F_Bytes_defaulted = 401 [default="Bignose"];
   150    optional sint32 F_Sint32_defaulted = 402 [default = -32];
   151    optional sint64 F_Sint64_defaulted = 403 [default = -64];
   152    optional sfixed32 F_Sfixed32_defaulted = 404 [default = -32];
   153    optional sfixed64 F_Sfixed64_defaulted = 405 [default = -64];
   154  
   155    // Packed repeated fields (no string or bytes).
   156    repeated bool F_Bool_repeated_packed = 50 [packed=true];
   157    repeated int32 F_Int32_repeated_packed = 51 [packed=true];
   158    repeated int64 F_Int64_repeated_packed = 52 [packed=true];
   159    repeated fixed32 F_Fixed32_repeated_packed = 53 [packed=true];
   160    repeated fixed64 F_Fixed64_repeated_packed = 54 [packed=true];
   161    repeated uint32 F_Uint32_repeated_packed = 55 [packed=true];
   162    repeated uint64 F_Uint64_repeated_packed = 56 [packed=true];
   163    repeated float F_Float_repeated_packed = 57 [packed=true];
   164    repeated double F_Double_repeated_packed = 58 [packed=true];
   165    repeated sint32 F_Sint32_repeated_packed = 502 [packed=true];
   166    repeated sint64 F_Sint64_repeated_packed = 503 [packed=true];
   167    repeated sfixed32 F_Sfixed32_repeated_packed = 504 [packed=true];
   168    repeated sfixed64 F_Sfixed64_repeated_packed = 505 [packed=true];
   169  
   170    // Required, repeated, and optional groups.
   171    required group RequiredGroup = 70 {
   172      required string RequiredField = 71;
   173    };
   174  
   175    repeated group RepeatedGroup = 80 {
   176      required string RequiredField = 81;
   177    };
   178  
   179    optional group OptionalGroup = 90 {
   180      required string RequiredField = 91;
   181    };
   182  }
   183  
   184  // For testing a group containing a required field.
   185  message GoTestRequiredGroupField {
   186    required group Group = 1 {
   187      required int32 Field = 2;
   188    };
   189  }
   190  
   191  // For testing skipping of unrecognized fields.
   192  // Numbers are all big, larger than tag numbers in GoTestField,
   193  // the message used in the corresponding test.
   194  message GoSkipTest {
   195    required int32 skip_int32 = 11;
   196    required fixed32 skip_fixed32 = 12;
   197    required fixed64 skip_fixed64 = 13;
   198    required string skip_string = 14;
   199    required group SkipGroup = 15 {
   200      required int32 group_int32 = 16;
   201      required string group_string = 17;
   202    }
   203  }
   204  
   205  // For testing packed/non-packed decoder switching.
   206  // A serialized instance of one should be deserializable as the other.
   207  message NonPackedTest {
   208    repeated int32 a = 1;
   209  }
   210  
   211  message PackedTest {
   212    repeated int32 b = 1 [packed=true];
   213  }
   214  
   215  message MaxTag {
   216    // Maximum possible tag number.
   217    optional string last_field = 536870911;
   218  }
   219  
   220  message OldMessage {
   221    message Nested {
   222      optional string name = 1;
   223    }
   224    optional Nested nested = 1;
   225  
   226    optional int32 num = 2;
   227  }
   228  
   229  // NewMessage is wire compatible with OldMessage;
   230  // imagine it as a future version.
   231  message NewMessage {
   232    message Nested {
   233      optional string name = 1;
   234      optional string food_group = 2;
   235    }
   236    optional Nested nested = 1;
   237  
   238    // This is an int32 in OldMessage.
   239    optional int64 num = 2;
   240  }
   241  
   242  // Smaller tests for ASCII formatting.
   243  
   244  message InnerMessage {
   245    required string host = 1;
   246    optional int32 port = 2 [default=4000];
   247    optional bool connected = 3;
   248  }
   249  
   250  message OtherMessage {
   251    optional int64 key = 1;
   252    optional bytes value = 2;
   253    optional float weight = 3;
   254    optional InnerMessage inner = 4;
   255  
   256    extensions 100 to max;
   257  }
   258  
   259  message RequiredInnerMessage {
   260    required InnerMessage leo_finally_won_an_oscar = 1;
   261  }
   262  
   263  message MyMessage {
   264    required int32 count = 1;
   265    optional string name = 2;
   266    optional string quote = 3;
   267    repeated string pet = 4;
   268    optional InnerMessage inner = 5;
   269    repeated OtherMessage others = 6;
   270    optional RequiredInnerMessage we_must_go_deeper = 13;
   271    repeated InnerMessage rep_inner = 12;
   272  
   273    enum Color {
   274      RED = 0;
   275      GREEN = 1;
   276      BLUE = 2;
   277    };
   278    optional Color bikeshed = 7;
   279  
   280    optional group SomeGroup = 8 {
   281      optional int32 group_field = 9;
   282    }
   283  
   284    // This field becomes [][]byte in the generated code.
   285    repeated bytes rep_bytes = 10;
   286  
   287    optional double bigfloat = 11;
   288  
   289    extensions 100 to max;
   290  }
   291  
   292  message Ext {
   293    extend MyMessage {
   294      optional Ext more = 103;
   295      optional string text = 104;
   296      optional int32 number = 105;
   297    }
   298  
   299    optional string data = 1;
   300    map<int32, int32> map_field = 2;
   301  }
   302  
   303  extend MyMessage {
   304    repeated string greeting = 106;
   305    // leave field 200 unregistered for testing
   306  }
   307  
   308  message ComplexExtension {
   309    optional int32 first = 1;
   310    optional int32 second = 2;
   311    repeated int32 third = 3;
   312  }
   313  
   314  extend OtherMessage {
   315    optional ComplexExtension complex = 200;
   316    repeated ComplexExtension r_complex = 201;
   317  }
   318  
   319  message DefaultsMessage {
   320    enum DefaultsEnum {
   321      ZERO = 0;
   322      ONE = 1;
   323      TWO = 2;
   324    };
   325    extensions 100 to max;
   326  }
   327  
   328  extend DefaultsMessage {
   329    optional double no_default_double = 101;
   330    optional float no_default_float = 102;
   331    optional int32 no_default_int32 = 103;
   332    optional int64 no_default_int64 = 104;
   333    optional uint32 no_default_uint32 = 105;
   334    optional uint64 no_default_uint64 = 106;
   335    optional sint32 no_default_sint32 = 107;
   336    optional sint64 no_default_sint64 = 108;
   337    optional fixed32 no_default_fixed32 = 109;
   338    optional fixed64 no_default_fixed64 = 110;
   339    optional sfixed32 no_default_sfixed32 = 111;
   340    optional sfixed64 no_default_sfixed64 = 112;
   341    optional bool no_default_bool = 113;
   342    optional string no_default_string = 114;
   343    optional bytes no_default_bytes = 115;
   344    optional DefaultsMessage.DefaultsEnum no_default_enum = 116;
   345  
   346    optional double default_double = 201 [default = 3.1415];
   347    optional float default_float = 202 [default = 3.14];
   348    optional int32 default_int32 = 203 [default = 42];
   349    optional int64 default_int64 = 204 [default = 43];
   350    optional uint32 default_uint32 = 205 [default = 44];
   351    optional uint64 default_uint64 = 206 [default = 45];
   352    optional sint32 default_sint32 = 207 [default = 46];
   353    optional sint64 default_sint64 = 208 [default = 47];
   354    optional fixed32 default_fixed32 = 209 [default = 48];
   355    optional fixed64 default_fixed64 = 210 [default = 49];
   356    optional sfixed32 default_sfixed32 = 211 [default = 50];
   357    optional sfixed64 default_sfixed64 = 212 [default = 51];
   358    optional bool default_bool = 213 [default = true];
   359    optional string default_string = 214 [default = "Hello, string,def=foo"];
   360    optional bytes default_bytes = 215 [default = "Hello, bytes"];
   361    optional DefaultsMessage.DefaultsEnum default_enum = 216 [default = ONE];
   362  }
   363  
   364  message MyMessageSet {
   365    option message_set_wire_format = true;
   366    extensions 100 to max;
   367  }
   368  
   369  message Empty {
   370  }
   371  
   372  extend MyMessageSet {
   373      optional Empty x201 = 201;
   374      optional Empty x202 = 202;
   375      optional Empty x203 = 203;
   376      optional Empty x204 = 204;
   377      optional Empty x205 = 205;
   378      optional Empty x206 = 206;
   379      optional Empty x207 = 207;
   380      optional Empty x208 = 208;
   381      optional Empty x209 = 209;
   382      optional Empty x210 = 210;
   383      optional Empty x211 = 211;
   384      optional Empty x212 = 212;
   385      optional Empty x213 = 213;
   386      optional Empty x214 = 214;
   387      optional Empty x215 = 215;
   388      optional Empty x216 = 216;
   389      optional Empty x217 = 217;
   390      optional Empty x218 = 218;
   391      optional Empty x219 = 219;
   392      optional Empty x220 = 220;
   393      optional Empty x221 = 221;
   394      optional Empty x222 = 222;
   395      optional Empty x223 = 223;
   396      optional Empty x224 = 224;
   397      optional Empty x225 = 225;
   398      optional Empty x226 = 226;
   399      optional Empty x227 = 227;
   400      optional Empty x228 = 228;
   401      optional Empty x229 = 229;
   402      optional Empty x230 = 230;
   403      optional Empty x231 = 231;
   404      optional Empty x232 = 232;
   405      optional Empty x233 = 233;
   406      optional Empty x234 = 234;
   407      optional Empty x235 = 235;
   408      optional Empty x236 = 236;
   409      optional Empty x237 = 237;
   410      optional Empty x238 = 238;
   411      optional Empty x239 = 239;
   412      optional Empty x240 = 240;
   413      optional Empty x241 = 241;
   414      optional Empty x242 = 242;
   415      optional Empty x243 = 243;
   416      optional Empty x244 = 244;
   417      optional Empty x245 = 245;
   418      optional Empty x246 = 246;
   419      optional Empty x247 = 247;
   420      optional Empty x248 = 248;
   421      optional Empty x249 = 249;
   422      optional Empty x250 = 250;
   423  }
   424  
   425  message MessageList {
   426    repeated group Message = 1 {
   427      required string name = 2;
   428      required int32 count = 3;
   429    }
   430  }
   431  
   432  message Strings {
   433    optional string string_field = 1;
   434    optional bytes bytes_field = 2;
   435  }
   436  
   437  message Defaults {
   438    enum Color {
   439      RED = 0;
   440      GREEN = 1;
   441      BLUE = 2;
   442    }
   443  
   444    // Default-valued fields of all basic types.
   445    // Same as GoTest, but copied here to make testing easier.
   446    optional bool F_Bool = 1 [default=true];
   447    optional int32 F_Int32 = 2 [default=32];
   448    optional int64 F_Int64 = 3 [default=64];
   449    optional fixed32 F_Fixed32 = 4 [default=320];
   450    optional fixed64 F_Fixed64 = 5 [default=640];
   451    optional uint32 F_Uint32 = 6 [default=3200];
   452    optional uint64 F_Uint64 = 7 [default=6400];
   453    optional float F_Float = 8 [default=314159.];
   454    optional double F_Double = 9 [default=271828.];
   455    optional string F_String = 10 [default="hello, \"world!\"\n"];
   456    optional bytes F_Bytes = 11 [default="Bignose"];
   457    optional sint32 F_Sint32 = 12 [default=-32];
   458    optional sint64 F_Sint64 = 13 [default=-64];
   459    optional Color F_Enum = 14 [default=GREEN];
   460  
   461    // More fields with crazy defaults.
   462    optional float F_Pinf = 15 [default=inf];
   463    optional float F_Ninf = 16 [default=-inf];
   464    optional float F_Nan = 17 [default=nan];
   465  
   466    // Sub-message.
   467    optional SubDefaults sub = 18;
   468  
   469    // Redundant but explicit defaults.
   470    optional string str_zero = 19 [default=""];
   471  }
   472  
   473  message SubDefaults {
   474    optional int64 n = 1 [default=7];
   475  }
   476  
   477  message RepeatedEnum {
   478    enum Color {
   479      RED = 1;
   480    }
   481    repeated Color color = 1;
   482  }
   483  
   484  message MoreRepeated {
   485    repeated bool bools = 1;
   486    repeated bool bools_packed = 2 [packed=true];
   487    repeated int32 ints = 3;
   488    repeated int32 ints_packed = 4 [packed=true];
   489    repeated int64 int64s_packed = 7 [packed=true];
   490    repeated string strings = 5;
   491    repeated fixed32 fixeds = 6;
   492  }
   493  
   494  // GroupOld and GroupNew have the same wire format.
   495  // GroupNew has a new field inside a group.
   496  
   497  message GroupOld {
   498    optional group G = 101 {
   499      optional int32 x = 2;
   500    }
   501  }
   502  
   503  message GroupNew {
   504    optional group G = 101 {
   505      optional int32 x = 2;
   506      optional int32 y = 3;
   507    }
   508  }
   509  
   510  message FloatingPoint {
   511    required double f = 1;
   512    optional bool exact = 2;
   513  }
   514  
   515  message MessageWithMap {
   516    map<int32, string> name_mapping = 1;
   517    map<sint64, FloatingPoint> msg_mapping = 2;
   518    map<bool, bytes> byte_mapping = 3;
   519    map<string, string> str_to_str = 4;
   520  }
   521  
   522  message Oneof {
   523    oneof union {
   524      bool F_Bool = 1;
   525      int32 F_Int32 = 2;
   526      int64 F_Int64 = 3;
   527      fixed32 F_Fixed32 = 4;
   528      fixed64 F_Fixed64 = 5;
   529      uint32 F_Uint32 = 6;
   530      uint64 F_Uint64 = 7;
   531      float F_Float = 8;
   532      double F_Double = 9;
   533      string F_String = 10;
   534      bytes F_Bytes = 11;
   535      sint32 F_Sint32 = 12;
   536      sint64 F_Sint64 = 13;
   537      MyMessage.Color F_Enum = 14;
   538      GoTestField F_Message = 15;
   539      group F_Group = 16 {
   540        optional int32 x = 17;
   541      }
   542      int32 F_Largest_Tag = 536870911;
   543    }
   544  
   545    oneof tormato {
   546      int32 value = 100;
   547    }
   548  }
   549  
   550  message Communique {
   551    optional bool make_me_cry = 1;
   552  
   553    // This is a oneof, called "union".
   554    oneof union {
   555      int32 number = 5;
   556      string name = 6;
   557      bytes data = 7;
   558      double temp_c = 8;
   559      MyMessage.Color col = 9;
   560      Strings msg = 10;
   561    }
   562  }
   563  
   564  message TestUTF8 {
   565    optional string scalar = 1;
   566    repeated string vector = 2;
   567    oneof oneof { string field = 3; }
   568    map<string, int64> map_key = 4;
   569    map<int64, string> map_value = 5;
   570  }