gh-157227: _remote_debugging: Validate lists and tuples in write_sample

[maurycy]

See #157227 for more details

Basically, BinaryWriter.write_sample() only checks whether stack_frames is a list, and does PyList_GET_ITEM() / PyStructSequence_GET_ITEM() all the way. The PR adds a check for these containers.

Now it's graceful:

maurycy@gimel cpython (fix-remote-debugging-writer-validation aec95c2*) % ./python.exe 
Python 3.16.0a0 (heads/fix-remote-debugging-writer-validation-dirty:aec95c21726, Sep  9 2026, 20:) [Clang 21.0.0 (clang-2100.1.1.101)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import _remote_debugging
>>> _remote_debugging.BinaryWriter("/tmp/o.bin", 1000, 1000000).write_sample([42], 2000)
Traceback (most recent call last):
  File "<python-input-1>", line 1, in <module>
    _remote_debugging.BinaryWriter("/tmp/o.bin", 1000, 1000000).write_sample([42], 2000)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^
TypeError: interp_info must be a tuple of at least 2 items
>>> 

instead of segmentation fault.

Closes #157227

• Issue: _remote_debugging: BinaryWriter.write_sample() trivial segfault #157227

[maurycy]

Truth be told, we reinvent similar check over and over:

cpython/Objects/memoryobject.c

Lines 217 to 222 in 9a75080

	#define CHECK_LIST_OR_TUPLE(v) \
	if (!PyList_Check(v) && !PyTuple_Check(v)) { \
	PyErr_SetString(PyExc_TypeError, \
	#v " must be a list or a tuple"); \
	return NULL; \
	}

cpython/Modules/_testbuffer.c

Lines 26 to 33 in 9a75080

	#define CHECK_LIST_OR_TUPLE(v) \
	do { \
	if (!PyList_Check(v) && !PyTuple_Check(v)) { \
	PyErr_SetString(PyExc_TypeError, \
	#v " must be a list or a tuple"); \
	return NULL; \
	} \
	} while (0)

Sometimes without a macro:

cpython/Modules/_io/stringio.c

Lines 922 to 930 in 9a75080

	/* We allow the state tuple to be longer than 4, because we may need
	someday to extend the object's state without breaking
	backward-compatibility. */
	if (!PyTuple_Check(state) || PyTuple_GET_SIZE(state) < 4) {
	PyErr_Format(PyExc_TypeError,
	"%.200s.__setstate__ argument should be 4-tuple, got %.200s",
	Py_TYPE(self)->tp_name, Py_TYPE(state)->tp_name);
	return NULL;
	}

cpython/Python/_warnings.c

Lines 450 to 465 in 9a75080

	tmp_item = PyList_GET_ITEM(filters, i);
	if (!PyTuple_Check(tmp_item) || PyTuple_GET_SIZE(tmp_item) != 5) {
	PyErr_Format(PyExc_ValueError,
	"warnings.%s item %zd isn't a 5-tuple", list_name, i);
	result = false;
	break;
	}
	/* Python code: action, msg, cat, mod, ln = item */
	Py_INCREF(tmp_item);
	action = PyTuple_GET_ITEM(tmp_item, 0);
	msg = PyTuple_GET_ITEM(tmp_item, 1);
	cat = PyTuple_GET_ITEM(tmp_item, 2);
	mod = PyTuple_GET_ITEM(tmp_item, 3);
	ln_obj = PyTuple_GET_ITEM(tmp_item, 4);