1
# Copyright (C) 2005, 2006 Canonical Ltd
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
# GNU General Public License for more details.
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
"""Tests for rio serialization
19
A simple, reproducible structured IO format.
21
rio itself works in Unicode strings. It is typically encoded to UTF-8,
22
but this depends on the transport.
29
from tempfile import TemporaryFile
34
from bzrlib.tests import TestCaseInTempDir, TestCase
35
from bzrlib.rio import (RioWriter, Stanza, read_stanza, read_stanzas, rio_file,
39
class TestRio(TestCase):
41
def test_stanza(self):
42
"""Construct rio stanza in memory"""
43
s = Stanza(number='42', name="fred")
44
self.assertTrue('number' in s)
45
self.assertFalse('color' in s)
46
self.assertFalse('42' in s)
47
self.assertEquals(list(s.iter_pairs()),
48
[('name', 'fred'), ('number', '42')])
49
self.assertEquals(s.get('number'), '42')
50
self.assertEquals(s.get('name'), 'fred')
52
def test_value_checks(self):
53
"""rio checks types on construction"""
54
# these aren't enforced at construction time
55
## self.assertRaises(ValueError,
56
## Stanza, complex=42 + 3j)
57
## self.assertRaises(ValueError,
58
## Stanza, several=range(10))
60
def test_empty_value(self):
61
"""Serialize stanza with empty field"""
63
self.assertEqualDiff(s.to_string(),
66
def test_to_lines(self):
67
"""Write simple rio stanza to string"""
68
s = Stanza(number='42', name='fred')
69
self.assertEquals(list(s.to_lines()),
73
def test_as_dict(self):
74
"""Convert rio Stanza to dictionary"""
75
s = Stanza(number='42', name='fred')
77
self.assertEquals(sd, dict(number='42', name='fred'))
79
def test_to_file(self):
80
"""Write rio to file"""
81
tmpf = TemporaryFile()
82
s = Stanza(a_thing='something with "quotes like \\"this\\""', number='42', name='fred')
85
self.assertEqualDiff(tmpf.read(), r'''
86
a_thing: something with "quotes like \"this\""
91
def test_multiline_string(self):
92
tmpf = TemporaryFile()
93
s = Stanza(motto="war is peace\nfreedom is slavery\nignorance is strength")
96
self.assertEqualDiff(tmpf.read(), '''\
99
\tignorance is strength
102
s2 = read_stanza(tmpf)
103
self.assertEquals(s, s2)
105
def test_read_stanza(self):
106
"""Load stanza from string"""
108
revision: mbp@sourcefrog.net-123-abc
109
timestamp: 1130653962
111
committer: Martin Pool <mbp@test.sourcefrog.net>
113
s = read_stanza(lines)
114
self.assertTrue('revision' in s)
115
self.assertEqualDiff(s.get('revision'), 'mbp@sourcefrog.net-123-abc')
116
self.assertEquals(list(s.iter_pairs()),
117
[('revision', 'mbp@sourcefrog.net-123-abc'),
118
('timestamp', '1130653962'),
119
('timezone', '36000'),
120
('committer', "Martin Pool <mbp@test.sourcefrog.net>")])
121
self.assertEquals(len(s), 4)
123
def test_repeated_field(self):
124
"""Repeated field in rio"""
126
for k, v in [('a', '10'), ('b', '20'), ('a', '100'), ('b', '200'),
127
('a', '1000'), ('b', '2000')]:
129
s2 = read_stanza(s.to_lines())
130
self.assertEquals(s, s2)
131
self.assertEquals(s.get_all('a'), map(str, [10, 100, 1000]))
132
self.assertEquals(s.get_all('b'), map(str, [20, 200, 2000]))
134
def test_backslash(self):
137
self.assertEqualDiff(t, 'q: \\\n')
138
s2 = read_stanza(s.to_lines())
139
self.assertEquals(s, s2)
141
def test_blank_line(self):
142
s = Stanza(none='', one='\n', two='\n\n')
143
self.assertEqualDiff(s.to_string(), """\
151
s2 = read_stanza(s.to_lines())
152
self.assertEquals(s, s2)
154
def test_whitespace_value(self):
155
s = Stanza(space=' ', tabs='\t\t\t', combo='\n\t\t\n')
156
self.assertEqualDiff(s.to_string(), """\
163
s2 = read_stanza(s.to_lines())
164
self.assertEquals(s, s2)
165
self.rio_file_stanzas([s])
167
def test_quoted(self):
168
"""rio quoted string cases"""
169
s = Stanza(q1='"hello"',
179
s2 = read_stanza(s.to_lines())
180
self.assertEquals(s, s2)
181
# apparent bug in read_stanza
182
# s3 = read_stanza(self.stanzas_to_str([s]))
183
# self.assertEquals(s, s3)
185
def test_read_empty(self):
186
"""Detect end of rio file"""
188
self.assertEqual(s, None)
189
self.assertTrue(s is None)
191
def test_read_iter(self):
192
"""Read several stanzas from file"""
193
tmpf = TemporaryFile()
204
reader = read_stanzas(tmpf)
205
read_iter = iter(reader)
207
self.assertEqual(stuff,
208
[ Stanza(version_header='1'),
209
Stanza(name="foo", val='123'),
210
Stanza(name="bar", val='129319'), ])
212
def test_read_several(self):
213
"""Read several stanzas from file"""
214
tmpf = TemporaryFile()
222
address: "Willowglen"
230
s = read_stanza(tmpf)
231
self.assertEquals(s, Stanza(version_header='1'))
232
s = read_stanza(tmpf)
233
self.assertEquals(s, Stanza(name="foo", val='123'))
234
s = read_stanza(tmpf)
235
self.assertEqualDiff(s.get('name'), 'quoted')
236
self.assertEqualDiff(s.get('address'), ' "Willowglen"\n 42 Wallaby Way\n Sydney')
237
s = read_stanza(tmpf)
238
self.assertEquals(s, Stanza(name="bar", val='129319'))
239
s = read_stanza(tmpf)
240
self.assertEquals(s, None)
241
self.check_rio_file(tmpf)
243
def check_rio_file(self, real_file):
245
read_write = rio_file(RioReader(real_file)).read()
247
self.assertEquals(read_write, real_file.read())
250
def stanzas_to_str(stanzas):
251
return rio_file(stanzas).read()
253
def rio_file_stanzas(self, stanzas):
254
new_stanzas = list(RioReader(rio_file(stanzas)))
255
self.assertEqual(new_stanzas, stanzas)
257
def test_tricky_quoted(self):
258
tmpf = TemporaryFile()
292
expected_vals = ['"one"',
305
for expected in expected_vals:
306
stanza = read_stanza(tmpf)
307
self.rio_file_stanzas([stanza])
308
self.assertEquals(len(stanza), 1)
309
self.assertEqualDiff(stanza.get('s'), expected)
311
def test_write_empty_stanza(self):
312
"""Write empty stanza"""
313
l = list(Stanza().to_lines())
314
self.assertEquals(l, [])
316
def test_rio_raises_type_error(self):
317
"""TypeError on adding invalid type to Stanza"""
319
self.assertRaises(TypeError, s.add, 'foo', {})
321
def test_rio_raises_type_error_key(self):
322
"""TypeError on adding invalid type to Stanza"""
324
self.assertRaises(TypeError, s.add, 10, {})
326
def test_rio_unicode(self):
327
uni_data = u'\N{KATAKANA LETTER O}'
328
s = Stanza(foo=uni_data)
329
self.assertEquals(s.get('foo'), uni_data)
330
raw_lines = s.to_lines()
331
self.assertEquals(raw_lines,
332
['foo: ' + uni_data.encode('utf-8') + '\n'])
333
new_s = read_stanza(raw_lines)
334
self.assertEquals(new_s.get('foo'), uni_data)
336
def test_rio_to_unicode(self):
337
uni_data = u'\N{KATAKANA LETTER O}'
338
s = Stanza(foo=uni_data)
339
unicode_str = s.to_unicode()
340
self.assertEqual(u'foo: %s\n' % (uni_data,), unicode_str)
341
new_s = rio.read_stanza_unicode(unicode_str.splitlines(True))
342
self.assertEqual(uni_data, new_s.get('foo'))
344
def test_nested_rio_unicode(self):
345
uni_data = u'\N{KATAKANA LETTER O}'
346
s = Stanza(foo=uni_data)
347
parent_stanza = Stanza(child=s.to_unicode())
348
raw_lines = parent_stanza.to_lines()
349
self.assertEqual(['child: foo: ' + uni_data.encode('utf-8') + '\n',
352
new_parent = read_stanza(raw_lines)
353
child_text = new_parent.get('child')
354
self.assertEqual(u'foo: %s\n' % uni_data, child_text)
355
new_child = rio.read_stanza_unicode(child_text.splitlines(True))
356
self.assertEqual(uni_data, new_child.get('foo'))
358
def mail_munge(self, lines, dos_nl=True):
361
line = re.sub(' *\n', '\n', line)
363
line = re.sub('([^\r])\n', '\\1\r\n', line)
364
new_lines.append(line)
367
def test_patch_rio(self):
368
stanza = Stanza(data='#\n\r\\r ', space=' ' * 255, hash='#' * 255)
369
lines = rio.to_patch_lines(stanza)
371
self.assertContainsRe(line, '^# ')
372
self.assertTrue(72 >= len(line))
373
for line in rio.to_patch_lines(stanza, max_width=12):
374
self.assertTrue(12 >= len(line))
375
new_stanza = rio.read_patch_stanza(self.mail_munge(lines,
377
lines = self.mail_munge(lines)
378
new_stanza = rio.read_patch_stanza(lines)
379
self.assertEqual('#\n\r\\r ', new_stanza.get('data'))
380
self.assertEqual(' '* 255, new_stanza.get('space'))
381
self.assertEqual('#'* 255, new_stanza.get('hash'))
383
def test_patch_rio_linebreaks(self):
384
stanza = Stanza(breaktest='linebreak -/'*30)
385
self.assertContainsRe(rio.to_patch_lines(stanza, 71)[0],
387
stanza = Stanza(breaktest='linebreak-/'*30)
388
self.assertContainsRe(rio.to_patch_lines(stanza, 70)[0],
390
stanza = Stanza(breaktest='linebreak/'*30)
391
self.assertContainsRe(rio.to_patch_lines(stanza, 70)[0],