Tuples and Unpacking

A tuple is a collection of items similar to a list. However, while lists are designed to be changed (mutable), tuples are permanently fixed (immutable).

You create a tuple by separating values with commas. Parentheses are usually added to group the items clearly.

coordinates = (10, 20)
print(coordinates)
print(type(coordinates))

(10, 20)
<class 'tuple'>

Because tuples are immutable, you can never alter their contents once created. There is no append(), no remove(), and you cannot overwrite an index.

try:
    coordinates = (10, 20)
    coordinates[0] = 15
except TypeError as e:
    print(repr(e))

TypeError("'tuple' object does not support item assignment")

The Empty Tuple

Creating an empty tuple is straightforward: you use an empty pair of parentheses.

empty = ()
print(type(empty))
print(len(empty))

<class 'tuple'>
0

The Single Element Gotcha

Here is one of Python’s most famous quirks: creating a tuple with exactly one element requires a trailing comma.

not_a_tuple = (5)
real_tuple = (5,)
print(type(not_a_tuple))
print(type(real_tuple))

<class 'int'>
<class 'tuple'>

Without the comma, Python treats (5) as an integer wrapped in mathematical parentheses!

Tuple Unpacking

Tuples allow you to extract all their elements directly into variables in a single step. This is known as unpacking.

user = ('Alice', 25, 'Admin')
name, age, role = user
print(name)
print(age)
print(role)

Alice
25
Admin

When unpacking, you must provide exactly one variable for every item in the tuple. If the counts don’t match, Python throws a ValueError.

try:
    user = ('Alice', 25, 'Admin')
    name, age = user
except ValueError as e:
    print(repr(e))

ValueError('too many values to unpack (expected 2, got 3)')

The Swapping Idiom

Because Python evaluates the entire right side of an assignment before assigning it to the left side, you can use tuple packing and unpacking to swap two variables on a single line!

a = 'apple'
b = 'banana'
a, b = b, a
print(a, b)

banana apple

Behind the scenes, Python packs b and a into a temporary tuple, and immediately unpacks it into the a and b variables on the left.

Returning Multiple Values

A function in Python can technically only return exactly one item. However, if you return multiple values separated by commas, Python automatically packs them into a single tuple!

def get_min_max(numbers):
    return min(numbers), max(numbers)

lowest, highest = get_min_max([10, 2, 7, 9])
print(lowest)
print(highest)

2
10

This pattern makes Python functions incredibly flexible, allowing you to return and immediately unpack multiple pieces of data.