grpc-tools 1.21.0 → 1.22.0.pre1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/bin/x86-linux/google/protobuf/compiler/plugin.proto +1 -0
- data/bin/x86-linux/google/protobuf/descriptor.proto +66 -67
- data/bin/x86-linux/google/protobuf/duration.proto +0 -1
- data/bin/x86-linux/google/protobuf/struct.proto +0 -1
- data/bin/x86-linux/google/protobuf/timestamp.proto +6 -5
- data/bin/x86-linux/google/protobuf/type.proto +20 -20
- data/bin/x86-linux/grpc_ruby_plugin +0 -0
- data/bin/x86-linux/protoc +0 -0
- data/bin/x86-macos/google/protobuf/compiler/plugin.proto +1 -0
- data/bin/x86-macos/google/protobuf/descriptor.proto +66 -67
- data/bin/x86-macos/google/protobuf/duration.proto +0 -1
- data/bin/x86-macos/google/protobuf/struct.proto +0 -1
- data/bin/x86-macos/google/protobuf/timestamp.proto +6 -5
- data/bin/x86-macos/google/protobuf/type.proto +20 -20
- data/bin/x86-macos/grpc_ruby_plugin +0 -0
- data/bin/x86-macos/protoc +0 -0
- data/bin/x86-windows/google/protobuf/compiler/plugin.proto +1 -0
- data/bin/x86-windows/google/protobuf/descriptor.proto +66 -67
- data/bin/x86-windows/google/protobuf/duration.proto +0 -1
- data/bin/x86-windows/google/protobuf/struct.proto +0 -1
- data/bin/x86-windows/google/protobuf/timestamp.proto +6 -5
- data/bin/x86-windows/google/protobuf/type.proto +20 -20
- data/bin/x86-windows/grpc_ruby_plugin.exe +0 -0
- data/bin/x86-windows/protoc.exe +0 -0
- data/bin/x86_64-linux/google/protobuf/compiler/plugin.proto +1 -0
- data/bin/x86_64-linux/google/protobuf/descriptor.proto +66 -67
- data/bin/x86_64-linux/google/protobuf/duration.proto +0 -1
- data/bin/x86_64-linux/google/protobuf/struct.proto +0 -1
- data/bin/x86_64-linux/google/protobuf/timestamp.proto +6 -5
- data/bin/x86_64-linux/google/protobuf/type.proto +20 -20
- data/bin/x86_64-linux/grpc_ruby_plugin +0 -0
- data/bin/x86_64-linux/protoc +0 -0
- data/bin/x86_64-macos/google/protobuf/compiler/plugin.proto +1 -0
- data/bin/x86_64-macos/google/protobuf/descriptor.proto +66 -67
- data/bin/x86_64-macos/google/protobuf/duration.proto +0 -1
- data/bin/x86_64-macos/google/protobuf/struct.proto +0 -1
- data/bin/x86_64-macos/google/protobuf/timestamp.proto +6 -5
- data/bin/x86_64-macos/google/protobuf/type.proto +20 -20
- data/bin/x86_64-macos/grpc_ruby_plugin +0 -0
- data/bin/x86_64-macos/protoc +0 -0
- data/bin/x86_64-windows/google/protobuf/compiler/plugin.proto +1 -0
- data/bin/x86_64-windows/google/protobuf/descriptor.proto +66 -67
- data/bin/x86_64-windows/google/protobuf/duration.proto +0 -1
- data/bin/x86_64-windows/google/protobuf/struct.proto +0 -1
- data/bin/x86_64-windows/google/protobuf/timestamp.proto +6 -5
- data/bin/x86_64-windows/google/protobuf/type.proto +20 -20
- data/bin/x86_64-windows/grpc_ruby_plugin.exe +0 -0
- data/bin/x86_64-windows/protoc.exe +0 -0
- data/version.rb +1 -1
- metadata +4 -4
@@ -40,6 +40,7 @@
|
|
40
40
|
syntax = "proto2";
|
41
41
|
|
42
42
|
package google.protobuf;
|
43
|
+
|
43
44
|
option go_package = "github.com/golang/protobuf/protoc-gen-go/descriptor;descriptor";
|
44
45
|
option java_package = "com.google.protobuf";
|
45
46
|
option java_outer_classname = "DescriptorProtos";
|
@@ -59,8 +60,8 @@ message FileDescriptorSet {
|
|
59
60
|
|
60
61
|
// Describes a complete .proto file.
|
61
62
|
message FileDescriptorProto {
|
62
|
-
optional string name = 1;
|
63
|
-
optional string package = 2;
|
63
|
+
optional string name = 1; // file name, relative to root of source tree
|
64
|
+
optional string package = 2; // e.g. "foo", "foo.bar", etc.
|
64
65
|
|
65
66
|
// Names of files imported by this file.
|
66
67
|
repeated string dependency = 3;
|
@@ -115,8 +116,8 @@ message DescriptorProto {
|
|
115
116
|
// fields or extension ranges in the same message. Reserved ranges may
|
116
117
|
// not overlap.
|
117
118
|
message ReservedRange {
|
118
|
-
optional int32 start = 1;
|
119
|
-
optional int32 end = 2;
|
119
|
+
optional int32 start = 1; // Inclusive.
|
120
|
+
optional int32 end = 2; // Exclusive.
|
120
121
|
}
|
121
122
|
repeated ReservedRange reserved_range = 9;
|
122
123
|
// Reserved field names, which may not be used by fields in the same message.
|
@@ -137,42 +138,42 @@ message FieldDescriptorProto {
|
|
137
138
|
enum Type {
|
138
139
|
// 0 is reserved for errors.
|
139
140
|
// Order is weird for historical reasons.
|
140
|
-
TYPE_DOUBLE
|
141
|
-
TYPE_FLOAT
|
141
|
+
TYPE_DOUBLE = 1;
|
142
|
+
TYPE_FLOAT = 2;
|
142
143
|
// Not ZigZag encoded. Negative numbers take 10 bytes. Use TYPE_SINT64 if
|
143
144
|
// negative values are likely.
|
144
|
-
TYPE_INT64
|
145
|
-
TYPE_UINT64
|
145
|
+
TYPE_INT64 = 3;
|
146
|
+
TYPE_UINT64 = 4;
|
146
147
|
// Not ZigZag encoded. Negative numbers take 10 bytes. Use TYPE_SINT32 if
|
147
148
|
// negative values are likely.
|
148
|
-
TYPE_INT32
|
149
|
-
TYPE_FIXED64
|
150
|
-
TYPE_FIXED32
|
151
|
-
TYPE_BOOL
|
152
|
-
TYPE_STRING
|
149
|
+
TYPE_INT32 = 5;
|
150
|
+
TYPE_FIXED64 = 6;
|
151
|
+
TYPE_FIXED32 = 7;
|
152
|
+
TYPE_BOOL = 8;
|
153
|
+
TYPE_STRING = 9;
|
153
154
|
// Tag-delimited aggregate.
|
154
155
|
// Group type is deprecated and not supported in proto3. However, Proto3
|
155
156
|
// implementations should still be able to parse the group wire format and
|
156
157
|
// treat group fields as unknown fields.
|
157
|
-
TYPE_GROUP
|
158
|
-
TYPE_MESSAGE
|
158
|
+
TYPE_GROUP = 10;
|
159
|
+
TYPE_MESSAGE = 11; // Length-delimited aggregate.
|
159
160
|
|
160
161
|
// New in version 2.
|
161
|
-
TYPE_BYTES
|
162
|
-
TYPE_UINT32
|
163
|
-
TYPE_ENUM
|
164
|
-
TYPE_SFIXED32
|
165
|
-
TYPE_SFIXED64
|
166
|
-
TYPE_SINT32
|
167
|
-
TYPE_SINT64
|
168
|
-
}
|
162
|
+
TYPE_BYTES = 12;
|
163
|
+
TYPE_UINT32 = 13;
|
164
|
+
TYPE_ENUM = 14;
|
165
|
+
TYPE_SFIXED32 = 15;
|
166
|
+
TYPE_SFIXED64 = 16;
|
167
|
+
TYPE_SINT32 = 17; // Uses ZigZag encoding.
|
168
|
+
TYPE_SINT64 = 18; // Uses ZigZag encoding.
|
169
|
+
}
|
169
170
|
|
170
171
|
enum Label {
|
171
172
|
// 0 is reserved for errors
|
172
|
-
LABEL_OPTIONAL
|
173
|
-
LABEL_REQUIRED
|
174
|
-
LABEL_REPEATED
|
175
|
-
}
|
173
|
+
LABEL_OPTIONAL = 1;
|
174
|
+
LABEL_REQUIRED = 2;
|
175
|
+
LABEL_REPEATED = 3;
|
176
|
+
}
|
176
177
|
|
177
178
|
optional string name = 1;
|
178
179
|
optional int32 number = 3;
|
@@ -234,8 +235,8 @@ message EnumDescriptorProto {
|
|
234
235
|
// is inclusive such that it can appropriately represent the entire int32
|
235
236
|
// domain.
|
236
237
|
message EnumReservedRange {
|
237
|
-
optional int32 start = 1;
|
238
|
-
optional int32 end = 2;
|
238
|
+
optional int32 start = 1; // Inclusive.
|
239
|
+
optional int32 end = 2; // Inclusive.
|
239
240
|
}
|
240
241
|
|
241
242
|
// Range of reserved numeric values. Reserved numeric values may not be used
|
@@ -276,9 +277,9 @@ message MethodDescriptorProto {
|
|
276
277
|
optional MethodOptions options = 4;
|
277
278
|
|
278
279
|
// Identifies if client streams multiple client messages
|
279
|
-
optional bool client_streaming = 5 [default=false];
|
280
|
+
optional bool client_streaming = 5 [default = false];
|
280
281
|
// Identifies if server streams multiple server messages
|
281
|
-
optional bool server_streaming = 6 [default=false];
|
282
|
+
optional bool server_streaming = 6 [default = false];
|
282
283
|
}
|
283
284
|
|
284
285
|
|
@@ -314,7 +315,6 @@ message MethodDescriptorProto {
|
|
314
315
|
// If this turns out to be popular, a web service will be set up
|
315
316
|
// to automatically assign option numbers.
|
316
317
|
|
317
|
-
|
318
318
|
message FileOptions {
|
319
319
|
|
320
320
|
// Sets the Java package where classes generated from this .proto will be
|
@@ -337,7 +337,7 @@ message FileOptions {
|
|
337
337
|
// named by java_outer_classname. However, the outer class will still be
|
338
338
|
// generated to contain the file's getDescriptor() method as well as any
|
339
339
|
// top-level extensions defined in the file.
|
340
|
-
optional bool java_multiple_files = 10 [default=false];
|
340
|
+
optional bool java_multiple_files = 10 [default = false];
|
341
341
|
|
342
342
|
// This option does nothing.
|
343
343
|
optional bool java_generate_equals_and_hash = 20 [deprecated=true];
|
@@ -348,17 +348,17 @@ message FileOptions {
|
|
348
348
|
// Message reflection will do the same.
|
349
349
|
// However, an extension field still accepts non-UTF-8 byte sequences.
|
350
350
|
// This option has no effect on when used with the lite runtime.
|
351
|
-
optional bool java_string_check_utf8 = 27 [default=false];
|
351
|
+
optional bool java_string_check_utf8 = 27 [default = false];
|
352
352
|
|
353
353
|
|
354
354
|
// Generated classes can be optimized for speed or code size.
|
355
355
|
enum OptimizeMode {
|
356
|
-
SPEED = 1;
|
357
|
-
|
358
|
-
CODE_SIZE = 2;
|
359
|
-
LITE_RUNTIME = 3;
|
356
|
+
SPEED = 1; // Generate complete code for parsing, serialization,
|
357
|
+
// etc.
|
358
|
+
CODE_SIZE = 2; // Use ReflectionOps to implement these methods.
|
359
|
+
LITE_RUNTIME = 3; // Generate code using MessageLite and the lite runtime.
|
360
360
|
}
|
361
|
-
optional OptimizeMode optimize_for = 9 [default=SPEED];
|
361
|
+
optional OptimizeMode optimize_for = 9 [default = SPEED];
|
362
362
|
|
363
363
|
// Sets the Go package where structs generated from this .proto will be
|
364
364
|
// placed. If omitted, the Go package will be derived from the following:
|
@@ -379,20 +379,20 @@ message FileOptions {
|
|
379
379
|
// that generate code specific to your particular RPC system. Therefore,
|
380
380
|
// these default to false. Old code which depends on generic services should
|
381
381
|
// explicitly set them to true.
|
382
|
-
optional bool cc_generic_services = 16 [default=false];
|
383
|
-
optional bool java_generic_services = 17 [default=false];
|
384
|
-
optional bool py_generic_services = 18 [default=false];
|
385
|
-
optional bool php_generic_services = 42 [default=false];
|
382
|
+
optional bool cc_generic_services = 16 [default = false];
|
383
|
+
optional bool java_generic_services = 17 [default = false];
|
384
|
+
optional bool py_generic_services = 18 [default = false];
|
385
|
+
optional bool php_generic_services = 42 [default = false];
|
386
386
|
|
387
387
|
// Is this file deprecated?
|
388
388
|
// Depending on the target platform, this can emit Deprecated annotations
|
389
389
|
// for everything in the file, or it will be completely ignored; in the very
|
390
390
|
// least, this is a formalization for deprecating files.
|
391
|
-
optional bool deprecated = 23 [default=false];
|
391
|
+
optional bool deprecated = 23 [default = false];
|
392
392
|
|
393
393
|
// Enables the use of arenas for the proto messages in this file. This applies
|
394
394
|
// only to generated classes for C++.
|
395
|
-
optional bool cc_enable_arenas = 31 [default=false];
|
395
|
+
optional bool cc_enable_arenas = 31 [default = false];
|
396
396
|
|
397
397
|
|
398
398
|
// Sets the objective c class prefix which is prepended to all objective c
|
@@ -417,10 +417,9 @@ message FileOptions {
|
|
417
417
|
// determining the namespace.
|
418
418
|
optional string php_namespace = 41;
|
419
419
|
|
420
|
-
|
421
420
|
// Use this option to change the namespace of php generated metadata classes.
|
422
|
-
// Default is empty. When this option is empty, the proto file name will be
|
423
|
-
// for determining the namespace.
|
421
|
+
// Default is empty. When this option is empty, the proto file name will be
|
422
|
+
// used for determining the namespace.
|
424
423
|
optional string php_metadata_namespace = 44;
|
425
424
|
|
426
425
|
// Use this option to change the package of ruby generated classes. Default
|
@@ -458,18 +457,18 @@ message MessageOptions {
|
|
458
457
|
//
|
459
458
|
// Because this is an option, the above two restrictions are not enforced by
|
460
459
|
// the protocol compiler.
|
461
|
-
optional bool message_set_wire_format = 1 [default=false];
|
460
|
+
optional bool message_set_wire_format = 1 [default = false];
|
462
461
|
|
463
462
|
// Disables the generation of the standard "descriptor()" accessor, which can
|
464
463
|
// conflict with a field of the same name. This is meant to make migration
|
465
464
|
// from proto1 easier; new code should avoid fields named "descriptor".
|
466
|
-
optional bool no_standard_descriptor_accessor = 2 [default=false];
|
465
|
+
optional bool no_standard_descriptor_accessor = 2 [default = false];
|
467
466
|
|
468
467
|
// Is this message deprecated?
|
469
468
|
// Depending on the target platform, this can emit Deprecated annotations
|
470
469
|
// for the message, or it will be completely ignored; in the very least,
|
471
470
|
// this is a formalization for deprecating messages.
|
472
|
-
optional bool deprecated = 3 [default=false];
|
471
|
+
optional bool deprecated = 3 [default = false];
|
473
472
|
|
474
473
|
// Whether the message is an automatically generated map entry type for the
|
475
474
|
// maps field.
|
@@ -486,7 +485,7 @@ message MessageOptions {
|
|
486
485
|
//
|
487
486
|
// Implementations may choose not to generate the map_entry=true message, but
|
488
487
|
// use a native map in the target language to hold the keys and values.
|
489
|
-
// The reflection APIs in such
|
488
|
+
// The reflection APIs in such implementations still need to work as
|
490
489
|
// if the field is a repeated message field.
|
491
490
|
//
|
492
491
|
// NOTE: Do not set the option in .proto files. Always use the maps syntax
|
@@ -576,16 +575,16 @@ message FieldOptions {
|
|
576
575
|
// implementation must either *always* check its required fields, or *never*
|
577
576
|
// check its required fields, regardless of whether or not the message has
|
578
577
|
// been parsed.
|
579
|
-
optional bool lazy = 5 [default=false];
|
578
|
+
optional bool lazy = 5 [default = false];
|
580
579
|
|
581
580
|
// Is this field deprecated?
|
582
581
|
// Depending on the target platform, this can emit Deprecated annotations
|
583
582
|
// for accessors, or it will be completely ignored; in the very least, this
|
584
583
|
// is a formalization for deprecating fields.
|
585
|
-
optional bool deprecated = 3 [default=false];
|
584
|
+
optional bool deprecated = 3 [default = false];
|
586
585
|
|
587
586
|
// For Google-internal migration only. Do not use.
|
588
|
-
optional bool weak = 10 [default=false];
|
587
|
+
optional bool weak = 10 [default = false];
|
589
588
|
|
590
589
|
|
591
590
|
// The parser stores options it doesn't recognize here. See above.
|
@@ -615,7 +614,7 @@ message EnumOptions {
|
|
615
614
|
// Depending on the target platform, this can emit Deprecated annotations
|
616
615
|
// for the enum, or it will be completely ignored; in the very least, this
|
617
616
|
// is a formalization for deprecating enums.
|
618
|
-
optional bool deprecated = 3 [default=false];
|
617
|
+
optional bool deprecated = 3 [default = false];
|
619
618
|
|
620
619
|
reserved 5; // javanano_as_lite
|
621
620
|
|
@@ -631,7 +630,7 @@ message EnumValueOptions {
|
|
631
630
|
// Depending on the target platform, this can emit Deprecated annotations
|
632
631
|
// for the enum value, or it will be completely ignored; in the very least,
|
633
632
|
// this is a formalization for deprecating enum values.
|
634
|
-
optional bool deprecated = 1 [default=false];
|
633
|
+
optional bool deprecated = 1 [default = false];
|
635
634
|
|
636
635
|
// The parser stores options it doesn't recognize here. See above.
|
637
636
|
repeated UninterpretedOption uninterpreted_option = 999;
|
@@ -651,7 +650,7 @@ message ServiceOptions {
|
|
651
650
|
// Depending on the target platform, this can emit Deprecated annotations
|
652
651
|
// for the service, or it will be completely ignored; in the very least,
|
653
652
|
// this is a formalization for deprecating services.
|
654
|
-
optional bool deprecated = 33 [default=false];
|
653
|
+
optional bool deprecated = 33 [default = false];
|
655
654
|
|
656
655
|
// The parser stores options it doesn't recognize here. See above.
|
657
656
|
repeated UninterpretedOption uninterpreted_option = 999;
|
@@ -671,18 +670,18 @@ message MethodOptions {
|
|
671
670
|
// Depending on the target platform, this can emit Deprecated annotations
|
672
671
|
// for the method, or it will be completely ignored; in the very least,
|
673
672
|
// this is a formalization for deprecating methods.
|
674
|
-
optional bool deprecated = 33 [default=false];
|
673
|
+
optional bool deprecated = 33 [default = false];
|
675
674
|
|
676
675
|
// Is this method side-effect-free (or safe in HTTP parlance), or idempotent,
|
677
676
|
// or neither? HTTP based RPC implementation may choose GET verb for safe
|
678
677
|
// methods, and PUT verb for idempotent methods instead of the default POST.
|
679
678
|
enum IdempotencyLevel {
|
680
679
|
IDEMPOTENCY_UNKNOWN = 0;
|
681
|
-
NO_SIDE_EFFECTS
|
682
|
-
IDEMPOTENT
|
680
|
+
NO_SIDE_EFFECTS = 1; // implies idempotent
|
681
|
+
IDEMPOTENT = 2; // idempotent, but may have side effects
|
683
682
|
}
|
684
|
-
optional IdempotencyLevel idempotency_level =
|
685
|
-
|
683
|
+
optional IdempotencyLevel idempotency_level = 34
|
684
|
+
[default = IDEMPOTENCY_UNKNOWN];
|
686
685
|
|
687
686
|
// The parser stores options it doesn't recognize here. See above.
|
688
687
|
repeated UninterpretedOption uninterpreted_option = 999;
|
@@ -763,7 +762,7 @@ message SourceCodeInfo {
|
|
763
762
|
// beginning of the "extend" block and is shared by all extensions within
|
764
763
|
// the block.
|
765
764
|
// - Just because a location's span is a subset of some other location's span
|
766
|
-
// does not mean that it is a
|
765
|
+
// does not mean that it is a descendant. For example, a "group" defines
|
767
766
|
// both a type and a field in a single declaration. Thus, the locations
|
768
767
|
// corresponding to the type and field and their components will overlap.
|
769
768
|
// - Code which tries to interpret locations should probably be designed to
|
@@ -794,14 +793,14 @@ message SourceCodeInfo {
|
|
794
793
|
// [ 4, 3, 2, 7 ]
|
795
794
|
// this path refers to the whole field declaration (from the beginning
|
796
795
|
// of the label to the terminating semicolon).
|
797
|
-
repeated int32 path = 1 [packed=true];
|
796
|
+
repeated int32 path = 1 [packed = true];
|
798
797
|
|
799
798
|
// Always has exactly three or four elements: start line, start column,
|
800
799
|
// end line (optional, otherwise assumed same as start line), end column.
|
801
800
|
// These are packed into a single field for efficiency. Note that line
|
802
801
|
// and column numbers are zero-based -- typically you will want to add
|
803
802
|
// 1 to each before displaying to a user.
|
804
|
-
repeated int32 span = 2 [packed=true];
|
803
|
+
repeated int32 span = 2 [packed = true];
|
805
804
|
|
806
805
|
// If this SourceCodeInfo represents a complete declaration, these are any
|
807
806
|
// comments appearing before and after the declaration which appear to be
|
@@ -866,7 +865,7 @@ message GeneratedCodeInfo {
|
|
866
865
|
message Annotation {
|
867
866
|
// Identifies the element in the original source .proto file. This field
|
868
867
|
// is formatted the same as SourceCodeInfo.Location.path.
|
869
|
-
repeated int32 path = 1 [packed=true];
|
868
|
+
repeated int32 path = 1 [packed = true];
|
870
869
|
|
871
870
|
// Identifies the filesystem path to the original source .proto.
|
872
871
|
optional string source_file = 2;
|
@@ -101,7 +101,6 @@ option objc_class_prefix = "GPB";
|
|
101
101
|
//
|
102
102
|
//
|
103
103
|
message Duration {
|
104
|
-
|
105
104
|
// Signed seconds of the span of time. Must be from -315,576,000,000
|
106
105
|
// to +315,576,000,000 inclusive. Note: these bounds are computed from:
|
107
106
|
// 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
|
@@ -40,7 +40,6 @@ option java_outer_classname = "StructProto";
|
|
40
40
|
option java_multiple_files = true;
|
41
41
|
option objc_class_prefix = "GPB";
|
42
42
|
|
43
|
-
|
44
43
|
// `Struct` represents a structured data value, consisting of fields
|
45
44
|
// which map to dynamically typed values. In some languages, `Struct`
|
46
45
|
// might be supported by a native representation. For example, in
|
@@ -113,17 +113,18 @@ option objc_class_prefix = "GPB";
|
|
113
113
|
// 01:30 UTC on January 15, 2017.
|
114
114
|
//
|
115
115
|
// In JavaScript, one can convert a Date object to this format using the
|
116
|
-
// standard
|
116
|
+
// standard
|
117
|
+
// [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
|
117
118
|
// method. In Python, a standard `datetime.datetime` object can be converted
|
118
|
-
// to this format using
|
119
|
-
//
|
120
|
-
//
|
119
|
+
// to this format using
|
120
|
+
// [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
|
121
|
+
// the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
|
122
|
+
// the Joda Time's [`ISODateTimeFormat.dateTime()`](
|
121
123
|
// http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
|
122
124
|
// ) to obtain a formatter capable of generating timestamps in this format.
|
123
125
|
//
|
124
126
|
//
|
125
127
|
message Timestamp {
|
126
|
-
|
127
128
|
// Represents seconds of UTC time since Unix epoch
|
128
129
|
// 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
|
129
130
|
// 9999-12-31T23:59:59Z inclusive.
|
@@ -64,44 +64,44 @@ message Field {
|
|
64
64
|
// Basic field types.
|
65
65
|
enum Kind {
|
66
66
|
// Field type unknown.
|
67
|
-
TYPE_UNKNOWN
|
67
|
+
TYPE_UNKNOWN = 0;
|
68
68
|
// Field type double.
|
69
|
-
TYPE_DOUBLE
|
69
|
+
TYPE_DOUBLE = 1;
|
70
70
|
// Field type float.
|
71
|
-
TYPE_FLOAT
|
71
|
+
TYPE_FLOAT = 2;
|
72
72
|
// Field type int64.
|
73
|
-
TYPE_INT64
|
73
|
+
TYPE_INT64 = 3;
|
74
74
|
// Field type uint64.
|
75
|
-
TYPE_UINT64
|
75
|
+
TYPE_UINT64 = 4;
|
76
76
|
// Field type int32.
|
77
|
-
TYPE_INT32
|
77
|
+
TYPE_INT32 = 5;
|
78
78
|
// Field type fixed64.
|
79
|
-
TYPE_FIXED64
|
79
|
+
TYPE_FIXED64 = 6;
|
80
80
|
// Field type fixed32.
|
81
|
-
TYPE_FIXED32
|
81
|
+
TYPE_FIXED32 = 7;
|
82
82
|
// Field type bool.
|
83
|
-
TYPE_BOOL
|
83
|
+
TYPE_BOOL = 8;
|
84
84
|
// Field type string.
|
85
|
-
TYPE_STRING
|
85
|
+
TYPE_STRING = 9;
|
86
86
|
// Field type group. Proto2 syntax only, and deprecated.
|
87
|
-
TYPE_GROUP
|
87
|
+
TYPE_GROUP = 10;
|
88
88
|
// Field type message.
|
89
|
-
TYPE_MESSAGE
|
89
|
+
TYPE_MESSAGE = 11;
|
90
90
|
// Field type bytes.
|
91
|
-
TYPE_BYTES
|
91
|
+
TYPE_BYTES = 12;
|
92
92
|
// Field type uint32.
|
93
|
-
TYPE_UINT32
|
93
|
+
TYPE_UINT32 = 13;
|
94
94
|
// Field type enum.
|
95
|
-
TYPE_ENUM
|
95
|
+
TYPE_ENUM = 14;
|
96
96
|
// Field type sfixed32.
|
97
|
-
TYPE_SFIXED32
|
97
|
+
TYPE_SFIXED32 = 15;
|
98
98
|
// Field type sfixed64.
|
99
|
-
TYPE_SFIXED64
|
99
|
+
TYPE_SFIXED64 = 16;
|
100
100
|
// Field type sint32.
|
101
|
-
TYPE_SINT32
|
101
|
+
TYPE_SINT32 = 17;
|
102
102
|
// Field type sint64.
|
103
|
-
TYPE_SINT64
|
104
|
-
}
|
103
|
+
TYPE_SINT64 = 18;
|
104
|
+
}
|
105
105
|
|
106
106
|
// Whether a field is optional, required, or repeated.
|
107
107
|
enum Cardinality {
|
Binary file
|
data/bin/x86_64-linux/protoc
CHANGED
Binary file
|
@@ -40,6 +40,7 @@
|
|
40
40
|
syntax = "proto2";
|
41
41
|
|
42
42
|
package google.protobuf;
|
43
|
+
|
43
44
|
option go_package = "github.com/golang/protobuf/protoc-gen-go/descriptor;descriptor";
|
44
45
|
option java_package = "com.google.protobuf";
|
45
46
|
option java_outer_classname = "DescriptorProtos";
|
@@ -59,8 +60,8 @@ message FileDescriptorSet {
|
|
59
60
|
|
60
61
|
// Describes a complete .proto file.
|
61
62
|
message FileDescriptorProto {
|
62
|
-
optional string name = 1;
|
63
|
-
optional string package = 2;
|
63
|
+
optional string name = 1; // file name, relative to root of source tree
|
64
|
+
optional string package = 2; // e.g. "foo", "foo.bar", etc.
|
64
65
|
|
65
66
|
// Names of files imported by this file.
|
66
67
|
repeated string dependency = 3;
|
@@ -115,8 +116,8 @@ message DescriptorProto {
|
|
115
116
|
// fields or extension ranges in the same message. Reserved ranges may
|
116
117
|
// not overlap.
|
117
118
|
message ReservedRange {
|
118
|
-
optional int32 start = 1;
|
119
|
-
optional int32 end = 2;
|
119
|
+
optional int32 start = 1; // Inclusive.
|
120
|
+
optional int32 end = 2; // Exclusive.
|
120
121
|
}
|
121
122
|
repeated ReservedRange reserved_range = 9;
|
122
123
|
// Reserved field names, which may not be used by fields in the same message.
|
@@ -137,42 +138,42 @@ message FieldDescriptorProto {
|
|
137
138
|
enum Type {
|
138
139
|
// 0 is reserved for errors.
|
139
140
|
// Order is weird for historical reasons.
|
140
|
-
TYPE_DOUBLE
|
141
|
-
TYPE_FLOAT
|
141
|
+
TYPE_DOUBLE = 1;
|
142
|
+
TYPE_FLOAT = 2;
|
142
143
|
// Not ZigZag encoded. Negative numbers take 10 bytes. Use TYPE_SINT64 if
|
143
144
|
// negative values are likely.
|
144
|
-
TYPE_INT64
|
145
|
-
TYPE_UINT64
|
145
|
+
TYPE_INT64 = 3;
|
146
|
+
TYPE_UINT64 = 4;
|
146
147
|
// Not ZigZag encoded. Negative numbers take 10 bytes. Use TYPE_SINT32 if
|
147
148
|
// negative values are likely.
|
148
|
-
TYPE_INT32
|
149
|
-
TYPE_FIXED64
|
150
|
-
TYPE_FIXED32
|
151
|
-
TYPE_BOOL
|
152
|
-
TYPE_STRING
|
149
|
+
TYPE_INT32 = 5;
|
150
|
+
TYPE_FIXED64 = 6;
|
151
|
+
TYPE_FIXED32 = 7;
|
152
|
+
TYPE_BOOL = 8;
|
153
|
+
TYPE_STRING = 9;
|
153
154
|
// Tag-delimited aggregate.
|
154
155
|
// Group type is deprecated and not supported in proto3. However, Proto3
|
155
156
|
// implementations should still be able to parse the group wire format and
|
156
157
|
// treat group fields as unknown fields.
|
157
|
-
TYPE_GROUP
|
158
|
-
TYPE_MESSAGE
|
158
|
+
TYPE_GROUP = 10;
|
159
|
+
TYPE_MESSAGE = 11; // Length-delimited aggregate.
|
159
160
|
|
160
161
|
// New in version 2.
|
161
|
-
TYPE_BYTES
|
162
|
-
TYPE_UINT32
|
163
|
-
TYPE_ENUM
|
164
|
-
TYPE_SFIXED32
|
165
|
-
TYPE_SFIXED64
|
166
|
-
TYPE_SINT32
|
167
|
-
TYPE_SINT64
|
168
|
-
}
|
162
|
+
TYPE_BYTES = 12;
|
163
|
+
TYPE_UINT32 = 13;
|
164
|
+
TYPE_ENUM = 14;
|
165
|
+
TYPE_SFIXED32 = 15;
|
166
|
+
TYPE_SFIXED64 = 16;
|
167
|
+
TYPE_SINT32 = 17; // Uses ZigZag encoding.
|
168
|
+
TYPE_SINT64 = 18; // Uses ZigZag encoding.
|
169
|
+
}
|
169
170
|
|
170
171
|
enum Label {
|
171
172
|
// 0 is reserved for errors
|
172
|
-
LABEL_OPTIONAL
|
173
|
-
LABEL_REQUIRED
|
174
|
-
LABEL_REPEATED
|
175
|
-
}
|
173
|
+
LABEL_OPTIONAL = 1;
|
174
|
+
LABEL_REQUIRED = 2;
|
175
|
+
LABEL_REPEATED = 3;
|
176
|
+
}
|
176
177
|
|
177
178
|
optional string name = 1;
|
178
179
|
optional int32 number = 3;
|
@@ -234,8 +235,8 @@ message EnumDescriptorProto {
|
|
234
235
|
// is inclusive such that it can appropriately represent the entire int32
|
235
236
|
// domain.
|
236
237
|
message EnumReservedRange {
|
237
|
-
optional int32 start = 1;
|
238
|
-
optional int32 end = 2;
|
238
|
+
optional int32 start = 1; // Inclusive.
|
239
|
+
optional int32 end = 2; // Inclusive.
|
239
240
|
}
|
240
241
|
|
241
242
|
// Range of reserved numeric values. Reserved numeric values may not be used
|
@@ -276,9 +277,9 @@ message MethodDescriptorProto {
|
|
276
277
|
optional MethodOptions options = 4;
|
277
278
|
|
278
279
|
// Identifies if client streams multiple client messages
|
279
|
-
optional bool client_streaming = 5 [default=false];
|
280
|
+
optional bool client_streaming = 5 [default = false];
|
280
281
|
// Identifies if server streams multiple server messages
|
281
|
-
optional bool server_streaming = 6 [default=false];
|
282
|
+
optional bool server_streaming = 6 [default = false];
|
282
283
|
}
|
283
284
|
|
284
285
|
|
@@ -314,7 +315,6 @@ message MethodDescriptorProto {
|
|
314
315
|
// If this turns out to be popular, a web service will be set up
|
315
316
|
// to automatically assign option numbers.
|
316
317
|
|
317
|
-
|
318
318
|
message FileOptions {
|
319
319
|
|
320
320
|
// Sets the Java package where classes generated from this .proto will be
|
@@ -337,7 +337,7 @@ message FileOptions {
|
|
337
337
|
// named by java_outer_classname. However, the outer class will still be
|
338
338
|
// generated to contain the file's getDescriptor() method as well as any
|
339
339
|
// top-level extensions defined in the file.
|
340
|
-
optional bool java_multiple_files = 10 [default=false];
|
340
|
+
optional bool java_multiple_files = 10 [default = false];
|
341
341
|
|
342
342
|
// This option does nothing.
|
343
343
|
optional bool java_generate_equals_and_hash = 20 [deprecated=true];
|
@@ -348,17 +348,17 @@ message FileOptions {
|
|
348
348
|
// Message reflection will do the same.
|
349
349
|
// However, an extension field still accepts non-UTF-8 byte sequences.
|
350
350
|
// This option has no effect on when used with the lite runtime.
|
351
|
-
optional bool java_string_check_utf8 = 27 [default=false];
|
351
|
+
optional bool java_string_check_utf8 = 27 [default = false];
|
352
352
|
|
353
353
|
|
354
354
|
// Generated classes can be optimized for speed or code size.
|
355
355
|
enum OptimizeMode {
|
356
|
-
SPEED = 1;
|
357
|
-
|
358
|
-
CODE_SIZE = 2;
|
359
|
-
LITE_RUNTIME = 3;
|
356
|
+
SPEED = 1; // Generate complete code for parsing, serialization,
|
357
|
+
// etc.
|
358
|
+
CODE_SIZE = 2; // Use ReflectionOps to implement these methods.
|
359
|
+
LITE_RUNTIME = 3; // Generate code using MessageLite and the lite runtime.
|
360
360
|
}
|
361
|
-
optional OptimizeMode optimize_for = 9 [default=SPEED];
|
361
|
+
optional OptimizeMode optimize_for = 9 [default = SPEED];
|
362
362
|
|
363
363
|
// Sets the Go package where structs generated from this .proto will be
|
364
364
|
// placed. If omitted, the Go package will be derived from the following:
|
@@ -379,20 +379,20 @@ message FileOptions {
|
|
379
379
|
// that generate code specific to your particular RPC system. Therefore,
|
380
380
|
// these default to false. Old code which depends on generic services should
|
381
381
|
// explicitly set them to true.
|
382
|
-
optional bool cc_generic_services = 16 [default=false];
|
383
|
-
optional bool java_generic_services = 17 [default=false];
|
384
|
-
optional bool py_generic_services = 18 [default=false];
|
385
|
-
optional bool php_generic_services = 42 [default=false];
|
382
|
+
optional bool cc_generic_services = 16 [default = false];
|
383
|
+
optional bool java_generic_services = 17 [default = false];
|
384
|
+
optional bool py_generic_services = 18 [default = false];
|
385
|
+
optional bool php_generic_services = 42 [default = false];
|
386
386
|
|
387
387
|
// Is this file deprecated?
|
388
388
|
// Depending on the target platform, this can emit Deprecated annotations
|
389
389
|
// for everything in the file, or it will be completely ignored; in the very
|
390
390
|
// least, this is a formalization for deprecating files.
|
391
|
-
optional bool deprecated = 23 [default=false];
|
391
|
+
optional bool deprecated = 23 [default = false];
|
392
392
|
|
393
393
|
// Enables the use of arenas for the proto messages in this file. This applies
|
394
394
|
// only to generated classes for C++.
|
395
|
-
optional bool cc_enable_arenas = 31 [default=false];
|
395
|
+
optional bool cc_enable_arenas = 31 [default = false];
|
396
396
|
|
397
397
|
|
398
398
|
// Sets the objective c class prefix which is prepended to all objective c
|
@@ -417,10 +417,9 @@ message FileOptions {
|
|
417
417
|
// determining the namespace.
|
418
418
|
optional string php_namespace = 41;
|
419
419
|
|
420
|
-
|
421
420
|
// Use this option to change the namespace of php generated metadata classes.
|
422
|
-
// Default is empty. When this option is empty, the proto file name will be
|
423
|
-
// for determining the namespace.
|
421
|
+
// Default is empty. When this option is empty, the proto file name will be
|
422
|
+
// used for determining the namespace.
|
424
423
|
optional string php_metadata_namespace = 44;
|
425
424
|
|
426
425
|
// Use this option to change the package of ruby generated classes. Default
|
@@ -458,18 +457,18 @@ message MessageOptions {
|
|
458
457
|
//
|
459
458
|
// Because this is an option, the above two restrictions are not enforced by
|
460
459
|
// the protocol compiler.
|
461
|
-
optional bool message_set_wire_format = 1 [default=false];
|
460
|
+
optional bool message_set_wire_format = 1 [default = false];
|
462
461
|
|
463
462
|
// Disables the generation of the standard "descriptor()" accessor, which can
|
464
463
|
// conflict with a field of the same name. This is meant to make migration
|
465
464
|
// from proto1 easier; new code should avoid fields named "descriptor".
|
466
|
-
optional bool no_standard_descriptor_accessor = 2 [default=false];
|
465
|
+
optional bool no_standard_descriptor_accessor = 2 [default = false];
|
467
466
|
|
468
467
|
// Is this message deprecated?
|
469
468
|
// Depending on the target platform, this can emit Deprecated annotations
|
470
469
|
// for the message, or it will be completely ignored; in the very least,
|
471
470
|
// this is a formalization for deprecating messages.
|
472
|
-
optional bool deprecated = 3 [default=false];
|
471
|
+
optional bool deprecated = 3 [default = false];
|
473
472
|
|
474
473
|
// Whether the message is an automatically generated map entry type for the
|
475
474
|
// maps field.
|
@@ -486,7 +485,7 @@ message MessageOptions {
|
|
486
485
|
//
|
487
486
|
// Implementations may choose not to generate the map_entry=true message, but
|
488
487
|
// use a native map in the target language to hold the keys and values.
|
489
|
-
// The reflection APIs in such
|
488
|
+
// The reflection APIs in such implementations still need to work as
|
490
489
|
// if the field is a repeated message field.
|
491
490
|
//
|
492
491
|
// NOTE: Do not set the option in .proto files. Always use the maps syntax
|
@@ -576,16 +575,16 @@ message FieldOptions {
|
|
576
575
|
// implementation must either *always* check its required fields, or *never*
|
577
576
|
// check its required fields, regardless of whether or not the message has
|
578
577
|
// been parsed.
|
579
|
-
optional bool lazy = 5 [default=false];
|
578
|
+
optional bool lazy = 5 [default = false];
|
580
579
|
|
581
580
|
// Is this field deprecated?
|
582
581
|
// Depending on the target platform, this can emit Deprecated annotations
|
583
582
|
// for accessors, or it will be completely ignored; in the very least, this
|
584
583
|
// is a formalization for deprecating fields.
|
585
|
-
optional bool deprecated = 3 [default=false];
|
584
|
+
optional bool deprecated = 3 [default = false];
|
586
585
|
|
587
586
|
// For Google-internal migration only. Do not use.
|
588
|
-
optional bool weak = 10 [default=false];
|
587
|
+
optional bool weak = 10 [default = false];
|
589
588
|
|
590
589
|
|
591
590
|
// The parser stores options it doesn't recognize here. See above.
|
@@ -615,7 +614,7 @@ message EnumOptions {
|
|
615
614
|
// Depending on the target platform, this can emit Deprecated annotations
|
616
615
|
// for the enum, or it will be completely ignored; in the very least, this
|
617
616
|
// is a formalization for deprecating enums.
|
618
|
-
optional bool deprecated = 3 [default=false];
|
617
|
+
optional bool deprecated = 3 [default = false];
|
619
618
|
|
620
619
|
reserved 5; // javanano_as_lite
|
621
620
|
|
@@ -631,7 +630,7 @@ message EnumValueOptions {
|
|
631
630
|
// Depending on the target platform, this can emit Deprecated annotations
|
632
631
|
// for the enum value, or it will be completely ignored; in the very least,
|
633
632
|
// this is a formalization for deprecating enum values.
|
634
|
-
optional bool deprecated = 1 [default=false];
|
633
|
+
optional bool deprecated = 1 [default = false];
|
635
634
|
|
636
635
|
// The parser stores options it doesn't recognize here. See above.
|
637
636
|
repeated UninterpretedOption uninterpreted_option = 999;
|
@@ -651,7 +650,7 @@ message ServiceOptions {
|
|
651
650
|
// Depending on the target platform, this can emit Deprecated annotations
|
652
651
|
// for the service, or it will be completely ignored; in the very least,
|
653
652
|
// this is a formalization for deprecating services.
|
654
|
-
optional bool deprecated = 33 [default=false];
|
653
|
+
optional bool deprecated = 33 [default = false];
|
655
654
|
|
656
655
|
// The parser stores options it doesn't recognize here. See above.
|
657
656
|
repeated UninterpretedOption uninterpreted_option = 999;
|
@@ -671,18 +670,18 @@ message MethodOptions {
|
|
671
670
|
// Depending on the target platform, this can emit Deprecated annotations
|
672
671
|
// for the method, or it will be completely ignored; in the very least,
|
673
672
|
// this is a formalization for deprecating methods.
|
674
|
-
optional bool deprecated = 33 [default=false];
|
673
|
+
optional bool deprecated = 33 [default = false];
|
675
674
|
|
676
675
|
// Is this method side-effect-free (or safe in HTTP parlance), or idempotent,
|
677
676
|
// or neither? HTTP based RPC implementation may choose GET verb for safe
|
678
677
|
// methods, and PUT verb for idempotent methods instead of the default POST.
|
679
678
|
enum IdempotencyLevel {
|
680
679
|
IDEMPOTENCY_UNKNOWN = 0;
|
681
|
-
NO_SIDE_EFFECTS
|
682
|
-
IDEMPOTENT
|
680
|
+
NO_SIDE_EFFECTS = 1; // implies idempotent
|
681
|
+
IDEMPOTENT = 2; // idempotent, but may have side effects
|
683
682
|
}
|
684
|
-
optional IdempotencyLevel idempotency_level =
|
685
|
-
|
683
|
+
optional IdempotencyLevel idempotency_level = 34
|
684
|
+
[default = IDEMPOTENCY_UNKNOWN];
|
686
685
|
|
687
686
|
// The parser stores options it doesn't recognize here. See above.
|
688
687
|
repeated UninterpretedOption uninterpreted_option = 999;
|
@@ -763,7 +762,7 @@ message SourceCodeInfo {
|
|
763
762
|
// beginning of the "extend" block and is shared by all extensions within
|
764
763
|
// the block.
|
765
764
|
// - Just because a location's span is a subset of some other location's span
|
766
|
-
// does not mean that it is a
|
765
|
+
// does not mean that it is a descendant. For example, a "group" defines
|
767
766
|
// both a type and a field in a single declaration. Thus, the locations
|
768
767
|
// corresponding to the type and field and their components will overlap.
|
769
768
|
// - Code which tries to interpret locations should probably be designed to
|
@@ -794,14 +793,14 @@ message SourceCodeInfo {
|
|
794
793
|
// [ 4, 3, 2, 7 ]
|
795
794
|
// this path refers to the whole field declaration (from the beginning
|
796
795
|
// of the label to the terminating semicolon).
|
797
|
-
repeated int32 path = 1 [packed=true];
|
796
|
+
repeated int32 path = 1 [packed = true];
|
798
797
|
|
799
798
|
// Always has exactly three or four elements: start line, start column,
|
800
799
|
// end line (optional, otherwise assumed same as start line), end column.
|
801
800
|
// These are packed into a single field for efficiency. Note that line
|
802
801
|
// and column numbers are zero-based -- typically you will want to add
|
803
802
|
// 1 to each before displaying to a user.
|
804
|
-
repeated int32 span = 2 [packed=true];
|
803
|
+
repeated int32 span = 2 [packed = true];
|
805
804
|
|
806
805
|
// If this SourceCodeInfo represents a complete declaration, these are any
|
807
806
|
// comments appearing before and after the declaration which appear to be
|
@@ -866,7 +865,7 @@ message GeneratedCodeInfo {
|
|
866
865
|
message Annotation {
|
867
866
|
// Identifies the element in the original source .proto file. This field
|
868
867
|
// is formatted the same as SourceCodeInfo.Location.path.
|
869
|
-
repeated int32 path = 1 [packed=true];
|
868
|
+
repeated int32 path = 1 [packed = true];
|
870
869
|
|
871
870
|
// Identifies the filesystem path to the original source .proto.
|
872
871
|
optional string source_file = 2;
|