Python File I/O

Reading and writing files is where real scripts start. Learn the with-statement, path handling, and JSON round-trips.

30 min · Reviewed 2026

pathlib Is the Answer

Skip `os.path` and string concatenation. `pathlib.Path` handles cross-platform paths, reads, writes, and checks existence in one object.

from pathlib import Path
import json

data_dir = Path("data")
data_dir.mkdir(exist_ok=True)

record = {"user": "Ada", "score": 91}

out = data_dir / "record.json"
out.write_text(json.dumps(record, indent=2), encoding="utf-8")

loaded = json.loads(out.read_text(encoding="utf-8"))
print(loaded["score"])  # 91write_text / read_text handle open, close, and encoding. Safer than raw open().

Line-by-line for big files

with open("big.log", encoding="utf-8") as f:
    errors = [line for line in f if "ERROR" in line]

print(f"found {len(errors)} errors")Iterating a file streams one line at a time — no memory blowups on huge logs.

Understanding "Python File I/O" in practice: AI can help you write, fix, and understand code faster than ever — even if you're just learning. Reading and writing files is where real scripts start. Learn the with-statement, path handling, and JSON round-trips — and knowing how to apply this gives you a concrete advantage.

Apply pathlib in your ai-coding workflow to get better results
Apply with in your ai-coding workflow to get better results
Apply json in your ai-coding workflow to get better results
Apply encoding in your ai-coding workflow to get better results

Use AI to generate unit tests for an existing function
Ask AI to refactor a messy function and explain the changes
Have AI suggest a code review for a recent pull request

The big idea: pathlib for paths, context managers for safety, explicit utf-8 everywhere. That covers nine out of ten I/O tasks.

End-of-lesson check

15 questions · take it digitally for instant feedback at tendril.neural-forge.io/learn/quiz/end-progx-python-file-io-builders

Why is it recommended to use pathlib.Path instead of string concatenation when building file paths?
1. pathlib.Path automatically handles differences between operating systems
2. String concatenation is faster than pathlib for large projects
3. String concatenation only works on Windows, not Mac or Linux
4. pathlib.Path can read and write files directly without opening them
On a Windows computer, a script writes emoji to a file using the default encoding. What likely happens?
1. The emoji displays as a question mark or causes an error
2. The script runs faster because Windows handles emoji natively
3. The emoji is automatically converted to ASCII
4. The emoji is stored in half the normal space
A CSV file contains a quoted field like: "Doe, John". What happens if you parse it using .split(',')?
1. The parser automatically detects quoted fields and handles them
2. The parser correctly handles the quoted comma as part of the field
3. The entire row is skipped because the quote is unrecognized
4. The comma inside quotes splits the field incorrectly into two parts
What is the main purpose of the 'with' statement when opening files in Python?
1. It makes the file open faster than normal open()
2. It encrypts the file contents while working with them
3. It allows multiple files to be opened at the same time
4. It automatically closes the file even if an error occurs
Which Python module is recommended for properly parsing CSV files with quoted fields containing commas?
1. re (regular expressions) module
2. string module
3. json module
4. csv module
What problem does explicitly specifying encoding='utf-8' solve?
1. It prevents character corruption on non-English text and emoji
2. It automatically backs up files before reading
3. It converts CSV files to JSON format
4. It makes files load twice as fast
What happens if you forget to close a file after opening it with open() but without a 'with' statement?
1. The file becomes encrypted and cannot be reopened
2. The file automatically closes when the program ends
3. The operating system deletes the file automatically
4. Data may be lost if the program crashes before closing
A student builds a path like 'data/' + 'folder/' + 'file.txt'. Why might this cause problems on Windows?
1. Windows doesn't support the + operator for strings
2. The forward slashes work on all systems without issues
3. Windows uses backslashes, so forward slash paths may fail
4. The + operator only works with numbers, not text
What is a key advantage of pathlib.Path.write_text() compared to manually opening and writing files?
1. It converts the text to binary automatically
2. It handles opening, encoding, and closing all in one method call
3. It can write to multiple files simultaneously
4. It automatically creates a backup copy of the file
Why might reading a 10GB log file all at once cause problems?
1. Python limits all file reads to 1GB maximum
2. Large files are automatically compressed by the operating system
3. The computer may run out of available RAM
4. Log files cannot be larger than 1MB in Python
What does pathlib.Path.exists() return when checking a file path?
1. True if the path points to an existing file or folder, False otherwise
2. The date the file was last modified
3. The file size in bytes
4. The file contents as a string
Which of these is a correct reason to use the csv.DictReader class?
1. It treats each row as a dictionary with column headers as keys
2. It can only read files smaller than 1MB
3. It converts CSV data directly to HTML tables
4. It automatically formats numbers as currency
A Python script runs on Linux but produces files that Windows users say are corrupted. What is the most likely cause?
1. The script didn't specify encoding and used different defaults
2. Linux automatically compresses files that Windows can't read
3. The file size is too large for Windows
4. Linux files are not compatible with Windows
What does the 'with' statement guarantee when used with file operations?
1. The file will be created if it doesn't exist
2. The file will be properly closed even if an exception occurs
3. The file contents will be encrypted automatically
4. The file will be opened in read-only mode
Why is Path('folder') / 'file.txt' preferred over 'folder/' + 'file.txt'?
1. The slash operator is faster than string concatenation
2. The slash operator works correctly on Windows, Linux, and Mac
3. The slash operator can only be used with absolute paths
4. The slash operator automatically creates the folder

