Reading and Writing Text Files in Python: write(), writelines(), and Stream Iteration0%

Reading and Writing Text Files in Python: write(), writelines(), and Stream Iteration

Beginner12 min read•Updated: 2026-09-30

Reading and Writing Text Files in Python: `write()`, `writelines()`, & Stream Iteration

File I/O bridges the volatile memory of your Python script with permanent disk storage. Once a file is opened in 'w', 'a', or 'r' mode, Python provides a suite of methods to transfer text data into and out of files.

However, writing to files differs from printing to the console screen in subtle ways: while print() automatically appends a newline character (\n) at the end of every call, file writing methods do not. You must manage newlines, line breaks, and stream iteration explicitly.

Real-World Analogy: The Fountain Pen Ledger & The Index Card Batch

Visual Architecture Blueprint

+-------------------------------------------------------------------------------+
|                    READING & WRITING REAL-WORLD ANALOGIES                     |
+-------------------------------------------------------------------------------+

  1. THE COURT STENOGRAPHER'S FOUNTAIN PEN (`.write()`):
     - The stenographer writes words on a continuous parchment roll.
     - When you write "Item 1", the pen does NOT jump to the next line
       by magic—the stenographer must explicitly pull the carriage return lever
       (`\n`) to begin a new line.
     - You can write strings of any length; the method reports the exact count
       of characters pressed into the page.

  2. THE ARCHIVAL INDEX CARD BUNDLE (`.writelines()`):
     - A postal clerk holds a rubber-banded stack of 10 pre-printed cards.
     - `.writelines()` pastes all 10 cards onto the manifest page in one stroke.
     - Crucial Note: If each card did not already have a newline stamped on its
       bottom edge, they all stick together in one continuous unbroken sentence!

  3. THE LINE-BY-LINE MAGNIFYING GLASS (`for line in file:`):
     - Reading a 500-page property deed one line at a time.
     - You only look at 1 line in memory at any millisecond, keeping your desk
       clean even if the book weighs 10 kilograms.
+-------------------------------------------------------------------------------+

Visual Architecture: File Pointer Mechanics

1================================================================================
                  FILE STREAM POINTER TRAVERSAL
3================================================================================
4 
Initial State: open("data.txt", "w")
[File Pointer @ Byte 0]
           |
           v
f.write("Aarav\n")    --> Writes 6 characters ("A", "a", "r", "a", "v", "\n")
[File Pointer advances to Byte 6]
           |
           v
f.write("Pooja\n")    --> Writes 6 characters ("P", "o", "o", "j", "a", "\n")
[File Pointer advances to Byte 12]
15 
READING BACK: open("data.txt", "r")
[Read Pointer @ Byte 0]
           |
           v
Reads "Aarav\n" ----> Next iteration reads "Pooja\n" ----> EOF (Halts)
21================================================================================

1. Writing Text to Files: `.write()`

The .write(string) method writes a string to the open file and returns the integer number of characters written:

1# ==========================================================
2# Example 1: The .write() Method and Explicit Newlines
3# ==========================================================
4 
5f = open("election_booth.txt", "w", encoding="utf-8")
6 
7# Note: Explicit '\n' is MANDATORY to separate lines!
8chars_1 = f.write("Constituency: New Delhi Central (AC-40)\n")
9chars_2 = f.write("Total Registered Voters: 145000\n")
10chars_3 = f.write("EVM Status: Operational\n")
11 
12f.close()
13 
14print(f"File created successfully. Total characters written: {chars_1 + chars_2 + chars_3}")

Important Warning

[!CAUTION] Data Type Requirement: .write() strictly accepts strings (str). Passing an integer, float, or list (e.g. f.write(450)) raises an immediate TypeError: write() argument must be str, not int. Always cast non-strings using str() or f-strings: f.write(f"{amount}\n").

2. Writing Multiple Lines: `.writelines()`

The .writelines(iterable) method takes an iterable of strings (such as a list of strings) and writes them to the file in sequence:

