Tuples as Dictionary Keys

One Key, Several Values

A tuple can collect several values into one object. That makes it useful when a dictionary key needs to represent a combination of values rather than a single value. The important idea is easy to miss: commas create tuples. Parentheses do not create tuples by themselves; they only group an expression or make a tuple easier to read.

The Comma Creates the Tuple

Python identifies tuple construction through commas. A multi-element tuple has commas between its elements. Parentheses may surround the elements, but they are optional. Therefore, these two forms represent the same tuple: 'a', 'b', 'c' and ('a', 'b', 'c'). The parenthesized form is often easier to read, especially when the tuple is used as a dictionary key.

key_a = 'a', 'b', 'c'
key_b = ('a', 'b', 'c')

Both assignments use commas between the elements. The parentheses in key_b improve readability; they are not the feature that makes the value a tuple.

The Single-Element Trap

A single-element tuple makes the comma rule especially important. In ('a'), the parentheses group the string expression, so the result remains the string 'a'. In ('a',), the trailing comma signals that a tuple should be created, so the result is a tuple containing one element.

Constructing Tuples from Existing Data

The tuple() constructor provides another way to create tuples. Pass it a string, list, or another tuple, and it creates a tuple containing the elements from that sequence. Calling tuple() without an argument creates an empty tuple. Comma syntax is convenient when writing tuple values directly; tuple() is useful when the data already exists in another form.

from_text = tuple('cat')
from_list = tuple([1, 2, 3])
empty = tuple()

The string contributes its elements to the new tuple, the list contributes its elements to the new tuple, and tuple() with no argument creates an empty tuple. The constructor is not the same syntax as a tuple literal, but both approaches create tuples.

Names That Preserve the Constructor

Because tuple is the name of Python's built-in constructor, avoid using tuple as a variable name. Assigning a value to tuple overwrites that name in the current scope, so tuple() can no longer be used there to create tuples.

• Expecting parentheses alone to create a tuple.

  Parentheses group the string expression, so the value remains a string.

  Fix: Use value = ('a',) when the tuple has one element.

• Leaving out the trailing comma in a one-element tuple.

  There is no comma to signal tuple construction.

  Fix: Write key = ('north',).

• Using tuple as a variable name.

  The built-in constructor name is overwritten in that scope.

  Fix: Choose another variable name, such as values or items.

Check Your Construction

Essential Rules

1. Commas create tuples; parentheses only group expressions or improve readability.
2. A single-element tuple requires a trailing comma, as in ('a',).
3. Multi-element tuples need commas between elements and may be written with or without surrounding parentheses.
4. tuple() converts strings, lists, and other tuples into tuples, while tuple() with no argument creates an empty tuple.
5. Do not use tuple as a variable name because it shadows the built-in constructor.
6. A tuple can collect multiple values into one dictionary key for lookup and association.