~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tests/test_osutils.py

  • Committer: John Arbash Meinel
  • Date: 2006-07-09 15:47:02 UTC
  • mto: This revision was merged to the branch mainline in revision 1846.
  • Revision ID: john@arbash-meinel.com-20060709154702-304436a47a55e265
Renaming LockHelpers.py to lock_helpers.py

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
# Copyright (C) 2005 by Canonical Ltd
 
2
#
 
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.
 
7
#
 
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.
 
12
#
 
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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
16
 
 
17
"""Tests for the osutils wrapper."""
 
18
 
 
19
import errno
 
20
import os
 
21
import socket
 
22
import stat
 
23
import sys
 
24
 
 
25
import bzrlib
 
26
from bzrlib.errors import BzrBadParameterNotUnicode, InvalidURL
 
27
import bzrlib.osutils as osutils
 
28
from bzrlib.tests import (
 
29
        StringIOWrapper,
 
30
        TestCase, 
 
31
        TestCaseInTempDir, 
 
32
        TestSkipped,
 
33
        )
 
34
 
 
35
 
 
36
class TestOSUtils(TestCaseInTempDir):
 
37
 
 
38
    def test_fancy_rename(self):
 
39
        # This should work everywhere
 
40
        def rename(a, b):
 
41
            osutils.fancy_rename(a, b,
 
42
                    rename_func=os.rename,
 
43
                    unlink_func=os.unlink)
 
44
 
 
45
        open('a', 'wb').write('something in a\n')
 
46
        rename('a', 'b')
 
47
        self.failIfExists('a')
 
48
        self.failUnlessExists('b')
 
49
        self.check_file_contents('b', 'something in a\n')
 
50
 
 
51
        open('a', 'wb').write('new something in a\n')
 
52
        rename('b', 'a')
 
53
 
 
54
        self.check_file_contents('a', 'something in a\n')
 
55
 
 
56
    def test_rename(self):
 
57
        # Rename should be semi-atomic on all platforms
 
58
        open('a', 'wb').write('something in a\n')
 
59
        osutils.rename('a', 'b')
 
60
        self.failIfExists('a')
 
61
        self.failUnlessExists('b')
 
62
        self.check_file_contents('b', 'something in a\n')
 
63
 
 
64
        open('a', 'wb').write('new something in a\n')
 
65
        osutils.rename('b', 'a')
 
66
 
 
67
        self.check_file_contents('a', 'something in a\n')
 
68
 
 
69
    # TODO: test fancy_rename using a MemoryTransport
 
70
 
 
71
    def test_01_rand_chars_empty(self):
 
72
        result = osutils.rand_chars(0)
 
73
        self.assertEqual(result, '')
 
74
 
 
75
    def test_02_rand_chars_100(self):
 
76
        result = osutils.rand_chars(100)
 
77
        self.assertEqual(len(result), 100)
 
78
        self.assertEqual(type(result), str)
 
79
        self.assertContainsRe(result, r'^[a-z0-9]{100}$')
 
80
 
 
81
 
 
82
    def test_rmtree(self):
 
83
        # Check to remove tree with read-only files/dirs
 
84
        os.mkdir('dir')
 
85
        f = file('dir/file', 'w')
 
86
        f.write('spam')
 
87
        f.close()
 
88
        # would like to also try making the directory readonly, but at the
 
89
        # moment python shutil.rmtree doesn't handle that properly - it would
 
90
        # need to chmod the directory before removing things inside it - deferred
 
91
        # for now -- mbp 20060505
 
92
        # osutils.make_readonly('dir')
 
93
        osutils.make_readonly('dir/file')
 
94
 
 
95
        osutils.rmtree('dir')
 
96
 
 
97
        self.failIfExists('dir/file')
 
98
        self.failIfExists('dir')
 
99
 
 
100
    def test_file_kind(self):
 
101
        self.build_tree(['file', 'dir/'])
 
102
        self.assertEquals('file', osutils.file_kind('file'))
 
103
        self.assertEquals('directory', osutils.file_kind('dir/'))
 
104
        if osutils.has_symlinks():
 
105
            os.symlink('symlink', 'symlink')
 
106
            self.assertEquals('symlink', osutils.file_kind('symlink'))
 
107
        
 
108
        # TODO: jam 20060529 Test a block device
 
109
        try:
 
110
            os.lstat('/dev/null')
 
111
        except OSError, e:
 
112
            if e.errno not in (errno.ENOENT,):
 
113
                raise
 
114
        else:
 
115
            self.assertEquals('chardev', osutils.file_kind('/dev/null'))
 
116
 
 
117
        mkfifo = getattr(os, 'mkfifo', None)
 
118
        if mkfifo:
 
119
            mkfifo('fifo')
 
120
            try:
 
121
                self.assertEquals('fifo', osutils.file_kind('fifo'))
 
