transpec 1.1.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e4b8ad9709db52ce5becc1fe21c78454138667a5
-  data.tar.gz: 91977cdc9490c4fd3878769d0308cc01f551a7ff
+  metadata.gz: e113c8ac0e1041e1b1704f1119af7e1dc57567ad
+  data.tar.gz: 5f531ea384b0ff31c32126bf03cc88d69474c2bd
 SHA512:
-  metadata.gz: 1656fc0b87a530e09d986213f76cb3ec52efd78d7fc5106ddb4d555461f8699ad10f2bd23c4fe4b8ca49a3fe78bd926b2123231e95a9cefc6ce69bf9cc5ec6db
-  data.tar.gz: efa265154035cc620e19e4b7ce0e87345337c152f34f737a87c85820d96e02421002b5f596292ab9ceba1810292f8dfb3b53314168050719c69e195905eef2b3
+  metadata.gz: 4dda416fa2df40afd219d2b78b0c7420c0850cec9c31d3607fec6c3623bf38a712a778c428fda819a9b1cf1d8370be8a43042e40763e299ad65fd306e5525d2a
+  data.tar.gz: 67de6752f2ea60e243c850efa449a807be0d52cb8f4d3d25182b89c52599788f8e40b244c7f5ec20dc980b4e46634a338c37fd3989789309d7ab248ff4522c4c

data/.gitignore

@@ -12,7 +12,6 @@ lib/bundler/man
 pkg
 rdoc
 spec/reports
-spec/cache
 test/tmp
 test/version_tmp
 tmp

data/.rubocop.yml

@@ -50,4 +50,4 @@ IndentationWidth:
 
 # TODO: Shorten to 100.
 ClassLength:
-  Max: 194
+  Max: 150

data/CHANGELOG.md

@@ -1,6 +1,14 @@
 # Changelog
 
