I was building a class yesterday and I wanted the instantiation process of the class
to be self-documenting so I decided to use a keyword argument in the
1 2 3 4 5 class HallMonitor def initialize(user: nil) @user = user end end
As you can see, I also decided to make the
user keyword argument optional by
making it default to nil.
Later while pairing and refactoring the implementation of the class and the associated specs, I forgot about my fancy keyword argument and simply wrote the following:
This raised the following error:
1 ArgumentError: wrong number of arguments (1 for 0)
I was confused for a second. I hesitated, then said "it makes no sense" out loud
because I remembered making the
user argument optional. Of course I had misread
the exception as "wrong number of arguments (0 for 1)", which it wasn't.
Then I went back to the class, looked up the method definitation and went "aaaahhh!".
But here, Ruby could have been far more helpful to me. It made sense before we had keyword arguments for Ruby to respond with an exception that would just compare the number of provided arguments against the number of required arguments. Nowadays we have keyword arguments, Ruby can tell us exactly what argument is missing and what its name is (if we use keyword arguments of course), so why not throw this exception instead:
1 ArgumentError: wrong number of arguments (1 for 0), keyword arguments: [user: nil]
This kind of simple error feedback improvements, similar to one proposed by Richard Schneeman earlier this year would probably save a Rubyists time debugging simple mistakes. And that's bound to make them happier, isn't it?