Debian Codegraph @

Lib/test/test_ctypes/test_memfunctions.py

raw
1 import sys
2 import unittest
3 from test import support
4 from ctypes import (POINTER, sizeof, cast,
5 create_string_buffer, string_at,
6 create_unicode_buffer, wstring_at,
7 memmove, memset,
8 memoryview_at, c_void_p,
9 c_char_p, c_byte, c_ubyte, c_wchar,
10 addressof, byref)
11
12
13 class MemFunctionsTest(unittest.TestCase):
14 def test_overflow(self):
15 # string_at and wstring_at must use the Python calling
16 # convention (which acquires the GIL and checks the Python
17 # error flag). Provoke an error and catch it; see also issue
18 # gh-47804.
19 self.assertRaises((OverflowError, MemoryError, SystemError),
20 lambda: wstring_at(u"foo", sys.maxsize - 1))
21 self.assertRaises((OverflowError, MemoryError, SystemError),
22 lambda: string_at("foo", sys.maxsize - 1))
23
24 def test_memmove(self):
25 # large buffers apparently increase the chance that the memory
26 # is allocated in high address space.
27 a = create_string_buffer(1000000)
28 p = b"Hello, World"
29 result = memmove(a, p, len(p))
30 self.assertEqual(a.value, b"Hello, World")
31
32 self.assertEqual(string_at(result), b"Hello, World")
33 self.assertEqual(string_at(result, 5), b"Hello")
34 self.assertEqual(string_at(result, 16), b"Hello, World\0\0\0\0")
35 self.assertEqual(string_at(result, 0), b"")
36
37 def test_memset(self):
38 a = create_string_buffer(1000000)
39 result = memset(a, ord('x'), 16)
40 self.assertEqual(a.value, b"xxxxxxxxxxxxxxxx")
41
42 self.assertEqual(string_at(result), b"xxxxxxxxxxxxxxxx")
43 self.assertEqual(string_at(a), b"xxxxxxxxxxxxxxxx")
44 self.assertEqual(string_at(a, 20), b"xxxxxxxxxxxxxxxx\0\0\0\0")
45
46 def test_cast(self):
47 a = (c_ubyte * 32)(*map(ord, "abcdef"))
48 self.assertEqual(cast(a, c_char_p).value, b"abcdef")
49 self.assertEqual(cast(a, POINTER(c_byte))[:7],
50 [97, 98, 99, 100, 101, 102, 0])
51 self.assertEqual(cast(a, POINTER(c_byte))[:7:],
52 [97, 98, 99, 100, 101, 102, 0])
53 self.assertEqual(cast(a, POINTER(c_byte))[6:-1:-1],
54 [0, 102, 101, 100, 99, 98, 97])
55 self.assertEqual(cast(a, POINTER(c_byte))[:7:2],
56 [97, 99, 101, 0])
57 self.assertEqual(cast(a, POINTER(c_byte))[:7:7],
58 [97])
59
60 @support.refcount_test
61 def test_string_at(self):
62 s = string_at(b"foo bar")
63 self.assertTrue(s, "foo bar")
64
65 self.assertEqual(string_at(b"foo bar", 7), b"foo bar")
66 self.assertEqual(string_at(b"foo bar", 3), b"foo")
67
68 def test_wstring_at(self):
69 p = create_unicode_buffer("Hello, World")
70 a = create_unicode_buffer(1000000)
71 result = memmove(a, p, len(p) * sizeof(c_wchar))
72 self.assertEqual(a.value, "Hello, World")
73
74 self.assertEqual(wstring_at(a), "Hello, World")
75 self.assertEqual(wstring_at(a, 5), "Hello")
76 self.assertEqual(wstring_at(a, 16), "Hello, World\0\0\0\0")
77 self.assertEqual(wstring_at(a, 0), "")
78
79 def test_memoryview_at(self):
80 b = (c_byte * 10)()
81
82 size = len(b)
83 for foreign_ptr in (
84 b,
85 cast(b, c_void_p),
86 byref(b),
87 addressof(b),
88 ):
89 with self.subTest(foreign_ptr=type(foreign_ptr).__name__):
90 b[:] = b"initialval"
91 v = memoryview_at(foreign_ptr, size)
92 self.assertIsInstance(v, memoryview)
93 self.assertEqual(bytes(v), b"initialval")
94
95 # test that writes to source buffer get reflected in memoryview
96 b[:] = b"0123456789"
97 self.assertEqual(bytes(v), b"0123456789")
98
99 # test that writes to memoryview get reflected in source buffer
100 v[:] = b"9876543210"
101 self.assertEqual(bytes(b), b"9876543210")
102
103 with self.assertRaises(ValueError):
104 memoryview_at(foreign_ptr, -1)
105
106 with self.assertRaises(ValueError):
107 memoryview_at(foreign_ptr, sys.maxsize + 1)
108
109 v0 = memoryview_at(foreign_ptr, 0)
110 self.assertEqual(bytes(v0), b'')
111
112 def test_memoryview_at_readonly(self):
113 b = (c_byte * 10)()
114
115 size = len(b)
116 for foreign_ptr in (
117 b,
118 cast(b, c_void_p),
119 byref(b),
120 addressof(b),
121 ):
122 with self.subTest(foreign_ptr=type(foreign_ptr).__name__):
123 b[:] = b"initialval"
124 v = memoryview_at(foreign_ptr, size, readonly=True)
125 self.assertIsInstance(v, memoryview)
126 self.assertEqual(bytes(v), b"initialval")
127
128 # test that writes to source buffer get reflected in memoryview
129 b[:] = b"0123456789"
130 self.assertEqual(bytes(v), b"0123456789")
131
132 # test that writes to the memoryview are blocked
133 with self.assertRaises(TypeError):
134 v[:] = b"9876543210"
135
136 if __name__ == "__main__":
137 unittest.main()