Module: RSpec::Matchers::EnglishPhrasing

Defined in:
lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/rspec-expectations-3.12.2/lib/rspec/matchers/english_phrasing.rb

Overview

Facilitates converting ruby objects to English phrases.

Class Method Summary collapse

Class Method Details

.Array(obj) ⇒ Object

Not sure why, but on travis on 1.8.7 we have gotten these warnings: lib/rspec/matchers/english_phrasing.rb:28: warning: default ‘to_a’ will be obsolete So it appears that ‘Array` can trigger that (e.g. by calling `to_a` on the passed object?) So here we replace `Kernel#Array` with our own warning-free implementation for 1.8.7. rubocop:disable Naming/MethodName



48
49
50
51
52
53
 
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/rspec-expectations-3.12.2/lib/rspec/matchers/english_phrasing.rb', line 48

def self.Array(obj)
  case obj
  when Array then obj
  else [obj]
  end
end

.list(obj) ⇒ Object

Note:

The returned string has a leading space except

when given an empty list.

Converts an object (often a collection of objects) into an English list.

list(['banana', 'kiwi', 'mango'])
#=> " \"banana\", \"kiwi\", and \"mango\""

Given an empty collection, returns the empty string.

list([]) #=> ""



26
27
28
29
30
31
32
33
34
35
36
37
38
39
 
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/rspec-expectations-3.12.2/lib/rspec/matchers/english_phrasing.rb', line 26

def self.list(obj)
  return " #{RSpec::Support::ObjectFormatter.format(obj)}" if !obj || Struct === obj || Hash === obj
  items = Array(obj).map { |w| RSpec::Support::ObjectFormatter.format(w) }
  case items.length
  when 0
    ""
  when 1
    " #{items[0]}"
  when 2
    " #{items[0]} and #{items[1]}"
  else
    " #{items[0...-1].join(', ')}, and #{items[-1]}"
  end
end

.split_words(sym) ⇒ Object

Converts a symbol into an English expression.

split_words(:banana_creme_pie) #=> "banana creme pie"



9
10
11
 
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/rspec-expectations-3.12.2/lib/rspec/matchers/english_phrasing.rb', line 9

def self.split_words(sym)
  sym.to_s.tr('_', ' ')
end