Understanding Python Dictionary Iteration Through a Real File Handling Example

[Rajeev Bagra]

Here is the revised, publish-ready Q&A post with the full context code included at the very beginning, so your online audience can understand everything without prior knowledge.

---

Understanding save_file() in Python — Questions & Answers

Context Code (What We Are Discussing)

class FileHandler:
    def __init__(self, filename):
        self.__filename = filename

    def load_file(self):
        names = {}
        with open(self.__filename) as f:
            for line in f:
                parts = line.strip().split(';')
                name, *numbers = parts
                names[name] = numbers
        return names

    def save_file(self, phonebook: dict):
        with open(self.__filename, "w") as f:
            for name, numbers in phonebook.items():
                line = [name] + numbers
                f.write(";".join(line) + "\n")

---

Q1. What does the FileHandler class do?

Answer:
The FileHandler class is responsible for reading from and writing to a file that stores a phonebook.

Each line in the file represents one person and their phone numbers, separated by semicolons.

Example file content:

Alice;123;456
Bob;789

---

Q2. What is the structure of the phonebook dictionary?

Answer:
The dictionary follows this structure:

{
    "Alice": ["123", "456"],
    "Bob": ["789"]
}

• Key → one name (string)
• Value → a list of one or more phone numbers (strings)

This structure is enforced by the load_file() method.

---

Q3. What does phonebook.items() return?

Answer:
It returns all key–value pairs as tuples.

Example:

phonebook.items()

Returns:

[
    ("Alice", ["123", "456"]),
    ("Bob", ["789"])
]

Each item is always a two-element tuple:

(key, value)

---

Q4. Where do name and numbers come from in this line?

for name, numbers in phonebook.items():

Answer:
Python uses tuple unpacking.

Each (key, value) tuple is automatically split into:

• name → dictionary key
• numbers → dictionary value

Internally, Python does something equivalent to:

for item in phonebook.items():
    name = item[0]
    numbers = item[1]

---

Q5. Are name and numbers predefined anywhere?

Answer:
No.
They are created dynamically by the for loop during each iteration.

They only exist while the loop is running.

---

Q6. Why is there only one name but possibly many numbers?

Answer:
Because dictionary keys must be single values, but dictionary values can be complex objects.

Here, each name maps to a list of phone numbers:

"Alice" → ["123", "456"]

Python is not guessing — it simply follows the data structure.

---

Q7. What does this line do?

line = [name] + numbers

Answer:
It creates a new list starting with the name, followed by all phone numbers.

Example:

name = "Alice"
numbers = ["123", "456"]

Result:

["Alice", "123", "456"]

---

Q8. Why is ";".join(line) used?

Answer:
join() converts a list of strings into a single string, separated by semicolons.

";".join(["Alice", "123", "456"])

Produces:

Alice;123;456

This makes the file both human-readable and easy to reload.

---

Q9. How does Python “know” that numbers is a list?

Answer:
Python does not infer or assume this.

It works because:

• load_file() created the dictionary in this format
• save_file() expects the same structure

If the structure is violated, the method will fail.

This is an example of data contract design.

---

Q10. What happens if the dictionary is structured incorrectly?

Answer:
If the value is not a list:

phonebook = {"Alice": "123"}

Then this line will fail:

line = [name] + numbers

Because strings cannot be concatenated with lists.

---

Q11. Why is tuple unpacking used instead of indexing?

Answer:
Tuple unpacking:

• Makes the code cleaner
• Improves readability
• Reduces indexing errors

Instead of:

item = phonebook.items()

You directly get meaningful variable names.

---

Q12. What is the key concept to remember?

Answer:

for name, numbers in phonebook.items() works because each dictionary item is a (key, value) tuple, and Python automatically unpacks it.

---

Final Takeaway

If you understand dictionary items and tuple unpacking, the save_file() method becomes straightforward and predictable.

---

[Author]

Posts