| OLD | NEW |
| (Empty) |
| 1 // Protocol Buffers - Google's data interchange format | |
| 2 // Copyright 2008 Google Inc. All rights reserved. | |
| 3 // https://developers.google.com/protocol-buffers/ | |
| 4 // | |
| 5 // Redistribution and use in source and binary forms, with or without | |
| 6 // modification, are permitted provided that the following conditions are | |
| 7 // met: | |
| 8 // | |
| 9 // * Redistributions of source code must retain the above copyright | |
| 10 // notice, this list of conditions and the following disclaimer. | |
| 11 // * Redistributions in binary form must reproduce the above | |
| 12 // copyright notice, this list of conditions and the following disclaimer | |
| 13 // in the documentation and/or other materials provided with the | |
| 14 // distribution. | |
| 15 // * Neither the name of Google Inc. nor the names of its | |
| 16 // contributors may be used to endorse or promote products derived from | |
| 17 // this software without specific prior written permission. | |
| 18 // | |
| 19 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | |
| 20 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | |
| 21 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | |
| 22 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | |
| 23 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | |
| 24 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | |
| 25 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | |
| 26 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | |
| 27 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 28 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | |
| 29 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 30 | |
| 31 syntax = "proto3"; | |
| 32 package conformance; | |
| 33 option java_package = "com.google.protobuf.conformance"; | |
| 34 | |
| 35 // This defines the conformance testing protocol. This protocol exists between | |
| 36 // the conformance test suite itself and the code being tested. For each test, | |
| 37 // the suite will send a ConformanceRequest message and expect a | |
| 38 // ConformanceResponse message. | |
| 39 // | |
| 40 // You can either run the tests in two different ways: | |
| 41 // | |
| 42 // 1. in-process (using the interface in conformance_test.h). | |
| 43 // | |
| 44 // 2. as a sub-process communicating over a pipe. Information about how to | |
| 45 // do this is in conformance_test_runner.cc. | |
| 46 // | |
| 47 // Pros/cons of the two approaches: | |
| 48 // | |
| 49 // - running as a sub-process is much simpler for languages other than C/C++. | |
| 50 // | |
| 51 // - running as a sub-process may be more tricky in unusual environments like | |
| 52 // iOS apps, where fork/stdin/stdout are not available. | |
| 53 | |
| 54 enum WireFormat { | |
| 55 UNSPECIFIED = 0; | |
| 56 PROTOBUF = 1; | |
| 57 JSON = 2; | |
| 58 } | |
| 59 | |
| 60 // Represents a single test case's input. The testee should: | |
| 61 // | |
| 62 // 1. parse this proto (which should always succeed) | |
| 63 // 2. parse the protobuf or JSON payload in "payload" (which may fail) | |
| 64 // 3. if the parse succeeded, serialize the message in the requested format. | |
| 65 message ConformanceRequest { | |
| 66 // The payload (whether protobuf of JSON) is always for a TestAllTypes proto | |
| 67 // (see below). | |
| 68 oneof payload { | |
| 69 bytes protobuf_payload = 1; | |
| 70 string json_payload = 2; | |
| 71 } | |
| 72 | |
| 73 // Which format should the testee serialize its message to? | |
| 74 WireFormat requested_output_format = 3; | |
| 75 } | |
| 76 | |
| 77 // Represents a single test case's output. | |
| 78 message ConformanceResponse { | |
| 79 oneof result { | |
| 80 // This string should be set to indicate parsing failed. The string can | |
| 81 // provide more information about the parse error if it is available. | |
| 82 // | |
| 83 // Setting this string does not necessarily mean the testee failed the | |
| 84 // test. Some of the test cases are intentionally invalid input. | |
| 85 string parse_error = 1; | |
| 86 | |
| 87 // This should be set if some other error occurred. This will always | |
| 88 // indicate that the test failed. The string can provide more information | |
| 89 // about the failure. | |
| 90 string runtime_error = 2; | |
| 91 | |
| 92 // If the input was successfully parsed and the requested output was | |
| 93 // protobuf, serialize it to protobuf and set it in this field. | |
| 94 bytes protobuf_payload = 3; | |
| 95 | |
| 96 // If the input was successfully parsed and the requested output was JSON, | |
| 97 // serialize to JSON and set it in this field. | |
| 98 string json_payload = 4; | |
| 99 | |
| 100 // For when the testee skipped the test, likely because a certain feature | |
| 101 // wasn't supported, like JSON input/output. | |
| 102 string skipped = 5; | |
| 103 } | |
| 104 } | |
| 105 | |
| 106 // This proto includes every type of field in both singular and repeated | |
| 107 // forms. | |
| 108 message TestAllTypes { | |
| 109 message NestedMessage { | |
| 110 int32 a = 1; | |
| 111 TestAllTypes corecursive = 2; | |
| 112 } | |
| 113 | |
| 114 enum NestedEnum { | |
| 115 FOO = 0; | |
| 116 BAR = 1; | |
| 117 BAZ = 2; | |
| 118 NEG = -1; // Intentionally negative. | |
| 119 } | |
| 120 | |
| 121 // Singular | |
| 122 int32 optional_int32 = 1; | |
| 123 int64 optional_int64 = 2; | |
| 124 uint32 optional_uint32 = 3; | |
| 125 uint64 optional_uint64 = 4; | |
| 126 sint32 optional_sint32 = 5; | |
| 127 sint64 optional_sint64 = 6; | |
| 128 fixed32 optional_fixed32 = 7; | |
| 129 fixed64 optional_fixed64 = 8; | |
| 130 sfixed32 optional_sfixed32 = 9; | |
| 131 sfixed64 optional_sfixed64 = 10; | |
| 132 float optional_float = 11; | |
| 133 double optional_double = 12; | |
| 134 bool optional_bool = 13; | |
| 135 string optional_string = 14; | |
| 136 bytes optional_bytes = 15; | |
| 137 | |
| 138 NestedMessage optional_nested_message = 18; | |
| 139 ForeignMessage optional_foreign_message = 19; | |
| 140 | |
| 141 NestedEnum optional_nested_enum = 21; | |
| 142 ForeignEnum optional_foreign_enum = 22; | |
| 143 | |
| 144 string optional_string_piece = 24 [ctype=STRING_PIECE]; | |
| 145 string optional_cord = 25 [ctype=CORD]; | |
| 146 | |
| 147 TestAllTypes recursive_message = 27; | |
| 148 | |
| 149 // Repeated | |
| 150 repeated int32 repeated_int32 = 31; | |
| 151 repeated int64 repeated_int64 = 32; | |
| 152 repeated uint32 repeated_uint32 = 33; | |
| 153 repeated uint64 repeated_uint64 = 34; | |
| 154 repeated sint32 repeated_sint32 = 35; | |
| 155 repeated sint64 repeated_sint64 = 36; | |
| 156 repeated fixed32 repeated_fixed32 = 37; | |
| 157 repeated fixed64 repeated_fixed64 = 38; | |
| 158 repeated sfixed32 repeated_sfixed32 = 39; | |
| 159 repeated sfixed64 repeated_sfixed64 = 40; | |
| 160 repeated float repeated_float = 41; | |
| 161 repeated double repeated_double = 42; | |
| 162 repeated bool repeated_bool = 43; | |
| 163 repeated string repeated_string = 44; | |
| 164 repeated bytes repeated_bytes = 45; | |
| 165 | |
| 166 repeated NestedMessage repeated_nested_message = 48; | |
| 167 repeated ForeignMessage repeated_foreign_message = 49; | |
| 168 | |
| 169 repeated NestedEnum repeated_nested_enum = 51; | |
| 170 repeated ForeignEnum repeated_foreign_enum = 52; | |
| 171 | |
| 172 repeated string repeated_string_piece = 54 [ctype=STRING_PIECE]; | |
| 173 repeated string repeated_cord = 55 [ctype=CORD]; | |
| 174 | |
| 175 // Map | |
| 176 map < int32, int32> map_int32_int32 = 56; | |
| 177 map < int64, int64> map_int64_int64 = 57; | |
| 178 map < uint32, uint32> map_uint32_uint32 = 58; | |
| 179 map < uint64, uint64> map_uint64_uint64 = 59; | |
| 180 map < sint32, sint32> map_sint32_sint32 = 60; | |
| 181 map < sint64, sint64> map_sint64_sint64 = 61; | |
| 182 map < fixed32, fixed32> map_fixed32_fixed32 = 62; | |
| 183 map < fixed64, fixed64> map_fixed64_fixed64 = 63; | |
| 184 map <sfixed32, sfixed32> map_sfixed32_sfixed32 = 64; | |
| 185 map <sfixed64, sfixed64> map_sfixed64_sfixed64 = 65; | |
| 186 map < int32, float> map_int32_float = 66; | |
| 187 map < int32, double> map_int32_double = 67; | |
| 188 map < bool, bool> map_bool_bool = 68; | |
| 189 map < string, string> map_string_string = 69; | |
| 190 map < string, bytes> map_string_bytes = 70; | |
| 191 map < string, NestedMessage> map_string_nested_message = 71; | |
| 192 map < string, ForeignMessage> map_string_foreign_message = 72; | |
| 193 map < string, NestedEnum> map_string_nested_enum = 73; | |
| 194 map < string, ForeignEnum> map_string_foreign_enum = 74; | |
| 195 | |
| 196 oneof oneof_field { | |
| 197 uint32 oneof_uint32 = 111; | |
| 198 NestedMessage oneof_nested_message = 112; | |
| 199 string oneof_string = 113; | |
| 200 bytes oneof_bytes = 114; | |
| 201 } | |
| 202 } | |
| 203 | |
| 204 message ForeignMessage { | |
| 205 int32 c = 1; | |
| 206 } | |
| 207 | |
| 208 enum ForeignEnum { | |
| 209 FOREIGN_FOO = 0; | |
| 210 FOREIGN_BAR = 1; | |
| 211 FOREIGN_BAZ = 2; | |
| 212 } | |
| OLD | NEW |