← Back to interactive lesson

Tendril · Builders · AI-Assisted Coding

Python File I/O

Reading and writing files is where real scripts start. Learn the with-statement, path handling, and JSON round-trips.

30 min · Reviewed 2026

pathlib Is the Answer

Skip `os.path` and string concatenation. `pathlib.Path` handles cross-platform paths, reads, writes, and checks existence in one object.

from pathlib import Path
import json

data_dir = Path("data")
data_dir.mkdir(exist_ok=True)

record = {"user": "Ada", "score": 91}

out = data_dir / "record.json"
out.write_text(json.dumps(record, indent=2), encoding="utf-8")

loaded = json.loads(out.read_text(encoding="utf-8"))
print(loaded["score"])  # 91write_text / read_text handle open, close, and encoding. Safer than raw open().

Line-by-line for big files

with open("big.log", encoding="utf-8") as f:
    errors = [line for line in f if "ERROR" in line]

print(f"found {len(errors)} errors")Iterating a file streams one line at a time — no memory blowups on huge logs.

Apply pathlib in your ai-coding workflow to get better results
Apply with in your ai-coding workflow to get better results
Apply json in your ai-coding workflow to get better results
Apply encoding in your ai-coding workflow to get better results

Use AI to generate unit tests for an existing function
Ask AI to refactor a messy function and explain the changes
Have AI suggest a code review for a recent pull request

The big idea: pathlib for paths, context managers for safety, explicit utf-8 everywhere. That covers nine out of ten I/O tasks.

End-of-lesson check

15 questions · take it digitally for instant feedback at tendril.neural-forge.io/learn/quiz/end-progx-python-file-io-builders

Why is it recommended to use pathlib.Path instead of string concatenation when building file paths?
1. pathlib.Path automatically handles differences between operating systems
2. String concatenation is faster than pathlib for large projects
3. String concatenation only works on Windows, not Mac or Linux
4. pathlib.Path can read and write files directly without opening them
On a Windows computer, a script writes emoji to a file using the default encoding. What likely happens?
1. The emoji displays as a question mark or causes an error
2. The script runs faster because Windows handles emoji natively
3. The emoji is automatically converted to ASCII
4. The emoji is stored in half the normal space
A CSV file contains a quoted field like: "Doe, John". What happens if you parse it using .split(',')?
1. The parser automatically detects quoted fields and handles them
2. The parser correctly handles the quoted comma as part of the field
3. The entire row is skipped because the quote is unrecognized
4. The comma inside quotes splits the field incorrectly into two parts
What is the main purpose of the 'with' statement when opening files in Python?
1. It makes the file open faster than normal open()
2. It encrypts the file contents while working with them
3. It allows multiple files to be opened at the same time
4. It automatically closes the file even if an error occurs
Which Python module is recommended for properly parsing CSV files with quoted fields containing commas?
1. re (regular expressions) module
2. string module
3. json module
4. csv module
What problem does explicitly specifying encoding='utf-8' solve?
1. It prevents character corruption on non-English text and emoji
2. It automatically backs up files before reading
3. It converts CSV files to JSON format
4. It makes files load twice as fast
What happens if you forget to close a file after opening it with open() but without a 'with' statement?
1. The file becomes encrypted and cannot be reopened
2. The file automatically closes when the program ends
3. The operating system deletes the file automatically
4. Data may be lost if the program crashes before closing
A student builds a path like 'data/' + 'folder/' + 'file.txt'. Why might this cause problems on Windows?
1. Windows doesn't support the + operator for strings
2. The forward slashes work on all systems without issues
3. Windows uses backslashes, so forward slash paths may fail
4. The + operator only works with numbers, not text
What is a key advantage of pathlib.Path.write_text() compared to manually opening and writing files?
1. It converts the text to binary automatically
2. It handles opening, encoding, and closing all in one method call
3. It can write to multiple files simultaneously
4. It automatically creates a backup copy of the file
Why might reading a 10GB log file all at once cause problems?
1. Python limits all file reads to 1GB maximum
2. Large files are automatically compressed by the operating system
3. The computer may run out of available RAM
4. Log files cannot be larger than 1MB in Python
What does pathlib.Path.exists() return when checking a file path?
1. True if the path points to an existing file or folder, False otherwise
2. The date the file was last modified
3. The file size in bytes
4. The file contents as a string
Which of these is a correct reason to use the csv.DictReader class?
1. It treats each row as a dictionary with column headers as keys
2. It can only read files smaller than 1MB
3. It converts CSV data directly to HTML tables
4. It automatically formats numbers as currency
A Python script runs on Linux but produces files that Windows users say are corrupted. What is the most likely cause?
1. The script didn't specify encoding and used different defaults
2. Linux automatically compresses files that Windows can't read
3. The file size is too large for Windows
4. Linux files are not compatible with Windows
What does the 'with' statement guarantee when used with file operations?
1. The file will be created if it doesn't exist
2. The file will be properly closed even if an exception occurs
3. The file contents will be encrypted automatically
4. The file will be opened in read-only mode
Why is Path('folder') / 'file.txt' preferred over 'folder/' + 'file.txt'?
1. The slash operator is faster than string concatenation
2. The slash operator works correctly on Windows, Linux, and Mac
3. The slash operator can only be used with absolute paths
4. The slash operator automatically creates the folder

← Back to interactive lesson