1# ==========================================================
2# Example 2: Batch Writing with .writelines()
3# ==========================================================
4 
5candidate_manifest = [
6    "Candidate 1: Rajesh Kumar (Independent)\n",
7    "Candidate 2: Priya Sen (Janata Party)\n",
8    "Candidate 3: Vikramaditya Singh (National Congress)\n"
9]
10 
11f = open("candidates_list.txt", "w", encoding="utf-8")
12f.writelines(candidate_manifest)  # Writes all list elements efficiently
13f.close()
14 
15print("Candidate list flushed to disk via .writelines().")

Important Warning

[!WARNING] No Automatic Newlines: Despite its name, .writelines() does NOT insert newline characters between items! If the strings in your list do not end with \n, they will be concatenated into one giant single line.

3. Reading Files: The Three Main Approaches

Python provides three distinct techniques to read data from a text file:

Visual Architecture Blueprint

+---------------------------+-----------------------------------+-------------------------------------+
| METHOD                    | HOW IT WORKS                      | MEMORY PROFILE                      |
+---------------------------+-----------------------------------+-------------------------------------+
| `f.read()`                | Reads the ENTIRE file as one str  | Loads entire file into RAM. Risky   |
|                           | into memory.                      | for large files (> 1 GB).           |
+---------------------------+-----------------------------------+-------------------------------------+
| `f.readlines()`           | Reads entire file into a list of  | Loads entire list into RAM.         |
|                           | string lines: `['L1\n', 'L2\n']`. | Retains trailing newlines.          |
+---------------------------+-----------------------------------+-------------------------------------+
| `for line in f:`          | Streams one line at a time        | EXTREMELY EFFICIENT! Uses O(1)      |
| (Stream Iteration)        | lazily on demand.                 | RAM even for a 50 GB log file!      |
+---------------------------+-----------------------------------+-------------------------------------+

Approach 1: Stream Iteration (The Gold Standard)

Iterating directly over the file object is the most memory-efficient and Pythonic way to read text files:

1# ==========================================================
2# Example 3: Memory-Efficient Stream Iteration
3# ==========================================================
4 
5f = open("candidates_list.txt", "r", encoding="utf-8")
6 
7print("=== PARSING CANDIDATE REGISTER (LINE BY LINE) ===")
8# Memory-efficient: loads one line at a time
9for line_number, line in enumerate(f, start=1):
10    # .strip() removes the trailing '\n' and extra whitespace
11    clean_text = line.strip()
12    print(f"Entry #{line_number}: {clean_text}")
13 
14f.close()

Output:

1=== PARSING CANDIDATE REGISTER (LINE BY LINE) ===
2Entry #1: Candidate 1: Rajesh Kumar (Independent)
3Entry #2: Candidate 2: Priya Sen (Janata Party)
4Entry #3: Candidate 3: Vikramaditya Singh (National Congress)

4. Reading Specific Byte Chunks: `f.read(size)`

You can pass an optional integer argument to read(size) to read only a specified number of characters:

1# ==========================================================
2# Example 4: Chunked Reading
3# ==========================================================
4 
5f = open("candidates_list.txt", "r", encoding="utf-8")
6 
7# Read first 11 characters
8chunk1 = f.read(11)
9print("Chunk 1:", repr(chunk1))
10 
11# Read next 12 characters (file pointer continues from byte 11)
12chunk2 = f.read(12)
13print("Chunk 2:", repr(chunk2))
14 
15f.close()

Output:

1Chunk 1: 'Candidate 1'
2Chunk 2: ': Rajesh Kum'

5. Do's and Don'ts Best Practices

