blob: 1cd0d621cd4b3a14256b8ea6b90c222f476f2ee7 [file] [log] [blame]
Mark Hammond7995eb22002-10-03 23:14:10 +00001# Test the Unicode versions of normal file functions
2# open, os.open, os.stat. os.listdir, os.rename, os.remove, os.mkdir, os.chdir, os.rmdir
Victor Stinner1ab6c2d2011-11-15 22:27:41 +01003import os
4import sys
5import unittest
6import warnings
Florent Xiclunaeb136182010-03-21 18:49:50 +00007from unicodedata import normalize
Benjamin Petersonee8712c2008-05-20 21:35:26 +00008from test import support
Mark Hammond7995eb22002-10-03 23:14:10 +00009
10filenames = [
Victor Stinner7362c4f2010-10-28 11:20:31 +000011 '1_abc',
12 '2_ascii',
13 '3_Gr\xfc\xdf-Gott',
14 '4_\u0393\u03b5\u03b9\u03ac-\u03c3\u03b1\u03c2',
15 '5_\u0417\u0434\u0440\u0430\u0432\u0441\u0442\u0432\u0443\u0439\u0442\u0435',
16 '6_\u306b\u307d\u3093',
17 '7_\u05d4\u05e9\u05e7\u05e6\u05e5\u05e1',
18 '8_\u66e8\u66e9\u66eb',
19 '9_\u66e8\u05e9\u3093\u0434\u0393\xdf',
luzpaza5293b42017-11-05 07:37:50 -060020 # Specific code points: fn, NFC(fn) and NFKC(fn) all different
Victor Stinner7362c4f2010-10-28 11:20:31 +000021 '10_\u1fee\u1ffd',
Mark Hammond7995eb22002-10-03 23:14:10 +000022 ]
23
Florent Xiclunafd1b0932010-03-28 00:25:02 +000024# Mac OS X decomposes Unicode names, using Normal Form D.
25# http://developer.apple.com/mac/library/qa/qa2001/qa1173.html
26# "However, most volume formats do not follow the exact specification for
27# these normal forms. For example, HFS Plus uses a variant of Normal Form D
28# in which U+2000 through U+2FFF, U+F900 through U+FAFF, and U+2F800 through
29# U+2FAFF are not decomposed."
30if sys.platform != 'darwin':
31 filenames.extend([
luzpaza5293b42017-11-05 07:37:50 -060032 # Specific code points: NFC(fn), NFD(fn), NFKC(fn) and NFKD(fn) all different
Victor Stinnerfc6f5a42010-10-28 22:57:03 +000033 '11_\u0385\u03d3\u03d4',
34 '12_\u00a8\u0301\u03d2\u0301\u03d2\u0308', # == NFD('\u0385\u03d3\u03d4')
35 '13_\u0020\u0308\u0301\u038e\u03ab', # == NFKC('\u0385\u03d3\u03d4')
36 '14_\u1e9b\u1fc1\u1fcd\u1fce\u1fcf\u1fdd\u1fde\u1fdf\u1fed',
37
luzpaza5293b42017-11-05 07:37:50 -060038 # Specific code points: fn, NFC(fn) and NFKC(fn) all different
Victor Stinner7362c4f2010-10-28 11:20:31 +000039 '15_\u1fee\u1ffd\ufad1',
40 '16_\u2000\u2000\u2000A',
41 '17_\u2001\u2001\u2001A',
42 '18_\u2003\u2003\u2003A', # == NFC('\u2001\u2001\u2001A')
43 '19_\u0020\u0020\u0020A', # '\u0020' == ' ' == NFKC('\u2000') ==
Florent Xicluna65eb4532011-11-03 23:11:14 +010044 # NFKC('\u2001') == NFKC('\u2003')
45 ])
Florent Xiclunaeb136182010-03-21 18:49:50 +000046
Florent Xicluna87082ee2010-08-09 17:18:05 +000047
48# Is it Unicode-friendly?
49if not os.path.supports_unicode_filenames:
Victor Stinner94908bb2010-08-18 21:23:25 +000050 fsencoding = sys.getfilesystemencoding()
Florent Xicluna87082ee2010-08-09 17:18:05 +000051 try:
52 for name in filenames:
53 name.encode(fsencoding)
54 except UnicodeEncodeError:
55 raise unittest.SkipTest("only NT+ and systems with "
56 "Unicode-friendly filesystem encoding")
57
58
Mark Hammond7995eb22002-10-03 23:14:10 +000059class UnicodeFileTests(unittest.TestCase):
Florent Xiclunaeb136182010-03-21 18:49:50 +000060 files = set(filenames)
61 normal_form = None
Tim Peters1ee401f2002-10-05 17:54:56 +000062
Mark Hammond7995eb22002-10-03 23:14:10 +000063 def setUp(self):
Mark Hammond7995eb22002-10-03 23:14:10 +000064 try:
Benjamin Petersonee8712c2008-05-20 21:35:26 +000065 os.mkdir(support.TESTFN)
Florent Xicluna65eb4532011-11-03 23:11:14 +010066 except FileExistsError:
Mark Hammond7995eb22002-10-03 23:14:10 +000067 pass
Victor Stinner09706572014-07-29 00:40:50 +020068 self.addCleanup(support.rmtree, support.TESTFN)
69
Florent Xiclunaeb136182010-03-21 18:49:50 +000070 files = set()
Mark Hammond7995eb22002-10-03 23:14:10 +000071 for name in self.files:
Florent Xiclunaeb136182010-03-21 18:49:50 +000072 name = os.path.join(support.TESTFN, self.norm(name))
Florent Xicluna87082ee2010-08-09 17:18:05 +000073 with open(name, 'wb') as f:
74 f.write((name+'\n').encode("utf-8"))
Mark Hammond7995eb22002-10-03 23:14:10 +000075 os.stat(name)
Florent Xiclunaeb136182010-03-21 18:49:50 +000076 files.add(name)
77 self.files = files
Mark Hammond7995eb22002-10-03 23:14:10 +000078
Florent Xiclunaeb136182010-03-21 18:49:50 +000079 def norm(self, s):
80 if self.normal_form:
81 return normalize(self.normal_form, s)
82 return s
83
Florent Xicluna65eb4532011-11-03 23:11:14 +010084 def _apply_failure(self, fn, filename,
85 expected_exception=FileNotFoundError,
86 check_filename=True):
Florent Xiclunaeb136182010-03-21 18:49:50 +000087 with self.assertRaises(expected_exception) as c:
Mark Hammond7995eb22002-10-03 23:14:10 +000088 fn(filename)
Florent Xiclunaeb136182010-03-21 18:49:50 +000089 exc_filename = c.exception.filename
Florent Xicluna65eb4532011-11-03 23:11:14 +010090 if check_filename:
Victor Stinner74ad7542010-10-28 11:09:09 +000091 self.assertEqual(exc_filename, filename, "Function '%s(%a) failed "
Victor Stinner7dae81b2010-10-28 11:11:24 +000092 "with bad filename in the exception: %a" %
Florent Xiclunaeb136182010-03-21 18:49:50 +000093 (fn.__name__, filename, exc_filename))
Mark Hammond7995eb22002-10-03 23:14:10 +000094
95 def test_failures(self):
96 # Pass non-existing Unicode filenames all over the place.
97 for name in self.files:
98 name = "not_" + name
Florent Xicluna65eb4532011-11-03 23:11:14 +010099 self._apply_failure(open, name)
100 self._apply_failure(os.stat, name)
101 self._apply_failure(os.chdir, name)
102 self._apply_failure(os.rmdir, name)
103 self._apply_failure(os.remove, name)
Florent Xiclunae0912db2011-11-07 21:56:17 +0100104 self._apply_failure(os.listdir, name)
105
106 if sys.platform == 'win32':
Florent Xiclunabe908402011-11-07 23:24:08 +0100107 # Windows is lunatic. Issue #13366.
108 _listdir_failure = NotADirectoryError, FileNotFoundError
Florent Xiclunae0912db2011-11-07 21:56:17 +0100109 else:
110 _listdir_failure = NotADirectoryError
Mark Hammond7995eb22002-10-03 23:14:10 +0000111
112 def test_open(self):
113 for name in self.files:
Guido van Rossumc12a8132007-10-26 04:29:23 +0000114 f = open(name, 'wb')
Mark Hammond7995eb22002-10-03 23:14:10 +0000115 f.write((name+'\n').encode("utf-8"))
116 f.close()
117 os.stat(name)
Florent Xiclunae0912db2011-11-07 21:56:17 +0100118 self._apply_failure(os.listdir, name, self._listdir_failure)
Mark Hammond7995eb22002-10-03 23:14:10 +0000119
Victor Stinnerbfd7b262010-10-28 23:14:45 +0000120 # Skip the test on darwin, because darwin does normalize the filename to
121 # NFD (a variant of Unicode NFD form). Normalize the filename to NFC, NFKC,
122 # NFKD in Python is useless, because darwin will normalize it later and so
123 # open(), os.stat(), etc. don't raise any exception.
Florent Xicluna65eb4532011-11-03 23:11:14 +0100124 @unittest.skipIf(sys.platform == 'darwin', 'irrelevant test on Mac OS X')
Florent Xiclunaeb136182010-03-21 18:49:50 +0000125 def test_normalize(self):
126 files = set(self.files)
127 others = set()
128 for nf in set(['NFC', 'NFD', 'NFKC', 'NFKD']):
129 others |= set(normalize(nf, file) for file in files)
130 others -= files
Florent Xiclunaeb136182010-03-21 18:49:50 +0000131 for name in others:
Florent Xicluna65eb4532011-11-03 23:11:14 +0100132 self._apply_failure(open, name)
133 self._apply_failure(os.stat, name)
134 self._apply_failure(os.chdir, name)
135 self._apply_failure(os.rmdir, name)
136 self._apply_failure(os.remove, name)
Florent Xiclunae0912db2011-11-07 21:56:17 +0100137 self._apply_failure(os.listdir, name)
Florent Xiclunaeb136182010-03-21 18:49:50 +0000138
Victor Stinnerbfd7b262010-10-28 23:14:45 +0000139 # Skip the test on darwin, because darwin uses a normalization different
140 # than Python NFD normalization: filenames are different even if we use
141 # Python NFD normalization.
Florent Xicluna65eb4532011-11-03 23:11:14 +0100142 @unittest.skipIf(sys.platform == 'darwin', 'irrelevant test on Mac OS X')
Mark Hammond7995eb22002-10-03 23:14:10 +0000143 def test_listdir(self):
Florent Xiclunaeb136182010-03-21 18:49:50 +0000144 sf0 = set(self.files)
Victor Stinner1ab6c2d2011-11-15 22:27:41 +0100145 with warnings.catch_warnings():
146 warnings.simplefilter("ignore", DeprecationWarning)
147 f1 = os.listdir(support.TESTFN.encode(sys.getfilesystemencoding()))
Florent Xiclunaeb136182010-03-21 18:49:50 +0000148 f2 = os.listdir(support.TESTFN)
Florent Xiclunaeb136182010-03-21 18:49:50 +0000149 sf2 = set(os.path.join(support.TESTFN, f) for f in f2)
Victor Stinner2ebe6972010-10-24 21:05:03 +0000150 self.assertEqual(sf0, sf2, "%a != %a" % (sf0, sf2))
Florent Xiclunaeb136182010-03-21 18:49:50 +0000151 self.assertEqual(len(f1), len(f2))
Mark Hammond7995eb22002-10-03 23:14:10 +0000152
153 def test_rename(self):
154 for name in self.files:
Florent Xiclunaeb136182010-03-21 18:49:50 +0000155 os.rename(name, "tmp")
156 os.rename("tmp", name)
Mark Hammond7995eb22002-10-03 23:14:10 +0000157
158 def test_directory(self):
Florent Xiclunaeb136182010-03-21 18:49:50 +0000159 dirname = os.path.join(support.TESTFN, 'Gr\xfc\xdf-\u66e8\u66e9\u66eb')
Guido van Rossumef87d6e2007-05-02 19:09:54 +0000160 filename = '\xdf-\u66e8\u66e9\u66eb'
Serhiy Storchaka2a23adf2015-09-06 14:13:25 +0300161 with support.temp_cwd(dirname):
Florent Xiclunaeb136182010-03-21 18:49:50 +0000162 with open(filename, 'wb') as f:
163 f.write((filename + '\n').encode("utf-8"))
164 os.access(filename,os.R_OK)
165 os.remove(filename)
Florent Xiclunaeb136182010-03-21 18:49:50 +0000166
167
168class UnicodeNFCFileTests(UnicodeFileTests):
169 normal_form = 'NFC'
170
171
172class UnicodeNFDFileTests(UnicodeFileTests):
173 normal_form = 'NFD'
174
175
176class UnicodeNFKCFileTests(UnicodeFileTests):
177 normal_form = 'NFKC'
178
179
180class UnicodeNFKDFileTests(UnicodeFileTests):
181 normal_form = 'NFKD'
182
Mark Hammond7995eb22002-10-03 23:14:10 +0000183
184def test_main():
Victor Stinner09706572014-07-29 00:40:50 +0200185 support.run_unittest(
186 UnicodeFileTests,
187 UnicodeNFCFileTests,
188 UnicodeNFDFileTests,
189 UnicodeNFKCFileTests,
190 UnicodeNFKDFileTests,
191 )
Mark Hammond7995eb22002-10-03 23:14:10 +0000192
Florent Xiclunaeb136182010-03-21 18:49:50 +0000193
Mark Hammond7995eb22002-10-03 23:14:10 +0000194if __name__ == "__main__":
195 test_main()