Gecko [ beriskala.com ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2026-05-01 04:20
__init__.py	6.98 KB	-rw-r--r--	2024-04-17 20:28
runtests.py	682 B	-rw-r--r--	2024-04-17 20:28
test_anon.py	2 KB	-rw-r--r--	2024-04-17 20:28
test_array_in_pointer.py	1.7 KB	-rw-r--r--	2024-04-17 20:28
test_arrays.py	5.54 KB	-rw-r--r--	2024-04-17 20:28
test_as_parameter.py	6.63 KB	-rw-r--r--	2024-04-17 20:28
test_bitfields.py	9.08 KB	-rw-r--r--	2024-04-17 20:28
test_buffers.py	2.18 KB	-rw-r--r--	2024-04-17 20:28
test_bytes.py	1.16 KB	-rw-r--r--	2024-04-17 20:28
test_byteswap.py	10.57 KB	-rw-r--r--	2024-04-17 20:28
test_callbacks.py	8.77 KB	-rw-r--r--	2024-04-17 20:28
test_cast.py	3.13 KB	-rw-r--r--	2024-04-17 20:28
test_cfuncs.py	7.44 KB	-rw-r--r--	2024-04-17 20:28
test_checkretval.py	995 B	-rw-r--r--	2024-04-17 20:28
test_delattr.py	533 B	-rw-r--r--	2024-04-17 20:28
test_errcheck.py	477 B	-rw-r--r--	2024-04-17 20:28
test_errno.py	2.25 KB	-rw-r--r--	2024-04-17 20:28
test_find.py	2.41 KB	-rw-r--r--	2024-04-17 20:28
test_frombuffer.py	2.42 KB	-rw-r--r--	2024-04-17 20:28
test_funcptr.py	3.82 KB	-rw-r--r--	2024-04-17 20:28
test_functions.py	12.35 KB	-rw-r--r--	2024-04-17 20:28
test_incomplete.py	1023 B	-rw-r--r--	2024-04-17 20:28
test_init.py	1.01 KB	-rw-r--r--	2024-04-17 20:28
test_integers.py	96 B	-rw-r--r--	2024-04-17 20:28
test_internals.py	2.56 KB	-rw-r--r--	2024-04-17 20:28
test_keeprefs.py	3.93 KB	-rw-r--r--	2024-04-17 20:28
test_libc.py	1005 B	-rw-r--r--	2024-04-17 20:28
test_loading.py	4 KB	-rw-r--r--	2024-04-17 20:28
test_macholib.py	1.56 KB	-rw-r--r--	2024-04-17 20:28
test_memfunctions.py	3.24 KB	-rw-r--r--	2024-04-17 20:28
test_numbers.py	9 KB	-rw-r--r--	2024-04-17 20:28
test_objects.py	1.72 KB	-rw-r--r--	2024-04-17 20:28
test_parameters.py	6.16 KB	-rw-r--r--	2024-04-17 20:28
test_pep3118.py	7.35 KB	-rw-r--r--	2024-04-17 20:28
test_pickling.py	2.15 KB	-rw-r--r--	2024-04-17 20:28
test_pointers.py	6.12 KB	-rw-r--r--	2024-04-17 20:28
test_prototypes.py	6.63 KB	-rw-r--r--	2024-04-17 20:28
test_python_api.py	3.07 KB	-rw-r--r--	2024-04-17 20:28
test_random_things.py	2.77 KB	-rw-r--r--	2024-04-17 20:28
test_refcounts.py	2.52 KB	-rw-r--r--	2024-04-17 20:28
test_repr.py	842 B	-rw-r--r--	2024-04-17 20:28
test_returnfuncptrs.py	2.83 KB	-rw-r--r--	2024-04-17 20:28
test_simplesubclasses.py	1.26 KB	-rw-r--r--	2024-04-17 20:28
test_sizes.py	815 B	-rw-r--r--	2024-04-17 20:28
test_slicing.py	5.95 KB	-rw-r--r--	2024-04-17 20:28
test_stringptr.py	2.48 KB	-rw-r--r--	2024-04-17 20:28
test_strings.py	6.94 KB	-rw-r--r--	2024-04-17 20:28
test_struct_fields.py	1.47 KB	-rw-r--r--	2024-04-17 20:28
test_structures.py	15.43 KB	-rw-r--r--	2024-04-17 20:28
test_unaligned_structures.py	1.19 KB	-rw-r--r--	2024-04-17 20:28
test_unicode.py	1.87 KB	-rw-r--r--	2024-04-17 20:28
test_values.py	3.43 KB	-rw-r--r--	2024-04-17 20:28
test_varsize_struct.py	1.8 KB	-rw-r--r--	2024-04-17 20:28
test_win32.py	3.96 KB	-rw-r--r--	2024-04-17 20:28
test_wintypes.py	1.44 KB	-rw-r--r--	2024-04-17 20:28

Rename

r'''
This tests the '_objects' attribute of ctypes instances.  '_objects'
holds references to objects that must be kept alive as long as the
ctypes instance, to make sure that the memory buffer is valid.

WARNING: The '_objects' attribute is exposed ONLY for debugging ctypes itself,
it MUST NEVER BE MODIFIED!

'_objects' is initialized to a dictionary on first use, before that it
is None.

Here is an array of string pointers:

>>> from ctypes import *
>>> array = (c_char_p * 5)()
>>> print(array._objects)
None
>>>

The memory block stores pointers to strings, and the strings itself
assigned from Python must be kept.

>>> array[4] = b'foo bar'
>>> array._objects
{'4': b'foo bar'}
>>> array[4]
b'foo bar'
>>>

It gets more complicated when the ctypes instance itself is contained
in a 'base' object.

>>> class X(Structure):
...     _fields_ = [("x", c_int), ("y", c_int), ("array", c_char_p * 5)]
...
>>> x = X()
>>> print(x._objects)
None
>>>

The'array' attribute of the 'x' object shares part of the memory buffer
of 'x' ('_b_base_' is either None, or the root object owning the memory block):

>>> print(x.array._b_base_) # doctest: +ELLIPSIS
<ctypes.test.test_objects.X object at 0x...>
>>>

>>> x.array[0] = b'spam spam spam'
>>> x._objects
{'0:2': b'spam spam spam'}
>>> x.array._b_base_._objects
{'0:2': b'spam spam spam'}
>>>

'''

import unittest, doctest, sys

import ctypes.test.test_objects

class TestCase(unittest.TestCase):
    if sys.hexversion > 0x02040000:
        # Python 2.3 has no ELLIPSIS flag, so we don't test with this
        # version:
        def test(self):
            doctest.testmod(ctypes.test.test_objects)

if __name__ == '__main__':
    if sys.hexversion > 0x02040000:
        doctest.testmod(ctypes.test.test_objects)