Python Tuples

Python Tuples: Immutable Sequences & Data Integrity

Tuples are immutable, ordered collections of objects. Because tuples cannot be modified after instantiation, CPython optimizes their memory allocation, making them ideal for representing fixed data structures, function return pairs, and dictionary keys.

Tuple Memory & Packing Model

flowchart LR
    subgraph Memory Stack
        t["point = (10, 20, 30)"]
    end
    subgraph Tuple Heap Allocation
        p0["index 0 -> int(10)"]
        p1["index 1 -> int(20)"]
        p2["index 2 -> int(30)"]
    end
    t --> Tuple Heap Allocation

Key Differences: List vs Tuple

Practical Code Example

from typing import Tuple, NamedTuple

class DatabaseConfig(NamedTuple):
    host: str
    port: int
    user: str

def get_server_status() -> Tuple[int, str, float]:
    """Return a tuple representing (status_code, status_message, latency_ms)."""
    return (200, "OK", 14.2)

if __name__ == "__main__":
    # Tuple Unpacking
    code, msg, latency = get_server_status()
    print(f"Status Code: {code} | Message: '{msg}' | Latency: {latency}ms")

    # NamedTuple Usage for Readability
    db_info = DatabaseConfig("localhost", 5432, "postgres")
    print(f"Connecting to {db_info.host}:{db_info.port} as {db_info.user}")

    # Single Element Tuple Trailing Comma Requirement
    single_tuple = ("standalone",)  # Trailing comma is required!
    print(f"Single Element Tuple Type: {type(single_tuple).__name__}")

Best Practices & Gotchas

• Trailing Comma for Single Items: ("val") evaluates as a parenthesized string "val". You must include a trailing comma ("val",) to instantiate a single-element tuple.
• Tuples with Mutable Elements: A tuple itself is immutable, but if it contains a mutable object (like a list (1, [2, 3])), the nested list can still be modified!
• Use NamedTuple or dataclass(frozen=True): When returning structured records from functions, use typing.NamedTuple for field-name accessibility.

Self-Check Challenge

Write a function swap_values(a: Any, b: Any) -> Tuple[Any, Any] that uses tuple packing and unpacking to swap two variables in a single expression.