module RSpec::Matchers

Public Instance Methods

a_collection_having(n)
Alias for: have
have(n) click to toggle source

Passes if receiver is a collection with the submitted number of items OR if the receiver OWNS a collection with the submitted number of items.

If the receiver OWNS the collection, you must use the name of the collection. So if a `Team` instance has a collection named `#players`, you must use that name to set the expectation.

If the receiver IS the collection, you can use any name you like for `named_collection`. We'd recommend using either “elements”, “members”, or “items” as these are all standard ways of describing the things IN a collection.

This also works for Strings, letting you set expectations about their lengths.

@example

# Passes if team.players.size == 11
expect(team).to have(11).players

# Passes if [1,2,3].length == 3
expect([1,2,3]).to have(3).items #"items" is pure sugar

# Passes if ['a', 'b', 'c'].count == 3
expect([1,2,3]).to have(3).items #"items" is pure sugar

# Passes if "this string".length == 11
expect("this string").to have(11).characters #"characters" is pure sugar
# File lib/rspec/collection_matchers/matchers.rb, line 33
def have(n)
  RSpec::CollectionMatchers::Have.new(n)
end
Also aliased as: have_exactly, a_collection_having
have_at_least(n) click to toggle source

Exactly like have() with >=.

@example

expect("this").to have_at_least(3).letters

### Warning:

`expect(..).not_to have_at_least` is not supported

# File lib/rspec/collection_matchers/matchers.rb, line 47
def have_at_least(n)
  RSpec::CollectionMatchers::Have.new(n, :at_least)
end
have_at_most(n) click to toggle source

Exactly like have() with <=.

@example

expect("this").to have_at_most(4).letters

### Warning:

`expect(..).not_to have_at_most` is not supported

# File lib/rspec/collection_matchers/matchers.rb, line 59
def have_at_most(n)
  RSpec::CollectionMatchers::Have.new(n, :at_most)
end
have_exactly(n)
Alias for: have