Why Enumerable is Ruby's most powerful module - Visual Breakdown

Concept Flow - Why Enumerable is Ruby's most powerful module

Include Enumerable module

↓

Define each method in class

↓

Call Enumerable methods

↓

Enumerable uses each to iterate

↓

Perform operations like map, select, etc.

↓

Return results based on block logic

Enumerable works by requiring an each method, then provides many useful methods that use each to process collections.

Execution Sample

Ruby

class MyCollection
  include Enumerable
  def initialize(items)
    @items = items
  end
  def each
    @items.each { |item| yield item }
  end
end

c = MyCollection.new([1,2,3])
p c.map { |x| x * 2 }

This code shows a custom collection class including Enumerable and using map to double each item.

Execution Table

Step	Action	Evaluation	Result
1	Create MyCollection instance with [1,2,3]	c = MyCollection.new([1,2,3])	c holds [1,2,3]
2	Call c.map with block { |x| x * 2 }	c.map { |x| x * 2 }	Calls Enumerable#map
3	Enumerable#map calls c.each to get items	c.each	Yields 1, 2, 3
4	Block runs on each item	1 * 2	2
5	Block runs on each item	2 * 2	4
6	Block runs on each item	3 * 2	6
7	map collects results	Results array	[2, 4, 6]
8	Return map result	p prints result	[2, 4, 6]

💡 All items processed, map returns new array with doubled values

Variable Tracker

Variable	Start	After 1	After 2	After 3	Final
c	nil	MyCollection([1,2,3])	MyCollection([1,2,3])	MyCollection([1,2,3])	MyCollection([1,2,3])
item (yielded)	none	1	2	3	none
map result	none	[2]	[2,4]	[2,4,6]	[2,4,6]

Key Moments - 3 Insights

Why does Enumerable require the each method to work?

Enumerable methods like map and select use each to get items one by one. Without each, Enumerable can't access elements to process (see execution_table step 3).

How does map produce a new array without explicitly looping?

map calls each internally to get items, then applies the block to each item and collects results automatically (see steps 3 to 7).

What happens if the class does not define each but includes Enumerable?

Enumerable methods will fail because they rely on each to yield items. The class must define each for Enumerable to work.

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of 'item (yielded)' at step 5?

A 1

B 2

C 3

D none

💡 Hint

Check the 'Action' and 'Evaluation' columns at step 5 where the block runs on the second item.

At which step does Enumerable call the each method of MyCollection?

A Step 4

B Step 2

C Step 3

D Step 7

💡 Hint

Look for the step where c.each is invoked to yield items.

If the each method yielded items in reverse order, how would the map result change?

A Result would be [6, 4, 2]

B Result would be [2, 4, 6]

C Result would be empty

D Result would cause an error

💡 Hint

Check variable_tracker for map result and consider order of yielded items.

Concept Snapshot

Enumerable module requires a class to define each.
It provides many useful methods like map, select, reduce.
These methods use each to access elements.
This makes Enumerable powerful and reusable.
Include Enumerable and define each to get many methods for free.

Full Transcript

Enumerable is a Ruby module that adds many helpful methods to classes that include it. To use Enumerable, a class must define an each method that yields items one by one. Enumerable methods like map, select, and reduce then use this each method to process the collection. For example, when calling map on a custom collection, Enumerable calls the class's each method to get each item, applies the block to it, and collects the results. This design makes Enumerable very powerful because it provides many methods without needing to rewrite iteration logic. If a class includes Enumerable but does not define each, the methods will not work. The example shows a MyCollection class including Enumerable, defining each to yield items from an internal array, and using map to double each item. The execution table traces each step, showing how each item is yielded and processed. The variable tracker shows how variables change during execution. Key moments clarify why each is required and how map works internally. The quiz tests understanding of the execution steps and effects of changing each. Overall, Enumerable's power comes from combining a simple each method with many useful iteration methods.