Hash as named parameters pattern in Ruby - Mini Project: Build & Apply

Hash as Named Parameters Pattern in Ruby

📖 Scenario: You are building a simple greeting system where users can provide their name and optional details like age and city. You want to use a Ruby method that accepts these details as named parameters using a hash.

🎯 Goal: Create a Ruby method that uses a hash as named parameters to greet a user with their name and optionally include their age and city in the greeting.

📋 What You'll Learn

Create a method called greet_user that accepts a single hash parameter named details.

The details hash must have a required key :name.

Optionally, the details hash can have keys :age and :city.

Inside the method, build a greeting string that always includes the :name.

If :age is provided, include it in the greeting.

If :city is provided, include it in the greeting.

Call the method with different hashes to test the greetings.

💡 Why This Matters

🌍 Real World

Using hashes as named parameters is common in Ruby gems and libraries to allow flexible method calls with optional settings.

💼 Career

Understanding this pattern helps you read and write Ruby code that is clean, flexible, and easy to maintain, which is valuable in Ruby development jobs.

1

Create the greet_user method with a details hash parameter

Write a method called greet_user that takes one parameter named details. Inside the method, create a variable greeting and set it to the string "Hello, " plus the value of details[:name].

Ruby

def greet_user(details)
  # Your code here
end

Hint

Use details[:name] to access the name from the hash.

2

Add optional age and city to the greeting inside greet_user

Inside the greet_user method, add code to check if details[:age] exists. If it does, append ", age " plus the age to the greeting string. Then check if details[:city] exists. If it does, append ", from " plus the city to the greeting string.

Ruby

def greet_user(details)
  greeting = "Hello, " + details[:name]
  # Your code here
end

Hint

Use if details[:age] and if details[:city] to check for optional keys.

3

Return the greeting string from the method

Modify the greet_user method to return the greeting string at the end.

Ruby

def greet_user(details)
  greeting = "Hello, " + details[:name]
  greeting += ", age " + details[:age].to_s if details[:age]
  greeting += ", from " + details[:city] if details[:city]
  # Your code here
end

Hint

Use return greeting to send the greeting string back to the caller.

4

Call greet_user with different hashes and print the results

Call greet_user with the hash {name: "Alice"} and print the result. Then call it with {name: "Bob", age: 30} and print the result. Finally, call it with {name: "Carol", city: "Paris"} and print the result.

Ruby

def greet_user(details)
  greeting = "Hello, " + details[:name]
  greeting += ", age " + details[:age].to_s if details[:age]
  greeting += ", from " + details[:city] if details[:city]
  return greeting
end

# Your code here

Hint

Use puts greet_user({name: "Alice"}) to print the greeting.

Practice

1. What is the main advantage of using a hash as named parameters in a Ruby method?

easy

A. It improves the method's execution speed significantly.

B. It forces the method to accept only one argument.

C. It makes the method call clearer by naming each argument explicitly.

D. It prevents any default values from being used.

Solution

1. Step 1: Understand named parameters purpose

   Named parameters improve code readability by explicitly naming each argument passed to a method.

2. Step 2: Compare with other options

   Options B, C, and D are incorrect because using a hash does not limit argument count to one, does not speed up execution notably, and does not prevent default values.

3. Final Answer:

   It makes the method call clearer by naming each argument explicitly. -> Option C

4. Quick Check:

   Named parameters = clearer calls [OK]

Hint: Named parameters improve clarity by naming each argument [OK]

Common Mistakes:

• Thinking it limits arguments to one
• Assuming it speeds up code
• Believing it disables default values

2. Which of the following is the correct syntax to define a method using a hash for named parameters in Ruby?

easy

A. def greet(name: options = {})

B. def greet(name, options = {})

C. def greet(options: {})

D. def greet(options = [])

Solution

1. Step 1: Identify correct method parameter syntax

   In Ruby, to accept named parameters as a hash, you define the method with a parameter defaulting to an empty hash, like options = {}.

