blob: f1d6bf9900f0f9a2bc0b5c1ec3b945f37ad71a23 [file] [log] [blame]
Tamir Duberstein9d9d0b72015-04-11 20:23:45 -07001#! /usr/bin/env python
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +00002#
3# Protocol Buffers - Google's data interchange format
4# Copyright 2008 Google Inc. All rights reserved.
Feng Xiaoe4288622014-10-01 16:26:23 -07005# https://developers.google.com/protocol-buffers/
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +00006#
7# Redistribution and use in source and binary forms, with or without
8# modification, are permitted provided that the following conditions are
9# met:
10#
11# * Redistributions of source code must retain the above copyright
12# notice, this list of conditions and the following disclaimer.
13# * Redistributions in binary form must reproduce the above
14# copyright notice, this list of conditions and the following disclaimer
15# in the documentation and/or other materials provided with the
16# distribution.
17# * Neither the name of Google Inc. nor the names of its
18# contributors may be used to endorse or promote products derived from
19# this software without specific prior written permission.
20#
21# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32
33"""Tests for google.protobuf.descriptor_pool."""
34
35__author__ = 'matthewtoia@google.com (Matt Toia)'
36
jieluo@google.combde4a322014-08-12 21:10:30 +000037import os
jieluo@google.combde4a322014-08-12 21:10:30 +000038
Jisi Liudbea00a2015-10-05 16:08:22 -070039try:
40 import unittest2 as unittest
41except ImportError:
42 import unittest
Feng Xiaoe841bac2015-12-11 17:09:20 -080043from google.protobuf import unittest_import_pb2
44from google.protobuf import unittest_import_public_pb2
jieluo@google.combde4a322014-08-12 21:10:30 +000045from google.protobuf import unittest_pb2
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000046from google.protobuf import descriptor_pb2
jieluo@google.combde4a322014-08-12 21:10:30 +000047from google.protobuf.internal import api_implementation
48from google.protobuf.internal import descriptor_pool_test1_pb2
49from google.protobuf.internal import descriptor_pool_test2_pb2
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000050from google.protobuf.internal import factory_test1_pb2
51from google.protobuf.internal import factory_test2_pb2
Jisi Liu46e8ff62015-10-05 11:59:43 -070052from google.protobuf.internal import test_util
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000053from google.protobuf import descriptor
54from google.protobuf import descriptor_database
55from google.protobuf import descriptor_pool
Feng Xiaoe841bac2015-12-11 17:09:20 -080056from google.protobuf import message_factory
Feng Xiao6ef984a2014-11-10 17:34:54 -080057from google.protobuf import symbol_database
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000058
59
Tres Seaver7ee25832015-01-13 14:47:32 -050060class DescriptorPoolTest(unittest.TestCase):
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000061
Feng Xiaoe841bac2015-12-11 17:09:20 -080062 def CreatePool(self):
63 return descriptor_pool.DescriptorPool()
64
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000065 def setUp(self):
Feng Xiaoe841bac2015-12-11 17:09:20 -080066 self.pool = self.CreatePool()
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000067 self.factory_test1_fd = descriptor_pb2.FileDescriptorProto.FromString(
68 factory_test1_pb2.DESCRIPTOR.serialized_pb)
69 self.factory_test2_fd = descriptor_pb2.FileDescriptorProto.FromString(
70 factory_test2_pb2.DESCRIPTOR.serialized_pb)
71 self.pool.Add(self.factory_test1_fd)
72 self.pool.Add(self.factory_test2_fd)
73
74 def testFindFileByName(self):
jieluo@google.combde4a322014-08-12 21:10:30 +000075 name1 = 'google/protobuf/internal/factory_test1.proto'
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000076 file_desc1 = self.pool.FindFileByName(name1)
77 self.assertIsInstance(file_desc1, descriptor.FileDescriptor)
Tres Seavera2abc942015-01-13 15:47:55 -050078 self.assertEqual(name1, file_desc1.name)
79 self.assertEqual('google.protobuf.python.internal', file_desc1.package)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000080 self.assertIn('Factory1Message', file_desc1.message_types_by_name)
81
jieluo@google.combde4a322014-08-12 21:10:30 +000082 name2 = 'google/protobuf/internal/factory_test2.proto'
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000083 file_desc2 = self.pool.FindFileByName(name2)
84 self.assertIsInstance(file_desc2, descriptor.FileDescriptor)
Tres Seavera2abc942015-01-13 15:47:55 -050085 self.assertEqual(name2, file_desc2.name)
86 self.assertEqual('google.protobuf.python.internal', file_desc2.package)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000087 self.assertIn('Factory2Message', file_desc2.message_types_by_name)
88
89 def testFindFileByNameFailure(self):
jieluo@google.combde4a322014-08-12 21:10:30 +000090 with self.assertRaises(KeyError):
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000091 self.pool.FindFileByName('Does not exist')
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000092
93 def testFindFileContainingSymbol(self):
94 file_desc1 = self.pool.FindFileContainingSymbol(
jieluo@google.combde4a322014-08-12 21:10:30 +000095 'google.protobuf.python.internal.Factory1Message')
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +000096 self.assertIsInstance(file_desc1, descriptor.FileDescriptor)
Tres Seavera2abc942015-01-13 15:47:55 -050097 self.assertEqual('google/protobuf/internal/factory_test1.proto',
Feng Xiaoe841bac2015-12-11 17:09:20 -080098 file_desc1.name)
Tres Seavera2abc942015-01-13 15:47:55 -050099 self.assertEqual('google.protobuf.python.internal', file_desc1.package)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000100 self.assertIn('Factory1Message', file_desc1.message_types_by_name)
101
102 file_desc2 = self.pool.FindFileContainingSymbol(
jieluo@google.combde4a322014-08-12 21:10:30 +0000103 'google.protobuf.python.internal.Factory2Message')
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000104 self.assertIsInstance(file_desc2, descriptor.FileDescriptor)
Tres Seavera2abc942015-01-13 15:47:55 -0500105 self.assertEqual('google/protobuf/internal/factory_test2.proto',
Feng Xiaoe841bac2015-12-11 17:09:20 -0800106 file_desc2.name)
Tres Seavera2abc942015-01-13 15:47:55 -0500107 self.assertEqual('google.protobuf.python.internal', file_desc2.package)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000108 self.assertIn('Factory2Message', file_desc2.message_types_by_name)
109
110 def testFindFileContainingSymbolFailure(self):
jieluo@google.combde4a322014-08-12 21:10:30 +0000111 with self.assertRaises(KeyError):
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000112 self.pool.FindFileContainingSymbol('Does not exist')
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000113
114 def testFindMessageTypeByName(self):
115 msg1 = self.pool.FindMessageTypeByName(
jieluo@google.combde4a322014-08-12 21:10:30 +0000116 'google.protobuf.python.internal.Factory1Message')
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000117 self.assertIsInstance(msg1, descriptor.Descriptor)
Tres Seavera2abc942015-01-13 15:47:55 -0500118 self.assertEqual('Factory1Message', msg1.name)
119 self.assertEqual('google.protobuf.python.internal.Factory1Message',
Feng Xiaoe841bac2015-12-11 17:09:20 -0800120 msg1.full_name)
Tres Seavera2abc942015-01-13 15:47:55 -0500121 self.assertEqual(None, msg1.containing_type)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000122
123 nested_msg1 = msg1.nested_types[0]
Tres Seavera2abc942015-01-13 15:47:55 -0500124 self.assertEqual('NestedFactory1Message', nested_msg1.name)
125 self.assertEqual(msg1, nested_msg1.containing_type)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000126
127 nested_enum1 = msg1.enum_types[0]
Tres Seavera2abc942015-01-13 15:47:55 -0500128 self.assertEqual('NestedFactory1Enum', nested_enum1.name)
129 self.assertEqual(msg1, nested_enum1.containing_type)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000130
Tres Seavera2abc942015-01-13 15:47:55 -0500131 self.assertEqual(nested_msg1, msg1.fields_by_name[
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000132 'nested_factory_1_message'].message_type)
Tres Seavera2abc942015-01-13 15:47:55 -0500133 self.assertEqual(nested_enum1, msg1.fields_by_name[
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000134 'nested_factory_1_enum'].enum_type)
135
136 msg2 = self.pool.FindMessageTypeByName(
jieluo@google.combde4a322014-08-12 21:10:30 +0000137 'google.protobuf.python.internal.Factory2Message')
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000138 self.assertIsInstance(msg2, descriptor.Descriptor)
Tres Seavera2abc942015-01-13 15:47:55 -0500139 self.assertEqual('Factory2Message', msg2.name)
140 self.assertEqual('google.protobuf.python.internal.Factory2Message',
Feng Xiaoe841bac2015-12-11 17:09:20 -0800141 msg2.full_name)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000142 self.assertIsNone(msg2.containing_type)
143
144 nested_msg2 = msg2.nested_types[0]
Tres Seavera2abc942015-01-13 15:47:55 -0500145 self.assertEqual('NestedFactory2Message', nested_msg2.name)
146 self.assertEqual(msg2, nested_msg2.containing_type)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000147
148 nested_enum2 = msg2.enum_types[0]
Tres Seavera2abc942015-01-13 15:47:55 -0500149 self.assertEqual('NestedFactory2Enum', nested_enum2.name)
150 self.assertEqual(msg2, nested_enum2.containing_type)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000151
Tres Seavera2abc942015-01-13 15:47:55 -0500152 self.assertEqual(nested_msg2, msg2.fields_by_name[
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000153 'nested_factory_2_message'].message_type)
Tres Seavera2abc942015-01-13 15:47:55 -0500154 self.assertEqual(nested_enum2, msg2.fields_by_name[
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000155 'nested_factory_2_enum'].enum_type)
156
jieluo@google.combde4a322014-08-12 21:10:30 +0000157 self.assertTrue(msg2.fields_by_name['int_with_default'].has_default_value)
Tres Seavera2abc942015-01-13 15:47:55 -0500158 self.assertEqual(
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000159 1776, msg2.fields_by_name['int_with_default'].default_value)
160
jieluo@google.combde4a322014-08-12 21:10:30 +0000161 self.assertTrue(
162 msg2.fields_by_name['double_with_default'].has_default_value)
Tres Seavera2abc942015-01-13 15:47:55 -0500163 self.assertEqual(
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000164 9.99, msg2.fields_by_name['double_with_default'].default_value)
165
jieluo@google.combde4a322014-08-12 21:10:30 +0000166 self.assertTrue(
167 msg2.fields_by_name['string_with_default'].has_default_value)
Tres Seavera2abc942015-01-13 15:47:55 -0500168 self.assertEqual(
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000169 'hello world', msg2.fields_by_name['string_with_default'].default_value)
170
jieluo@google.combde4a322014-08-12 21:10:30 +0000171 self.assertTrue(msg2.fields_by_name['bool_with_default'].has_default_value)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000172 self.assertFalse(msg2.fields_by_name['bool_with_default'].default_value)
173
jieluo@google.combde4a322014-08-12 21:10:30 +0000174 self.assertTrue(msg2.fields_by_name['enum_with_default'].has_default_value)
Tres Seavera2abc942015-01-13 15:47:55 -0500175 self.assertEqual(
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000176 1, msg2.fields_by_name['enum_with_default'].default_value)
177
178 msg3 = self.pool.FindMessageTypeByName(
jieluo@google.combde4a322014-08-12 21:10:30 +0000179 'google.protobuf.python.internal.Factory2Message.NestedFactory2Message')
Tres Seavera2abc942015-01-13 15:47:55 -0500180 self.assertEqual(nested_msg2, msg3)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000181
jieluo@google.combde4a322014-08-12 21:10:30 +0000182 self.assertTrue(msg2.fields_by_name['bytes_with_default'].has_default_value)
Tres Seavera2abc942015-01-13 15:47:55 -0500183 self.assertEqual(
jieluo@google.combde4a322014-08-12 21:10:30 +0000184 b'a\xfb\x00c',
185 msg2.fields_by_name['bytes_with_default'].default_value)
186
187 self.assertEqual(1, len(msg2.oneofs))
188 self.assertEqual(1, len(msg2.oneofs_by_name))
189 self.assertEqual(2, len(msg2.oneofs[0].fields))
190 for name in ['oneof_int', 'oneof_string']:
191 self.assertEqual(msg2.oneofs[0],
192 msg2.fields_by_name[name].containing_oneof)
193 self.assertIn(msg2.fields_by_name[name], msg2.oneofs[0].fields)
194
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000195 def testFindMessageTypeByNameFailure(self):
jieluo@google.combde4a322014-08-12 21:10:30 +0000196 with self.assertRaises(KeyError):
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000197 self.pool.FindMessageTypeByName('Does not exist')
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000198
199 def testFindEnumTypeByName(self):
200 enum1 = self.pool.FindEnumTypeByName(
jieluo@google.combde4a322014-08-12 21:10:30 +0000201 'google.protobuf.python.internal.Factory1Enum')
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000202 self.assertIsInstance(enum1, descriptor.EnumDescriptor)
Tres Seavera2abc942015-01-13 15:47:55 -0500203 self.assertEqual(0, enum1.values_by_name['FACTORY_1_VALUE_0'].number)
204 self.assertEqual(1, enum1.values_by_name['FACTORY_1_VALUE_1'].number)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000205
206 nested_enum1 = self.pool.FindEnumTypeByName(
jieluo@google.combde4a322014-08-12 21:10:30 +0000207 'google.protobuf.python.internal.Factory1Message.NestedFactory1Enum')
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000208 self.assertIsInstance(nested_enum1, descriptor.EnumDescriptor)
Tres Seavera2abc942015-01-13 15:47:55 -0500209 self.assertEqual(
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000210 0, nested_enum1.values_by_name['NESTED_FACTORY_1_VALUE_0'].number)
Tres Seavera2abc942015-01-13 15:47:55 -0500211 self.assertEqual(
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000212 1, nested_enum1.values_by_name['NESTED_FACTORY_1_VALUE_1'].number)
213
214 enum2 = self.pool.FindEnumTypeByName(
jieluo@google.combde4a322014-08-12 21:10:30 +0000215 'google.protobuf.python.internal.Factory2Enum')
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000216 self.assertIsInstance(enum2, descriptor.EnumDescriptor)
Tres Seavera2abc942015-01-13 15:47:55 -0500217 self.assertEqual(0, enum2.values_by_name['FACTORY_2_VALUE_0'].number)
218 self.assertEqual(1, enum2.values_by_name['FACTORY_2_VALUE_1'].number)
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000219
220 nested_enum2 = self.pool.FindEnumTypeByName(
jieluo@google.combde4a322014-08-12 21:10:30 +0000221 'google.protobuf.python.internal.Factory2Message.NestedFactory2Enum')
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000222 self.assertIsInstance(nested_enum2, descriptor.EnumDescriptor)
Tres Seavera2abc942015-01-13 15:47:55 -0500223 self.assertEqual(
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000224 0, nested_enum2.values_by_name['NESTED_FACTORY_2_VALUE_0'].number)
Tres Seavera2abc942015-01-13 15:47:55 -0500225 self.assertEqual(
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000226 1, nested_enum2.values_by_name['NESTED_FACTORY_2_VALUE_1'].number)
227
228 def testFindEnumTypeByNameFailure(self):
jieluo@google.combde4a322014-08-12 21:10:30 +0000229 with self.assertRaises(KeyError):
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000230 self.pool.FindEnumTypeByName('Does not exist')
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000231
Feng Xiaoe841bac2015-12-11 17:09:20 -0800232 def testFindFieldByName(self):
233 field = self.pool.FindFieldByName(
234 'google.protobuf.python.internal.Factory1Message.list_value')
235 self.assertEqual(field.name, 'list_value')
236 self.assertEqual(field.label, field.LABEL_REPEATED)
237 with self.assertRaises(KeyError):
238 self.pool.FindFieldByName('Does not exist')
239
240 def testFindExtensionByName(self):
241 # An extension defined in a message.
242 extension = self.pool.FindExtensionByName(
243 'google.protobuf.python.internal.Factory2Message.one_more_field')
244 self.assertEqual(extension.name, 'one_more_field')
245 # An extension defined at file scope.
246 extension = self.pool.FindExtensionByName(
247 'google.protobuf.python.internal.another_field')
248 self.assertEqual(extension.name, 'another_field')
249 self.assertEqual(extension.number, 1002)
250 with self.assertRaises(KeyError):
251 self.pool.FindFieldByName('Does not exist')
252
253 def testExtensionsAreNotFields(self):
254 with self.assertRaises(KeyError):
255 self.pool.FindFieldByName('google.protobuf.python.internal.another_field')
256 with self.assertRaises(KeyError):
257 self.pool.FindFieldByName(
258 'google.protobuf.python.internal.Factory2Message.one_more_field')
259 with self.assertRaises(KeyError):
260 self.pool.FindExtensionByName(
261 'google.protobuf.python.internal.Factory1Message.list_value')
262
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000263 def testUserDefinedDB(self):
264 db = descriptor_database.DescriptorDatabase()
265 self.pool = descriptor_pool.DescriptorPool(db)
266 db.Add(self.factory_test1_fd)
267 db.Add(self.factory_test2_fd)
268 self.testFindMessageTypeByName()
269
Bo Yang5db21732015-05-21 14:28:59 -0700270 def testAddSerializedFile(self):
Feng Xiaoe841bac2015-12-11 17:09:20 -0800271 self.pool = descriptor_pool.DescriptorPool()
Bo Yang5db21732015-05-21 14:28:59 -0700272 self.pool.AddSerializedFile(self.factory_test1_fd.SerializeToString())
273 self.pool.AddSerializedFile(self.factory_test2_fd.SerializeToString())
274 self.testFindMessageTypeByName()
275
jieluo@google.combde4a322014-08-12 21:10:30 +0000276 def testComplexNesting(self):
277 test1_desc = descriptor_pb2.FileDescriptorProto.FromString(
278 descriptor_pool_test1_pb2.DESCRIPTOR.serialized_pb)
279 test2_desc = descriptor_pb2.FileDescriptorProto.FromString(
280 descriptor_pool_test2_pb2.DESCRIPTOR.serialized_pb)
281 self.pool.Add(test1_desc)
282 self.pool.Add(test2_desc)
283 TEST1_FILE.CheckFile(self, self.pool)
284 TEST2_FILE.CheckFile(self, self.pool)
285
286
Feng Xiao6ef984a2014-11-10 17:34:54 -0800287 def testEnumDefaultValue(self):
288 """Test the default value of enums which don't start at zero."""
289 def _CheckDefaultValue(file_descriptor):
290 default_value = (file_descriptor
291 .message_types_by_name['DescriptorPoolTest1']
292 .fields_by_name['nested_enum']
293 .default_value)
294 self.assertEqual(default_value,
295 descriptor_pool_test1_pb2.DescriptorPoolTest1.BETA)
296 # First check what the generated descriptor contains.
297 _CheckDefaultValue(descriptor_pool_test1_pb2.DESCRIPTOR)
298 # Then check the generated pool. Normally this is the same descriptor.
299 file_descriptor = symbol_database.Default().pool.FindFileByName(
300 'google/protobuf/internal/descriptor_pool_test1.proto')
301 self.assertIs(file_descriptor, descriptor_pool_test1_pb2.DESCRIPTOR)
302 _CheckDefaultValue(file_descriptor)
303
304 # Then check the dynamic pool and its internal DescriptorDatabase.
305 descriptor_proto = descriptor_pb2.FileDescriptorProto.FromString(
306 descriptor_pool_test1_pb2.DESCRIPTOR.serialized_pb)
307 self.pool.Add(descriptor_proto)
308 # And do the same check as above
309 file_descriptor = self.pool.FindFileByName(
310 'google/protobuf/internal/descriptor_pool_test1.proto')
311 _CheckDefaultValue(file_descriptor)
312
Feng Xiaoe841bac2015-12-11 17:09:20 -0800313 def testDefaultValueForCustomMessages(self):
314 """Check the value returned by non-existent fields."""
315 def _CheckValueAndType(value, expected_value, expected_type):
316 self.assertEqual(value, expected_value)
317 self.assertIsInstance(value, expected_type)
318
319 def _CheckDefaultValues(msg):
320 try:
321 int64 = long
322 except NameError: # Python3
323 int64 = int
324 try:
325 unicode_type = unicode
326 except NameError: # Python3
327 unicode_type = str
328 _CheckValueAndType(msg.optional_int32, 0, int)
329 _CheckValueAndType(msg.optional_uint64, 0, (int64, int))
330 _CheckValueAndType(msg.optional_float, 0, (float, int))
331 _CheckValueAndType(msg.optional_double, 0, (float, int))
332 _CheckValueAndType(msg.optional_bool, False, bool)
333 _CheckValueAndType(msg.optional_string, u'', unicode_type)
334 _CheckValueAndType(msg.optional_bytes, b'', bytes)
335 _CheckValueAndType(msg.optional_nested_enum, msg.FOO, int)
336 # First for the generated message
337 _CheckDefaultValues(unittest_pb2.TestAllTypes())
338 # Then for a message built with from the DescriptorPool.
339 pool = descriptor_pool.DescriptorPool()
340 pool.Add(descriptor_pb2.FileDescriptorProto.FromString(
341 unittest_import_public_pb2.DESCRIPTOR.serialized_pb))
342 pool.Add(descriptor_pb2.FileDescriptorProto.FromString(
343 unittest_import_pb2.DESCRIPTOR.serialized_pb))
344 pool.Add(descriptor_pb2.FileDescriptorProto.FromString(
345 unittest_pb2.DESCRIPTOR.serialized_pb))
346 message_class = message_factory.MessageFactory(pool).GetPrototype(
347 pool.FindMessageTypeByName(
348 unittest_pb2.TestAllTypes.DESCRIPTOR.full_name))
349 _CheckDefaultValues(message_class())
350
351
352@unittest.skipIf(api_implementation.Type() != 'cpp',
353 'explicit tests of the C++ implementation')
354class CppDescriptorPoolTest(DescriptorPoolTest):
355 # TODO(amauryfa): remove when descriptor_pool.DescriptorPool() creates true
356 # C++ descriptor pool object for C++ implementation.
357
358 def CreatePool(self):
359 # pylint: disable=g-import-not-at-top
360 from google.protobuf.pyext import _message
361 return _message.DescriptorPool()
362
jieluo@google.combde4a322014-08-12 21:10:30 +0000363
364class ProtoFile(object):
365
366 def __init__(self, name, package, messages, dependencies=None):
367 self.name = name
368 self.package = package
369 self.messages = messages
370 self.dependencies = dependencies or []
371
372 def CheckFile(self, test, pool):
373 file_desc = pool.FindFileByName(self.name)
Tres Seavera2abc942015-01-13 15:47:55 -0500374 test.assertEqual(self.name, file_desc.name)
375 test.assertEqual(self.package, file_desc.package)
jieluo@google.combde4a322014-08-12 21:10:30 +0000376 dependencies_names = [f.name for f in file_desc.dependencies]
377 test.assertEqual(self.dependencies, dependencies_names)
378 for name, msg_type in self.messages.items():
379 msg_type.CheckType(test, None, name, file_desc)
380
381
382class EnumType(object):
383
384 def __init__(self, values):
385 self.values = values
386
387 def CheckType(self, test, msg_desc, name, file_desc):
388 enum_desc = msg_desc.enum_types_by_name[name]
389 test.assertEqual(name, enum_desc.name)
390 expected_enum_full_name = '.'.join([msg_desc.full_name, name])
391 test.assertEqual(expected_enum_full_name, enum_desc.full_name)
392 test.assertEqual(msg_desc, enum_desc.containing_type)
393 test.assertEqual(file_desc, enum_desc.file)
394 for index, (value, number) in enumerate(self.values):
395 value_desc = enum_desc.values_by_name[value]
396 test.assertEqual(value, value_desc.name)
397 test.assertEqual(index, value_desc.index)
398 test.assertEqual(number, value_desc.number)
399 test.assertEqual(enum_desc, value_desc.type)
400 test.assertIn(value, msg_desc.enum_values_by_name)
401
402
403class MessageType(object):
404
405 def __init__(self, type_dict, field_list, is_extendable=False,
406 extensions=None):
407 self.type_dict = type_dict
408 self.field_list = field_list
409 self.is_extendable = is_extendable
410 self.extensions = extensions or []
411
412 def CheckType(self, test, containing_type_desc, name, file_desc):
413 if containing_type_desc is None:
414 desc = file_desc.message_types_by_name[name]
415 expected_full_name = '.'.join([file_desc.package, name])
416 else:
417 desc = containing_type_desc.nested_types_by_name[name]
418 expected_full_name = '.'.join([containing_type_desc.full_name, name])
419
420 test.assertEqual(name, desc.name)
421 test.assertEqual(expected_full_name, desc.full_name)
422 test.assertEqual(containing_type_desc, desc.containing_type)
423 test.assertEqual(desc.file, file_desc)
424 test.assertEqual(self.is_extendable, desc.is_extendable)
425 for name, subtype in self.type_dict.items():
426 subtype.CheckType(test, desc, name, file_desc)
427
428 for index, (name, field) in enumerate(self.field_list):
429 field.CheckField(test, desc, name, index)
430
431 for index, (name, field) in enumerate(self.extensions):
432 field.CheckField(test, desc, name, index)
433
434
435class EnumField(object):
436
437 def __init__(self, number, type_name, default_value):
438 self.number = number
439 self.type_name = type_name
440 self.default_value = default_value
441
442 def CheckField(self, test, msg_desc, name, index):
443 field_desc = msg_desc.fields_by_name[name]
444 enum_desc = msg_desc.enum_types_by_name[self.type_name]
445 test.assertEqual(name, field_desc.name)
446 expected_field_full_name = '.'.join([msg_desc.full_name, name])
447 test.assertEqual(expected_field_full_name, field_desc.full_name)
448 test.assertEqual(index, field_desc.index)
449 test.assertEqual(self.number, field_desc.number)
450 test.assertEqual(descriptor.FieldDescriptor.TYPE_ENUM, field_desc.type)
451 test.assertEqual(descriptor.FieldDescriptor.CPPTYPE_ENUM,
452 field_desc.cpp_type)
453 test.assertTrue(field_desc.has_default_value)
Feng Xiao6ef984a2014-11-10 17:34:54 -0800454 test.assertEqual(enum_desc.values_by_name[self.default_value].number,
jieluo@google.combde4a322014-08-12 21:10:30 +0000455 field_desc.default_value)
456 test.assertEqual(msg_desc, field_desc.containing_type)
457 test.assertEqual(enum_desc, field_desc.enum_type)
458
459
460class MessageField(object):
461
462 def __init__(self, number, type_name):
463 self.number = number
464 self.type_name = type_name
465
466 def CheckField(self, test, msg_desc, name, index):
467 field_desc = msg_desc.fields_by_name[name]
468 field_type_desc = msg_desc.nested_types_by_name[self.type_name]
469 test.assertEqual(name, field_desc.name)
470 expected_field_full_name = '.'.join([msg_desc.full_name, name])
471 test.assertEqual(expected_field_full_name, field_desc.full_name)
472 test.assertEqual(index, field_desc.index)
473 test.assertEqual(self.number, field_desc.number)
474 test.assertEqual(descriptor.FieldDescriptor.TYPE_MESSAGE, field_desc.type)
475 test.assertEqual(descriptor.FieldDescriptor.CPPTYPE_MESSAGE,
476 field_desc.cpp_type)
477 test.assertFalse(field_desc.has_default_value)
478 test.assertEqual(msg_desc, field_desc.containing_type)
479 test.assertEqual(field_type_desc, field_desc.message_type)
480
481
482class StringField(object):
483
484 def __init__(self, number, default_value):
485 self.number = number
486 self.default_value = default_value
487
488 def CheckField(self, test, msg_desc, name, index):
489 field_desc = msg_desc.fields_by_name[name]
490 test.assertEqual(name, field_desc.name)
491 expected_field_full_name = '.'.join([msg_desc.full_name, name])
492 test.assertEqual(expected_field_full_name, field_desc.full_name)
493 test.assertEqual(index, field_desc.index)
494 test.assertEqual(self.number, field_desc.number)
495 test.assertEqual(descriptor.FieldDescriptor.TYPE_STRING, field_desc.type)
496 test.assertEqual(descriptor.FieldDescriptor.CPPTYPE_STRING,
497 field_desc.cpp_type)
498 test.assertTrue(field_desc.has_default_value)
499 test.assertEqual(self.default_value, field_desc.default_value)
500
501
502class ExtensionField(object):
503
504 def __init__(self, number, extended_type):
505 self.number = number
506 self.extended_type = extended_type
507
508 def CheckField(self, test, msg_desc, name, index):
509 field_desc = msg_desc.extensions_by_name[name]
510 test.assertEqual(name, field_desc.name)
511 expected_field_full_name = '.'.join([msg_desc.full_name, name])
512 test.assertEqual(expected_field_full_name, field_desc.full_name)
513 test.assertEqual(self.number, field_desc.number)
514 test.assertEqual(index, field_desc.index)
515 test.assertEqual(descriptor.FieldDescriptor.TYPE_MESSAGE, field_desc.type)
516 test.assertEqual(descriptor.FieldDescriptor.CPPTYPE_MESSAGE,
517 field_desc.cpp_type)
518 test.assertFalse(field_desc.has_default_value)
519 test.assertTrue(field_desc.is_extension)
520 test.assertEqual(msg_desc, field_desc.extension_scope)
521 test.assertEqual(msg_desc, field_desc.message_type)
522 test.assertEqual(self.extended_type, field_desc.containing_type.name)
523
524
Tres Seaver7ee25832015-01-13 14:47:32 -0500525class AddDescriptorTest(unittest.TestCase):
jieluo@google.combde4a322014-08-12 21:10:30 +0000526
527 def _TestMessage(self, prefix):
528 pool = descriptor_pool.DescriptorPool()
529 pool.AddDescriptor(unittest_pb2.TestAllTypes.DESCRIPTOR)
Tres Seavera2abc942015-01-13 15:47:55 -0500530 self.assertEqual(
jieluo@google.combde4a322014-08-12 21:10:30 +0000531 'protobuf_unittest.TestAllTypes',
532 pool.FindMessageTypeByName(
533 prefix + 'protobuf_unittest.TestAllTypes').full_name)
534
535 # AddDescriptor is not recursive.
536 with self.assertRaises(KeyError):
537 pool.FindMessageTypeByName(
538 prefix + 'protobuf_unittest.TestAllTypes.NestedMessage')
539
540 pool.AddDescriptor(unittest_pb2.TestAllTypes.NestedMessage.DESCRIPTOR)
Tres Seavera2abc942015-01-13 15:47:55 -0500541 self.assertEqual(
jieluo@google.combde4a322014-08-12 21:10:30 +0000542 'protobuf_unittest.TestAllTypes.NestedMessage',
543 pool.FindMessageTypeByName(
544 prefix + 'protobuf_unittest.TestAllTypes.NestedMessage').full_name)
545
546 # Files are implicitly also indexed when messages are added.
Tres Seavera2abc942015-01-13 15:47:55 -0500547 self.assertEqual(
jieluo@google.combde4a322014-08-12 21:10:30 +0000548 'google/protobuf/unittest.proto',
549 pool.FindFileByName(
550 'google/protobuf/unittest.proto').name)
551
Tres Seavera2abc942015-01-13 15:47:55 -0500552 self.assertEqual(
jieluo@google.combde4a322014-08-12 21:10:30 +0000553 'google/protobuf/unittest.proto',
554 pool.FindFileContainingSymbol(
555 prefix + 'protobuf_unittest.TestAllTypes.NestedMessage').name)
556
Feng Xiaoe841bac2015-12-11 17:09:20 -0800557 @unittest.skipIf(api_implementation.Type() == 'cpp',
558 'With the cpp implementation, Add() must be called first')
jieluo@google.combde4a322014-08-12 21:10:30 +0000559 def testMessage(self):
560 self._TestMessage('')
561 self._TestMessage('.')
562
563 def _TestEnum(self, prefix):
564 pool = descriptor_pool.DescriptorPool()
565 pool.AddEnumDescriptor(unittest_pb2.ForeignEnum.DESCRIPTOR)
Tres Seavera2abc942015-01-13 15:47:55 -0500566 self.assertEqual(
jieluo@google.combde4a322014-08-12 21:10:30 +0000567 'protobuf_unittest.ForeignEnum',
568 pool.FindEnumTypeByName(
569 prefix + 'protobuf_unittest.ForeignEnum').full_name)
570
571 # AddEnumDescriptor is not recursive.
572 with self.assertRaises(KeyError):
573 pool.FindEnumTypeByName(
574 prefix + 'protobuf_unittest.ForeignEnum.NestedEnum')
575
576 pool.AddEnumDescriptor(unittest_pb2.TestAllTypes.NestedEnum.DESCRIPTOR)
Tres Seavera2abc942015-01-13 15:47:55 -0500577 self.assertEqual(
jieluo@google.combde4a322014-08-12 21:10:30 +0000578 'protobuf_unittest.TestAllTypes.NestedEnum',
579 pool.FindEnumTypeByName(
580 prefix + 'protobuf_unittest.TestAllTypes.NestedEnum').full_name)
581
582 # Files are implicitly also indexed when enums are added.
Tres Seavera2abc942015-01-13 15:47:55 -0500583 self.assertEqual(
jieluo@google.combde4a322014-08-12 21:10:30 +0000584 'google/protobuf/unittest.proto',
585 pool.FindFileByName(
586 'google/protobuf/unittest.proto').name)
587
Tres Seavera2abc942015-01-13 15:47:55 -0500588 self.assertEqual(
jieluo@google.combde4a322014-08-12 21:10:30 +0000589 'google/protobuf/unittest.proto',
590 pool.FindFileContainingSymbol(
591 prefix + 'protobuf_unittest.TestAllTypes.NestedEnum').name)
592
Feng Xiaoe841bac2015-12-11 17:09:20 -0800593 @unittest.skipIf(api_implementation.Type() == 'cpp',
594 'With the cpp implementation, Add() must be called first')
jieluo@google.combde4a322014-08-12 21:10:30 +0000595 def testEnum(self):
596 self._TestEnum('')
597 self._TestEnum('.')
598
Feng Xiaoe841bac2015-12-11 17:09:20 -0800599 @unittest.skipIf(api_implementation.Type() == 'cpp',
600 'With the cpp implementation, Add() must be called first')
jieluo@google.combde4a322014-08-12 21:10:30 +0000601 def testFile(self):
602 pool = descriptor_pool.DescriptorPool()
603 pool.AddFileDescriptor(unittest_pb2.DESCRIPTOR)
Tres Seavera2abc942015-01-13 15:47:55 -0500604 self.assertEqual(
jieluo@google.combde4a322014-08-12 21:10:30 +0000605 'google/protobuf/unittest.proto',
606 pool.FindFileByName(
607 'google/protobuf/unittest.proto').name)
608
609 # AddFileDescriptor is not recursive; messages and enums within files must
610 # be explicitly registered.
611 with self.assertRaises(KeyError):
612 pool.FindFileContainingSymbol(
613 'protobuf_unittest.TestAllTypes')
614
Feng Xiaoe841bac2015-12-11 17:09:20 -0800615 def _GetDescriptorPoolClass(self):
616 # Test with both implementations of descriptor pools.
617 if api_implementation.Type() == 'cpp':
618 # pylint: disable=g-import-not-at-top
619 from google.protobuf.pyext import _message
620 return _message.DescriptorPool
621 else:
622 return descriptor_pool.DescriptorPool
623
624 def testEmptyDescriptorPool(self):
625 # Check that an empty DescriptorPool() contains no message.
626 pool = self._GetDescriptorPoolClass()()
627 proto_file_name = descriptor_pb2.DESCRIPTOR.name
628 self.assertRaises(KeyError, pool.FindFileByName, proto_file_name)
629 # Add the above file to the pool
630 file_descriptor = descriptor_pb2.FileDescriptorProto()
631 descriptor_pb2.DESCRIPTOR.CopyToProto(file_descriptor)
632 pool.Add(file_descriptor)
633 # Now it exists.
634 self.assertTrue(pool.FindFileByName(proto_file_name))
635
636 def testCustomDescriptorPool(self):
637 # Create a new pool, and add a file descriptor.
638 pool = self._GetDescriptorPoolClass()()
639 file_desc = descriptor_pb2.FileDescriptorProto(
640 name='some/file.proto', package='package')
641 file_desc.message_type.add(name='Message')
642 pool.Add(file_desc)
643 self.assertEqual(pool.FindFileByName('some/file.proto').name,
644 'some/file.proto')
645 self.assertEqual(pool.FindMessageTypeByName('package.Message').name,
646 'Message')
647
648
649@unittest.skipIf(
650 api_implementation.Type() != 'cpp',
651 'default_pool is only supported by the C++ implementation')
652class DefaultPoolTest(unittest.TestCase):
653
654 def testFindMethods(self):
655 # pylint: disable=g-import-not-at-top
656 from google.protobuf.pyext import _message
657 pool = _message.default_pool
658 self.assertIs(
659 pool.FindFileByName('google/protobuf/unittest.proto'),
660 unittest_pb2.DESCRIPTOR)
661 self.assertIs(
662 pool.FindMessageTypeByName('protobuf_unittest.TestAllTypes'),
663 unittest_pb2.TestAllTypes.DESCRIPTOR)
664 self.assertIs(
665 pool.FindFieldByName('protobuf_unittest.TestAllTypes.optional_int32'),
666 unittest_pb2.TestAllTypes.DESCRIPTOR.fields_by_name['optional_int32'])
667 self.assertIs(
668 pool.FindExtensionByName('protobuf_unittest.optional_int32_extension'),
669 unittest_pb2.DESCRIPTOR.extensions_by_name['optional_int32_extension'])
670 self.assertIs(
671 pool.FindEnumTypeByName('protobuf_unittest.ForeignEnum'),
672 unittest_pb2.ForeignEnum.DESCRIPTOR)
673 self.assertIs(
674 pool.FindOneofByName('protobuf_unittest.TestAllTypes.oneof_field'),
675 unittest_pb2.TestAllTypes.DESCRIPTOR.oneofs_by_name['oneof_field'])
676
677 def testAddFileDescriptor(self):
678 # pylint: disable=g-import-not-at-top
679 from google.protobuf.pyext import _message
680 pool = _message.default_pool
681 file_desc = descriptor_pb2.FileDescriptorProto(name='some/file.proto')
682 pool.Add(file_desc)
683 pool.AddSerializedFile(file_desc.SerializeToString())
684
jieluo@google.combde4a322014-08-12 21:10:30 +0000685
686TEST1_FILE = ProtoFile(
687 'google/protobuf/internal/descriptor_pool_test1.proto',
688 'google.protobuf.python.internal',
689 {
690 'DescriptorPoolTest1': MessageType({
691 'NestedEnum': EnumType([('ALPHA', 1), ('BETA', 2)]),
692 'NestedMessage': MessageType({
693 'NestedEnum': EnumType([('EPSILON', 5), ('ZETA', 6)]),
694 'DeepNestedMessage': MessageType({
695 'NestedEnum': EnumType([('ETA', 7), ('THETA', 8)]),
696 }, [
697 ('nested_enum', EnumField(1, 'NestedEnum', 'ETA')),
698 ('nested_field', StringField(2, 'theta')),
699 ]),
700 }, [
701 ('nested_enum', EnumField(1, 'NestedEnum', 'ZETA')),
702 ('nested_field', StringField(2, 'beta')),
703 ('deep_nested_message', MessageField(3, 'DeepNestedMessage')),
704 ])
705 }, [
706 ('nested_enum', EnumField(1, 'NestedEnum', 'BETA')),
707 ('nested_message', MessageField(2, 'NestedMessage')),
708 ], is_extendable=True),
709
710 'DescriptorPoolTest2': MessageType({
711 'NestedEnum': EnumType([('GAMMA', 3), ('DELTA', 4)]),
712 'NestedMessage': MessageType({
713 'NestedEnum': EnumType([('IOTA', 9), ('KAPPA', 10)]),
714 'DeepNestedMessage': MessageType({
715 'NestedEnum': EnumType([('LAMBDA', 11), ('MU', 12)]),
716 }, [
717 ('nested_enum', EnumField(1, 'NestedEnum', 'MU')),
718 ('nested_field', StringField(2, 'lambda')),
719 ]),
720 }, [
721 ('nested_enum', EnumField(1, 'NestedEnum', 'IOTA')),
722 ('nested_field', StringField(2, 'delta')),
723 ('deep_nested_message', MessageField(3, 'DeepNestedMessage')),
724 ])
725 }, [
726 ('nested_enum', EnumField(1, 'NestedEnum', 'GAMMA')),
727 ('nested_message', MessageField(2, 'NestedMessage')),
728 ]),
729 })
730
731
732TEST2_FILE = ProtoFile(
733 'google/protobuf/internal/descriptor_pool_test2.proto',
734 'google.protobuf.python.internal',
735 {
736 'DescriptorPoolTest3': MessageType({
737 'NestedEnum': EnumType([('NU', 13), ('XI', 14)]),
738 'NestedMessage': MessageType({
739 'NestedEnum': EnumType([('OMICRON', 15), ('PI', 16)]),
740 'DeepNestedMessage': MessageType({
741 'NestedEnum': EnumType([('RHO', 17), ('SIGMA', 18)]),
742 }, [
743 ('nested_enum', EnumField(1, 'NestedEnum', 'RHO')),
744 ('nested_field', StringField(2, 'sigma')),
745 ]),
746 }, [
747 ('nested_enum', EnumField(1, 'NestedEnum', 'PI')),
748 ('nested_field', StringField(2, 'nu')),
749 ('deep_nested_message', MessageField(3, 'DeepNestedMessage')),
750 ])
751 }, [
752 ('nested_enum', EnumField(1, 'NestedEnum', 'XI')),
753 ('nested_message', MessageField(2, 'NestedMessage')),
754 ], extensions=[
755 ('descriptor_pool_test',
756 ExtensionField(1001, 'DescriptorPoolTest1')),
757 ]),
758 },
759 dependencies=['google/protobuf/internal/descriptor_pool_test1.proto'])
760
761
xiaofeng@google.comb55a20f2012-09-22 02:40:50 +0000762if __name__ == '__main__':
Tres Seaver7ee25832015-01-13 14:47:32 -0500763 unittest.main()