Iterating Over Key-Value Pairs (items)
🏷️ Dictionaries / Iterating Over Dictionaries
🧠 Context Introduction
When working with dictionaries, you often need to access both the key and its corresponding value at the same time. While you can loop through just the keys or just the values, the most powerful and common approach is to iterate over key-value pairs using the .items() method. This gives you direct access to both pieces of data in each iteration, making your code cleaner and more readable.
⚙️ What Does .items() Do?
The .items() method returns a view object that displays a list of a dictionary's key-value tuple pairs. When used inside a loop, it unpacks each pair into two variables—typically named key and value.
- Each iteration gives you one key-value pair as a tuple.
- You can assign the key and value to separate variables in the loop definition.
- This is the most Pythonic way to loop through a dictionary when you need both pieces of information.
📊 Basic Syntax and Example
The structure for iterating over key-value pairs looks like this:
- Loop structure:
for key, value in dictionary.items(): - Inside the loop, you can use
keyandvalueas regular variables. - The variable names can be anything, but
keyandvalueare standard conventions.
Example:
Consider a dictionary storing server names and their IP addresses:
- Dictionary:
servers = {"web01": "192.168.1.10", "db01": "192.168.1.20", "cache01": "192.168.1.30"} - Loop:
for server_name, ip_address in servers.items(): - Inside loop:
print(f"Server {server_name} has IP {ip_address}")
Expected output:
- Server web01 has IP 192.168.1.10
- Server db01 has IP 192.168.1.20
- Server cache01 has IP 192.168.1.30
🛠️ Practical Use Cases for Engineers
Iterating over key-value pairs is especially useful in real-world scenarios:
| Use Case | Description | Example |
|---|---|---|
| 🖥️ Configuration Management | Loop through config settings to apply them | for setting, value in config.items(): |
| 📡 Monitoring Data | Process metrics where keys are hostnames and values are statuses | for host, status in health_checks.items(): |
| 📋 Inventory Reporting | Generate reports from asset dictionaries | for asset_id, details in inventory.items(): |
| 🔄 Data Transformation | Convert dictionary data into another format | for old_key, old_value in data.items(): |
🕵️ Common Patterns and Tips
Pattern 1: Conditional Processing
You can add conditions inside the loop to filter or modify specific pairs:
- Loop:
for env, port in environments.items(): - Condition:
if port == 8080: - Action:
print(f"{env} is using the default port")
Pattern 2: Building a New Dictionary
Use key-value iteration to create a transformed dictionary:
- Original:
prices = {"cpu": 250, "ram": 120, "ssd": 90} - Loop:
for item, cost in prices.items(): - Inside loop:
new_prices[item] = cost * 1.1(adding 10% markup)
Pattern 3: Nested Dictionaries
When values are themselves dictionaries, you can access nested data:
- Loop:
for region, instances in cloud_resources.items(): - Inside loop:
for instance_id, specs in instances.items():
✅ Key Takeaways
.items()is the standard method for iterating over both keys and values simultaneously.- Always use two variables in the loop to unpack the key-value pair.
- This approach is more readable and efficient than accessing values by key inside a loop.
- Use descriptive variable names that reflect the data you are working with.
- Combine with conditions and nested loops for complex data processing tasks.
Remember: whenever you need to work with both the key and the value from a dictionary, .items() is your go-to tool. It keeps your code clean, explicit, and easy to understand.
The .items() method returns a view object containing key-value pairs from a dictionary, allowing you to access both the key and its corresponding value in a single loop iteration.
🔧 Example 1: Basic iteration over all key-value pairs
This example shows the simplest way to loop through a dictionary and print each key with its value.
user_settings = {"theme": "dark", "language": "en", "notifications": True}
for key, value in user_settings.items():
print(key, value)
📤 Output: theme dark language en notifications True
🔧 Example 2: Formatting key-value pairs into readable strings
This example demonstrates how to combine keys and values into a formatted sentence.
server_config = {"host": "192.168.1.1", "port": 8080, "protocol": "https"}
for key, value in server_config.items():
print(f"{key}: {value}")
📤 Output: host: 192.168.1.1 port: 8080 protocol: https
🔧 Example 3: Using items() to build a new dictionary with modified values
This example shows how to transform values while preserving keys using items().
temperatures_celsius = {"room1": 22, "room2": 25, "room3": 18}
temperatures_fahrenheit = {}
for room, celsius in temperatures_celsius.items():
fahrenheit = (celsius * 9/5) + 32
temperatures_fahrenheit[room] = fahrenheit
print(temperatures_fahrenheit)
📤 Output: {'room1': 71.6, 'room2': 77.0, 'room3': 64.4}
🔧 Example 4: Filtering dictionary items based on value condition
This example demonstrates how to select only specific key-value pairs using a condition.
system_health = {"cpu": 85, "memory": 92, "disk": 45, "network": 78}
critical_services = {}
for service, usage in system_health.items():
if usage > 80:
critical_services[service] = usage
print(critical_services)
📤 Output: {'cpu': 85, 'memory': 92}
🔧 Example 5: Converting items() into a list for debugging or logging
This example shows how to capture all key-value pairs as a list of tuples for inspection.
api_endpoints = {"login": "/auth/login", "logout": "/auth/logout", "status": "/health"}
endpoint_list = list(api_endpoints.items())
print(endpoint_list)
📤 Output: [('login', '/auth/login'), ('logout', '/auth/logout'), ('status', '/health')]
🔧 Example 6: Unpacking items into separate key and value lists
This example demonstrates splitting a dictionary into two parallel lists using items().
sensor_data = {"temperature": 23.5, "humidity": 60, "pressure": 1013}
sensor_names = []
sensor_values = []
for name, value in sensor_data.items():
sensor_names.append(name)
sensor_values.append(value)
print(sensor_names)
print(sensor_values)
📤 Output: ['temperature', 'humidity', 'pressure'] [23.5, 60, 1013]
📊 Comparison: Iteration Methods for Dictionaries
| Method | What it returns | Use case |
|---|---|---|
.items() |
Key-value pairs (tuples) | When you need both key and value |
.keys() |
Only keys | When you only need dictionary keys |
.values() |
Only values | When you only need dictionary values |
🧠 Context Introduction
When working with dictionaries, you often need to access both the key and its corresponding value at the same time. While you can loop through just the keys or just the values, the most powerful and common approach is to iterate over key-value pairs using the .items() method. This gives you direct access to both pieces of data in each iteration, making your code cleaner and more readable.
⚙️ What Does .items() Do?
The .items() method returns a view object that displays a list of a dictionary's key-value tuple pairs. When used inside a loop, it unpacks each pair into two variables—typically named key and value.
- Each iteration gives you one key-value pair as a tuple.
- You can assign the key and value to separate variables in the loop definition.
- This is the most Pythonic way to loop through a dictionary when you need both pieces of information.
📊 Basic Syntax and Example
The structure for iterating over key-value pairs looks like this:
- Loop structure:
for key, value in dictionary.items(): - Inside the loop, you can use
keyandvalueas regular variables. - The variable names can be anything, but
keyandvalueare standard conventions.
Example:
Consider a dictionary storing server names and their IP addresses:
- Dictionary:
servers = {"web01": "192.168.1.10", "db01": "192.168.1.20", "cache01": "192.168.1.30"} - Loop:
for server_name, ip_address in servers.items(): - Inside loop:
print(f"Server {server_name} has IP {ip_address}")
Expected output:
- Server web01 has IP 192.168.1.10
- Server db01 has IP 192.168.1.20
- Server cache01 has IP 192.168.1.30
🛠️ Practical Use Cases for Engineers
Iterating over key-value pairs is especially useful in real-world scenarios:
| Use Case | Description | Example |
|---|---|---|
| 🖥️ Configuration Management | Loop through config settings to apply them | for setting, value in config.items(): |
| 📡 Monitoring Data | Process metrics where keys are hostnames and values are statuses | for host, status in health_checks.items(): |
| 📋 Inventory Reporting | Generate reports from asset dictionaries | for asset_id, details in inventory.items(): |
| 🔄 Data Transformation | Convert dictionary data into another format | for old_key, old_value in data.items(): |
🕵️ Common Patterns and Tips
Pattern 1: Conditional Processing
You can add conditions inside the loop to filter or modify specific pairs:
- Loop:
for env, port in environments.items(): - Condition:
if port == 8080: - Action:
print(f"{env} is using the default port")
Pattern 2: Building a New Dictionary
Use key-value iteration to create a transformed dictionary:
- Original:
prices = {"cpu": 250, "ram": 120, "ssd": 90} - Loop:
for item, cost in prices.items(): - Inside loop:
new_prices[item] = cost * 1.1(adding 10% markup)
Pattern 3: Nested Dictionaries
When values are themselves dictionaries, you can access nested data:
- Loop:
for region, instances in cloud_resources.items(): - Inside loop:
for instance_id, specs in instances.items():
✅ Key Takeaways
.items()is the standard method for iterating over both keys and values simultaneously.- Always use two variables in the loop to unpack the key-value pair.
- This approach is more readable and efficient than accessing values by key inside a loop.
- Use descriptive variable names that reflect the data you are working with.
- Combine with conditions and nested loops for complex data processing tasks.
Remember: whenever you need to work with both the key and the value from a dictionary, .items() is your go-to tool. It keeps your code clean, explicit, and easy to understand.
Interactive Views
You are currently in 📚 All-in-One mode. Use the tabs at the top to switch to 📖 Theory Only or 💻 Code Only views.
The .items() method returns a view object containing key-value pairs from a dictionary, allowing you to access both the key and its corresponding value in a single loop iteration.
🔧 Example 1: Basic iteration over all key-value pairs
This example shows the simplest way to loop through a dictionary and print each key with its value.
user_settings = {"theme": "dark", "language": "en", "notifications": True}
for key, value in user_settings.items():
print(key, value)
📤 Output: theme dark language en notifications True
🔧 Example 2: Formatting key-value pairs into readable strings
This example demonstrates how to combine keys and values into a formatted sentence.
server_config = {"host": "192.168.1.1", "port": 8080, "protocol": "https"}
for key, value in server_config.items():
print(f"{key}: {value}")
📤 Output: host: 192.168.1.1 port: 8080 protocol: https
🔧 Example 3: Using items() to build a new dictionary with modified values
This example shows how to transform values while preserving keys using items().
temperatures_celsius = {"room1": 22, "room2": 25, "room3": 18}
temperatures_fahrenheit = {}
for room, celsius in temperatures_celsius.items():
fahrenheit = (celsius * 9/5) + 32
temperatures_fahrenheit[room] = fahrenheit
print(temperatures_fahrenheit)
📤 Output: {'room1': 71.6, 'room2': 77.0, 'room3': 64.4}
🔧 Example 4: Filtering dictionary items based on value condition
This example demonstrates how to select only specific key-value pairs using a condition.
system_health = {"cpu": 85, "memory": 92, "disk": 45, "network": 78}
critical_services = {}
for service, usage in system_health.items():
if usage > 80:
critical_services[service] = usage
print(critical_services)
📤 Output: {'cpu': 85, 'memory': 92}
🔧 Example 5: Converting items() into a list for debugging or logging
This example shows how to capture all key-value pairs as a list of tuples for inspection.
api_endpoints = {"login": "/auth/login", "logout": "/auth/logout", "status": "/health"}
endpoint_list = list(api_endpoints.items())
print(endpoint_list)
📤 Output: [('login', '/auth/login'), ('logout', '/auth/logout'), ('status', '/health')]
🔧 Example 6: Unpacking items into separate key and value lists
This example demonstrates splitting a dictionary into two parallel lists using items().
sensor_data = {"temperature": 23.5, "humidity": 60, "pressure": 1013}
sensor_names = []
sensor_values = []
for name, value in sensor_data.items():
sensor_names.append(name)
sensor_values.append(value)
print(sensor_names)
print(sensor_values)
📤 Output: ['temperature', 'humidity', 'pressure'] [23.5, 60, 1013]
📊 Comparison: Iteration Methods for Dictionaries
| Method | What it returns | Use case |
|---|---|---|
.items() |
Key-value pairs (tuples) | When you need both key and value |
.keys() |
Only keys | When you only need dictionary keys |
.values() |
Only values | When you only need dictionary values |