2. Step 2: Check each option

   def greet(name, options = {}) uses options = {} correctly. def greet(name: options = {}) uses invalid syntax. def greet(options: {}) tries to use keyword arguments incorrectly. def greet(options = []) uses an array instead of a hash.

3. Final Answer:

   def greet(name, options = {}) -> Option B

4. Quick Check:

   Hash parameter = options = {} [OK]

Hint: Use options = {} to accept named parameters as a hash [OK]

Common Mistakes:

• Using square brackets [] instead of curly braces {}
• Confusing keyword arguments with hash parameters
• Incorrect syntax like name: options = {}

3. What will be the output of the following Ruby code?

def info(options = {})
  "Name: #{options[:name]}, Age: #{options[:age]}"
end

puts info(name: "Alice", age: 30)

medium

A. Name: , Age:

B. Error: wrong number of arguments

C. Name: {:name=>"Alice"}, Age: {:age=>30}

D. Name: Alice, Age: 30

Solution

1. Step 1: Understand method call with hash named parameters

   The method info accepts a hash options. The call info(name: "Alice", age: 30) passes a hash with keys :name and :age.

2. Step 2: Evaluate string interpolation

   The method returns a string with values from the hash accessed by options[:name] and options[:age], which are "Alice" and 30 respectively.

3. Final Answer:

   Name: Alice, Age: 30 -> Option D

4. Quick Check:

   options[:name], options[:age] = Alice, 30 [OK]

Hint: Access hash keys with options[:key] inside method [OK]

Common Mistakes:

• Expecting error due to multiple arguments
• Confusing hash keys with string keys
• Not using symbol keys for access

4. Identify the error in the following Ruby method using hash named parameters:

def display(options = {})
  puts "Title: #{options[:title]}"
  puts "Author: #{options[:author]}"
end

display(title: "Ruby Guide")

medium

A. It prints Title but prints nothing for Author without error.

B. It raises an error because :author key is missing in options.

C. Syntax error due to missing parentheses in method call.

D. No error; it prints Title and Author correctly.

Solution

1. Step 1: Analyze method call and parameters

   The method display is called with a hash containing only :title. The :author key is missing.

2. Step 2: Understand Ruby hash access behavior

   Accessing a missing key like options[:author] returns nil, which prints as empty string without error.

3. Final Answer:

   It prints Title but prints nothing for Author without error. -> Option A

4. Quick Check:

   Missing key returns nil, no error [OK]

Hint: Missing hash keys return nil, print empty string [OK]

Common Mistakes:

• Expecting a runtime error for missing keys
• Thinking missing keys print 'nil' string
• Assuming syntax error without parentheses

5. Given the method below, how can you modify it to provide a default value of 18 for the :age key if it is not passed?

def person_info(options = {})
  "Name: #{options[:name]}, Age: #{options[:age]}"
end

puts person_info(name: "Bob")

hard

A. Use options[:age] || 18 inside the string interpolation.

B. Set default value in method definition like def person_info(options = {age: 18}).

C. Raise an error if :age is missing to force passing it.

D. Use options.fetch(:age) without default to get 18.

Solution

1. Step 1: Understand default value requirement

   We want to show 18 if :age is missing in options.

2. Step 2: Use Ruby's || operator for default

   Using options[:age] || 18 returns options[:age] if present, otherwise 18.

3. Step 3: Check other options

   Set default value in method definition like def person_info(options = {age: 18}). sets default hash but can be overridden incorrectly. Raise an error if :age is missing to force passing it. raises error, not default. Use options.fetch(:age) without default to get 18. fetch without default raises error if missing.

4. Final Answer:

   Use options[:age] || 18 inside the string interpolation. -> Option A

5. Quick Check:

   Default with || operator = 18 [OK]

Hint: Use options[:key] || default_value for defaults [OK]

Common Mistakes:

• Setting default hash in parameter incorrectly
• Using fetch without default causing error
• Raising error instead of providing default