class RuboCop::Cop::RSpec::ExampleWording
end
it ‘does things’ do
# good
end
it ‘it does things’ do
# bad
@example
end
it ‘finds nothing’ do
# good
end
it ‘should find nothing’ do
# bad
@example
with CustomTransform (e.g. have => has) and IgnoredWords (e.g. only).
The autocorrect is experimental - use with care! It can be configured
@see betterspecs.org/#should<br><br>This cop will correct docstrings that begin with ‘should’ and ‘it’.
Checks for common mistakes in example descriptions.
def add_wording_offense(node, message)
def add_wording_offense(node, message) expr = node.loc.expression docstring = Parser::Source::Range.new( expr.source_buffer, expr.begin_pos + 1, expr.end_pos - 1 ) add_offense(docstring, location: docstring, message: message) end
def autocorrect(range)
def autocorrect(range) ->(corrector) { corrector.replace(range, replacement_text(range)) } end
def custom_transform
def custom_transform cop_config.fetch('CustomTransform', {}) end
def ignored_words
def ignored_words cop_config.fetch('IgnoredWords', []) end
def on_block(node)
def on_block(node) it_description(node) do |description_node, message| if message =~ SHOULD_PREFIX add_wording_offense(description_node, MSG_SHOULD) elsif message =~ IT_PREFIX add_wording_offense(description_node, MSG_IT) end end end
def replacement_text(range)
def replacement_text(range) text = range.source if text =~ SHOULD_PREFIX RuboCop::RSpec::Wording.new( text, ignore: ignored_words, replace: custom_transform ).rewrite else text.sub(IT_PREFIX, '') end end