122
            finally:
 
123
                os.remove('fifo')
 
124
 
 
125
        AF_UNIX = getattr(socket, 'AF_UNIX', None)
 
126
        if AF_UNIX:
 
127
            s = socket.socket(AF_UNIX)
 
128
            s.bind('socket')
 
129
            try:
 
130
                self.assertEquals('socket', osutils.file_kind('socket'))
 
131
            finally:
 
132
                os.remove('socket')
 
133
 
 
134
 
 
135
class TestSafeUnicode(TestCase):
 
136
 
 
137
    def test_from_ascii_string(self):
 
138
        self.assertEqual(u'foobar', osutils.safe_unicode('foobar'))
 
139
 
 
140
    def test_from_unicode_string_ascii_contents(self):
 
141
        self.assertEqual(u'bargam', osutils.safe_unicode(u'bargam'))
 
142
 
 
143
    def test_from_unicode_string_unicode_contents(self):
 
144
        self.assertEqual(u'bargam\xae', osutils.safe_unicode(u'bargam\xae'))
 
145
 
 
146
    def test_from_utf8_string(self):
 
147
        self.assertEqual(u'foo\xae', osutils.safe_unicode('foo\xc2\xae'))
 
148
 
 
149
    def test_bad_utf8_string(self):
 
150
        self.assertRaises(BzrBadParameterNotUnicode,
 
151
                          osutils.safe_unicode,
 
152
                          '\xbb\xbb')
 
153
 
 
154
 
 
155
class TestWin32Funcs(TestCase):
 
156
    """Test that the _win32 versions of os utilities return appropriate paths."""
 
157
 
 
158
    def test_abspath(self):
 
159
        self.assertEqual('C:/foo', osutils._win32_abspath('C:\\foo'))
 
160
        self.assertEqual('C:/foo', osutils._win32_abspath('C:/foo'))
 
161
 
 
162
    def test_realpath(self):
 
163
        self.assertEqual('C:/foo', osutils._win32_realpath('C:\\foo'))
 
164
        self.assertEqual('C:/foo', osutils._win32_realpath('C:/foo'))
 
165
 
 
166
    def test_pathjoin(self):
 
167
        self.assertEqual('path/to/foo', osutils._win32_pathjoin('path', 'to', 'foo'))
 
168
        self.assertEqual('C:/foo', osutils._win32_pathjoin('path\\to', 'C:\\foo'))
 
169
        self.assertEqual('C:/foo', osutils._win32_pathjoin('path/to', 'C:/foo'))
 
170
        self.assertEqual('path/to/foo', osutils._win32_pathjoin('path/to/', 'foo'))
 
171
        self.assertEqual('/foo', osutils._win32_pathjoin('C:/path/to/', '/foo'))
 
172
        self.assertEqual('/foo', osutils._win32_pathjoin('C:\\path\\to\\', '\\foo'))
 
173
 
 
174
    def test_normpath(self):
 
175
        self.assertEqual('path/to/foo', osutils._win32_normpath(r'path\\from\..\to\.\foo'))
 
176
        self.assertEqual('path/to/foo', osutils._win32_normpath('path//from/../to/./foo'))
 
177
 
 
178
    def test_getcwd(self):
 
179
        cwd = osutils._win32_getcwd()
 
180
        os_cwd = os.getcwdu()
 
181
        self.assertEqual(os_cwd[1:].replace('\\', '/'), cwd[1:])
 
182
        # win32 is inconsistent whether it returns lower or upper case
 
183
        # and even if it was consistent the user might type the other
 
184
        # so we force it to uppercase
 
185
        # running python.exe under cmd.exe return capital C:\\
 
186
        # running win32 python inside a cygwin shell returns lowercase
 
187
        self.assertEqual(os_cwd[0].upper(), cwd[0])
 
188
 
 
189
    def test_fixdrive(self):
 
190
        self.assertEqual('H:/foo', osutils._win32_fixdrive('h:/foo'))
 
191
        self.assertEqual('H:/foo', osutils._win32_fixdrive('H:/foo'))
 
192
        self.assertEqual('C:\\foo', osutils._win32_fixdrive('c:\\foo'))
 
193
 
 
194
 
 
195
class TestWin32FuncsDirs(TestCaseInTempDir):
 
196
    """Test win32 functions that create files."""
 
197
    
 
198
    def test_getcwd(self):
 
199
        # Make sure getcwd can handle unicode filenames
 
200
        try:
 
201
            os.mkdir(u'B\xe5gfors')
 
202
        except UnicodeError:
 
203
            raise TestSkipped("Unable to create Unicode filename")
 
204
 
 
205
        os.chdir(u'B\xe5gfors')
 
206
        # TODO: jam 20060427 This will probably fail on Mac OSX because
 
207
        #       it will change the normalization of B\xe5gfors
 
