text_format_test.py 82 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064
  1. #! /usr/bin/env python
  2. # -*- coding: utf-8 -*-
  3. #
  4. # Protocol Buffers - Google's data interchange format
  5. # Copyright 2008 Google Inc. All rights reserved.
  6. # https://developers.google.com/protocol-buffers/
  7. #
  8. # Redistribution and use in source and binary forms, with or without
  9. # modification, are permitted provided that the following conditions are
  10. # met:
  11. #
  12. # * Redistributions of source code must retain the above copyright
  13. # notice, this list of conditions and the following disclaimer.
  14. # * Redistributions in binary form must reproduce the above
  15. # copyright notice, this list of conditions and the following disclaimer
  16. # in the documentation and/or other materials provided with the
  17. # distribution.
  18. # * Neither the name of Google Inc. nor the names of its
  19. # contributors may be used to endorse or promote products derived from
  20. # this software without specific prior written permission.
  21. #
  22. # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  23. # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  24. # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  25. # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  26. # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  27. # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  28. # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  29. # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  30. # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  31. # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  32. # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  33. """Test for google.protobuf.text_format."""
  34. import io
  35. import math
  36. import re
  37. import string
  38. import textwrap
  39. import six
  40. # pylint: disable=g-import-not-at-top
  41. try:
  42. import unittest2 as unittest # PY26
  43. except ImportError:
  44. import unittest
  45. from google.protobuf import any_pb2
  46. from google.protobuf import any_test_pb2
  47. from google.protobuf import map_unittest_pb2
  48. from google.protobuf import unittest_custom_options_pb2
  49. from google.protobuf import unittest_mset_pb2
  50. from google.protobuf import unittest_pb2
  51. from google.protobuf import unittest_proto3_arena_pb2
  52. from google.protobuf import descriptor_pb2
  53. from google.protobuf.internal import any_test_pb2 as test_extend_any
  54. from google.protobuf.internal import message_set_extensions_pb2
  55. from google.protobuf.internal import test_util
  56. from google.protobuf import descriptor_pool
  57. from google.protobuf import text_format
  58. from google.protobuf.internal import _parameterized
  59. # pylint: enable=g-import-not-at-top
  60. # Low-level nuts-n-bolts tests.
  61. class SimpleTextFormatTests(unittest.TestCase):
  62. # The members of _QUOTES are formatted into a regexp template that
  63. # expects single characters. Therefore it's an error (in addition to being
  64. # non-sensical in the first place) to try to specify a "quote mark" that is
  65. # more than one character.
  66. def testQuoteMarksAreSingleChars(self):
  67. for quote in text_format._QUOTES:
  68. self.assertEqual(1, len(quote))
  69. # Base class with some common functionality.
  70. class TextFormatBase(unittest.TestCase):
  71. def ReadGolden(self, golden_filename):
  72. with test_util.GoldenFile(golden_filename) as f:
  73. return (f.readlines() if str is bytes else # PY3
  74. [golden_line.decode('utf-8') for golden_line in f])
  75. def CompareToGoldenFile(self, text, golden_filename):
  76. golden_lines = self.ReadGolden(golden_filename)
  77. self.assertMultiLineEqual(text, ''.join(golden_lines))
  78. def CompareToGoldenText(self, text, golden_text):
  79. self.assertEqual(text, golden_text)
  80. def RemoveRedundantZeros(self, text):
  81. # Some platforms print 1e+5 as 1e+005. This is fine, but we need to remove
  82. # these zeros in order to match the golden file.
  83. text = text.replace('e+0','e+').replace('e+0','e+') \
  84. .replace('e-0','e-').replace('e-0','e-')
  85. # Floating point fields are printed with .0 suffix even if they are
  86. # actualy integer numbers.
  87. text = re.compile(r'\.0$', re.MULTILINE).sub('', text)
  88. return text
  89. @_parameterized.parameters(unittest_pb2, unittest_proto3_arena_pb2)
  90. class TextFormatMessageToStringTests(TextFormatBase):
  91. def testPrintExotic(self, message_module):
  92. message = message_module.TestAllTypes()
  93. message.repeated_int64.append(-9223372036854775808)
  94. message.repeated_uint64.append(18446744073709551615)
  95. message.repeated_double.append(123.456)
  96. message.repeated_double.append(1.23e22)
  97. message.repeated_double.append(1.23e-18)
  98. message.repeated_string.append('\000\001\a\b\f\n\r\t\v\\\'"')
  99. message.repeated_string.append(u'\u00fc\ua71f')
  100. self.CompareToGoldenText(
  101. self.RemoveRedundantZeros(text_format.MessageToString(message)),
  102. 'repeated_int64: -9223372036854775808\n'
  103. 'repeated_uint64: 18446744073709551615\n'
  104. 'repeated_double: 123.456\n'
  105. 'repeated_double: 1.23e+22\n'
  106. 'repeated_double: 1.23e-18\n'
  107. 'repeated_string:'
  108. ' "\\000\\001\\007\\010\\014\\n\\r\\t\\013\\\\\\\'\\""\n'
  109. 'repeated_string: "\\303\\274\\352\\234\\237"\n')
  110. def testPrintExoticUnicodeSubclass(self, message_module):
  111. class UnicodeSub(six.text_type):
  112. pass
  113. message = message_module.TestAllTypes()
  114. message.repeated_string.append(UnicodeSub(u'\u00fc\ua71f'))
  115. self.CompareToGoldenText(
  116. text_format.MessageToString(message),
  117. 'repeated_string: "\\303\\274\\352\\234\\237"\n')
  118. def testPrintNestedMessageAsOneLine(self, message_module):
  119. message = message_module.TestAllTypes()
  120. msg = message.repeated_nested_message.add()
  121. msg.bb = 42
  122. self.CompareToGoldenText(
  123. text_format.MessageToString(message, as_one_line=True),
  124. 'repeated_nested_message { bb: 42 }')
  125. def testPrintRepeatedFieldsAsOneLine(self, message_module):
  126. message = message_module.TestAllTypes()
  127. message.repeated_int32.append(1)
  128. message.repeated_int32.append(1)
  129. message.repeated_int32.append(3)
  130. message.repeated_string.append('Google')
  131. message.repeated_string.append('Zurich')
  132. self.CompareToGoldenText(
  133. text_format.MessageToString(message, as_one_line=True),
  134. 'repeated_int32: 1 repeated_int32: 1 repeated_int32: 3 '
  135. 'repeated_string: "Google" repeated_string: "Zurich"')
  136. def VerifyPrintShortFormatRepeatedFields(self, message_module, as_one_line):
  137. message = message_module.TestAllTypes()
  138. message.repeated_int32.append(1)
  139. message.repeated_string.append('Google')
  140. message.repeated_string.append('Hello,World')
  141. message.repeated_foreign_enum.append(unittest_pb2.FOREIGN_FOO)
  142. message.repeated_foreign_enum.append(unittest_pb2.FOREIGN_BAR)
  143. message.repeated_foreign_enum.append(unittest_pb2.FOREIGN_BAZ)
  144. message.optional_nested_message.bb = 3
  145. for i in (21, 32):
  146. msg = message.repeated_nested_message.add()
  147. msg.bb = i
  148. expected_ascii = (
  149. 'optional_nested_message {\n bb: 3\n}\n'
  150. 'repeated_int32: [1]\n'
  151. 'repeated_string: "Google"\n'
  152. 'repeated_string: "Hello,World"\n'
  153. 'repeated_nested_message {\n bb: 21\n}\n'
  154. 'repeated_nested_message {\n bb: 32\n}\n'
  155. 'repeated_foreign_enum: [FOREIGN_FOO, FOREIGN_BAR, FOREIGN_BAZ]\n')
  156. if as_one_line:
  157. expected_ascii = expected_ascii.replace('\n', ' ')
  158. expected_ascii = re.sub(r'\s+', ' ', expected_ascii)
  159. expected_ascii = re.sub(r'\s$', '', expected_ascii)
  160. actual_ascii = text_format.MessageToString(
  161. message, use_short_repeated_primitives=True,
  162. as_one_line=as_one_line)
  163. self.CompareToGoldenText(actual_ascii, expected_ascii)
  164. parsed_message = message_module.TestAllTypes()
  165. text_format.Parse(actual_ascii, parsed_message)
  166. self.assertEqual(parsed_message, message)
  167. def testPrintShortFormatRepeatedFields(self, message_module):
  168. self.VerifyPrintShortFormatRepeatedFields(message_module, False)
  169. self.VerifyPrintShortFormatRepeatedFields(message_module, True)
  170. def testPrintNestedNewLineInStringAsOneLine(self, message_module):
  171. message = message_module.TestAllTypes()
  172. message.optional_string = 'a\nnew\nline'
  173. self.CompareToGoldenText(
  174. text_format.MessageToString(message, as_one_line=True),
  175. 'optional_string: "a\\nnew\\nline"')
  176. def testPrintExoticAsOneLine(self, message_module):
  177. message = message_module.TestAllTypes()
  178. message.repeated_int64.append(-9223372036854775808)
  179. message.repeated_uint64.append(18446744073709551615)
  180. message.repeated_double.append(123.456)
  181. message.repeated_double.append(1.23e22)
  182. message.repeated_double.append(1.23e-18)
  183. message.repeated_string.append('\000\001\a\b\f\n\r\t\v\\\'"')
  184. message.repeated_string.append(u'\u00fc\ua71f')
  185. self.CompareToGoldenText(
  186. self.RemoveRedundantZeros(text_format.MessageToString(
  187. message, as_one_line=True)),
  188. 'repeated_int64: -9223372036854775808'
  189. ' repeated_uint64: 18446744073709551615'
  190. ' repeated_double: 123.456'
  191. ' repeated_double: 1.23e+22'
  192. ' repeated_double: 1.23e-18'
  193. ' repeated_string: '
  194. '"\\000\\001\\007\\010\\014\\n\\r\\t\\013\\\\\\\'\\""'
  195. ' repeated_string: "\\303\\274\\352\\234\\237"')
  196. def testRoundTripExoticAsOneLine(self, message_module):
  197. message = message_module.TestAllTypes()
  198. message.repeated_int64.append(-9223372036854775808)
  199. message.repeated_uint64.append(18446744073709551615)
  200. message.repeated_double.append(123.456)
  201. message.repeated_double.append(1.23e22)
  202. message.repeated_double.append(1.23e-18)
  203. message.repeated_string.append('\000\001\a\b\f\n\r\t\v\\\'"')
  204. message.repeated_string.append(u'\u00fc\ua71f')
  205. # Test as_utf8 = False.
  206. wire_text = text_format.MessageToString(message,
  207. as_one_line=True,
  208. as_utf8=False)
  209. parsed_message = message_module.TestAllTypes()
  210. r = text_format.Parse(wire_text, parsed_message)
  211. self.assertIs(r, parsed_message)
  212. self.assertEqual(message, parsed_message)
  213. # Test as_utf8 = True.
  214. wire_text = text_format.MessageToString(message,
  215. as_one_line=True,
  216. as_utf8=True)
  217. parsed_message = message_module.TestAllTypes()
  218. r = text_format.Parse(wire_text, parsed_message)
  219. self.assertIs(r, parsed_message)
  220. self.assertEqual(message, parsed_message,
  221. '\n%s != %s' % (message, parsed_message))
  222. def testPrintRawUtf8String(self, message_module):
  223. message = message_module.TestAllTypes()
  224. message.repeated_string.append(u'\u00fc\t\ua71f')
  225. text = text_format.MessageToString(message, as_utf8=True)
  226. golden_unicode = u'repeated_string: "\u00fc\\t\ua71f"\n'
  227. golden_text = golden_unicode if six.PY3 else golden_unicode.encode('utf-8')
  228. # MessageToString always returns a native str.
  229. self.CompareToGoldenText(text, golden_text)
  230. parsed_message = message_module.TestAllTypes()
  231. text_format.Parse(text, parsed_message)
  232. self.assertEqual(
  233. message, parsed_message, '\n%s != %s (%s != %s)' %
  234. (message, parsed_message, message.repeated_string[0],
  235. parsed_message.repeated_string[0]))
  236. def testPrintFloatFormat(self, message_module):
  237. # Check that float_format argument is passed to sub-message formatting.
  238. message = message_module.NestedTestAllTypes()
  239. # We use 1.25 as it is a round number in binary. The proto 32-bit float
  240. # will not gain additional imprecise digits as a 64-bit Python float and
  241. # show up in its str. 32-bit 1.2 is noisy when extended to 64-bit:
  242. # >>> struct.unpack('f', struct.pack('f', 1.2))[0]
  243. # 1.2000000476837158
  244. # >>> struct.unpack('f', struct.pack('f', 1.25))[0]
  245. # 1.25
  246. message.payload.optional_float = 1.25
  247. # Check rounding at 15 significant digits
  248. message.payload.optional_double = -.000003456789012345678
  249. # Check no decimal point.
  250. message.payload.repeated_float.append(-5642)
  251. # Check no trailing zeros.
  252. message.payload.repeated_double.append(.000078900)
  253. formatted_fields = ['optional_float: 1.25',
  254. 'optional_double: -3.45678901234568e-6',
  255. 'repeated_float: -5642', 'repeated_double: 7.89e-5']
  256. text_message = text_format.MessageToString(message, float_format='.15g')
  257. self.CompareToGoldenText(
  258. self.RemoveRedundantZeros(text_message),
  259. 'payload {{\n {0}\n {1}\n {2}\n {3}\n}}\n'.format(
  260. *formatted_fields))
  261. # as_one_line=True is a separate code branch where float_format is passed.
  262. text_message = text_format.MessageToString(message,
  263. as_one_line=True,
  264. float_format='.15g')
  265. self.CompareToGoldenText(
  266. self.RemoveRedundantZeros(text_message),
  267. 'payload {{ {0} {1} {2} {3} }}'.format(*formatted_fields))
  268. def testMessageToString(self, message_module):
  269. message = message_module.ForeignMessage()
  270. message.c = 123
  271. self.assertEqual('c: 123\n', str(message))
  272. def testMessageToStringUnicode(self, message_module):
  273. golden_unicode = u'Á short desçription and a 🍌.'
  274. golden_bytes = golden_unicode.encode('utf-8')
  275. message = message_module.TestAllTypes()
  276. message.optional_string = golden_unicode
  277. message.optional_bytes = golden_bytes
  278. text = text_format.MessageToString(message, as_utf8=True)
  279. golden_message = textwrap.dedent(
  280. 'optional_string: "Á short desçription and a 🍌."\n'
  281. 'optional_bytes: '
  282. r'"\303\201 short des\303\247ription and a \360\237\215\214."'
  283. '\n')
  284. self.CompareToGoldenText(text, golden_message)
  285. def testMessageToStringASCII(self, message_module):
  286. golden_unicode = u'Á short desçription and a 🍌.'
  287. golden_bytes = golden_unicode.encode('utf-8')
  288. message = message_module.TestAllTypes()
  289. message.optional_string = golden_unicode
  290. message.optional_bytes = golden_bytes
  291. text = text_format.MessageToString(message, as_utf8=False) # ASCII
  292. golden_message = (
  293. 'optional_string: '
  294. r'"\303\201 short des\303\247ription and a \360\237\215\214."'
  295. '\n'
  296. 'optional_bytes: '
  297. r'"\303\201 short des\303\247ription and a \360\237\215\214."'
  298. '\n')
  299. self.CompareToGoldenText(text, golden_message)
  300. def testPrintField(self, message_module):
  301. message = message_module.TestAllTypes()
  302. field = message.DESCRIPTOR.fields_by_name['optional_float']
  303. value = message.optional_float
  304. out = text_format.TextWriter(False)
  305. text_format.PrintField(field, value, out)
  306. self.assertEqual('optional_float: 0.0\n', out.getvalue())
  307. out.close()
  308. # Test Printer
  309. out = text_format.TextWriter(False)
  310. printer = text_format._Printer(out)
  311. printer.PrintField(field, value)
  312. self.assertEqual('optional_float: 0.0\n', out.getvalue())
  313. out.close()
  314. def testPrintFieldValue(self, message_module):
  315. message = message_module.TestAllTypes()
  316. field = message.DESCRIPTOR.fields_by_name['optional_float']
  317. value = message.optional_float
  318. out = text_format.TextWriter(False)
  319. text_format.PrintFieldValue(field, value, out)
  320. self.assertEqual('0.0', out.getvalue())
  321. out.close()
  322. # Test Printer
  323. out = text_format.TextWriter(False)
  324. printer = text_format._Printer(out)
  325. printer.PrintFieldValue(field, value)
  326. self.assertEqual('0.0', out.getvalue())
  327. out.close()
  328. def testCustomOptions(self, message_module):
  329. message_descriptor = (unittest_custom_options_pb2.
  330. TestMessageWithCustomOptions.DESCRIPTOR)
  331. message_proto = descriptor_pb2.DescriptorProto()
  332. message_descriptor.CopyToProto(message_proto)
  333. expected_text = (
  334. 'name: "TestMessageWithCustomOptions"\n'
  335. 'field {\n'
  336. ' name: "field1"\n'
  337. ' number: 1\n'
  338. ' label: LABEL_OPTIONAL\n'
  339. ' type: TYPE_STRING\n'
  340. ' options {\n'
  341. ' ctype: CORD\n'
  342. ' [protobuf_unittest.field_opt1]: 8765432109\n'
  343. ' }\n'
  344. '}\n'
  345. 'field {\n'
  346. ' name: "oneof_field"\n'
  347. ' number: 2\n'
  348. ' label: LABEL_OPTIONAL\n'
  349. ' type: TYPE_INT32\n'
  350. ' oneof_index: 0\n'
  351. '}\n'
  352. 'enum_type {\n'
  353. ' name: "AnEnum"\n'
  354. ' value {\n'
  355. ' name: "ANENUM_VAL1"\n'
  356. ' number: 1\n'
  357. ' }\n'
  358. ' value {\n'
  359. ' name: "ANENUM_VAL2"\n'
  360. ' number: 2\n'
  361. ' options {\n'
  362. ' [protobuf_unittest.enum_value_opt1]: 123\n'
  363. ' }\n'
  364. ' }\n'
  365. ' options {\n'
  366. ' [protobuf_unittest.enum_opt1]: -789\n'
  367. ' }\n'
  368. '}\n'
  369. 'options {\n'
  370. ' message_set_wire_format: false\n'
  371. ' [protobuf_unittest.message_opt1]: -56\n'
  372. '}\n'
  373. 'oneof_decl {\n'
  374. ' name: "AnOneof"\n'
  375. ' options {\n'
  376. ' [protobuf_unittest.oneof_opt1]: -99\n'
  377. ' }\n'
  378. '}\n')
  379. self.assertEqual(expected_text,
  380. text_format.MessageToString(message_proto))
  381. parsed_proto = descriptor_pb2.DescriptorProto()
  382. text_format.Parse(expected_text, parsed_proto)
  383. self.assertEqual(message_proto, parsed_proto)
  384. @_parameterized.parameters(unittest_pb2, unittest_proto3_arena_pb2)
  385. class TextFormatMessageToTextBytesTests(TextFormatBase):
  386. def testMessageToBytes(self, message_module):
  387. message = message_module.ForeignMessage()
  388. message.c = 123
  389. self.assertEqual(b'c: 123\n', text_format.MessageToBytes(message))
  390. def testRawUtf8RoundTrip(self, message_module):
  391. message = message_module.TestAllTypes()
  392. message.repeated_string.append(u'\u00fc\t\ua71f')
  393. utf8_text = text_format.MessageToBytes(message, as_utf8=True)
  394. golden_bytes = b'repeated_string: "\xc3\xbc\\t\xea\x9c\x9f"\n'
  395. self.CompareToGoldenText(utf8_text, golden_bytes)
  396. parsed_message = message_module.TestAllTypes()
  397. text_format.Parse(utf8_text, parsed_message)
  398. self.assertEqual(
  399. message, parsed_message, '\n%s != %s (%s != %s)' %
  400. (message, parsed_message, message.repeated_string[0],
  401. parsed_message.repeated_string[0]))
  402. def testEscapedUtf8ASCIIRoundTrip(self, message_module):
  403. message = message_module.TestAllTypes()
  404. message.repeated_string.append(u'\u00fc\t\ua71f')
  405. ascii_text = text_format.MessageToBytes(message) # as_utf8=False default
  406. golden_bytes = b'repeated_string: "\\303\\274\\t\\352\\234\\237"\n'
  407. self.CompareToGoldenText(ascii_text, golden_bytes)
  408. parsed_message = message_module.TestAllTypes()
  409. text_format.Parse(ascii_text, parsed_message)
  410. self.assertEqual(
  411. message, parsed_message, '\n%s != %s (%s != %s)' %
  412. (message, parsed_message, message.repeated_string[0],
  413. parsed_message.repeated_string[0]))
  414. @_parameterized.parameters(unittest_pb2, unittest_proto3_arena_pb2)
  415. class TextFormatParserTests(TextFormatBase):
  416. def testParseAllFields(self, message_module):
  417. message = message_module.TestAllTypes()
  418. test_util.SetAllFields(message)
  419. ascii_text = text_format.MessageToString(message)
  420. parsed_message = message_module.TestAllTypes()
  421. text_format.Parse(ascii_text, parsed_message)
  422. self.assertEqual(message, parsed_message)
  423. if message_module is unittest_pb2:
  424. test_util.ExpectAllFieldsSet(self, message)
  425. def testParseAndMergeUtf8(self, message_module):
  426. message = message_module.TestAllTypes()
  427. test_util.SetAllFields(message)
  428. ascii_text = text_format.MessageToString(message)
  429. ascii_text = ascii_text.encode('utf-8')
  430. parsed_message = message_module.TestAllTypes()
  431. text_format.Parse(ascii_text, parsed_message)
  432. self.assertEqual(message, parsed_message)
  433. if message_module is unittest_pb2:
  434. test_util.ExpectAllFieldsSet(self, message)
  435. parsed_message.Clear()
  436. text_format.Merge(ascii_text, parsed_message)
  437. self.assertEqual(message, parsed_message)
  438. if message_module is unittest_pb2:
  439. test_util.ExpectAllFieldsSet(self, message)
  440. msg2 = message_module.TestAllTypes()
  441. text = (u'optional_string: "café"')
  442. text_format.Merge(text, msg2)
  443. self.assertEqual(msg2.optional_string, u'café')
  444. msg2.Clear()
  445. self.assertEqual(msg2.optional_string, u'')
  446. text_format.Parse(text, msg2)
  447. self.assertEqual(msg2.optional_string, u'café')
  448. def testParseDoubleToFloat(self, message_module):
  449. message = message_module.TestAllTypes()
  450. text = ('repeated_float: 3.4028235e+39\n'
  451. 'repeated_float: 1.4028235e-39\n')
  452. text_format.Parse(text, message)
  453. self.assertEqual(message.repeated_float[0], float('inf'))
  454. self.assertAlmostEqual(message.repeated_float[1], 1.4028235e-39)
  455. def testParseExotic(self, message_module):
  456. message = message_module.TestAllTypes()
  457. text = ('repeated_int64: -9223372036854775808\n'
  458. 'repeated_uint64: 18446744073709551615\n'
  459. 'repeated_double: 123.456\n'
  460. 'repeated_double: 1.23e+22\n'
  461. 'repeated_double: 1.23e-18\n'
  462. 'repeated_string: \n'
  463. '"\\000\\001\\007\\010\\014\\n\\r\\t\\013\\\\\\\'\\""\n'
  464. 'repeated_string: "foo" \'corge\' "grault"\n'
  465. 'repeated_string: "\\303\\274\\352\\234\\237"\n'
  466. 'repeated_string: "\\xc3\\xbc"\n'
  467. 'repeated_string: "\xc3\xbc"\n')
  468. text_format.Parse(text, message)
  469. self.assertEqual(-9223372036854775808, message.repeated_int64[0])
  470. self.assertEqual(18446744073709551615, message.repeated_uint64[0])
  471. self.assertEqual(123.456, message.repeated_double[0])
  472. self.assertEqual(1.23e22, message.repeated_double[1])
  473. self.assertEqual(1.23e-18, message.repeated_double[2])
  474. self.assertEqual('\000\001\a\b\f\n\r\t\v\\\'"', message.repeated_string[0])
  475. self.assertEqual('foocorgegrault', message.repeated_string[1])
  476. self.assertEqual(u'\u00fc\ua71f', message.repeated_string[2])
  477. self.assertEqual(u'\u00fc', message.repeated_string[3])
  478. def testParseTrailingCommas(self, message_module):
  479. message = message_module.TestAllTypes()
  480. text = ('repeated_int64: 100;\n'
  481. 'repeated_int64: 200;\n'
  482. 'repeated_int64: 300,\n'
  483. 'repeated_string: "one",\n'
  484. 'repeated_string: "two";\n')
  485. text_format.Parse(text, message)
  486. self.assertEqual(100, message.repeated_int64[0])
  487. self.assertEqual(200, message.repeated_int64[1])
  488. self.assertEqual(300, message.repeated_int64[2])
  489. self.assertEqual(u'one', message.repeated_string[0])
  490. self.assertEqual(u'two', message.repeated_string[1])
  491. def testParseRepeatedScalarShortFormat(self, message_module):
  492. message = message_module.TestAllTypes()
  493. text = ('repeated_int64: [100, 200];\n'
  494. 'repeated_int64: []\n'
  495. 'repeated_int64: 300,\n'
  496. 'repeated_string: ["one", "two"];\n')
  497. text_format.Parse(text, message)
  498. self.assertEqual(100, message.repeated_int64[0])
  499. self.assertEqual(200, message.repeated_int64[1])
  500. self.assertEqual(300, message.repeated_int64[2])
  501. self.assertEqual(u'one', message.repeated_string[0])
  502. self.assertEqual(u'two', message.repeated_string[1])
  503. def testParseRepeatedMessageShortFormat(self, message_module):
  504. message = message_module.TestAllTypes()
  505. text = ('repeated_nested_message: [{bb: 100}, {bb: 200}],\n'
  506. 'repeated_nested_message: {bb: 300}\n'
  507. 'repeated_nested_message [{bb: 400}];\n')
  508. text_format.Parse(text, message)
  509. self.assertEqual(100, message.repeated_nested_message[0].bb)
  510. self.assertEqual(200, message.repeated_nested_message[1].bb)
  511. self.assertEqual(300, message.repeated_nested_message[2].bb)
  512. self.assertEqual(400, message.repeated_nested_message[3].bb)
  513. def testParseEmptyText(self, message_module):
  514. message = message_module.TestAllTypes()
  515. text = ''
  516. text_format.Parse(text, message)
  517. self.assertEqual(message_module.TestAllTypes(), message)
  518. def testParseInvalidUtf8(self, message_module):
  519. message = message_module.TestAllTypes()
  520. text = 'repeated_string: "\\xc3\\xc3"'
  521. with self.assertRaises(text_format.ParseError) as e:
  522. text_format.Parse(text, message)
  523. self.assertEqual(e.exception.GetLine(), 1)
  524. self.assertEqual(e.exception.GetColumn(), 28)
  525. def testParseSingleWord(self, message_module):
  526. message = message_module.TestAllTypes()
  527. text = 'foo'
  528. six.assertRaisesRegex(self, text_format.ParseError, (
  529. r'1:1 : Message type "\w+.TestAllTypes" has no field named '
  530. r'"foo".'), text_format.Parse, text, message)
  531. def testParseUnknownField(self, message_module):
  532. message = message_module.TestAllTypes()
  533. text = 'unknown_field: 8\n'
  534. six.assertRaisesRegex(self, text_format.ParseError, (
  535. r'1:1 : Message type "\w+.TestAllTypes" has no field named '
  536. r'"unknown_field".'), text_format.Parse, text, message)
  537. def testParseBadEnumValue(self, message_module):
  538. message = message_module.TestAllTypes()
  539. text = 'optional_nested_enum: BARR'
  540. six.assertRaisesRegex(self, text_format.ParseError,
  541. (r'1:23 : \'optional_nested_enum: BARR\': '
  542. r'Enum type "\w+.TestAllTypes.NestedEnum" '
  543. r'has no value named BARR.'), text_format.Parse,
  544. text, message)
  545. def testParseBadIntValue(self, message_module):
  546. message = message_module.TestAllTypes()
  547. text = 'optional_int32: bork'
  548. six.assertRaisesRegex(self, text_format.ParseError,
  549. ('1:17 : \'optional_int32: bork\': '
  550. 'Couldn\'t parse integer: bork'),
  551. text_format.Parse, text, message)
  552. def testParseStringFieldUnescape(self, message_module):
  553. message = message_module.TestAllTypes()
  554. text = r'''repeated_string: "\xf\x62"
  555. repeated_string: "\\xf\\x62"
  556. repeated_string: "\\\xf\\\x62"
  557. repeated_string: "\\\\xf\\\\x62"
  558. repeated_string: "\\\\\xf\\\\\x62"
  559. repeated_string: "\x5cx20"'''
  560. text_format.Parse(text, message)
  561. SLASH = '\\'
  562. self.assertEqual('\x0fb', message.repeated_string[0])
  563. self.assertEqual(SLASH + 'xf' + SLASH + 'x62', message.repeated_string[1])
  564. self.assertEqual(SLASH + '\x0f' + SLASH + 'b', message.repeated_string[2])
  565. self.assertEqual(SLASH + SLASH + 'xf' + SLASH + SLASH + 'x62',
  566. message.repeated_string[3])
  567. self.assertEqual(SLASH + SLASH + '\x0f' + SLASH + SLASH + 'b',
  568. message.repeated_string[4])
  569. self.assertEqual(SLASH + 'x20', message.repeated_string[5])
  570. def testParseOneof(self, message_module):
  571. m = message_module.TestAllTypes()
  572. m.oneof_uint32 = 11
  573. m2 = message_module.TestAllTypes()
  574. text_format.Parse(text_format.MessageToString(m), m2)
  575. self.assertEqual('oneof_uint32', m2.WhichOneof('oneof_field'))
  576. def testParseMultipleOneof(self, message_module):
  577. m_string = '\n'.join(['oneof_uint32: 11', 'oneof_string: "foo"'])
  578. m2 = message_module.TestAllTypes()
  579. with six.assertRaisesRegex(self, text_format.ParseError,
  580. ' is specified along with field '):
  581. text_format.Parse(m_string, m2)
  582. # This example contains non-ASCII codepoint unicode data as literals
  583. # which should come through as utf-8 for bytes, and as the unicode
  584. # itself for string fields. It also demonstrates escaped binary data.
  585. # The ur"" string prefix is unfortunately missing from Python 3
  586. # so we resort to double escaping our \s so that they come through.
  587. _UNICODE_SAMPLE = u"""
  588. optional_bytes: 'Á short desçription'
  589. optional_string: 'Á short desçription'
  590. repeated_bytes: '\\303\\201 short des\\303\\247ription'
  591. repeated_bytes: '\\x12\\x34\\x56\\x78\\x90\\xab\\xcd\\xef'
  592. repeated_string: '\\xd0\\x9f\\xd1\\x80\\xd0\\xb8\\xd0\\xb2\\xd0\\xb5\\xd1\\x82'
  593. """
  594. _BYTES_SAMPLE = _UNICODE_SAMPLE.encode('utf-8')
  595. _GOLDEN_UNICODE = u'Á short desçription'
  596. _GOLDEN_BYTES = _GOLDEN_UNICODE.encode('utf-8')
  597. _GOLDEN_BYTES_1 = b'\x12\x34\x56\x78\x90\xab\xcd\xef'
  598. _GOLDEN_STR_0 = u'Привет'
  599. def testParseUnicode(self, message_module):
  600. m = message_module.TestAllTypes()
  601. text_format.Parse(self._UNICODE_SAMPLE, m)
  602. self.assertEqual(m.optional_bytes, self._GOLDEN_BYTES)
  603. self.assertEqual(m.optional_string, self._GOLDEN_UNICODE)
  604. self.assertEqual(m.repeated_bytes[0], self._GOLDEN_BYTES)
  605. # repeated_bytes[1] contained simple \ escaped non-UTF-8 raw binary data.
  606. self.assertEqual(m.repeated_bytes[1], self._GOLDEN_BYTES_1)
  607. # repeated_string[0] contained \ escaped data representing the UTF-8
  608. # representation of _GOLDEN_STR_0 - it needs to decode as such.
  609. self.assertEqual(m.repeated_string[0], self._GOLDEN_STR_0)
  610. def testParseBytes(self, message_module):
  611. m = message_module.TestAllTypes()
  612. text_format.Parse(self._BYTES_SAMPLE, m)
  613. self.assertEqual(m.optional_bytes, self._GOLDEN_BYTES)
  614. self.assertEqual(m.optional_string, self._GOLDEN_UNICODE)
  615. self.assertEqual(m.repeated_bytes[0], self._GOLDEN_BYTES)
  616. # repeated_bytes[1] contained simple \ escaped non-UTF-8 raw binary data.
  617. self.assertEqual(m.repeated_bytes[1], self._GOLDEN_BYTES_1)
  618. # repeated_string[0] contained \ escaped data representing the UTF-8
  619. # representation of _GOLDEN_STR_0 - it needs to decode as such.
  620. self.assertEqual(m.repeated_string[0], self._GOLDEN_STR_0)
  621. def testFromBytesFile(self, message_module):
  622. m = message_module.TestAllTypes()
  623. f = io.BytesIO(self._BYTES_SAMPLE)
  624. text_format.ParseLines(f, m)
  625. self.assertEqual(m.optional_bytes, self._GOLDEN_BYTES)
  626. self.assertEqual(m.optional_string, self._GOLDEN_UNICODE)
  627. self.assertEqual(m.repeated_bytes[0], self._GOLDEN_BYTES)
  628. def testFromUnicodeFile(self, message_module):
  629. m = message_module.TestAllTypes()
  630. f = io.StringIO(self._UNICODE_SAMPLE)
  631. text_format.ParseLines(f, m)
  632. self.assertEqual(m.optional_bytes, self._GOLDEN_BYTES)
  633. self.assertEqual(m.optional_string, self._GOLDEN_UNICODE)
  634. self.assertEqual(m.repeated_bytes[0], self._GOLDEN_BYTES)
  635. def testFromBytesLines(self, message_module):
  636. m = message_module.TestAllTypes()
  637. text_format.ParseLines(self._BYTES_SAMPLE.split(b'\n'), m)
  638. self.assertEqual(m.optional_bytes, self._GOLDEN_BYTES)
  639. self.assertEqual(m.optional_string, self._GOLDEN_UNICODE)
  640. self.assertEqual(m.repeated_bytes[0], self._GOLDEN_BYTES)
  641. def testFromUnicodeLines(self, message_module):
  642. m = message_module.TestAllTypes()
  643. text_format.ParseLines(self._UNICODE_SAMPLE.split(u'\n'), m)
  644. self.assertEqual(m.optional_bytes, self._GOLDEN_BYTES)
  645. self.assertEqual(m.optional_string, self._GOLDEN_UNICODE)
  646. self.assertEqual(m.repeated_bytes[0], self._GOLDEN_BYTES)
  647. def testParseDuplicateMessages(self, message_module):
  648. message = message_module.TestAllTypes()
  649. text = ('optional_nested_message { bb: 1 } '
  650. 'optional_nested_message { bb: 2 }')
  651. six.assertRaisesRegex(self, text_format.ParseError, (
  652. r'1:59 : Message type "\w+.TestAllTypes" '
  653. r'should not have multiple "optional_nested_message" fields.'),
  654. text_format.Parse, text,
  655. message)
  656. def testParseDuplicateScalars(self, message_module):
  657. message = message_module.TestAllTypes()
  658. text = ('optional_int32: 42 ' 'optional_int32: 67')
  659. six.assertRaisesRegex(self, text_format.ParseError, (
  660. r'1:36 : Message type "\w+.TestAllTypes" should not '
  661. r'have multiple "optional_int32" fields.'), text_format.Parse, text,
  662. message)
  663. @_parameterized.parameters(unittest_pb2, unittest_proto3_arena_pb2)
  664. class TextFormatMergeTests(TextFormatBase):
  665. def testMergeDuplicateScalars(self, message_module):
  666. message = message_module.TestAllTypes()
  667. text = ('optional_int32: 42 ' 'optional_int32: 67')
  668. r = text_format.Merge(text, message)
  669. self.assertIs(r, message)
  670. self.assertEqual(67, message.optional_int32)
  671. def testMergeDuplicateNestedMessageScalars(self, message_module):
  672. message = message_module.TestAllTypes()
  673. text = ('optional_nested_message { bb: 1 } '
  674. 'optional_nested_message { bb: 2 }')
  675. r = text_format.Merge(text, message)
  676. self.assertTrue(r is message)
  677. self.assertEqual(2, message.optional_nested_message.bb)
  678. def testMergeMultipleOneof(self, message_module):
  679. m_string = '\n'.join(['oneof_uint32: 11', 'oneof_string: "foo"'])
  680. m2 = message_module.TestAllTypes()
  681. text_format.Merge(m_string, m2)
  682. self.assertEqual('oneof_string', m2.WhichOneof('oneof_field'))
  683. # These are tests that aren't fundamentally specific to proto2, but are at
  684. # the moment because of differences between the proto2 and proto3 test schemas.
  685. # Ideally the schemas would be made more similar so these tests could pass.
  686. class OnlyWorksWithProto2RightNowTests(TextFormatBase):
  687. def testPrintAllFieldsPointy(self):
  688. message = unittest_pb2.TestAllTypes()
  689. test_util.SetAllFields(message)
  690. self.CompareToGoldenFile(
  691. self.RemoveRedundantZeros(text_format.MessageToString(
  692. message, pointy_brackets=True)),
  693. 'text_format_unittest_data_pointy_oneof.txt')
  694. def testParseGolden(self):
  695. golden_text = '\n'.join(self.ReadGolden(
  696. 'text_format_unittest_data_oneof_implemented.txt'))
  697. parsed_message = unittest_pb2.TestAllTypes()
  698. r = text_format.Parse(golden_text, parsed_message)
  699. self.assertIs(r, parsed_message)
  700. message = unittest_pb2.TestAllTypes()
  701. test_util.SetAllFields(message)
  702. self.assertEqual(message, parsed_message)
  703. def testPrintAllFields(self):
  704. message = unittest_pb2.TestAllTypes()
  705. test_util.SetAllFields(message)
  706. self.CompareToGoldenFile(
  707. self.RemoveRedundantZeros(text_format.MessageToString(message)),
  708. 'text_format_unittest_data_oneof_implemented.txt')
  709. def testPrintInIndexOrder(self):
  710. message = unittest_pb2.TestFieldOrderings()
  711. # Fields are listed in index order instead of field number.
  712. message.my_string = 'str'
  713. message.my_int = 101
  714. message.my_float = 111
  715. message.optional_nested_message.oo = 0
  716. message.optional_nested_message.bb = 1
  717. message.Extensions[unittest_pb2.my_extension_string] = 'ext_str0'
  718. # Extensions are listed based on the order of extension number.
  719. # Extension number 12.
  720. message.Extensions[unittest_pb2.TestExtensionOrderings2.
  721. test_ext_orderings2].my_string = 'ext_str2'
  722. # Extension number 13.
  723. message.Extensions[unittest_pb2.TestExtensionOrderings1.
  724. test_ext_orderings1].my_string = 'ext_str1'
  725. # Extension number 14.
  726. message.Extensions[
  727. unittest_pb2.TestExtensionOrderings2.TestExtensionOrderings3.
  728. test_ext_orderings3].my_string = 'ext_str3'
  729. # Print in index order.
  730. self.CompareToGoldenText(
  731. self.RemoveRedundantZeros(
  732. text_format.MessageToString(message, use_index_order=True)),
  733. 'my_string: "str"\n'
  734. 'my_int: 101\n'
  735. 'my_float: 111\n'
  736. 'optional_nested_message {\n'
  737. ' oo: 0\n'
  738. ' bb: 1\n'
  739. '}\n'
  740. '[protobuf_unittest.TestExtensionOrderings2.test_ext_orderings2] {\n'
  741. ' my_string: "ext_str2"\n'
  742. '}\n'
  743. '[protobuf_unittest.TestExtensionOrderings1.test_ext_orderings1] {\n'
  744. ' my_string: "ext_str1"\n'
  745. '}\n'
  746. '[protobuf_unittest.TestExtensionOrderings2.TestExtensionOrderings3'
  747. '.test_ext_orderings3] {\n'
  748. ' my_string: "ext_str3"\n'
  749. '}\n'
  750. '[protobuf_unittest.my_extension_string]: "ext_str0"\n')
  751. # By default, print in field number order.
  752. self.CompareToGoldenText(
  753. self.RemoveRedundantZeros(text_format.MessageToString(message)),
  754. 'my_int: 101\n'
  755. 'my_string: "str"\n'
  756. '[protobuf_unittest.TestExtensionOrderings2.test_ext_orderings2] {\n'
  757. ' my_string: "ext_str2"\n'
  758. '}\n'
  759. '[protobuf_unittest.TestExtensionOrderings1.test_ext_orderings1] {\n'
  760. ' my_string: "ext_str1"\n'
  761. '}\n'
  762. '[protobuf_unittest.TestExtensionOrderings2.TestExtensionOrderings3'
  763. '.test_ext_orderings3] {\n'
  764. ' my_string: "ext_str3"\n'
  765. '}\n'
  766. '[protobuf_unittest.my_extension_string]: "ext_str0"\n'
  767. 'my_float: 111\n'
  768. 'optional_nested_message {\n'
  769. ' bb: 1\n'
  770. ' oo: 0\n'
  771. '}\n')
  772. def testMergeLinesGolden(self):
  773. opened = self.ReadGolden('text_format_unittest_data_oneof_implemented.txt')
  774. parsed_message = unittest_pb2.TestAllTypes()
  775. r = text_format.MergeLines(opened, parsed_message)
  776. self.assertIs(r, parsed_message)
  777. message = unittest_pb2.TestAllTypes()
  778. test_util.SetAllFields(message)
  779. self.assertEqual(message, parsed_message)
  780. def testParseLinesGolden(self):
  781. opened = self.ReadGolden('text_format_unittest_data_oneof_implemented.txt')
  782. parsed_message = unittest_pb2.TestAllTypes()
  783. r = text_format.ParseLines(opened, parsed_message)
  784. self.assertIs(r, parsed_message)
  785. message = unittest_pb2.TestAllTypes()
  786. test_util.SetAllFields(message)
  787. self.assertEqual(message, parsed_message)
  788. def testPrintMap(self):
  789. message = map_unittest_pb2.TestMap()
  790. message.map_int32_int32[-123] = -456
  791. message.map_int64_int64[-2**33] = -2**34
  792. message.map_uint32_uint32[123] = 456
  793. message.map_uint64_uint64[2**33] = 2**34
  794. message.map_string_string['abc'] = '123'
  795. message.map_int32_foreign_message[111].c = 5
  796. # Maps are serialized to text format using their underlying repeated
  797. # representation.
  798. self.CompareToGoldenText(
  799. text_format.MessageToString(message), 'map_int32_int32 {\n'
  800. ' key: -123\n'
  801. ' value: -456\n'
  802. '}\n'
  803. 'map_int64_int64 {\n'
  804. ' key: -8589934592\n'
  805. ' value: -17179869184\n'
  806. '}\n'
  807. 'map_uint32_uint32 {\n'
  808. ' key: 123\n'
  809. ' value: 456\n'
  810. '}\n'
  811. 'map_uint64_uint64 {\n'
  812. ' key: 8589934592\n'
  813. ' value: 17179869184\n'
  814. '}\n'
  815. 'map_string_string {\n'
  816. ' key: "abc"\n'
  817. ' value: "123"\n'
  818. '}\n'
  819. 'map_int32_foreign_message {\n'
  820. ' key: 111\n'
  821. ' value {\n'
  822. ' c: 5\n'
  823. ' }\n'
  824. '}\n')
  825. # In cpp implementation, __str__ calls the cpp implementation of text format.
  826. def testPrintMapUsingCppImplementation(self):
  827. message = map_unittest_pb2.TestMap()
  828. inner_msg = message.map_int32_foreign_message[111]
  829. inner_msg.c = 1
  830. self.assertEqual(
  831. str(message),
  832. 'map_int32_foreign_message {\n'
  833. ' key: 111\n'
  834. ' value {\n'
  835. ' c: 1\n'
  836. ' }\n'
  837. '}\n')
  838. inner_msg.c = 2
  839. self.assertEqual(
  840. str(message),
  841. 'map_int32_foreign_message {\n'
  842. ' key: 111\n'
  843. ' value {\n'
  844. ' c: 2\n'
  845. ' }\n'
  846. '}\n')
  847. def testMapOrderEnforcement(self):
  848. message = map_unittest_pb2.TestMap()
  849. for letter in string.ascii_uppercase[13:26]:
  850. message.map_string_string[letter] = 'dummy'
  851. for letter in reversed(string.ascii_uppercase[0:13]):
  852. message.map_string_string[letter] = 'dummy'
  853. golden = ''.join(('map_string_string {\n key: "%c"\n value: "dummy"\n}\n'
  854. % (letter,) for letter in string.ascii_uppercase))
  855. self.CompareToGoldenText(text_format.MessageToString(message), golden)
  856. # TODO(teboring): In c/137553523, not serializing default value for map entry
  857. # message has been fixed. This test needs to be disabled in order to submit
  858. # that cl. Add this back when c/137553523 has been submitted.
  859. # def testMapOrderSemantics(self):
  860. # golden_lines = self.ReadGolden('map_test_data.txt')
  861. # message = map_unittest_pb2.TestMap()
  862. # text_format.ParseLines(golden_lines, message)
  863. # candidate = text_format.MessageToString(message)
  864. # # The Python implementation emits "1.0" for the double value that the C++
  865. # # implementation emits as "1".
  866. # candidate = candidate.replace('1.0', '1', 2)
  867. # candidate = candidate.replace('0.0', '0', 2)
  868. # self.assertMultiLineEqual(candidate, ''.join(golden_lines))
  869. # Tests of proto2-only features (MessageSet, extensions, etc.).
  870. class Proto2Tests(TextFormatBase):
  871. def testPrintMessageSet(self):
  872. message = unittest_mset_pb2.TestMessageSetContainer()
  873. ext1 = unittest_mset_pb2.TestMessageSetExtension1.message_set_extension
  874. ext2 = unittest_mset_pb2.TestMessageSetExtension2.message_set_extension
  875. message.message_set.Extensions[ext1].i = 23
  876. message.message_set.Extensions[ext2].str = 'foo'
  877. self.CompareToGoldenText(
  878. text_format.MessageToString(message), 'message_set {\n'
  879. ' [protobuf_unittest.TestMessageSetExtension1] {\n'
  880. ' i: 23\n'
  881. ' }\n'
  882. ' [protobuf_unittest.TestMessageSetExtension2] {\n'
  883. ' str: \"foo\"\n'
  884. ' }\n'
  885. '}\n')
  886. message = message_set_extensions_pb2.TestMessageSet()
  887. ext = message_set_extensions_pb2.message_set_extension3
  888. message.Extensions[ext].text = 'bar'
  889. self.CompareToGoldenText(
  890. text_format.MessageToString(message),
  891. '[google.protobuf.internal.TestMessageSetExtension3] {\n'
  892. ' text: \"bar\"\n'
  893. '}\n')
  894. def testPrintMessageSetByFieldNumber(self):
  895. out = text_format.TextWriter(False)
  896. message = unittest_mset_pb2.TestMessageSetContainer()
  897. ext1 = unittest_mset_pb2.TestMessageSetExtension1.message_set_extension
  898. ext2 = unittest_mset_pb2.TestMessageSetExtension2.message_set_extension
  899. message.message_set.Extensions[ext1].i = 23
  900. message.message_set.Extensions[ext2].str = 'foo'
  901. text_format.PrintMessage(message, out, use_field_number=True)
  902. self.CompareToGoldenText(out.getvalue(), '1 {\n'
  903. ' 1545008 {\n'
  904. ' 15: 23\n'
  905. ' }\n'
  906. ' 1547769 {\n'
  907. ' 25: \"foo\"\n'
  908. ' }\n'
  909. '}\n')
  910. out.close()
  911. def testPrintMessageSetAsOneLine(self):
  912. message = unittest_mset_pb2.TestMessageSetContainer()
  913. ext1 = unittest_mset_pb2.TestMessageSetExtension1.message_set_extension
  914. ext2 = unittest_mset_pb2.TestMessageSetExtension2.message_set_extension
  915. message.message_set.Extensions[ext1].i = 23
  916. message.message_set.Extensions[ext2].str = 'foo'
  917. self.CompareToGoldenText(
  918. text_format.MessageToString(message, as_one_line=True),
  919. 'message_set {'
  920. ' [protobuf_unittest.TestMessageSetExtension1] {'
  921. ' i: 23'
  922. ' }'
  923. ' [protobuf_unittest.TestMessageSetExtension2] {'
  924. ' str: \"foo\"'
  925. ' }'
  926. ' }')
  927. def testParseMessageSet(self):
  928. message = unittest_pb2.TestAllTypes()
  929. text = ('repeated_uint64: 1\n' 'repeated_uint64: 2\n')
  930. text_format.Parse(text, message)
  931. self.assertEqual(1, message.repeated_uint64[0])
  932. self.assertEqual(2, message.repeated_uint64[1])
  933. message = unittest_mset_pb2.TestMessageSetContainer()
  934. text = ('message_set {\n'
  935. ' [protobuf_unittest.TestMessageSetExtension1] {\n'
  936. ' i: 23\n'
  937. ' }\n'
  938. ' [protobuf_unittest.TestMessageSetExtension2] {\n'
  939. ' str: \"foo\"\n'
  940. ' }\n'
  941. '}\n')
  942. text_format.Parse(text, message)
  943. ext1 = unittest_mset_pb2.TestMessageSetExtension1.message_set_extension
  944. ext2 = unittest_mset_pb2.TestMessageSetExtension2.message_set_extension
  945. self.assertEqual(23, message.message_set.Extensions[ext1].i)
  946. self.assertEqual('foo', message.message_set.Extensions[ext2].str)
  947. def testExtensionInsideAnyMessage(self):
  948. message = test_extend_any.TestAny()
  949. text = ('value {\n'
  950. ' [type.googleapis.com/google.protobuf.internal.TestAny] {\n'
  951. ' [google.protobuf.internal.TestAnyExtension1.extension1] {\n'
  952. ' i: 10\n'
  953. ' }\n'
  954. ' }\n'
  955. '}\n')
  956. text_format.Merge(text, message, descriptor_pool=descriptor_pool.Default())
  957. self.CompareToGoldenText(
  958. text_format.MessageToString(
  959. message, descriptor_pool=descriptor_pool.Default()),
  960. text)
  961. def testParseMessageByFieldNumber(self):
  962. message = unittest_pb2.TestAllTypes()
  963. text = ('34: 1\n' 'repeated_uint64: 2\n')
  964. text_format.Parse(text, message, allow_field_number=True)
  965. self.assertEqual(1, message.repeated_uint64[0])
  966. self.assertEqual(2, message.repeated_uint64[1])
  967. message = unittest_mset_pb2.TestMessageSetContainer()
  968. text = ('1 {\n'
  969. ' 1545008 {\n'
  970. ' 15: 23\n'
  971. ' }\n'
  972. ' 1547769 {\n'
  973. ' 25: \"foo\"\n'
  974. ' }\n'
  975. '}\n')
  976. text_format.Parse(text, message, allow_field_number=True)
  977. ext1 = unittest_mset_pb2.TestMessageSetExtension1.message_set_extension
  978. ext2 = unittest_mset_pb2.TestMessageSetExtension2.message_set_extension
  979. self.assertEqual(23, message.message_set.Extensions[ext1].i)
  980. self.assertEqual('foo', message.message_set.Extensions[ext2].str)
  981. # Can't parse field number without set allow_field_number=True.
  982. message = unittest_pb2.TestAllTypes()
  983. text = '34:1\n'
  984. six.assertRaisesRegex(self, text_format.ParseError, (
  985. r'1:1 : Message type "\w+.TestAllTypes" has no field named '
  986. r'"34".'), text_format.Parse, text, message)
  987. # Can't parse if field number is not found.
  988. text = '1234:1\n'
  989. six.assertRaisesRegex(
  990. self,
  991. text_format.ParseError,
  992. (r'1:1 : Message type "\w+.TestAllTypes" has no field named '
  993. r'"1234".'),
  994. text_format.Parse,
  995. text,
  996. message,
  997. allow_field_number=True)
  998. def testPrintAllExtensions(self):
  999. message = unittest_pb2.TestAllExtensions()
  1000. test_util.SetAllExtensions(message)
  1001. self.CompareToGoldenFile(
  1002. self.RemoveRedundantZeros(text_format.MessageToString(message)),
  1003. 'text_format_unittest_extensions_data.txt')
  1004. def testPrintAllExtensionsPointy(self):
  1005. message = unittest_pb2.TestAllExtensions()
  1006. test_util.SetAllExtensions(message)
  1007. self.CompareToGoldenFile(
  1008. self.RemoveRedundantZeros(text_format.MessageToString(
  1009. message, pointy_brackets=True)),
  1010. 'text_format_unittest_extensions_data_pointy.txt')
  1011. def testParseGoldenExtensions(self):
  1012. golden_text = '\n'.join(self.ReadGolden(
  1013. 'text_format_unittest_extensions_data.txt'))
  1014. parsed_message = unittest_pb2.TestAllExtensions()
  1015. text_format.Parse(golden_text, parsed_message)
  1016. message = unittest_pb2.TestAllExtensions()
  1017. test_util.SetAllExtensions(message)
  1018. self.assertEqual(message, parsed_message)
  1019. def testParseAllExtensions(self):
  1020. message = unittest_pb2.TestAllExtensions()
  1021. test_util.SetAllExtensions(message)
  1022. ascii_text = text_format.MessageToString(message)
  1023. parsed_message = unittest_pb2.TestAllExtensions()
  1024. text_format.Parse(ascii_text, parsed_message)
  1025. self.assertEqual(message, parsed_message)
  1026. def testParseAllowedUnknownExtension(self):
  1027. # Skip over unknown extension correctly.
  1028. message = unittest_mset_pb2.TestMessageSetContainer()
  1029. text = ('message_set {\n'
  1030. ' [unknown_extension] {\n'
  1031. ' i: 23\n'
  1032. ' bin: "\xe0"'
  1033. ' [nested_unknown_ext]: {\n'
  1034. ' i: 23\n'
  1035. ' x: x\n'
  1036. ' test: "test_string"\n'
  1037. ' floaty_float: -0.315\n'
  1038. ' num: -inf\n'
  1039. ' multiline_str: "abc"\n'
  1040. ' "def"\n'
  1041. ' "xyz."\n'
  1042. ' [nested_unknown_ext.ext]: <\n'
  1043. ' i: 23\n'
  1044. ' i: 24\n'
  1045. ' pointfloat: .3\n'
  1046. ' test: "test_string"\n'
  1047. ' floaty_float: -0.315\n'
  1048. ' num: -inf\n'
  1049. ' long_string: "test" "test2" \n'
  1050. ' >\n'
  1051. ' }\n'
  1052. ' }\n'
  1053. ' [unknown_extension]: 5\n'
  1054. ' [unknown_extension_with_number_field] {\n'
  1055. ' 1: "some_field"\n'
  1056. ' 2: -0.451\n'
  1057. ' }\n'
  1058. '}\n')
  1059. text_format.Parse(text, message, allow_unknown_extension=True)
  1060. golden = 'message_set {\n}\n'
  1061. self.CompareToGoldenText(text_format.MessageToString(message), golden)
  1062. # Catch parse errors in unknown extension.
  1063. message = unittest_mset_pb2.TestMessageSetContainer()
  1064. malformed = ('message_set {\n'
  1065. ' [unknown_extension] {\n'
  1066. ' i:\n' # Missing value.
  1067. ' }\n'
  1068. '}\n')
  1069. six.assertRaisesRegex(self,
  1070. text_format.ParseError,
  1071. 'Invalid field value: }',
  1072. text_format.Parse,
  1073. malformed,
  1074. message,
  1075. allow_unknown_extension=True)
  1076. message = unittest_mset_pb2.TestMessageSetContainer()
  1077. malformed = ('message_set {\n'
  1078. ' [unknown_extension] {\n'
  1079. ' str: "malformed string\n' # Missing closing quote.
  1080. ' }\n'
  1081. '}\n')
  1082. six.assertRaisesRegex(self,
  1083. text_format.ParseError,
  1084. 'Invalid field value: "',
  1085. text_format.Parse,
  1086. malformed,
  1087. message,
  1088. allow_unknown_extension=True)
  1089. message = unittest_mset_pb2.TestMessageSetContainer()
  1090. malformed = ('message_set {\n'
  1091. ' [unknown_extension] {\n'
  1092. ' str: "malformed\n multiline\n string\n'
  1093. ' }\n'
  1094. '}\n')
  1095. six.assertRaisesRegex(self,
  1096. text_format.ParseError,
  1097. 'Invalid field value: "',
  1098. text_format.Parse,
  1099. malformed,
  1100. message,
  1101. allow_unknown_extension=True)
  1102. message = unittest_mset_pb2.TestMessageSetContainer()
  1103. malformed = ('message_set {\n'
  1104. ' [malformed_extension] <\n'
  1105. ' i: -5\n'
  1106. ' \n' # Missing '>' here.
  1107. '}\n')
  1108. six.assertRaisesRegex(self,
  1109. text_format.ParseError,
  1110. '5:1 : \'}\': Expected ">".',
  1111. text_format.Parse,
  1112. malformed,
  1113. message,
  1114. allow_unknown_extension=True)
  1115. # Don't allow unknown fields with allow_unknown_extension=True.
  1116. message = unittest_mset_pb2.TestMessageSetContainer()
  1117. malformed = ('message_set {\n'
  1118. ' unknown_field: true\n'
  1119. '}\n')
  1120. six.assertRaisesRegex(self,
  1121. text_format.ParseError,
  1122. ('2:3 : Message type '
  1123. '"proto2_wireformat_unittest.TestMessageSet" has no'
  1124. ' field named "unknown_field".'),
  1125. text_format.Parse,
  1126. malformed,
  1127. message,
  1128. allow_unknown_extension=True)
  1129. # Parse known extension correctly.
  1130. message = unittest_mset_pb2.TestMessageSetContainer()
  1131. text = ('message_set {\n'
  1132. ' [protobuf_unittest.TestMessageSetExtension1] {\n'
  1133. ' i: 23\n'
  1134. ' }\n'
  1135. ' [protobuf_unittest.TestMessageSetExtension2] {\n'
  1136. ' str: \"foo\"\n'
  1137. ' }\n'
  1138. '}\n')
  1139. text_format.Parse(text, message, allow_unknown_extension=True)
  1140. ext1 = unittest_mset_pb2.TestMessageSetExtension1.message_set_extension
  1141. ext2 = unittest_mset_pb2.TestMessageSetExtension2.message_set_extension
  1142. self.assertEqual(23, message.message_set.Extensions[ext1].i)
  1143. self.assertEqual('foo', message.message_set.Extensions[ext2].str)
  1144. def testParseBadIdentifier(self):
  1145. message = unittest_pb2.TestAllTypes()
  1146. text = ('optional_nested_message { "bb": 1 }')
  1147. with self.assertRaises(text_format.ParseError) as e:
  1148. text_format.Parse(text, message)
  1149. self.assertEqual(str(e.exception),
  1150. '1:27 : \'optional_nested_message { "bb": 1 }\': '
  1151. 'Expected identifier or number, got "bb".')
  1152. def testParseBadExtension(self):
  1153. message = unittest_pb2.TestAllExtensions()
  1154. text = '[unknown_extension]: 8\n'
  1155. six.assertRaisesRegex(self, text_format.ParseError,
  1156. '1:2 : Extension "unknown_extension" not registered.',
  1157. text_format.Parse, text, message)
  1158. message = unittest_pb2.TestAllTypes()
  1159. six.assertRaisesRegex(self, text_format.ParseError, (
  1160. '1:2 : Message type "protobuf_unittest.TestAllTypes" does not have '
  1161. 'extensions.'), text_format.Parse, text, message)
  1162. def testParseNumericUnknownEnum(self):
  1163. message = unittest_pb2.TestAllTypes()
  1164. text = 'optional_nested_enum: 100'
  1165. six.assertRaisesRegex(self, text_format.ParseError,
  1166. (r'1:23 : \'optional_nested_enum: 100\': '
  1167. r'Enum type "\w+.TestAllTypes.NestedEnum" '
  1168. r'has no value with number 100.'), text_format.Parse,
  1169. text, message)
  1170. def testMergeDuplicateExtensionScalars(self):
  1171. message = unittest_pb2.TestAllExtensions()
  1172. text = ('[protobuf_unittest.optional_int32_extension]: 42 '
  1173. '[protobuf_unittest.optional_int32_extension]: 67')
  1174. text_format.Merge(text, message)
  1175. self.assertEqual(67,
  1176. message.Extensions[unittest_pb2.optional_int32_extension])
  1177. def testParseDuplicateExtensionScalars(self):
  1178. message = unittest_pb2.TestAllExtensions()
  1179. text = ('[protobuf_unittest.optional_int32_extension]: 42 '
  1180. '[protobuf_unittest.optional_int32_extension]: 67')
  1181. six.assertRaisesRegex(self, text_format.ParseError, (
  1182. '1:96 : Message type "protobuf_unittest.TestAllExtensions" '
  1183. 'should not have multiple '
  1184. '"protobuf_unittest.optional_int32_extension" extensions.'),
  1185. text_format.Parse, text, message)
  1186. def testParseDuplicateExtensionMessages(self):
  1187. message = unittest_pb2.TestAllExtensions()
  1188. text = ('[protobuf_unittest.optional_nested_message_extension]: {} '
  1189. '[protobuf_unittest.optional_nested_message_extension]: {}')
  1190. six.assertRaisesRegex(self, text_format.ParseError, (
  1191. '1:114 : Message type "protobuf_unittest.TestAllExtensions" '
  1192. 'should not have multiple '
  1193. '"protobuf_unittest.optional_nested_message_extension" extensions.'),
  1194. text_format.Parse, text, message)
  1195. def testParseGroupNotClosed(self):
  1196. message = unittest_pb2.TestAllTypes()
  1197. text = 'RepeatedGroup: <'
  1198. six.assertRaisesRegex(self, text_format.ParseError, '1:16 : Expected ">".',
  1199. text_format.Parse, text, message)
  1200. text = 'RepeatedGroup: {'
  1201. six.assertRaisesRegex(self, text_format.ParseError, '1:16 : Expected "}".',
  1202. text_format.Parse, text, message)
  1203. def testParseEmptyGroup(self):
  1204. message = unittest_pb2.TestAllTypes()
  1205. text = 'OptionalGroup: {}'
  1206. text_format.Parse(text, message)
  1207. self.assertTrue(message.HasField('optionalgroup'))
  1208. message.Clear()
  1209. message = unittest_pb2.TestAllTypes()
  1210. text = 'OptionalGroup: <>'
  1211. text_format.Parse(text, message)
  1212. self.assertTrue(message.HasField('optionalgroup'))
  1213. # Maps aren't really proto2-only, but our test schema only has maps for
  1214. # proto2.
  1215. def testParseMap(self):
  1216. text = ('map_int32_int32 {\n'
  1217. ' key: -123\n'
  1218. ' value: -456\n'
  1219. '}\n'
  1220. 'map_int64_int64 {\n'
  1221. ' key: -8589934592\n'
  1222. ' value: -17179869184\n'
  1223. '}\n'
  1224. 'map_uint32_uint32 {\n'
  1225. ' key: 123\n'
  1226. ' value: 456\n'
  1227. '}\n'
  1228. 'map_uint64_uint64 {\n'
  1229. ' key: 8589934592\n'
  1230. ' value: 17179869184\n'
  1231. '}\n'
  1232. 'map_string_string {\n'
  1233. ' key: "abc"\n'
  1234. ' value: "123"\n'
  1235. '}\n'
  1236. 'map_int32_foreign_message {\n'
  1237. ' key: 111\n'
  1238. ' value {\n'
  1239. ' c: 5\n'
  1240. ' }\n'
  1241. '}\n')
  1242. message = map_unittest_pb2.TestMap()
  1243. text_format.Parse(text, message)
  1244. self.assertEqual(-456, message.map_int32_int32[-123])
  1245. self.assertEqual(-2**34, message.map_int64_int64[-2**33])
  1246. self.assertEqual(456, message.map_uint32_uint32[123])
  1247. self.assertEqual(2**34, message.map_uint64_uint64[2**33])
  1248. self.assertEqual('123', message.map_string_string['abc'])
  1249. self.assertEqual(5, message.map_int32_foreign_message[111].c)
  1250. class Proto3Tests(unittest.TestCase):
  1251. def testPrintMessageExpandAny(self):
  1252. packed_message = unittest_pb2.OneString()
  1253. packed_message.data = 'string'
  1254. message = any_test_pb2.TestAny()
  1255. message.any_value.Pack(packed_message)
  1256. self.assertEqual(
  1257. text_format.MessageToString(message,
  1258. descriptor_pool=descriptor_pool.Default()),
  1259. 'any_value {\n'
  1260. ' [type.googleapis.com/protobuf_unittest.OneString] {\n'
  1261. ' data: "string"\n'
  1262. ' }\n'
  1263. '}\n')
  1264. def testTopAnyMessage(self):
  1265. packed_msg = unittest_pb2.OneString()
  1266. msg = any_pb2.Any()
  1267. msg.Pack(packed_msg)
  1268. text = text_format.MessageToString(msg)
  1269. other_msg = text_format.Parse(text, any_pb2.Any())
  1270. self.assertEqual(msg, other_msg)
  1271. def testPrintMessageExpandAnyRepeated(self):
  1272. packed_message = unittest_pb2.OneString()
  1273. message = any_test_pb2.TestAny()
  1274. packed_message.data = 'string0'
  1275. message.repeated_any_value.add().Pack(packed_message)
  1276. packed_message.data = 'string1'
  1277. message.repeated_any_value.add().Pack(packed_message)
  1278. self.assertEqual(
  1279. text_format.MessageToString(message),
  1280. 'repeated_any_value {\n'
  1281. ' [type.googleapis.com/protobuf_unittest.OneString] {\n'
  1282. ' data: "string0"\n'
  1283. ' }\n'
  1284. '}\n'
  1285. 'repeated_any_value {\n'
  1286. ' [type.googleapis.com/protobuf_unittest.OneString] {\n'
  1287. ' data: "string1"\n'
  1288. ' }\n'
  1289. '}\n')
  1290. def testPrintMessageExpandAnyDescriptorPoolMissingType(self):
  1291. packed_message = unittest_pb2.OneString()
  1292. packed_message.data = 'string'
  1293. message = any_test_pb2.TestAny()
  1294. message.any_value.Pack(packed_message)
  1295. empty_pool = descriptor_pool.DescriptorPool()
  1296. self.assertEqual(
  1297. text_format.MessageToString(message, descriptor_pool=empty_pool),
  1298. 'any_value {\n'
  1299. ' type_url: "type.googleapis.com/protobuf_unittest.OneString"\n'
  1300. ' value: "\\n\\006string"\n'
  1301. '}\n')
  1302. def testPrintMessageExpandAnyPointyBrackets(self):
  1303. packed_message = unittest_pb2.OneString()
  1304. packed_message.data = 'string'
  1305. message = any_test_pb2.TestAny()
  1306. message.any_value.Pack(packed_message)
  1307. self.assertEqual(
  1308. text_format.MessageToString(message,
  1309. pointy_brackets=True),
  1310. 'any_value <\n'
  1311. ' [type.googleapis.com/protobuf_unittest.OneString] <\n'
  1312. ' data: "string"\n'
  1313. ' >\n'
  1314. '>\n')
  1315. def testPrintMessageExpandAnyAsOneLine(self):
  1316. packed_message = unittest_pb2.OneString()
  1317. packed_message.data = 'string'
  1318. message = any_test_pb2.TestAny()
  1319. message.any_value.Pack(packed_message)
  1320. self.assertEqual(
  1321. text_format.MessageToString(message,
  1322. as_one_line=True),
  1323. 'any_value {'
  1324. ' [type.googleapis.com/protobuf_unittest.OneString]'
  1325. ' { data: "string" } '
  1326. '}')
  1327. def testPrintMessageExpandAnyAsOneLinePointyBrackets(self):
  1328. packed_message = unittest_pb2.OneString()
  1329. packed_message.data = 'string'
  1330. message = any_test_pb2.TestAny()
  1331. message.any_value.Pack(packed_message)
  1332. self.assertEqual(
  1333. text_format.MessageToString(message,
  1334. as_one_line=True,
  1335. pointy_brackets=True,
  1336. descriptor_pool=descriptor_pool.Default()),
  1337. 'any_value <'
  1338. ' [type.googleapis.com/protobuf_unittest.OneString]'
  1339. ' < data: "string" > '
  1340. '>')
  1341. def testPrintAndParseMessageInvalidAny(self):
  1342. packed_message = unittest_pb2.OneString()
  1343. packed_message.data = 'string'
  1344. message = any_test_pb2.TestAny()
  1345. message.any_value.Pack(packed_message)
  1346. # Only include string after last '/' in type_url.
  1347. message.any_value.type_url = message.any_value.TypeName()
  1348. text = text_format.MessageToString(message)
  1349. self.assertEqual(
  1350. text, 'any_value {\n'
  1351. ' type_url: "protobuf_unittest.OneString"\n'
  1352. ' value: "\\n\\006string"\n'
  1353. '}\n')
  1354. parsed_message = any_test_pb2.TestAny()
  1355. text_format.Parse(text, parsed_message)
  1356. self.assertEqual(message, parsed_message)
  1357. def testUnknownEnums(self):
  1358. message = unittest_proto3_arena_pb2.TestAllTypes()
  1359. message2 = unittest_proto3_arena_pb2.TestAllTypes()
  1360. message.optional_nested_enum = 999
  1361. text_string = text_format.MessageToString(message)
  1362. text_format.Parse(text_string, message2)
  1363. self.assertEqual(999, message2.optional_nested_enum)
  1364. def testMergeExpandedAny(self):
  1365. message = any_test_pb2.TestAny()
  1366. text = ('any_value {\n'
  1367. ' [type.googleapis.com/protobuf_unittest.OneString] {\n'
  1368. ' data: "string"\n'
  1369. ' }\n'
  1370. '}\n')
  1371. text_format.Merge(text, message)
  1372. packed_message = unittest_pb2.OneString()
  1373. message.any_value.Unpack(packed_message)
  1374. self.assertEqual('string', packed_message.data)
  1375. message.Clear()
  1376. text_format.Parse(text, message)
  1377. packed_message = unittest_pb2.OneString()
  1378. message.any_value.Unpack(packed_message)
  1379. self.assertEqual('string', packed_message.data)
  1380. def testMergeExpandedAnyRepeated(self):
  1381. message = any_test_pb2.TestAny()
  1382. text = ('repeated_any_value {\n'
  1383. ' [type.googleapis.com/protobuf_unittest.OneString] {\n'
  1384. ' data: "string0"\n'
  1385. ' }\n'
  1386. '}\n'
  1387. 'repeated_any_value {\n'
  1388. ' [type.googleapis.com/protobuf_unittest.OneString] {\n'
  1389. ' data: "string1"\n'
  1390. ' }\n'
  1391. '}\n')
  1392. text_format.Merge(text, message)
  1393. packed_message = unittest_pb2.OneString()
  1394. message.repeated_any_value[0].Unpack(packed_message)
  1395. self.assertEqual('string0', packed_message.data)
  1396. message.repeated_any_value[1].Unpack(packed_message)
  1397. self.assertEqual('string1', packed_message.data)
  1398. def testMergeExpandedAnyPointyBrackets(self):
  1399. message = any_test_pb2.TestAny()
  1400. text = ('any_value {\n'
  1401. ' [type.googleapis.com/protobuf_unittest.OneString] <\n'
  1402. ' data: "string"\n'
  1403. ' >\n'
  1404. '}\n')
  1405. text_format.Merge(text, message)
  1406. packed_message = unittest_pb2.OneString()
  1407. message.any_value.Unpack(packed_message)
  1408. self.assertEqual('string', packed_message.data)
  1409. def testMergeAlternativeUrl(self):
  1410. message = any_test_pb2.TestAny()
  1411. text = ('any_value {\n'
  1412. ' [type.otherapi.com/protobuf_unittest.OneString] {\n'
  1413. ' data: "string"\n'
  1414. ' }\n'
  1415. '}\n')
  1416. text_format.Merge(text, message)
  1417. packed_message = unittest_pb2.OneString()
  1418. self.assertEqual('type.otherapi.com/protobuf_unittest.OneString',
  1419. message.any_value.type_url)
  1420. def testMergeExpandedAnyDescriptorPoolMissingType(self):
  1421. message = any_test_pb2.TestAny()
  1422. text = ('any_value {\n'
  1423. ' [type.googleapis.com/protobuf_unittest.OneString] {\n'
  1424. ' data: "string"\n'
  1425. ' }\n'
  1426. '}\n')
  1427. with self.assertRaises(text_format.ParseError) as e:
  1428. empty_pool = descriptor_pool.DescriptorPool()
  1429. text_format.Merge(text, message, descriptor_pool=empty_pool)
  1430. self.assertEqual(
  1431. str(e.exception),
  1432. 'Type protobuf_unittest.OneString not found in descriptor pool')
  1433. def testMergeUnexpandedAny(self):
  1434. text = ('any_value {\n'
  1435. ' type_url: "type.googleapis.com/protobuf_unittest.OneString"\n'
  1436. ' value: "\\n\\006string"\n'
  1437. '}\n')
  1438. message = any_test_pb2.TestAny()
  1439. text_format.Merge(text, message)
  1440. packed_message = unittest_pb2.OneString()
  1441. message.any_value.Unpack(packed_message)
  1442. self.assertEqual('string', packed_message.data)
  1443. def testMergeMissingAnyEndToken(self):
  1444. message = any_test_pb2.TestAny()
  1445. text = ('any_value {\n'
  1446. ' [type.googleapis.com/protobuf_unittest.OneString] {\n'
  1447. ' data: "string"\n')
  1448. with self.assertRaises(text_format.ParseError) as e:
  1449. text_format.Merge(text, message)
  1450. self.assertEqual(str(e.exception), '3:11 : Expected "}".')
  1451. class TokenizerTest(unittest.TestCase):
  1452. def testSimpleTokenCases(self):
  1453. text = ('identifier1:"string1"\n \n\n'
  1454. 'identifier2 : \n \n123 \n identifier3 :\'string\'\n'
  1455. 'identifiER_4 : 1.1e+2 ID5:-0.23 ID6:\'aaaa\\\'bbbb\'\n'
  1456. 'ID7 : "aa\\"bb"\n\n\n\n ID8: {A:inf B:-inf C:true D:false}\n'
  1457. 'ID9: 22 ID10: -111111111111111111 ID11: -22\n'
  1458. 'ID12: 2222222222222222222 ID13: 1.23456f ID14: 1.2e+2f '
  1459. 'false_bool: 0 true_BOOL:t \n true_bool1: 1 false_BOOL1:f '
  1460. 'False_bool: False True_bool: True X:iNf Y:-inF Z:nAN')
  1461. tokenizer = text_format.Tokenizer(text.splitlines())
  1462. methods = [(tokenizer.ConsumeIdentifier, 'identifier1'), ':',
  1463. (tokenizer.ConsumeString, 'string1'),
  1464. (tokenizer.ConsumeIdentifier, 'identifier2'), ':',
  1465. (tokenizer.ConsumeInteger, 123),
  1466. (tokenizer.ConsumeIdentifier, 'identifier3'), ':',
  1467. (tokenizer.ConsumeString, 'string'),
  1468. (tokenizer.ConsumeIdentifier, 'identifiER_4'), ':',
  1469. (tokenizer.ConsumeFloat, 1.1e+2),
  1470. (tokenizer.ConsumeIdentifier, 'ID5'), ':',
  1471. (tokenizer.ConsumeFloat, -0.23),
  1472. (tokenizer.ConsumeIdentifier, 'ID6'), ':',
  1473. (tokenizer.ConsumeString, 'aaaa\'bbbb'),
  1474. (tokenizer.ConsumeIdentifier, 'ID7'), ':',
  1475. (tokenizer.ConsumeString, 'aa\"bb'),
  1476. (tokenizer.ConsumeIdentifier, 'ID8'), ':', '{',
  1477. (tokenizer.ConsumeIdentifier, 'A'), ':',
  1478. (tokenizer.ConsumeFloat, float('inf')),
  1479. (tokenizer.ConsumeIdentifier, 'B'), ':',
  1480. (tokenizer.ConsumeFloat, -float('inf')),
  1481. (tokenizer.ConsumeIdentifier, 'C'), ':',
  1482. (tokenizer.ConsumeBool, True),
  1483. (tokenizer.ConsumeIdentifier, 'D'), ':',
  1484. (tokenizer.ConsumeBool, False), '}',
  1485. (tokenizer.ConsumeIdentifier, 'ID9'), ':',
  1486. (tokenizer.ConsumeInteger, 22),
  1487. (tokenizer.ConsumeIdentifier, 'ID10'), ':',
  1488. (tokenizer.ConsumeInteger, -111111111111111111),
  1489. (tokenizer.ConsumeIdentifier, 'ID11'), ':',
  1490. (tokenizer.ConsumeInteger, -22),
  1491. (tokenizer.ConsumeIdentifier, 'ID12'), ':',
  1492. (tokenizer.ConsumeInteger, 2222222222222222222),
  1493. (tokenizer.ConsumeIdentifier, 'ID13'), ':',
  1494. (tokenizer.ConsumeFloat, 1.23456),
  1495. (tokenizer.ConsumeIdentifier, 'ID14'), ':',
  1496. (tokenizer.ConsumeFloat, 1.2e+2),
  1497. (tokenizer.ConsumeIdentifier, 'false_bool'), ':',
  1498. (tokenizer.ConsumeBool, False),
  1499. (tokenizer.ConsumeIdentifier, 'true_BOOL'), ':',
  1500. (tokenizer.ConsumeBool, True),
  1501. (tokenizer.ConsumeIdentifier, 'true_bool1'), ':',
  1502. (tokenizer.ConsumeBool, True),
  1503. (tokenizer.ConsumeIdentifier, 'false_BOOL1'), ':',
  1504. (tokenizer.ConsumeBool, False),
  1505. (tokenizer.ConsumeIdentifier, 'False_bool'), ':',
  1506. (tokenizer.ConsumeBool, False),
  1507. (tokenizer.ConsumeIdentifier, 'True_bool'), ':',
  1508. (tokenizer.ConsumeBool, True),
  1509. (tokenizer.ConsumeIdentifier, 'X'), ':',
  1510. (tokenizer.ConsumeFloat, float('inf')),
  1511. (tokenizer.ConsumeIdentifier, 'Y'), ':',
  1512. (tokenizer.ConsumeFloat, float('-inf')),
  1513. (tokenizer.ConsumeIdentifier, 'Z'), ':',
  1514. (tokenizer.ConsumeFloat, float('nan'))]
  1515. i = 0
  1516. while not tokenizer.AtEnd():
  1517. m = methods[i]
  1518. if isinstance(m, str):
  1519. token = tokenizer.token
  1520. self.assertEqual(token, m)
  1521. tokenizer.NextToken()
  1522. elif isinstance(m[1], float) and math.isnan(m[1]):
  1523. self.assertTrue(math.isnan(m[0]()))
  1524. else:
  1525. self.assertEqual(m[1], m[0]())
  1526. i += 1
  1527. def testConsumeAbstractIntegers(self):
  1528. # This test only tests the failures in the integer parsing methods as well
  1529. # as the '0' special cases.
  1530. int64_max = (1 << 63) - 1
  1531. uint32_max = (1 << 32) - 1
  1532. text = '-1 %d %d' % (uint32_max + 1, int64_max + 1)
  1533. tokenizer = text_format.Tokenizer(text.splitlines())
  1534. self.assertEqual(-1, tokenizer.ConsumeInteger())
  1535. self.assertEqual(uint32_max + 1, tokenizer.ConsumeInteger())
  1536. self.assertEqual(int64_max + 1, tokenizer.ConsumeInteger())
  1537. self.assertTrue(tokenizer.AtEnd())
  1538. text = '-0 0 0 1.2'
  1539. tokenizer = text_format.Tokenizer(text.splitlines())
  1540. self.assertEqual(0, tokenizer.ConsumeInteger())
  1541. self.assertEqual(0, tokenizer.ConsumeInteger())
  1542. self.assertEqual(True, tokenizer.TryConsumeInteger())
  1543. self.assertEqual(False, tokenizer.TryConsumeInteger())
  1544. with self.assertRaises(text_format.ParseError):
  1545. tokenizer.ConsumeInteger()
  1546. self.assertEqual(1.2, tokenizer.ConsumeFloat())
  1547. self.assertTrue(tokenizer.AtEnd())
  1548. def testConsumeIntegers(self):
  1549. # This test only tests the failures in the integer parsing methods as well
  1550. # as the '0' special cases.
  1551. int64_max = (1 << 63) - 1
  1552. uint32_max = (1 << 32) - 1
  1553. text = '-1 %d %d' % (uint32_max + 1, int64_max + 1)
  1554. tokenizer = text_format.Tokenizer(text.splitlines())
  1555. self.assertRaises(text_format.ParseError,
  1556. text_format._ConsumeUint32, tokenizer)
  1557. self.assertRaises(text_format.ParseError,
  1558. text_format._ConsumeUint64, tokenizer)
  1559. self.assertEqual(-1, text_format._ConsumeInt32(tokenizer))
  1560. self.assertRaises(text_format.ParseError,
  1561. text_format._ConsumeUint32, tokenizer)
  1562. self.assertRaises(text_format.ParseError,
  1563. text_format._ConsumeInt32, tokenizer)
  1564. self.assertEqual(uint32_max + 1, text_format._ConsumeInt64(tokenizer))
  1565. self.assertRaises(text_format.ParseError,
  1566. text_format._ConsumeInt64, tokenizer)
  1567. self.assertEqual(int64_max + 1, text_format._ConsumeUint64(tokenizer))
  1568. self.assertTrue(tokenizer.AtEnd())
  1569. text = '-0 -0 0 0'
  1570. tokenizer = text_format.Tokenizer(text.splitlines())
  1571. self.assertEqual(0, text_format._ConsumeUint32(tokenizer))
  1572. self.assertEqual(0, text_format._ConsumeUint64(tokenizer))
  1573. self.assertEqual(0, text_format._ConsumeUint32(tokenizer))
  1574. self.assertEqual(0, text_format._ConsumeUint64(tokenizer))
  1575. self.assertTrue(tokenizer.AtEnd())
  1576. def testConsumeOctalIntegers(self):
  1577. """Test support for C style octal integers."""
  1578. text = '00 -00 04 0755 -010 007 -0033 08 -09 01'
  1579. tokenizer = text_format.Tokenizer(text.splitlines())
  1580. self.assertEqual(0, tokenizer.ConsumeInteger())
  1581. self.assertEqual(0, tokenizer.ConsumeInteger())
  1582. self.assertEqual(4, tokenizer.ConsumeInteger())
  1583. self.assertEqual(0o755, tokenizer.ConsumeInteger())
  1584. self.assertEqual(-0o10, tokenizer.ConsumeInteger())
  1585. self.assertEqual(7, tokenizer.ConsumeInteger())
  1586. self.assertEqual(-0o033, tokenizer.ConsumeInteger())
  1587. with self.assertRaises(text_format.ParseError):
  1588. tokenizer.ConsumeInteger() # 08
  1589. tokenizer.NextToken()
  1590. with self.assertRaises(text_format.ParseError):
  1591. tokenizer.ConsumeInteger() # -09
  1592. tokenizer.NextToken()
  1593. self.assertEqual(1, tokenizer.ConsumeInteger())
  1594. self.assertTrue(tokenizer.AtEnd())
  1595. def testConsumeByteString(self):
  1596. text = '"string1\''
  1597. tokenizer = text_format.Tokenizer(text.splitlines())
  1598. self.assertRaises(text_format.ParseError, tokenizer.ConsumeByteString)
  1599. text = 'string1"'
  1600. tokenizer = text_format.Tokenizer(text.splitlines())
  1601. self.assertRaises(text_format.ParseError, tokenizer.ConsumeByteString)
  1602. text = '\n"\\xt"'
  1603. tokenizer = text_format.Tokenizer(text.splitlines())
  1604. self.assertRaises(text_format.ParseError, tokenizer.ConsumeByteString)
  1605. text = '\n"\\"'
  1606. tokenizer = text_format.Tokenizer(text.splitlines())
  1607. self.assertRaises(text_format.ParseError, tokenizer.ConsumeByteString)
  1608. text = '\n"\\x"'
  1609. tokenizer = text_format.Tokenizer(text.splitlines())
  1610. self.assertRaises(text_format.ParseError, tokenizer.ConsumeByteString)
  1611. def testConsumeBool(self):
  1612. text = 'not-a-bool'
  1613. tokenizer = text_format.Tokenizer(text.splitlines())
  1614. self.assertRaises(text_format.ParseError, tokenizer.ConsumeBool)
  1615. def testSkipComment(self):
  1616. tokenizer = text_format.Tokenizer('# some comment'.splitlines())
  1617. self.assertTrue(tokenizer.AtEnd())
  1618. self.assertRaises(text_format.ParseError, tokenizer.ConsumeComment)
  1619. def testConsumeComment(self):
  1620. tokenizer = text_format.Tokenizer('# some comment'.splitlines(),
  1621. skip_comments=False)
  1622. self.assertFalse(tokenizer.AtEnd())
  1623. self.assertEqual('# some comment', tokenizer.ConsumeComment())
  1624. self.assertTrue(tokenizer.AtEnd())
  1625. def testConsumeTwoComments(self):
  1626. text = '# some comment\n# another comment'
  1627. tokenizer = text_format.Tokenizer(text.splitlines(), skip_comments=False)
  1628. self.assertEqual('# some comment', tokenizer.ConsumeComment())
  1629. self.assertFalse(tokenizer.AtEnd())
  1630. self.assertEqual('# another comment', tokenizer.ConsumeComment())
  1631. self.assertTrue(tokenizer.AtEnd())
  1632. def testConsumeTrailingComment(self):
  1633. text = 'some_number: 4\n# some comment'
  1634. tokenizer = text_format.Tokenizer(text.splitlines(), skip_comments=False)
  1635. self.assertRaises(text_format.ParseError, tokenizer.ConsumeComment)
  1636. self.assertEqual('some_number', tokenizer.ConsumeIdentifier())
  1637. self.assertEqual(tokenizer.token, ':')
  1638. tokenizer.NextToken()
  1639. self.assertRaises(text_format.ParseError, tokenizer.ConsumeComment)
  1640. self.assertEqual(4, tokenizer.ConsumeInteger())
  1641. self.assertFalse(tokenizer.AtEnd())
  1642. self.assertEqual('# some comment', tokenizer.ConsumeComment())
  1643. self.assertTrue(tokenizer.AtEnd())
  1644. def testConsumeLineComment(self):
  1645. tokenizer = text_format.Tokenizer('# some comment'.splitlines(),
  1646. skip_comments=False)
  1647. self.assertFalse(tokenizer.AtEnd())
  1648. self.assertEqual((False, '# some comment'),
  1649. tokenizer.ConsumeCommentOrTrailingComment())
  1650. self.assertTrue(tokenizer.AtEnd())
  1651. def testConsumeTwoLineComments(self):
  1652. text = '# some comment\n# another comment'
  1653. tokenizer = text_format.Tokenizer(text.splitlines(), skip_comments=False)
  1654. self.assertEqual((False, '# some comment'),
  1655. tokenizer.ConsumeCommentOrTrailingComment())
  1656. self.assertFalse(tokenizer.AtEnd())
  1657. self.assertEqual((False, '# another comment'),
  1658. tokenizer.ConsumeCommentOrTrailingComment())
  1659. self.assertTrue(tokenizer.AtEnd())
  1660. def testConsumeAndCheckTrailingComment(self):
  1661. text = 'some_number: 4 # some comment' # trailing comment on the same line
  1662. tokenizer = text_format.Tokenizer(text.splitlines(), skip_comments=False)
  1663. self.assertRaises(text_format.ParseError,
  1664. tokenizer.ConsumeCommentOrTrailingComment)
  1665. self.assertEqual('some_number', tokenizer.ConsumeIdentifier())
  1666. self.assertEqual(tokenizer.token, ':')
  1667. tokenizer.NextToken()
  1668. self.assertRaises(text_format.ParseError,
  1669. tokenizer.ConsumeCommentOrTrailingComment)
  1670. self.assertEqual(4, tokenizer.ConsumeInteger())
  1671. self.assertFalse(tokenizer.AtEnd())
  1672. self.assertEqual((True, '# some comment'),
  1673. tokenizer.ConsumeCommentOrTrailingComment())
  1674. self.assertTrue(tokenizer.AtEnd())
  1675. def testHashinComment(self):
  1676. text = 'some_number: 4 # some comment # not a new comment'
  1677. tokenizer = text_format.Tokenizer(text.splitlines(), skip_comments=False)
  1678. self.assertEqual('some_number', tokenizer.ConsumeIdentifier())
  1679. self.assertEqual(tokenizer.token, ':')
  1680. tokenizer.NextToken()
  1681. self.assertEqual(4, tokenizer.ConsumeInteger())
  1682. self.assertEqual((True, '# some comment # not a new comment'),
  1683. tokenizer.ConsumeCommentOrTrailingComment())
  1684. self.assertTrue(tokenizer.AtEnd())
  1685. def testHugeString(self):
  1686. # With pathologic backtracking, fails with Forge OOM.
  1687. text = '"' + 'a' * (10 * 1024 * 1024) + '"'
  1688. tokenizer = text_format.Tokenizer(text.splitlines(), skip_comments=False)
  1689. tokenizer.ConsumeString()
  1690. # Tests for pretty printer functionality.
  1691. @_parameterized.parameters((unittest_pb2), (unittest_proto3_arena_pb2))
  1692. class PrettyPrinterTest(TextFormatBase):
  1693. def testPrettyPrintNoMatch(self, message_module):
  1694. def printer(message, indent, as_one_line):
  1695. del message, indent, as_one_line
  1696. return None
  1697. message = message_module.TestAllTypes()
  1698. msg = message.repeated_nested_message.add()
  1699. msg.bb = 42
  1700. self.CompareToGoldenText(
  1701. text_format.MessageToString(
  1702. message, as_one_line=True, message_formatter=printer),
  1703. 'repeated_nested_message { bb: 42 }')
  1704. def testPrettyPrintOneLine(self, message_module):
  1705. def printer(m, indent, as_one_line):
  1706. del indent, as_one_line
  1707. if m.DESCRIPTOR == message_module.TestAllTypes.NestedMessage.DESCRIPTOR:
  1708. return 'My lucky number is %s' % m.bb
  1709. message = message_module.TestAllTypes()
  1710. msg = message.repeated_nested_message.add()
  1711. msg.bb = 42
  1712. self.CompareToGoldenText(
  1713. text_format.MessageToString(
  1714. message, as_one_line=True, message_formatter=printer),
  1715. 'repeated_nested_message { My lucky number is 42 }')
  1716. def testPrettyPrintMultiLine(self, message_module):
  1717. def printer(m, indent, as_one_line):
  1718. if m.DESCRIPTOR == message_module.TestAllTypes.NestedMessage.DESCRIPTOR:
  1719. line_deliminator = (' ' if as_one_line else '\n') + ' ' * indent
  1720. return 'My lucky number is:%s%s' % (line_deliminator, m.bb)
  1721. return None
  1722. message = message_module.TestAllTypes()
  1723. msg = message.repeated_nested_message.add()
  1724. msg.bb = 42
  1725. self.CompareToGoldenText(
  1726. text_format.MessageToString(
  1727. message, as_one_line=True, message_formatter=printer),
  1728. 'repeated_nested_message { My lucky number is: 42 }')
  1729. self.CompareToGoldenText(
  1730. text_format.MessageToString(
  1731. message, as_one_line=False, message_formatter=printer),
  1732. 'repeated_nested_message {\n My lucky number is:\n 42\n}\n')
  1733. def testPrettyPrintEntireMessage(self, message_module):
  1734. def printer(m, indent, as_one_line):
  1735. del indent, as_one_line
  1736. if m.DESCRIPTOR == message_module.TestAllTypes.DESCRIPTOR:
  1737. return 'The is the message!'
  1738. return None
  1739. message = message_module.TestAllTypes()
  1740. self.CompareToGoldenText(
  1741. text_format.MessageToString(
  1742. message, as_one_line=False, message_formatter=printer),
  1743. 'The is the message!\n')
  1744. self.CompareToGoldenText(
  1745. text_format.MessageToString(
  1746. message, as_one_line=True, message_formatter=printer),
  1747. 'The is the message!')
  1748. def testPrettyPrintMultipleParts(self, message_module):
  1749. def printer(m, indent, as_one_line):
  1750. del indent, as_one_line
  1751. if m.DESCRIPTOR == message_module.TestAllTypes.NestedMessage.DESCRIPTOR:
  1752. return 'My lucky number is %s' % m.bb
  1753. return None
  1754. message = message_module.TestAllTypes()
  1755. message.optional_int32 = 61
  1756. msg = message.repeated_nested_message.add()
  1757. msg.bb = 42
  1758. msg = message.repeated_nested_message.add()
  1759. msg.bb = 99
  1760. msg = message.optional_nested_message
  1761. msg.bb = 1
  1762. self.CompareToGoldenText(
  1763. text_format.MessageToString(
  1764. message, as_one_line=True, message_formatter=printer),
  1765. ('optional_int32: 61 '
  1766. 'optional_nested_message { My lucky number is 1 } '
  1767. 'repeated_nested_message { My lucky number is 42 } '
  1768. 'repeated_nested_message { My lucky number is 99 }'))
  1769. out = text_format.TextWriter(False)
  1770. text_format.PrintField(
  1771. message_module.TestAllTypes.DESCRIPTOR.fields_by_name[
  1772. 'optional_nested_message'],
  1773. message.optional_nested_message,
  1774. out,
  1775. message_formatter=printer)
  1776. self.assertEqual(
  1777. 'optional_nested_message {\n My lucky number is 1\n}\n',
  1778. out.getvalue())
  1779. out.close()
  1780. out = text_format.TextWriter(False)
  1781. text_format.PrintFieldValue(
  1782. message_module.TestAllTypes.DESCRIPTOR.fields_by_name[
  1783. 'optional_nested_message'],
  1784. message.optional_nested_message,
  1785. out,
  1786. message_formatter=printer)
  1787. self.assertEqual(
  1788. '{\n My lucky number is 1\n}',
  1789. out.getvalue())
  1790. out.close()
  1791. class WhitespaceTest(TextFormatBase):
  1792. def setUp(self):
  1793. self.out = text_format.TextWriter(False)
  1794. self.addCleanup(self.out.close)
  1795. self.message = unittest_pb2.NestedTestAllTypes()
  1796. self.message.child.payload.optional_string = 'value'
  1797. self.field = self.message.DESCRIPTOR.fields_by_name['child']
  1798. self.value = self.message.child
  1799. def testMessageToString(self):
  1800. self.CompareToGoldenText(
  1801. text_format.MessageToString(self.message),
  1802. textwrap.dedent("""\
  1803. child {
  1804. payload {
  1805. optional_string: "value"
  1806. }
  1807. }
  1808. """))
  1809. def testPrintMessage(self):
  1810. text_format.PrintMessage(self.message, self.out)
  1811. self.CompareToGoldenText(
  1812. self.out.getvalue(),
  1813. textwrap.dedent("""\
  1814. child {
  1815. payload {
  1816. optional_string: "value"
  1817. }
  1818. }
  1819. """))
  1820. def testPrintField(self):
  1821. text_format.PrintField(self.field, self.value, self.out)
  1822. self.CompareToGoldenText(
  1823. self.out.getvalue(),
  1824. textwrap.dedent("""\
  1825. child {
  1826. payload {
  1827. optional_string: "value"
  1828. }
  1829. }
  1830. """))
  1831. def testPrintFieldValue(self):
  1832. text_format.PrintFieldValue(
  1833. self.field, self.value, self.out)
  1834. self.CompareToGoldenText(
  1835. self.out.getvalue(),
  1836. textwrap.dedent("""\
  1837. {
  1838. payload {
  1839. optional_string: "value"
  1840. }
  1841. }"""))
  1842. if __name__ == '__main__':
  1843. unittest.main()