gh-143504: Expose CELL status of a symbol in symtable

Doc/library/symtable.rst

@@ -180,6 +180,10 @@ Examining Symbol Tables
       Return a tuple containing names of :term:`free (closure) variables <closure variable>`
       in this function.
 
+   .. method:: get_cells()
+
+      Return a tuple containing the names of cell variables in this table.
+
 
 .. class:: Class
 
@@ -353,6 +357,12 @@ Examining Symbol Tables
       Return the namespace bound to this name. If more than one or no namespace
       is bound to this name, a :exc:`ValueError` is raised.
 
+   .. method:: is_cell()
+
+      Return ``True`` if the symbol is a cell variable.
+
+      .. versionadded:: 3.15
+
 
 .. _symtable-cli:
 

Lib/test/test_symtable.py

@@ -255,6 +255,7 @@ def test_function_info(self):
         self.assertEqual(sorted(func.get_locals()), expected)
         self.assertEqual(sorted(func.get_globals()), ["bar", "glob", "some_assigned_global_var"])
         self.assertEqual(self.internal.get_frees(), ("x",))
+        self.assertEqual(self.spam.get_cells(), ("some_var", "x",))
 
     def test_globals(self):
         self.assertTrue(self.spam.lookup("glob").is_global())

Misc/NEWS.d/next/Library/2026-01-24-13-49-05.gh-issue-143594.nilGlg.rst

@@ -0,0 +1,2 @@
+Add :meth:`symtable.SymbolTable.get_cells` and
+:meth:`symtable.Symbol.is_cell` methods.