Document and test MethodCall

spec/spectator/mocks/method_call_spec.cr

@@ -0,0 +1,26 @@
+require "../../spec_helper"
+
+Spectator.describe Spectator::MethodCall do
+  let(arguments) { Spectator::Arguments.capture(42, "foobar", foo: :bar) }
+  subject(call) { Spectator::MethodCall.new(:foo, arguments) }
+
+  it "stores the method name" do
+    expect(&.method).to eq(:foo)
+  end
+
+  it "stores arguments" do
+    expect(&.arguments).to eq(arguments)
+  end
+
+  describe ".capture" do
+    subject(call) { Spectator::MethodCall.capture(:foo, 42, "foobar", foo: :bar) }
+
+    it "stores the method name" do
+      expect(&.method).to eq(:foo)
+    end
+
+    it "stores arguments" do
+      expect(&.arguments).to eq(arguments)
+    end
+  end
+end

src/spectator/mocks/method_call.cr

@@ -2,14 +2,19 @@ require "./abstract_arguments"
 require "./arguments"
 
 module Spectator
+  # Stores information about a call to a method.
   class MethodCall
+    # Name of the method.
     getter method : Symbol
 
+    # Arguments passed to the method.
     getter arguments : AbstractArguments
 
+    # Creates a method call.
     def initialize(@method : Symbol, @arguments : Arguments = Arguments.empty)
     end
 
+    # Creates a method call by splatting its arguments.
     def self.capture(method : Symbol, *args, **kwargs)
       arguments = Arguments.new(args, kwargs)
       new(method, arguments)