Best Practice (DO)	Dangerous Anti-Pattern (DON'T)
DO use `for line in file:` for line-by-line parsing to maintain $O(1)$ memory usage.	DON'T call `file.read()` on massive 10 GB log files, which exhausts system RAM.
DO explicitly append `\n` when calling `.write()` or preparing lists for `.writelines()`.	DON'T pass non-strings to `.write()`; cast them first with `str()` or f-strings.
DO use `.strip()` on lines read from a file to remove trailing `\n` characters.	DON'T assume `.writelines()` automatically adds line breaks between list items.

Quick Revision Summary

.write(string) writes text to a file and returns character count; does not append automatic newlines.
Passing non-string objects to .write() causes a TypeError.
.writelines(list_of_strings) writes a batch of strings to disk without inserting automatic newlines.
for line in file: provides lazy, memory-efficient stream iteration ($O(1)$ memory).
Always use line.strip() or line.rstrip('\n') when processing lines read from files to clean up trailing line breaks.

⚠️ Common Beginner Mistakes & Gotchas

1. Forgetting to Close Files (Leaking File Handles)

Always use the with open() context manager so files are automatically closed even if an exception occurs:

1# ❌ Risky manual file handling
2# f = open("notes.txt", "w")
3# f.write("Data")
4# f.close()  # May never execute if an error occurs above!
5 
6# ✅ Production standard context manager
7with open("notes.txt", "w", encoding="utf-8") as f:
8    f.write("Data safely flushed to disk")

2. Accidental Overwrite in `'w'` Mode

Opening an existing file in 'w' (write) mode immediately truncates (erases) all existing content! To preserve existing data and add to the end, use 'a' (append) mode.

Interactive Quiz• Knowledge Check

Practice Quiz

1. What happens if you call `file.write(500)` where `file` is opened in text write mode?

A. Python converts 500 to string "500" automatically B. Python raises a TypeError: write() argument must be str, not int C. Python writes 500 blank spaces to the file D. Python writes 500 binary bytes

Answer: B

2. What distinguishes `.write()` from `print()` regarding newline characters?

A. print() adds no newlines; .write() adds two newlines B. print() automatically appends a newline \n by default, whereas .write() only writes the exact characters supplied without any automatic newline C. .write() cannot write newlines D. There is no difference; they are aliases

Answer: B

3. If `lines = ["Apple", "Banana", "Cherry"]`, what will appear in a file written with `f.writelines(lines)`?

A. Three separate lines: Apple, Banana, Cherry B. A single continuous line: AppleBananaCherry C. A list formatted as ['Apple', 'Banana', 'Cherry'] D. An error because commas are missing

Answer: B

4. Which technique is most memory-efficient for reading a 20 GB web server access log in Python?

A. data = f.read() B. lines = f.readlines() C. for line in f: D. list(f)

Answer: C

5. Why is `.strip()` frequently called on lines during file reading (e.g. `for line in f: clean_line = line.strip()`)?

A. To convert the text to lowercase B. To strip out and remove the invisible trailing newline character \n that .readline() and stream iteration retain C. To encrypt the string in memory D. To convert the string to a list of tokens

Answer: B

Practice Challenge: Student Examination Roll List Generator & Parser

Build an automated grade export and parsing engine for a CBSE high school examination board.

Requirements:

1
Write a function export_student_marks_csv(filename, student_records):

Takes a list of student tuples: (roll_no, name, marks, grade).
Opens filename in write mode 'w'.
Writes a CSV header: "Roll_No,Student_Name,Marks,Grade\n".
Writes each student record as a comma-separated line with explicit \n.
Properly closes the file.

1
Write a function import_and_analyze_marks_csv(filename):

Opens filename in read mode 'r'.
Uses memory-efficient stream iteration (for line in f:) to parse the file line by line.
Skips the header line.
Splits each line by comma , and calculates: Total Students, Class Average Marks, and Top Scorer Name.
Properly closes the file and returns the analytics summary.

Complete Solution

1# ==========================================================
2# Challenge: CBSE Marks CSV Generator & Stream Parser
3# ==========================================================
4 
5import os
6 
7CSV_FILE = "cbse_batch_2026.csv"
8 
9def export_student_marks_csv(filename: str, records: list) -> None:
10    """Exports structured student records to a clean CSV file."""
11    f = open(filename, "w", encoding="utf-8")
12    
13    # Write CSV Header with explicit newline
14    f.write("Roll_No,Student_Name,Marks,Grade\n")
15    
16    # Write student records
17    for roll, name, marks, grade in records:
18        csv_line = f"{roll},{name},{marks},{grade}\n"
19        f.write(csv_line)
20        
21    f.close()
22    print(f"[EXPORT] Successfully saved {len(records)} records to {filename}")
23 
24 
25def import_and_analyze_marks_csv(filename: str) -> dict:
26    """Parses CSV line by line via stream iteration and computes metrics."""
27    f = open(filename, "r", encoding="utf-8")
28    
29    total_students = 0
30    total_marks = 0.0
31    highest_marks = -1.0
32    topper_name = ""
33    
34    print(f"\n=== PARSING & AUDITING CSV STREAM: {filename} ===")
35    
36    for line_idx, line in enumerate(f):
37        clean_line = line.strip()
38        
39        # Skip header row (line index 0)
40        if line_idx == 0:
41            print(f"  [HEADER] Columns: {clean_line}")
42            continue
43            
44        # Parse comma-separated fields
45        parts = clean_line.split(",")
46        roll = parts[0]
47        name = parts[1]
48        score = float(parts[2])
49        grade = parts[3]
50        
51        total_students += 1
52        total_marks += score
53        
54        if score > highest_marks:
55            highest_marks = score
56            topper_name = name
57            
58        print(f"  Processed Student: {name:<20} (Roll: {roll}) -> Score: {score}")
59        
60    f.close()
61    
62    avg_score = (total_marks / total_students) if total_students > 0 else 0.0
63    
64    return {
65        "student_count": total_students,
66        "class_average": avg_score,
67        "topper": topper_name,
68        "highest_score": highest_marks
69    }
70 
71 
72# Test Student Cohort Data
73students_data = [
74    ("DPS-101", "Aarav Singhania", 96.5, "A1"),
75    ("DPS-102", "Pooja Hegde",      88.0, "A2"),
76    ("DPS-103", "Kabir Sen",        94.0, "A1"),
77    ("DPS-104", "Meera Deshmukh",   79.5, "B1"),
78    ("DPS-105", "Rohan Verma",      98.0, "A1")
79]
80 
81# 1. Export records to disk
82export_student_marks_csv(CSV_FILE, students_data)
83 
84# 2. Read and analyze records from disk
85analysis = import_and_analyze_marks_csv(CSV_FILE)
86 
87print("\n" + "=" * 54)
88print(f"Total Enrolled Candidates: {analysis['student_count']}")
89print(f"Cohort Academic Average:   {analysis['class_average']:.2f}%")
90print(f"Class Top Scorer:          {analysis['topper']} ({analysis['highest_score']}%)")
91print("=" * 54)
92 
93# Cleanup scratch file
94if os.path.exists(CSV_FILE):
95    os.remove(CSV_FILE)
96    print("\n[CLEANUP] Scratch CSV audit file removed.")

🚀 What's Next?

In the next lesson, we will continue your Python learning journey with Working with open() (15: File Handling).

👉 Continue to Next Lesson: Working with open() →

Next Lesson

Working with open()

Continue learning with hands-on practice, examples, and exercises in the upcoming topic.

Related Lessons

Previous Lesson	Next Lesson
Opening & Closing Files	Working with open()

Practice Quiz

Test your understanding of this lesson with 5 questions. Each question has one correct answer.

Previous Next

PreviousPrevNext

MSK Institute • Shikohabad

Loading Page Content...

Preparing courses, live labs, and learning resources.सामग्री लोड हो रही है, कृपया प्रतीक्षा करें...

Connecting serverPlease wait...

💻 Practical Labs🚀 Free Demo📜 Verified Certificates

Working with open()

Reading and Writing Text Files in Python: write(), writelines(), and Stream Iteration

Beginner12 min read•Updated: 2026-09-30

Study Materials Cheatsheet

Reading and Writing Text Files in Python: `write()`, `writelines()`, & Stream Iteration

Real-World Analogy: The Fountain Pen Ledger & The Index Card Batch

Visual Architecture Blueprint

+-------------------------------------------------------------------------------+
|                    READING & WRITING REAL-WORLD ANALOGIES                     |
+-------------------------------------------------------------------------------+

  1. THE COURT STENOGRAPHER'S FOUNTAIN PEN (`.write()`):
     - The stenographer writes words on a continuous parchment roll.
     - When you write "Item 1", the pen does NOT jump to the next line
       by magic—the stenographer must explicitly pull the carriage return lever
       (`\n`) to begin a new line.
     - You can write strings of any length; the method reports the exact count
       of characters pressed into the page.

  2. THE ARCHIVAL INDEX CARD BUNDLE (`.writelines()`):
     - A postal clerk holds a rubber-banded stack of 10 pre-printed cards.
     - `.writelines()` pastes all 10 cards onto the manifest page in one stroke.
     - Crucial Note: If each card did not already have a newline stamped on its
       bottom edge, they all stick together in one continuous unbroken sentence!

  3. THE LINE-BY-LINE MAGNIFYING GLASS (`for line in file:`):
     - Reading a 500-page property deed one line at a time.
     - You only look at 1 line in memory at any millisecond, keeping your desk
       clean even if the book weighs 10 kilograms.
+-------------------------------------------------------------------------------+

Visual Architecture: File Pointer Mechanics

1================================================================================
                  FILE STREAM POINTER TRAVERSAL
3================================================================================
4 
Initial State: open("data.txt", "w")
[File Pointer @ Byte 0]
           |
           v
f.write("Aarav\n")    --> Writes 6 characters ("A", "a", "r", "a", "v", "\n")
[File Pointer advances to Byte 6]
           |
           v
f.write("Pooja\n")    --> Writes 6 characters ("P", "o", "o", "j", "a", "\n")
[File Pointer advances to Byte 12]
15 
READING BACK: open("data.txt", "r")
[Read Pointer @ Byte 0]
           |
           v
Reads "Aarav\n" ----> Next iteration reads "Pooja\n" ----> EOF (Halts)
21================================================================================

1. Writing Text to Files: `.write()`

The .write(string) method writes a string to the open file and returns the integer number of characters written:

1# ==========================================================
2# Example 1: The .write() Method and Explicit Newlines
3# ==========================================================
4 
5f = open("election_booth.txt", "w", encoding="utf-8")
6 
7# Note: Explicit '\n' is MANDATORY to separate lines!
8chars_1 = f.write("Constituency: New Delhi Central (AC-40)\n")
9chars_2 = f.write("Total Registered Voters: 145000\n")
10chars_3 = f.write("EVM Status: Operational\n")
11 
12f.close()
13 
14print(f"File created successfully. Total characters written: {chars_1 + chars_2 + chars_3}")

Important Warning

2. Writing Multiple Lines: `.writelines()`

The .writelines(iterable) method takes an iterable of strings (such as a list of strings) and writes them to the file in sequence:

1# ==========================================================
2# Example 2: Batch Writing with .writelines()
3# ==========================================================
4 
5candidate_manifest = [
6    "Candidate 1: Rajesh Kumar (Independent)\n",
7    "Candidate 2: Priya Sen (Janata Party)\n",
8    "Candidate 3: Vikramaditya Singh (National Congress)\n"
9]
10 
11f = open("candidates_list.txt", "w", encoding="utf-8")
12f.writelines(candidate_manifest)  # Writes all list elements efficiently
13f.close()
14 
15print("Candidate list flushed to disk via .writelines().")

Important Warning

3. Reading Files: The Three Main Approaches

Python provides three distinct techniques to read data from a text file:

Visual Architecture Blueprint

+---------------------------+-----------------------------------+-------------------------------------+
| METHOD                    | HOW IT WORKS                      | MEMORY PROFILE                      |
+---------------------------+-----------------------------------+-------------------------------------+
| `f.read()`                | Reads the ENTIRE file as one str  | Loads entire file into RAM. Risky   |
|                           | into memory.                      | for large files (> 1 GB).           |
+---------------------------+-----------------------------------+-------------------------------------+
| `f.readlines()`           | Reads entire file into a list of  | Loads entire list into RAM.         |
|                           | string lines: `['L1\n', 'L2\n']`. | Retains trailing newlines.          |
+---------------------------+-----------------------------------+-------------------------------------+
| `for line in f:`          | Streams one line at a time        | EXTREMELY EFFICIENT! Uses O(1)      |
| (Stream Iteration)        | lazily on demand.                 | RAM even for a 50 GB log file!      |
+---------------------------+-----------------------------------+-------------------------------------+

Approach 1: Stream Iteration (The Gold Standard)

Iterating directly over the file object is the most memory-efficient and Pythonic way to read text files:

1# ==========================================================
2# Example 3: Memory-Efficient Stream Iteration
3# ==========================================================
4 
5f = open("candidates_list.txt", "r", encoding="utf-8")
6 
7print("=== PARSING CANDIDATE REGISTER (LINE BY LINE) ===")
8# Memory-efficient: loads one line at a time
9for line_number, line in enumerate(f, start=1):
10    # .strip() removes the trailing '\n' and extra whitespace
11    clean_text = line.strip()
12    print(f"Entry #{line_number}: {clean_text}")
13 
14f.close()

Output:

1=== PARSING CANDIDATE REGISTER (LINE BY LINE) ===
2Entry #1: Candidate 1: Rajesh Kumar (Independent)
3Entry #2: Candidate 2: Priya Sen (Janata Party)
4Entry #3: Candidate 3: Vikramaditya Singh (National Congress)

4. Reading Specific Byte Chunks: `f.read(size)`

You can pass an optional integer argument to read(size) to read only a specified number of characters:

1# ==========================================================
2# Example 4: Chunked Reading
3# ==========================================================
4 
5f = open("candidates_list.txt", "r", encoding="utf-8")
6 
7# Read first 11 characters
8chunk1 = f.read(11)
9print("Chunk 1:", repr(chunk1))
10 
11# Read next 12 characters (file pointer continues from byte 11)
12chunk2 = f.read(12)
13print("Chunk 2:", repr(chunk2))
14 
15f.close()

Output:

1Chunk 1: 'Candidate 1'
2Chunk 2: ': Rajesh Kum'

5. Do's and Don'ts Best Practices

Best Practice (DO)	Dangerous Anti-Pattern (DON'T)
DO use `for line in file:` for line-by-line parsing to maintain $O(1)$ memory usage.	DON'T call `file.read()` on massive 10 GB log files, which exhausts system RAM.
DO explicitly append `\n` when calling `.write()` or preparing lists for `.writelines()`.	DON'T pass non-strings to `.write()`; cast them first with `str()` or f-strings.
DO use `.strip()` on lines read from a file to remove trailing `\n` characters.	DON'T assume `.writelines()` automatically adds line breaks between list items.

Quick Revision Summary

.write(string) writes text to a file and returns character count; does not append automatic newlines.
Passing non-string objects to .write() causes a TypeError.
.writelines(list_of_strings) writes a batch of strings to disk without inserting automatic newlines.
for line in file: provides lazy, memory-efficient stream iteration ($O(1)$ memory).
Always use line.strip() or line.rstrip('\n') when processing lines read from files to clean up trailing line breaks.

⚠️ Common Beginner Mistakes & Gotchas

1. Forgetting to Close Files (Leaking File Handles)

Always use the with open() context manager so files are automatically closed even if an exception occurs:

1# ❌ Risky manual file handling
2# f = open("notes.txt", "w")
3# f.write("Data")
4# f.close()  # May never execute if an error occurs above!
5 
6# ✅ Production standard context manager
7with open("notes.txt", "w", encoding="utf-8") as f:
8    f.write("Data safely flushed to disk")

2. Accidental Overwrite in `'w'` Mode

Opening an existing file in 'w' (write) mode immediately truncates (erases) all existing content! To preserve existing data and add to the end, use 'a' (append) mode.

Interactive Quiz• Knowledge Check

Practice Quiz

1. What happens if you call `file.write(500)` where `file` is opened in text write mode?

Answer: B

2. What distinguishes `.write()` from `print()` regarding newline characters?

Answer: B

3. If `lines = ["Apple", "Banana", "Cherry"]`, what will appear in a file written with `f.writelines(lines)`?

A. Three separate lines: Apple, Banana, Cherry B. A single continuous line: AppleBananaCherry C. A list formatted as ['Apple', 'Banana', 'Cherry'] D. An error because commas are missing

Answer: B

4. Which technique is most memory-efficient for reading a 20 GB web server access log in Python?

A. data = f.read() B. lines = f.readlines() C. for line in f: D. list(f)

Answer: C

5. Why is `.strip()` frequently called on lines during file reading (e.g. `for line in f: clean_line = line.strip()`)?

Answer: B

Practice Challenge: Student Examination Roll List Generator & Parser

Build an automated grade export and parsing engine for a CBSE high school examination board.

Requirements:

1
Write a function export_student_marks_csv(filename, student_records):

Takes a list of student tuples: (roll_no, name, marks, grade).
Opens filename in write mode 'w'.
Writes a CSV header: "Roll_No,Student_Name,Marks,Grade\n".
Writes each student record as a comma-separated line with explicit \n.
Properly closes the file.

1
Write a function import_and_analyze_marks_csv(filename):

Opens filename in read mode 'r'.
Uses memory-efficient stream iteration (for line in f:) to parse the file line by line.
Skips the header line.
Splits each line by comma , and calculates: Total Students, Class Average Marks, and Top Scorer Name.
Properly closes the file and returns the analytics summary.

Complete Solution

1# ==========================================================
2# Challenge: CBSE Marks CSV Generator & Stream Parser
3# ==========================================================
4 
5import os
6 
7CSV_FILE = "cbse_batch_2026.csv"
8 
9def export_student_marks_csv(filename: str, records: list) -> None:
10    """Exports structured student records to a clean CSV file."""
11    f = open(filename, "w", encoding="utf-8")
12    
13    # Write CSV Header with explicit newline
14    f.write("Roll_No,Student_Name,Marks,Grade\n")
15    
16    # Write student records
17    for roll, name, marks, grade in records:
18        csv_line = f"{roll},{name},{marks},{grade}\n"
19        f.write(csv_line)
20        
21    f.close()
22    print(f"[EXPORT] Successfully saved {len(records)} records to {filename}")
23 
24 
25def import_and_analyze_marks_csv(filename: str) -> dict:
26    """Parses CSV line by line via stream iteration and computes metrics."""
27    f = open(filename, "r", encoding="utf-8")
28    
29    total_students = 0
30    total_marks = 0.0
31    highest_marks = -1.0
32    topper_name = ""
33    
34    print(f"\n=== PARSING & AUDITING CSV STREAM: {filename} ===")
35    
36    for line_idx, line in enumerate(f):
37        clean_line = line.strip()
38        
39        # Skip header row (line index 0)
40        if line_idx == 0:
41            print(f"  [HEADER] Columns: {clean_line}")
42            continue
43            
44        # Parse comma-separated fields
45        parts = clean_line.split(",")
46        roll = parts[0]
47        name = parts[1]
48        score = float(parts[2])
49        grade = parts[3]
50        
51        total_students += 1
52        total_marks += score
53        
54        if score > highest_marks:
55            highest_marks = score
56            topper_name = name
57            
58        print(f"  Processed Student: {name:<20} (Roll: {roll}) -> Score: {score}")
59        
60    f.close()
61    
62    avg_score = (total_marks / total_students) if total_students > 0 else 0.0
63    
64    return {
65        "student_count": total_students,
66        "class_average": avg_score,
67        "topper": topper_name,
68        "highest_score": highest_marks
69    }
70 
71 
72# Test Student Cohort Data
73students_data = [
74    ("DPS-101", "Aarav Singhania", 96.5, "A1"),
75    ("DPS-102", "Pooja Hegde",      88.0, "A2"),
76    ("DPS-103", "Kabir Sen",        94.0, "A1"),
77    ("DPS-104", "Meera Deshmukh",   79.5, "B1"),
78    ("DPS-105", "Rohan Verma",      98.0, "A1")
79]
80 
81# 1. Export records to disk
82export_student_marks_csv(CSV_FILE, students_data)
83 
84# 2. Read and analyze records from disk
85analysis = import_and_analyze_marks_csv(CSV_FILE)
86 
87print("\n" + "=" * 54)
88print(f"Total Enrolled Candidates: {analysis['student_count']}")
89print(f"Cohort Academic Average:   {analysis['class_average']:.2f}%")
90print(f"Class Top Scorer:          {analysis['topper']} ({analysis['highest_score']}%)")
91print("=" * 54)
92 
93# Cleanup scratch file
94if os.path.exists(CSV_FILE):
95    os.remove(CSV_FILE)
96    print("\n[CLEANUP] Scratch CSV audit file removed.")

🚀 What's Next?

In the next lesson, we will continue your Python learning journey with Working with open() (15: File Handling).

👉 Continue to Next Lesson: Working with open() →

Next Lesson

Working with open()

Continue learning with hands-on practice, examples, and exercises in the upcoming topic.

Related Lessons

Previous Lesson	Next Lesson
Opening & Closing Files	Working with open()

Practice Quiz

Test your understanding of this lesson with 5 questions. Each question has one correct answer.

Previous Next

Reading and Writing Text Files in Python: write(), writelines(), & Stream Iteration

Real-World Analogy: The Fountain Pen Ledger & The Index Card Batch

Visual Architecture: File Pointer Mechanics

1. Writing Text to Files: .write()

2. Writing Multiple Lines: .writelines()

3. Reading Files: The Three Main Approaches

Approach 1: Stream Iteration (The Gold Standard)

4. Reading Specific Byte Chunks: f.read(size)

5. Do's and Don'ts Best Practices

Quick Revision Summary

⚠️ Common Beginner Mistakes & Gotchas

1. Forgetting to Close Files (Leaking File Handles)

2. Accidental Overwrite in 'w' Mode

Practice Quiz

1. What happens if you call file.write(500) where file is opened in text write mode?

2. What distinguishes .write() from print() regarding newline characters?

3. If lines = ["Apple", "Banana", "Cherry"], what will appear in a file written with f.writelines(lines)?

4. Which technique is most memory-efficient for reading a 20 GB web server access log in Python?

5. Why is .strip() frequently called on lines during file reading (e.g. for line in f: clean_line = line.strip())?

Practice Challenge: Student Examination Roll List Generator & Parser

Requirements:

Complete Solution

🚀 What's Next?

Working with open()

Related Lessons

Practice Quiz

Loading Page Content...

Reading and Writing Text Files in Python: write(), writelines(), & Stream Iteration

Real-World Analogy: The Fountain Pen Ledger & The Index Card Batch

Visual Architecture: File Pointer Mechanics

1. Writing Text to Files: .write()

2. Writing Multiple Lines: .writelines()

3. Reading Files: The Three Main Approaches

Approach 1: Stream Iteration (The Gold Standard)

4. Reading Specific Byte Chunks: f.read(size)

5. Do's and Don'ts Best Practices

Quick Revision Summary

⚠️ Common Beginner Mistakes & Gotchas

1. Forgetting to Close Files (Leaking File Handles)

2. Accidental Overwrite in 'w' Mode

Practice Quiz

1. What happens if you call file.write(500) where file is opened in text write mode?

2. What distinguishes .write() from print() regarding newline characters?

3. If lines = ["Apple", "Banana", "Cherry"], what will appear in a file written with f.writelines(lines)?

4. Which technique is most memory-efficient for reading a 20 GB web server access log in Python?

5. Why is .strip() frequently called on lines during file reading (e.g. for line in f: clean_line = line.strip())?

Practice Challenge: Student Examination Roll List Generator & Parser

Requirements:

Complete Solution

🚀 What's Next?

Working with open()

Related Lessons

Practice Quiz

Reading and Writing Text Files in Python: `write()`, `writelines()`, & Stream Iteration

1. Writing Text to Files: `.write()`

2. Writing Multiple Lines: `.writelines()`

4. Reading Specific Byte Chunks: `f.read(size)`

2. Accidental Overwrite in `'w'` Mode

1. What happens if you call `file.write(500)` where `file` is opened in text write mode?

2. What distinguishes `.write()` from `print()` regarding newline characters?

3. If `lines = ["Apple", "Banana", "Cherry"]`, what will appear in a file written with `f.writelines(lines)`?

5. Why is `.strip()` frequently called on lines during file reading (e.g. `for line in f: clean_line = line.strip()`)?

Reading and Writing Text Files in Python: `write()`, `writelines()`, & Stream Iteration

1. Writing Text to Files: `.write()`

2. Writing Multiple Lines: `.writelines()`

4. Reading Specific Byte Chunks: `f.read(size)`

2. Accidental Overwrite in `'w'` Mode

1. What happens if you call `file.write(500)` where `file` is opened in text write mode?

2. What distinguishes `.write()` from `print()` regarding newline characters?

3. If `lines = ["Apple", "Banana", "Cherry"]`, what will appear in a file written with `f.writelines(lines)`?

5. Why is `.strip()` frequently called on lines during file reading (e.g. `for line in f: clean_line = line.strip()`)?