- Define keyword arguments and learn why they are useful
- Define mass assignment and learn why it is useful
- Practice using keyword arguments and mass assignment
At this point, we're very familiar with the fact that methods can be defined to take in arguments. We also know that methods can be defined to take in multiple arguments. Let's take a look at an example:
def print_name_and_greeting(greeting, name)
puts "#{greeting}, #{name}"
end
print_name_and_greeting("'sup", "Hillary")
# 'sup, Hillary
# => nil
As it currently stands, whoever uses our method needs to remember exactly what order to pass in the arguments. They need to know that the first argument is greeting and the second argument is a name. Arguments defined this way are known as positional arguments, because the position they are passed in makes a difference when the function is called.
What happens if another developer who is working on our code base doesn't see the file where the method is defined, but only sees the method being invoked? Maybe it's not clear to them which argument is which โ after all, when you invoke methods, the arguments aren't labeled or anything. Let's take a look at what type of disaster would befall us:
print_name_and_greeting("Kanye", "hello")
# Kanye, hello
# => nil
That would be a weird way to greet Kanye. Let's take a look at another example, this time using arguments of two different data types:
def happy_birthday(name, current_age)
puts "Happy Birthday, #{name}"
current_age += 1
puts "You are now #{current_age} years old"
end
happy_birthday("Beyonce", 31)
# Happy Birthday, Beyonce
# You are now 32 years old
# => nil
But what happens if we accidentally pass the arguments in in the wrong order?
happy_birthday(31, "Beyonce")
# Happy Birthday, 31
# TypeError: no implicit conversion of Fixnum into String
Oh no! We broke our program! Clearly, we have a need to regulate the passing in of multiple arguments. It would be especially helpful if we could name the arguments that we pass in, when we invoke the method. Guess what? We can! (Okay, you probably saw that one coming.)
Keyword arguments are a special way of passing arguments into a method. They
behave like hashes, pairing a key that functions as the parameter name, with its
value. Let's walk through it together and refactor our happy_birthday
method:
def happy_birthday(name: "Beyonce", current_age: 31)
puts "Happy Birthday, #{name}"
current_age += 1
puts "You are now #{current_age} years old"
end
Here, we've defined our method to take in keyword arguments. Our keyword
arguments consist of two key/value pairs, :name
and :current_age
. We've
given our keyword arguments default values of "Beyonce"
and 31
, but we
didn't have to:
def happy_birthday(name:, current_age:)
puts "Happy Birthday, #{name}"
current_age += 1
puts "You are now #{current_age} years old"
end
Notice that we can reference name
and current_age
inside our method body, as
if they were barewords, even though they are the keys in our keyword
arguments. That's how keyword arguments work, they allow you to name the
arguments that you pass in as keys in a hash. Then, the method body can use the
values of those keys, referenced by their name. Let's call our method:
happy_birthday(current_age: 31, name: "Carmelo Anthony")
# Happy Birthday, Carmelo Anthony
# You are now 32 years old
Notice that even though we changed the order of our key/value pairs, our method didn't break! Not only is this method more robust (i.e. more resistant to breakage) than the version using positional arguments, it is also more explicit. Anyone looking at its invocation can tell exactly what kind of data you are passing in.
While there are differences in the way they are implemented, Ruby's keyword arguments feature provides similar functionality to parameter destructuring in JavaScript, like you've seen with props destructuring in React. For example, if we define a function in JavaScript that accepts an object as an argument, we can destructure the parameters of that argument in the function definition to make it clear to the callers of that function what data it needs:
function happyBirthday({ name, currentAge }) {
console.log(`Happy Birthday, ${name}`);
currentAge++;
console.log(`You are now ${currentAge} years old`);
}
happyBirthday({ currentAge: 31, name: "Carmelo Anthony" });
// Happy Birthday, Carmelo Anthony
// You are now 32 years old
Another benefit of using keyword arguments is the ability to "mass assign"
attributes to an object. Let's revisit our Person
class from an earlier
lesson. We'd like to initialize individual people with a name and an age:
class Person
attr_accessor :name, :age
def initialize(name, age)
@name = name
@age = age
end
end
As it stands, our initialize method is vulnerable to the same issues we discussed above. Let's refactor it to take in a person's attributes as keyword arguments:
class Person
attr_accessor :name, :age
def initialize(name:, age:)
@name = name
@age = age
end
end
Now, we have the added benefit of being able to use something called mass assignment to instantiate new people objects. If a method is defined to accept keyword arguments, we can create the hash that the method is expecting to accept as an argument, assign that hash to a variable, and simply pass the variable in to the method as an argument. Let's take a look:
person_attributes = { name: "Sophie", age: 26 }
sophie = Person.new(person_attributes)
# => #<Person:0x007f9bd5814ae8 @name="Sophie", @age=26>
Again, in order for this to work, we have to set up the initialize method to use keyword arguments. If it was set up to take positional arguments instead, calling the method as we did above would return an argument error:
ArgumentError: wrong number of arguments (given 1, expected 2)
At this point, it might not seem particularly useful to be able to pass in a hash as an argument. However, as we'll learn in the next lesson, one thing it enables us to do is write our code for initializing instances of a class in a more abstract, flexible and error-proof way. When we start building web applications, we'll understand more about how helpful this approach really is.
Note: Starting with Ruby version 3, the use of a hash for keyword arguments will be deprecated, so the code above will throw an error message. To get around this error, you can use the double splat operator (**) to convert a hash to keyword arguments:
person_attributes = { name: "Sophie", age: 26 }
sophie = Person.new(**person_attributes)
Using keyword arguments makes our Ruby methods more flexible by allowing arguments to be passed in any order, and by allowing our methods to receive a hash of key-value pairs as an argument.