CSV library basics in Ruby - Step-by-Step Execution

Concept Flow - CSV library basics

Start

↓

Require CSV library

↓

Open or create CSV file

↓

Read or write rows

↓

Process each row

↓

Close file

↓

End

This flow shows how Ruby uses the CSV library to open a file, read or write rows, process them, and then close the file.

Execution Sample

Ruby

require 'csv'

CSV.open('data.csv', 'w') do |csv|
  csv << ['Name', 'Age']
  csv << ['Alice', 30]
end

This code creates a CSV file named 'data.csv' and writes two rows: a header and one data row.

Execution Table

Step	Action	CSV Object State	Output/File Content
1	Require CSV library	CSV module loaded	No output
2	Open 'data.csv' for writing	CSV file opened, ready to write	File created or emptied
3	Write row ['Name', 'Age']	CSV has 1 row	Name,Age
4	Write row ['Alice', 30]	CSV has 2 rows	Name,Age Alice,30
5	Close file after block ends	CSV file closed	File saved with 2 rows
6	End of program	No active CSV file	Final file content: Name,Age Alice,30

💡 CSV file closed after writing rows, program ends.

Variable Tracker

Variable	Start	After Step 3	After Step 4	Final
csv	nil	CSV object open with 1 row	CSV object open with 2 rows	nil (closed)

Key Moments - 2 Insights

Why do we use a block with CSV.open instead of just opening the file?

Using a block ensures the CSV file is automatically closed after the block finishes, as shown in execution_table step 5.

What does the << operator do with the csv object?

It adds a new row to the CSV file, shown in steps 3 and 4 where rows are added to the file.

Visual Quiz - 3 Questions

Look at the execution table, what is the CSV file content after step 3?

A "Name,Age "

B "Alice,30 "

C "Name,Age Alice,30 "

D "" (empty)

💡 Hint

Check the 'Output/File Content' column at step 3 in the execution_table.

At which step is the CSV file closed?

A Step 3

B Step 5

C Step 4

D Step 6

💡 Hint

Look for 'Close file' action in the execution_table.

If we add another csv << ['Bob', 25] after step 4, what will be the final file content?

A "Alice,30 Bob,25 "

B "Name,Age Bob,25 "

C "Name,Age Alice,30 Bob,25 "

D "Name,Age Alice,30 "

💡 Hint

Adding a row appends it to the CSV file content as shown in steps 3 and 4.

Concept Snapshot

require 'csv' to use CSV features
Use CSV.open(filename, mode) with a block to open file
Inside block, use csv << [row] to add rows
Block auto-closes file when done
Rows are arrays representing CSV lines

Full Transcript

This visual execution shows how Ruby's CSV library works. First, the CSV library is loaded. Then, the program opens a CSV file named 'data.csv' for writing. It writes a header row ['Name', 'Age'] and a data row ['Alice', 30]. Each row is added using the << operator on the csv object. After the block ends, the CSV file is automatically closed and saved. The variable 'csv' holds the CSV object while writing and becomes nil after closing. Key points include using a block to ensure the file closes safely and understanding that each << adds a new row. The execution table tracks each step, showing the file content growing line by line.