208
        #       Consider using a different unicode character, or make
 
209
        #       osutils.getcwd() renormalize the path.
 
210
        self.assertTrue(osutils._win32_getcwd().endswith(u'/B\xe5gfors'))
 
211
 
 
212
    def test_mkdtemp(self):
 
213
        tmpdir = osutils._win32_mkdtemp(dir='.')
 
214
        self.assertFalse('\\' in tmpdir)
 
215
 
 
216
    def test_rename(self):
 
217
        a = open('a', 'wb')
 
218
        a.write('foo\n')
 
219
        a.close()
 
220
        b = open('b', 'wb')
 
221
        b.write('baz\n')
 
222
        b.close()
 
223
 
 
224
        osutils._win32_rename('b', 'a')
 
225
        self.failUnlessExists('a')
 
226
        self.failIfExists('b')
 
227
        self.assertFileEqual('baz\n', 'a')
 
228
 
 
229
    def test_rename_missing_file(self):
 
230
        a = open('a', 'wb')
 
231
        a.write('foo\n')
 
232
        a.close()
 
233
 
 
234
        try:
 
235
            osutils._win32_rename('b', 'a')
 
236
        except (IOError, OSError), e:
 
237
            self.assertEqual(errno.ENOENT, e.errno)
 
238
        self.assertFileEqual('foo\n', 'a')
 
239
 
 
240
    def test_rename_missing_dir(self):
 
241
        os.mkdir('a')
 
242
        try:
 
243
            osutils._win32_rename('b', 'a')
 
244
        except (IOError, OSError), e:
 
245
            self.assertEqual(errno.ENOENT, e.errno)
 
246
 
 
247
    def test_rename_current_dir(self):
 
248
        os.mkdir('a')
 
249
        os.chdir('a')
 
250
        # You can't rename the working directory
 
251
        # doing rename non-existant . usually
 
252
        # just raises ENOENT, since non-existant
 
253
        # doesn't exist.
 
254
        try:
 
255
            osutils._win32_rename('b', '.')
 
256
        except (IOError, OSError), e:
 
257
            self.assertEqual(errno.ENOENT, e.errno)
 
258
 
 
259
 
 
260
class TestSplitLines(TestCase):
 
261
 
 
262
    def test_split_unicode(self):
 
263
        self.assertEqual([u'foo\n', u'bar\xae'],
 
264
                         osutils.split_lines(u'foo\nbar\xae'))
 
265
        self.assertEqual([u'foo\n', u'bar\xae\n'],
 
266
                         osutils.split_lines(u'foo\nbar\xae\n'))
 
267
 
 
268
    def test_split_with_carriage_returns(self):
 
269
        self.assertEqual(['foo\rbar\n'],
 
270
                         osutils.split_lines('foo\rbar\n'))
 
271
 
 
272
 
 
273
class TestWalkDirs(TestCaseInTempDir):
 
274
 
 
275
    def test_walkdirs(self):
 
276
        tree = [
 
277
            '.bzr',
 
278
            '0file',
 
279
            '1dir/',
 
280
            '1dir/0file',
 
281
            '1dir/1dir/',
 
282
            '2file'
 
283
            ]
 
284
        self.build_tree(tree)
 
285
        expected_dirblocks = [
 
286
                [
 
287
                    ('0file', '0file', 'file'),
 
288
                    ('1dir', '1dir', 'directory'),
 
289
                    ('2file', '2file', 'file'),
 
290
                ],
 
291
                [
 
292
                    ('1dir/0file', '0file', 'file'),
 
293
                    ('1dir/1dir', '1dir', 'directory'),
 
294
                ],
 
295
                [
 
296
                ],
 
297
            ]
 
298
        result = []
 
299
        found_bzrdir = False
 
300
        for dirblock in osutils.walkdirs('.'):
 
301
            if len(dirblock) and dirblock[0][1] == '.bzr':
 
302
                # this tests the filtering of selected paths
 
303
                found_bzrdir = True
 
304
                del dirblock[0]
 
305
            result.append(dirblock)
 
306
 
 
307
        self.assertTrue(found_bzrdir)
 
308
        self.assertEqual(expected_dirblocks,
 
309
            [[line[0:3] for line in block] for block in result])
 
310
        # you can search a subdir only, with a supplied prefix.
 
311
        result = []
 
312
        for dirblock in osutils.walkdirs('1dir', '1dir'):
 
313
            result.append(dirblock)
 
314
        self.assertEqual(expected_dirblocks[1:],
 
315
            [[line[0:3] for line in block] for block in result])
 
316
 
 
317
    def assertPathCompare(self, path_less, path_greater):
 
318
        """check that path_less and path_greater compare correctly."""
 
319
        self.assertEqual(0, osutils.compare_paths_prefix_order(
 
320
            path_less, path_less))
 
