Asserts that some criteria defined by the matcher is satisfied. Allows a custom message to be used. Returns the expected value cast as the expected type, if the matcher is satisfied.

Extension method to create an expectation for an object. This is part of the spec DSL and mimics Crystal Spec's default should-syntax. A matcher should immediately follow this method, or be the only argument to it. Example usage:

it "equals the expected value" do
  subject.should eq(42)
end

An optional message can be used in case the expectation fails. It can be a string or proc returning a string.

subject.should_not be_nil, "Shouldn't be nil"

NOTE By default, the should-syntax is disabled. The expect-syntax is preferred, since it doesn't monkey-patch all objects. To enable should-syntax, add the following to your spec_helper.cr file:

require "spectator/should"

Works the same as #should except that the condition check is postponed. The expectation is checked after the example finishes and all hooks have run.

Works the same as #should_not except that the condition check is postponed. The expectation is checked after the example finishes and all hooks have run.

Asserts that some criteria defined by the matcher is not satisfied. Allows a custom message to be used. Returns the expected value cast without the unexpected type, if the matcher is satisfied.

Asserts that some criteria defined by the matcher is not satisfied. Allows a custom message to be used. Returns the expected value cast as a non-nillable type, if the matcher is satisfied.

Works the same as #should except the condition is inverted. When #should succeeds, this method will fail, and vice-versa.