Unpacking is the process of extracting elements from an iterable object (such as lists, tuples, dictionaries, or sets) and assigning them to individual variables. This mechanism relies on the * operator for iterables and the ** operator for dictionaries to simplify data handling and function arguments.

Basic Unpacking Operations

Any iterable object can be unpacked provided the number of variables matches the number of elements in the iterable.

List and Tuple Unpacking

x, y, z = [10, 20, 30]
print(x, y, z)  # Output: 10 20 30

p, q, r = (40, 50, 60)
print(p, q, r)  # Output: 40 50 60

If the variable count does not match the element count, Python raises a ValueError.

try:
    a, b = [1, 2, 3]
except ValueError as e:
    print(e)  # Output: too many values to unpack (expected 2)

String and Set Unpacking Strings are iterable sequences of characters, and sets are iterable collections of unique items.

c1, c2, c3 = "XYZ"
print(c1)  # Output: X

s1, s2, s3 = {100, 200, 300}
print(s1)  # Output: 100 (Order is not guaranteed in sets)

Generator and Range Unpacking Generators and range objects also support unpacking.

g1, g2, g3 = (val * 2 for val in range(3))
print(g1, g2, g3)  # Output: 0 2 4

Function Argument Unpacking

Unpacking syntax is frequently used to pass arguments to functions dynamically.

Positional Arguments Using the single asterisk * unpacks a list, tuple, or set into positional arguments.

def show_details(name, age, status):
    print(f"Name: {name}, Age: {age}, Status: {status}")

user_data = ["Alice", 28, "Active"]
show_details(*user_data)
# Output: Name: Alice, Age: 28, Status: Active

Keyword Arguments The double asterisk ** unpacks a dictionary into keyword arguments.

user_info = {"name": "Bob", "age": 35, "status": "Inactive"}
show_details(**user_info)
# Output: Name: Bob, Age: 35, Status: Inactive

Unpacking in Expressions

Python 3.5+ (PEP 448) extended unpacking to allow usage inside containers like lists and dictionaries, enabling efficient merging and construction.

Merging Lists Multiple lists or itearbles can be combined into a new list directly within the list literal.

list_a = [1, 2]
list_b = range(3, 5)

combined = [*list_a, *list_b, 99]
print(combined)  # Output: [1, 2, 3, 4, 99]

Merging Dictionaries Dictionaries can be merged using the ** operator. In case of key conflicts, the value from the rightmost dictionary takes precedence.

default_config = {"host": "127.0.0.1", "port": 8080, "debug": False}
user_config = {"port": 8000, "debug": True}

final_config = {**default_config, **user_config}
print(final_config)
# Output: {'host': '127.0.0.1', 'port': 8000, 'debug': True}

This approach provides a concise syntax for combining data structures without requiring explicit loop methods or utility functions like .update().