What is ast.Tuple(elts, ctx) in Python?

ast.Tuple(elts, ctx) is a class defined in the ast module that is used to express Python tuples in the form of an Abstract Syntax Treetree representation of source code.

When the parse() method of ast is called on a Python source code that contains a tuple, the ast.Tuple class is invoked, which expresses the tuple to a node in an ast tree data structure.

The ast.Tuple class represents the Tuple node type in the ast tree. In the class parameter, elts contains the list of nodes representing the elements in the tuple. ctx is Store() if the tuple is being destructured (i.e., (x,y)=something); otherwise, it is Load().

Example

import ast
from pprint import pprint
class TupleVisitor(ast.NodeVisitor):
    def visit_Tuple(self,node):
        print('Node type: Tuple\nFields: ', node._fields)
        ast.NodeVisitor.generic_visit(self, node)
    def visit_Constant(self,node):
        print('Node type: Constant\nFields: ', node._fields)
        ast.NodeVisitor.generic_visit(self, node)
visitor = TupleVisitor()
tree = ast.parse('(2,4,6)', mode='eval')
pprint(ast.dump(tree))
visitor.visit(tree)

Explanation

  • We define a TupleVisitor class that extends from the parent class ast.NodeVisitor. We override the predefined visit_Constant and visit_Tuple methods in the parent class, which receive the Constant and Tuple nodes, respectively. In the method, we print the type and the fields inside the node and call the generic_visit() method, which invokes the propagation of visit on the children nodes of the input node.
  • We initialize a visitor object of the class TupleVisitor.
  • We define a Python tuple (2,4,6) and send it to the ast.parse() method with mode='eval', which returns the result of the expression after evaluation and stores it in tree.
  • The ast.dump() method returns a formatted string of the tree structure in tree.
  • The visit method available to the visitor objects visits all the nodes in the tree structure.

Free Resources

Copyright ©2026 Educative, Inc. All rights reserved