class RuboCop::Cop::RSpec::DescribedClass
Checks that tests use `described_class`.
If the first argument of describe is a class, the class is exposed to each example via described_class.
This cop can be configured using the `EnforcedStyle` option
@example `EnforcedStyle: described_class`
# bad describe MyClass do subject { MyClass.do_something } end # good describe MyClass do subject { described_class.do_something } end
@example `EnforcedStyle: explicit`
# bad describe MyClass do subject { described_class.do_something } end # good describe MyClass do subject { MyClass.do_something } end
Constants
- DESCRIBED_CLASS
- MSG
Public Instance Methods
autocorrect(node)
click to toggle source
# File lib/rubocop/cop/rspec/described_class.rb, line 68 def autocorrect(node) replacement = if style == :described_class DESCRIBED_CLASS else @described_class.const_name end lambda do |corrector| corrector.replace(node.loc.expression, replacement) end end
on_block(node)
click to toggle source
# File lib/rubocop/cop/rspec/described_class.rb, line 51 def on_block(node) # In case the explicit style is used, we needs to remember what's # being described. Thus, we use an ivar for @described_class. describe, @described_class, body = described_constant(node) return if body.nil? return unless top_level_describe?(describe) find_usage(body) do |match| add_offense( match, location: :expression, message: message(match.const_name) ) end end
Private Instance Methods
find_usage(node) { |node| ... }
click to toggle source
# File lib/rubocop/cop/rspec/described_class.rb, line 81 def find_usage(node, &block) yield(node) if offensive?(node) return if scope_change?(node) || node.const_type? node.each_child_node do |child| find_usage(child, &block) end end
message(offense)
click to toggle source
# File lib/rubocop/cop/rspec/described_class.rb, line 91 def message(offense) if style == :described_class format(MSG, replacement: DESCRIBED_CLASS, src: offense) else format(MSG, replacement: @described_class.const_name, src: DESCRIBED_CLASS) end end
offensive?(node)
click to toggle source
# File lib/rubocop/cop/rspec/described_class.rb, line 114 def offensive?(node) if style == :described_class node.eql?(@described_class) else node.send_type? && node.method_name == :described_class end end
scope_change?(node)
click to toggle source
# File lib/rubocop/cop/rspec/described_class.rb, line 100 def scope_change?(node) scope_changing_syntax?(node) || common_instance_exec_closure?(node) || skippable_block?(node) end
skip_blocks?()
click to toggle source
# File lib/rubocop/cop/rspec/described_class.rb, line 110 def skip_blocks? cop_config['SkipBlocks'].equal?(true) end
skippable_block?(node)
click to toggle source
# File lib/rubocop/cop/rspec/described_class.rb, line 106 def skippable_block?(node) node.block_type? && !rspec_block?(node) && skip_blocks? end