321
        self.assertEqual(0, osutils.compare_paths_prefix_order(
 
322
            path_greater, path_greater))
 
323
        self.assertEqual(-1, osutils.compare_paths_prefix_order(
 
324
            path_less, path_greater))
 
325
        self.assertEqual(1, osutils.compare_paths_prefix_order(
 
326
            path_greater, path_less))
 
327
 
 
328
    def test_compare_paths_prefix_order(self):
 
329
        # root before all else
 
330
        self.assertPathCompare("/", "/a")
 
331
        # alpha within a dir
 
332
        self.assertPathCompare("/a", "/b")
 
333
        self.assertPathCompare("/b", "/z")
 
334
        # high dirs before lower.
 
335
        self.assertPathCompare("/z", "/a/a")
 
336
        # except if the deeper dir should be output first
 
337
        self.assertPathCompare("/a/b/c", "/d/g")
 
338
        # lexical betwen dirs of the same height
 
339
        self.assertPathCompare("/a/z", "/z/z")
 
340
        self.assertPathCompare("/a/c/z", "/a/d/e")
 
341
 
 
342
        # this should also be consistent for no leading / paths
 
343
        # root before all else
 
344
        self.assertPathCompare("", "a")
 
345
        # alpha within a dir
 
346
        self.assertPathCompare("a", "b")
 
347
        self.assertPathCompare("b", "z")
 
348
        # high dirs before lower.
 
349
        self.assertPathCompare("z", "a/a")
 
350
        # except if the deeper dir should be output first
 
351
        self.assertPathCompare("a/b/c", "d/g")
 
352
        # lexical betwen dirs of the same height
 
353
        self.assertPathCompare("a/z", "z/z")
 
354
        self.assertPathCompare("a/c/z", "a/d/e")
 
355
 
 
356
    def test_path_prefix_sorting(self):
 
357
        """Doing a sort on path prefix should match our sample data."""
 
358
        original_paths = [
 
359
            'a',
 
360
            'a/b',
 
361
            'a/b/c',
 
362
            'b',
 
363
            'b/c',
 
364
            'd',
 
365
            'd/e',
 
366
            'd/e/f',
 
367
            'd/f',
 
368
            'd/g',
 
369
            'g',
 
370
            ]
 
371
 
 
372
        dir_sorted_paths = [
 
373
            'a',
 
374
            'b',
 
375
            'd',
 
376
            'g',
 
377
            'a/b',
 
378
            'a/b/c',
 
379
            'b/c',
 
380
            'd/e',
 
381
            'd/f',
 
382
            'd/g',
 
383
            'd/e/f',
 
384
            ]
 
385
 
 
386
        self.assertEqual(
 
387
            dir_sorted_paths,
 
388
            sorted(original_paths, key=osutils.path_prefix_key))
 
389
        # using the comparison routine shoudl work too:
 
390
        self.assertEqual(
 
391
            dir_sorted_paths,
 
392
            sorted(original_paths, cmp=osutils.compare_paths_prefix_order))
 
393
 
 
394
 
 
395
class TestTerminalEncoding(TestCase):
 
396
    """Test the auto-detection of proper terminal encoding."""
 
397
 
 
398
    def setUp(self):
 
399
        self._stdout = sys.stdout
 
400
        self._stderr = sys.stderr
 
401
        self._stdin = sys.stdin
 
402
        self._user_encoding = bzrlib.user_encoding
 
403
 
 
404
        self.addCleanup(self._reset)
 
405
 
 
406
        sys.stdout = StringIOWrapper()
 
407
        sys.stdout.encoding = 'stdout_encoding'
 
408
        sys.stderr = StringIOWrapper()
 
409
        sys.stderr.encoding = 'stderr_encoding'
 
410
        sys.stdin = StringIOWrapper()
 
411
        sys.stdin.encoding = 'stdin_encoding'
 
412
        bzrlib.user_encoding = 'user_encoding'
 
413
 
 
414
    def _reset(self):
 
415
        sys.stdout = self._stdout
 
416
        sys.stderr = self._stderr
 
417
        sys.stdin = self._stdin
 
418
        bzrlib.user_encoding = self._user_encoding
 
419
 
 
420
    def test_get_terminal_encoding(self):
 
421
        # first preference is stdout encoding
 
422
        self.assertEqual('stdout_encoding', osutils.get_terminal_encoding())
 
423
 
 
424
        sys.stdout.encoding = None
 
425
        # if sys.stdout is None, fall back to sys.stdin
 
426
        self.assertEqual('stdin_encoding', osutils.get_terminal_encoding())
 
427
 
 
428
        sys.stdin.encoding = None
 
429
        # and in the worst case, use bzrlib.user_encoding
 
430
        self.assertEqual('user_encoding', osutils.get_terminal_encoding())
 
431