-## Master
+## Development
+
+## v1.2.0
+
+* Transpec is now ready for RSpec 2.99 and 3.0 beta!
+* Support conversion to `allow(obj).to receive_messages(:message => value)` ([#6](https://github.com/yujinakayama/transpec/issues/6))
+* Support conversion to `be_truthy` / `be_falsey` ([#8](https://github.com/yujinakayama/transpec/issues/8))
+* Add `-b/--boolean-matcher` option that allows to specify matcher type that `be_true` and `be_false` will be converted to
+* Abort if a target project's `rspec` gem dependency is older than the version required by Transpec
 
 ## v1.1.2
 
@@ -12,7 +20,7 @@
 
 ## v1.1.0
 
-* Support conversion of `its` (#9)
+* Support conversion of `its` ([#9](https://github.com/yujinakayama/transpec/issues/9))
 
 ## v1.0.0
 

data/Guardfile

@@ -1,7 +1,7 @@
 # A sample Guardfile
 # More info at https://github.com/guard/guard#readme
 
-guard :rspec, all_after_pass: true, all_on_start: true, keep_failed: true do
+guard :rspec, all_after_pass: true, all_on_start: true, keep_failed: true, cmd: 'bundle exec rspec' do
   watch(%r{^spec/.+_spec\.rb$})
   watch(%r{^lib/(.+)\.rb$})        { |m| "spec/#{m[1]}_spec.rb" }
   watch('spec/spec_helper.rb')     { "spec" }

data/README.md

@@ -4,7 +4,7 @@
 
 **Transpec** automatically converts your specs into latest [RSpec](http://rspec.info/) syntax with static and dynamic code analysis.
 
-This aims to facilitate smooth transition to RSpec 3.
+This aims to facilitate smooth transition to RSpec 3, and Transpec is now ready for RSpec 2.99 and 3.0 beta!
 
 See the following pages for the new RSpec syntax and the plan for RSpec 3:
 
@@ -354,6 +354,39 @@ expect([1, 2, 3]).to match_array([2, 1, 3])
 
 * See also: [(Almost) All Matchers Are Supported - RSpec's New Expectation Syntax](http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax#almost_all_matchers_are_supported)
 
+### Boolean matchers
+
+**This conversion is available only if your project has `rspec` gem dependency `2.99` or later.**
+
+```ruby
+# Targets
+expect(obj).to be_true
+expect(obj).to be_false
+
+# Converted
+expect(obj).to be_truthy
+expect(obj).to be_falsey
+
+# With `--boolean-matcher truthy,falsy`
+# be_falsy is just an alias of be_falsey.
+expect(obj).to be_truthy
+expect(obj).to be_falsy
+
+# With `--boolean-matcher true,false`
+expect(obj).to be true
+expect(obj).to be false
+```
+
+* `be_true` matcher passes if expectation subject is _truthy_ in conditional semantics. (i.e. all objects except `false` and `nil`)
+* `be_false` matcher passes if expectation subject is _falsey_ in conditional semantics. (i.e. `false` or `nil`)
+* `be_truthy` and `be_falsey` matchers are renamed version of `be_true` and `be_false` and their behaviors are same.
+* `be true` and `be false` are not new things. These are combinations of `be` matcher and boolean literals. These pass if expectation subject is exactly equal to boolean value.
+
+So, converting `be_true`/`be_false` to `be_truthy`/`be_falsey` never breaks your specs and this is the Transpec's default. If you are willing to test boolean values strictly, you can convert them to `be true`/`be false` with `--boolean-matcher true,false` option. Note that this may break your specs if your library codes don't return exact boolean values.
+
+* Disabled by: `--keep deprecated`
+* See also: [Consider renaming `be_true` and `be_false` to `be_truthy` and `be_falsey` · rspec/rspec-expectations](https://github.com/rspec/rspec-expectations/issues/283)
+
 ### `be_close` matcher
 
 ```ruby
@@ -485,14 +518,20 @@ allow(obj).to receive(:foo)
 
 allow(obj).to receive(:foo)
 
+# If the target project's rspec gem dependency is prior to 3.0
 allow(obj).to receive(:foo).and_return(1)
 allow(obj).to receive(:bar).and_return(2)
 
+# If the target project's rspec gem dependency is 3.0 or later
+allow(obj).to receive_messages(:foo => 1, :bar => 2)
+
 allow_any_instance_of(SomeClass).to receive(:foo)
 ```
 
 * Disabled by: `--keep stub`
-* See also: [RSpec's new message expectation syntax - Tea is awesome.](http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/)
+* See also:
+    * [RSpec's new message expectation syntax - Tea is awesome.](http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/)
+    * [allow receive with multiple methods · rspec/rspec-mocks](https://github.com/rspec/rspec-mocks/issues/368)
 
 ### Deprecated method stub aliases
 

data/README.md.erb

@@ -4,7 +4,7 @@
 
 **Transpec** automatically converts your specs into latest [RSpec](http://rspec.info/) syntax with static and dynamic code analysis.
 
-This aims to facilitate smooth transition to RSpec 3.
+This aims to facilitate smooth transition to RSpec 3, and Transpec is now ready for RSpec 2.99 and 3.0 beta!
 
 See the following pages for the new RSpec syntax and the plan for RSpec 3:
 
@@ -82,7 +82,7 @@ $ gem install transpec
 
 Before converting your specs:
 
-* Make sure your project has `rspec` gem dependency `<%= rspec_version %>` or later. If not, change your `*.gemspec` or `Gemfile` to do so.
+* Make sure your project has `rspec` gem dependency `<%= Transpec.required_rspec_version %>` or later. If not, change your `*.gemspec` or `Gemfile` to do so.
 * Run `rspec` and check if all the specs pass.
 * Ensure the Git repository is clean. (You don't want to mix up your changes and Transpec's changes, right?)
 
@@ -350,6 +350,39 @@ expect([1, 2, 3]).to match_array([2, 1, 3])
 
 * See also: [(Almost) All Matchers Are Supported - RSpec's New Expectation Syntax](http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax#almost_all_matchers_are_supported)
 
+### Boolean matchers
+
+**This conversion is available only if your project has `rspec` gem dependency `2.99` or later.**
+
+```ruby
+# Targets
+expect(obj).to be_true
+expect(obj).to be_false
+
+# Converted
+expect(obj).to be_truthy
+expect(obj).to be_falsey
+
+# With `--boolean-matcher truthy,falsy`
+# be_falsy is just an alias of be_falsey.
+expect(obj).to be_truthy
+expect(obj).to be_falsy
+
+# With `--boolean-matcher true,false`
+expect(obj).to be true
+expect(obj).to be false
+```
+
+* `be_true` matcher passes if expectation subject is _truthy_ in conditional semantics. (i.e. all objects except `false` and `nil`)
+* `be_false` matcher passes if expectation subject is _falsey_ in conditional semantics. (i.e. `false` or `nil`)
+* `be_truthy` and `be_falsey` matchers are renamed version of `be_true` and `be_false` and their behaviors are same.
+* `be true` and `be false` are not new things. These are combinations of `be` matcher and boolean literals. These pass if expectation subject is exactly equal to boolean value.
+
+So, converting `be_true`/`be_false` to `be_truthy`/`be_falsey` never breaks your specs and this is the Transpec's default. If you are willing to test boolean values strictly, you can convert them to `be true`/`be false` with `--boolean-matcher true,false` option. Note that this may break your specs if your library codes don't return exact boolean values.
+
+* Disabled by: `--keep deprecated`
+* See also: [Consider renaming `be_true` and `be_false` to `be_truthy` and `be_falsey` · rspec/rspec-expectations](https://github.com/rspec/rspec-expectations/issues/283)
+
 ### `be_close` matcher
 
 ```ruby
@@ -481,14 +514,20 @@ allow(obj).to receive(:foo)
 
 allow(obj).to receive(:foo)
 
+# If the target project's rspec gem dependency is prior to 3.0
 allow(obj).to receive(:foo).and_return(1)
 allow(obj).to receive(:bar).and_return(2)
 
+# If the target project's rspec gem dependency is 3.0 or later
+allow(obj).to receive_messages(:foo => 1, :bar => 2)
+
 allow_any_instance_of(SomeClass).to receive(:foo)
 ```
 
 * Disabled by: `--keep stub`
-* See also: [RSpec's new message expectation syntax - Tea is awesome.](http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/)
+* See also:
+    * [RSpec's new message expectation syntax - Tea is awesome.](http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/)
+    * [allow receive with multiple methods · rspec/rspec-mocks](https://github.com/rspec/rspec-mocks/issues/368)
 
 ### Deprecated method stub aliases
 

data/lib/transpec/cli.rb

@@ -6,18 +6,20 @@ require 'transpec/converter'
 require 'transpec/dynamic_analyzer'
 require 'transpec/file_finder'
 require 'transpec/option_parser'
+require 'transpec/project'
 require 'transpec/report'
 require 'rainbow'
 
 module Transpec
   class CLI
-    attr_reader :configuration
+    attr_reader :project, :configuration, :report
 
     def self.run(args = ARGV)
       new.run(args)
     end
 
     def initialize
+      @project = Project.new
       @configuration = Configuration.new
       @report = Report.new
     end
@@ -60,7 +62,7 @@ module Transpec
     def convert_file(file_path, runtime_data = nil)
       puts "Converting #{file_path}"
 
-      converter = Converter.new(@configuration, runtime_data, @report)
+      converter = Converter.new(@configuration, @project.rspec_version, runtime_data, @report)
       converter.convert_file!(file_path)
 
       @report.invalid_context_errors.concat(converter.invalid_context_errors)
@@ -76,11 +78,16 @@ module Transpec
     private
 
     def fail_if_should_not_continue!
-      return if @configuration.forced?
-      return unless Git.command_available?
-      return unless Git.inside_of_repository?
-      return if Git.clean?
-      fail 'The current Git repository is not clean. Aborting.'
+      unless @configuration.forced?
+        if Git.command_available? && Git.inside_of_repository? && !Git.clean?
+          fail 'The current Git repository is not clean. Aborting.'
+        end
+      end
+
+      if @project.rspec_version < Transpec.required_rspec_version
+        fail "Your project must have rspec gem dependency #{Transpec.required_rspec_version} " +
+             "or later but currently it's #{@project.rspec_version}. Aborting."
+      end
     end
 
     def display_summary
@@ -109,6 +116,8 @@ module Transpec
     end
 
     def display_final_guide
+      return if @report.records.empty?
+
       puts
       puts "Done! Now run #{'rspec'.bright} and check if all the converted specs pass."
     end

data/lib/transpec/configuration.rb

@@ -3,6 +3,8 @@
 module Transpec
   class Configuration
     NEGATIVE_FORMS_OF_TO = ['not_to', 'to_not'].freeze
+    FORMS_OF_BE_FALSEY = ['be_falsey', 'be_falsy'].freeze
+    BOOLEAN_MATCHER_TYPES = [:conditional, :exact].freeze
 
     PREDICATES = [
       [:convert_should,            true],
@@ -22,7 +24,7 @@ module Transpec
       alias_method predicate.to_s + '?', predicate
     end
 
-    attr_accessor :negative_form_of_to, :rspec_command
+    attr_accessor :negative_form_of_to, :boolean_matcher_type, :form_of_be_falsey, :rspec_command
 
     def initialize
       PREDICATES.each do |predicate, default_value|
@@ -30,16 +32,32 @@ module Transpec
       end
 
       self.negative_form_of_to = 'not_to'
+      self.boolean_matcher_type = :conditional
+      self.form_of_be_falsey = 'be_falsey'
     end
 
     def negative_form_of_to=(form)
-      unless NEGATIVE_FORMS_OF_TO.include?(form.to_s)
-        message = 'Negative form of "to" must be either '
-        message << NEGATIVE_FORMS_OF_TO.map(&:inspect).join(' or ')
-        fail ArgumentError, message
-      end
-
+      validate!(form.to_s, NEGATIVE_FORMS_OF_TO, 'Negative form of "to"')
       @negative_form_of_to = form.to_s.freeze
     end
+
+    def boolean_matcher_type=(type)
+      validate!(type.to_sym, BOOLEAN_MATCHER_TYPES, 'Boolean matcher type')
+      @boolean_matcher_type = type.to_sym
+    end
+
+    def form_of_be_falsey=(form)
+      validate!(form.to_s, FORMS_OF_BE_FALSEY, 'Form of "be_falsey"')
+      @form_of_be_falsey = form.to_s.freeze
+    end
+
+    private
+
+    def validate!(arg, valid_values, subject)
+      return if valid_values.include?(arg)
+      message = "#{subject} must be either "
+      message << valid_values.map(&:inspect).join(' or ')
+      fail ArgumentError, message
+    end
   end
 end

data/lib/transpec/converter.rb

@@ -3,7 +3,9 @@
 require 'transpec/base_rewriter'
 require 'transpec/configuration'
 require 'transpec/report'
+require 'transpec/rspec_version'
 require 'transpec/syntax'
+require 'transpec/syntax/be_boolean'
 require 'transpec/syntax/be_close'
 require 'transpec/syntax/double'
 require 'transpec/syntax/expect'
@@ -16,13 +18,14 @@ require 'transpec/syntax/should_receive'
 
 module Transpec
   class Converter < BaseRewriter
-    attr_reader :configuration, :runtime_data, :report, :invalid_context_errors
+    attr_reader :configuration, :rspec_version, :runtime_data, :report, :invalid_context_errors
 
     alias_method :convert_file!, :rewrite_file!
     alias_method :convert, :rewrite
 
-    def initialize(configuration = nil, runtime_data = nil, report = nil)
+    def initialize(configuration = nil, rspec_version = nil, runtime_data = nil, report = nil)
       @configuration = configuration || Configuration.new
+      @rspec_version = rspec_version || Transpec.current_rspec_version
       @runtime_data = runtime_data
       @report = report || Report.new
       @invalid_context_errors = []
@@ -92,7 +95,7 @@ module Transpec
 
     def process_method_stub(method_stub)
       if @configuration.convert_stub?
-        method_stub.allowize!
+        method_stub.allowize!(@rspec_version.receive_messages_available?)
       elsif @configuration.convert_deprecated_method?
         method_stub.convert_deprecated_method!
       end
@@ -100,6 +103,18 @@ module Transpec
       method_stub.remove_allowance_for_no_message! if @configuration.convert_deprecated_method?
     end
 
+    def process_be_boolean(be_boolean)
+      return unless @rspec_version.be_truthy_available?
+      return unless @configuration.convert_deprecated_method?
+
+      case @configuration.boolean_matcher_type
+      when :conditional
+        be_boolean.convert_to_conditional_matcher!(@configuration.form_of_be_falsey)
+      when :exact
+        be_boolean.convert_to_exact_matcher!
+      end
+    end
+
     def process_be_close(be_close)
       be_close.convert_to_be_within! if @configuration.convert_deprecated_method?
     end

data/lib/transpec/dynamic_analyzer.rb

@@ -1,8 +1,9 @@
 # coding: utf-8
 
-require 'transpec/file_finder'
 require 'transpec/dynamic_analyzer/rewriter'
 require 'transpec/dynamic_analyzer/runtime_data'
+require 'transpec/file_finder'
+require 'transpec/project'
 require 'tmpdir'
 require 'fileutils'
 require 'ostruct'
@@ -71,11 +72,11 @@ module Transpec
       end
     END
 
-    attr_reader :project_path, :rspec_command, :silent
+    attr_reader :project, :rspec_command, :silent
     alias_method :silent?, :silent
 
     def initialize(options = {})
-      @project_path = options[:project_path] || Dir.pwd
+      @project = options[:project] || Project.new
       @rspec_command = options[:rspec_command] || default_rspec_command
       @silent = options[:silent] || false
 
@@ -87,17 +88,13 @@ module Transpec
     end
 
     def default_rspec_command
-      if project_requires_bundler?
+      if @project.require_bundler?
         'bundle exec rspec'
       else
         'rspec'
       end
     end
 
-    def project_requires_bundler?
-      File.exist?('Gemfile')
-    end
-
     def analyze(paths = [])
       in_copied_project do
         rewriter = Rewriter.new
@@ -127,8 +124,8 @@ module Transpec
       @in_copied_project = true
 
       Dir.mktmpdir do |tmpdir|
-        FileUtils.cp_r(@project_path, tmpdir)
-        @copied_project_path = File.join(tmpdir, File.basename(@project_path))
+        FileUtils.cp_r(@project.path, tmpdir)
+        @copied_project_path = File.join(tmpdir, @project.basename)
         Dir.chdir(@copied_project_path) do
           yield
         end
@@ -138,7 +135,7 @@ module Transpec
     end
 
     def run_rspec(paths)
-      with_bundler_clean_env do
+      @project.with_bundler_clean_env do
         ENV['SPEC_OPTS'] = ['-r', "./#{HELPER_FILE}"].shelljoin
 
         command = "#{rspec_command} #{paths.shelljoin}"
@@ -159,17 +156,5 @@ module Transpec
         end
       end
     end
-
-    def with_bundler_clean_env
-      if defined?(Bundler) && project_requires_bundler?
-        Bundler.with_clean_env do
-          # Bundler.with_clean_env cleans environment variables
-          # which are set after bundler is loaded.
-          yield
-        end
-      else
-        yield
-      end
-    end
   end
 end

data/lib/transpec/option_parser.rb

@@ -8,7 +8,7 @@ require 'rainbow'
 
 module Transpec
   class OptionParser
-    CONFIG_ATTRS_FOR_CLI_TYPES = {
+    CONFIG_ATTRS_FOR_KEEP_TYPES = {
               should: :convert_should=,
       should_receive: :convert_should_receive=,
                 stub: :convert_stub=,
@@ -17,10 +17,12 @@ module Transpec
           deprecated: :convert_deprecated_method=
     }
 
+    VALID_BOOLEAN_MATCHER_TYPES = %w(truthy,falsey truthy,falsy true,false)
+
     attr_reader :configuration
 
     def self.available_conversion_types
-      CONFIG_ATTRS_FOR_CLI_TYPES.keys
+      CONFIG_ATTRS_FOR_KEEP_TYPES.keys
     end
 
     def initialize(configuration = Configuration.new)
@@ -66,7 +68,7 @@ module Transpec
 
       define_option('-k', '--keep TYPE[,TYPE...]') do |types|
         types.split(',').each do |type|
-          config_attr = CONFIG_ATTRS_FOR_CLI_TYPES[type.to_sym]
+          config_attr = CONFIG_ATTRS_FOR_KEEP_TYPES[type.to_sym]
           fail ArgumentError, "Unknown syntax type #{type.inspect}" unless config_attr
           @configuration.send(config_attr, false)
         end
@@ -76,6 +78,15 @@ module Transpec
         @configuration.negative_form_of_to = form
       end
 
+      define_option('-b', '--boolean-matcher TYPE') do |type|
+        unless VALID_BOOLEAN_MATCHER_TYPES.include?(type)
+          types = VALID_BOOLEAN_MATCHER_TYPES.map(&:inspect).join(', ')
+          fail ArgumentError, "Boolean matcher type must be any of #{types}"
+        end
+        @configuration.boolean_matcher_type = type.include?('truthy') ? :conditional : :exact
+        @configuration.form_of_be_falsey = type.include?('falsy') ? 'be_falsy' : 'be_falsey'
+      end
+
       define_option('-p', '--no-parentheses-matcher-arg') do
         @configuration.parenthesize_matcher_arg = false
       end
@@ -142,6 +153,14 @@ module Transpec
           "Either #{'not_to'.bright} or #{'to_not'.bright}.",
           "Default: #{'not_to'.bright}"
         ],
+        '-b' => [
+          "Specify matcher type that #{'be_true'.underline} and",
+          "#{'be_false'.underline} will be converted to.",
+          "  #{'truthy,falsey'.bright} (conditional semantics)",
+          "  #{'truthy,falsy'.bright}  (alias of #{'falsey'.underline})",
+          "  #{'true,false'.bright}    (exact equality)",
+          "Default: #{'truthy,falsey'.bright}"
+        ],
         '-p' => [
           'Suppress parenthesizing argument of matcher',
           'when converting operator to non-operator in',

data/lib/transpec/project.rb

@@ -0,0 +1,49 @@
+# coding: utf-8
+
+require 'transpec/rspec_version'
+
+module Transpec
+  class Project
+    attr_reader :path
+
+    def initialize(path = Dir.pwd)
+      @path = path
+    end
+
+    def basename
+      File.basename(@path)
+    end
+
+    def require_bundler?
+      gemfile_path = File.join(@path, 'Gemfile')
+      File.exist?(gemfile_path)
+    end
+
+    def rspec_version
+      @rspec_version ||= begin
+        command = 'rspec --version'
+        command = 'bundle exec ' + command if require_bundler?
+
+        version_string = nil
+
+        Dir.chdir(@path) do
+          with_bundler_clean_env { version_string = `#{command}`.chomp }
+        end
+
+        RSpecVersion.new(version_string)
+      end
+    end
+
+    def with_bundler_clean_env
+      if defined?(Bundler) && require_bundler?
+        Bundler.with_clean_env do
+          # Bundler.with_clean_env cleans environment variables
+          # which are set after bundler is loaded.
+          yield
+        end
+      else
+        yield
+      end
+    end
+  end
+end

data/lib/transpec/rspec_version.rb

@@ -0,0 +1,25 @@
+# coding: utf-8
+
+require 'transpec'
+
+module Transpec
+  class RSpecVersion < Gem::Version
+    # http://www.ruby-doc.org/stdlib-2.0.0/libdoc/rubygems/rdoc/Gem/Version.html
+    #
+    # If any part contains letters (currently only a-z are supported) then that version is
+    # considered prerelease.
+    # Prerelease parts are sorted alphabetically using the normal Ruby string sorting rules.
+    # If a prerelease part contains both letters and numbers, it will be broken into multiple parts
+    # to provide expected sort behavior (1.0.a10 becomes 1.0.a.10, and is greater than 1.0.a9).
+    VERSION_2_99 = new('2.99.aaaaaaaaaa')
+    VERSION_3_0  = new('3.0.aaaaaaaaaa')
+
+    def be_truthy_available?
+      self >= VERSION_2_99
+    end
+
+    def receive_messages_available?
+      self >= VERSION_3_0
+    end
+  end
+end

data/lib/transpec/syntax/be_boolean.rb

@@ -0,0 +1,38 @@
+# coding: utf-8
+
+require 'transpec/syntax'
+require 'transpec/syntax/mixin/send'
+
+module Transpec
+  class Syntax
+    class BeBoolean < Syntax
+      include Mixin::Send
+
+      def self.target_method?(receiver_node, method_name)
+        receiver_node.nil? && [:be_true, :be_false].include?(method_name)
+      end
+
+      def be_true?
+        method_name == :be_true
+      end
+
+      def convert_to_conditional_matcher!(form_of_be_falsey = 'be_falsey')
+        replacement = be_true? ? 'be_truthy' : form_of_be_falsey
+        replace(expression_range, replacement)
+        register_record(replacement)
+      end
+
+      def convert_to_exact_matcher!
+        replacement = be_true? ? 'be true' : 'be false'
+        replace(expression_range, replacement)
+        register_record(replacement)
+      end
+
+      private
+
+      def register_record(converted_syntax)
+        @report.records << Record.new(method_name.to_s, converted_syntax)
+      end
+    end
+  end
+end