ridecharge-rubocop 0.0.1

data/spec/rubocop/cop/lint/syntax_spec.rb

@@ -0,0 +1,34 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Rubocop::Cop::Lint::Syntax do
+  describe '.offence_from_diagnostic' do
+    subject(:offence) { described_class.offence_from_diagnostic(diagnostic) }
+    let(:diagnostic) { Parser::Diagnostic.new(level, reason, args, location) }
+    let(:level) { :warning }
+    let(:reason) { :odd_hash }
+    let(:args) { [] }
+    let(:location) { double('location').as_null_object }
+
+    it 'returns an offence' do
+      expect(offence).to be_a(Rubocop::Cop::Offence)
+    end
+
+    it "sets diagnostic's level to offence's severity" do
+      expect(offence.severity).to eq(level)
+    end
+
+    it "sets diagnostic's message to offence's message" do
+      expect(offence.message).to eq('odd number of entries for a hash')
+    end
+
+    it "sets diagnostic's location to offence's location" do
+      expect(offence.location).to eq(location)
+    end
+
+    it 'sets Syntax as a cop name' do
+      expect(offence.cop_name).to eq('Syntax')
+    end
+  end
+end

data/spec/rubocop/cop/lint/unreachable_code_spec.rb

@@ -0,0 +1,63 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Rubocop::Cop::Lint::UnreachableCode do
+  subject(:cop) { described_class.new }
+
+  described_class::NODE_TYPES.each do |t|
+    it "registers an offence for #{t} before other statements" do
+      inspect_source(cop,
+                     ['foo = 5',
+                      "#{t}",
+                      'bar'
+                     ])
+      expect(cop.offences.size).to eq(1)
+    end
+
+    it "accepts code with conditional #{t}" do
+      inspect_source(cop,
+                     ['foo = 5',
+                      "#{t} if test",
+                      'bar'
+                     ])
+      expect(cop.offences).to be_empty
+    end
+
+    it "accepts #{t} as the final expression" do
+      inspect_source(cop,
+                     ['foo = 5',
+                      "#{t} if test"
+                     ])
+      expect(cop.offences).to be_empty
+    end
+  end
+
+  described_class::FLOW_COMMANDS.each do |t|
+    it "registers an offence for #{t} before other statements" do
+      inspect_source(cop,
+                     ['foo = 5',
+                      "#{t} something",
+                      'bar'
+                     ])
+      expect(cop.offences.size).to eq(1)
+    end
+
+    it "accepts code with conditional #{t}" do
+      inspect_source(cop,
+                     ['foo = 5',
+                      "#{t} something if test",
+                      'bar'
+                     ])
+      expect(cop.offences).to be_empty
+    end
+
+    it "accepts #{t} as the final expression" do
+      inspect_source(cop,
+                     ['foo = 5',
+                      "#{t} something if test"
+                     ])
+      expect(cop.offences).to be_empty
+    end
+  end
+end

data/spec/rubocop/cop/lint/useless_assignment_spec.rb

@@ -0,0 +1,1570 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Rubocop::Cop::Lint::UselessAssignment do
+  subject(:cop) { described_class.new }
+
+  context 'when a variable is assigned and unreferenced in a method' do
+    let(:source) do
+      [
+        'class SomeClass',
+        '  foo = 1',
+        '  puts foo',
+        '  def some_method',
+        '    foo = 2',
+        '    bar = 3',
+        '    puts bar',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(5)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned and unreferenced ' \
+          'in a singleton method defined with self keyword' do
+    let(:source) do
+      [
+        'class SomeClass',
+        '  foo = 1',
+        '  puts foo',
+        '  def self.some_method',
+        '    foo = 2',
+        '    bar = 3',
+        '    puts bar',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(5)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned and unreferenced ' \
+          'in a singleton method defined with variable name' do
+    let(:source) do
+      [
+        '1.times do',
+        '  foo = 1',
+        '  puts foo',
+        '  instance = Object.new',
+        '  def instance.some_method',
+        '    foo = 2',
+        '    bar = 3',
+        '    puts bar',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(6)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned and unreferenced in a class' do
+    let(:source) do
+      [
+        '1.times do',
+        '  foo = 1',
+        '  puts foo',
+        '  class SomeClass',
+        '    foo = 2',
+        '    bar = 3',
+        '    puts bar',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(5)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned and unreferenced in a class ' \
+          'subclassing another class stored in local variable' do
+    let(:source) do
+      [
+        '1.times do',
+        '  foo = 1',
+        '  puts foo',
+        '  array_class = Array',
+        '  class SomeClass < array_class',
+        '    foo = 2',
+        '    bar = 3',
+        '    puts bar',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(6)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned and unreferenced ' \
+          'in a singleton class' do
+    let(:source) do
+      [
+        '1.times do',
+        '  foo = 1',
+        '  puts foo',
+        '  instance = Object.new',
+        '  class << instance',
+        '    foo = 2',
+        '    bar = 3',
+        '    puts bar',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(6)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned and unreferenced in a module' do
+    let(:source) do
+      [
+        '1.times do',
+        '  foo = 1',
+        '  puts foo',
+        '  module SomeModule',
+        '    foo = 2',
+        '    bar = 3',
+        '    puts bar',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(5)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned and unreferenced in top level' do
+    let(:source) do
+      [
+        'foo = 1',
+        'bar = 2',
+        'puts bar'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(1)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned with operator assignment ' \
+          'in top level' do
+    let(:source) do
+      [
+        'foo ||= 1'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo. Use just operator ||.')
+      expect(cop.offences.first.line).to eq(1)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is assigned multiple times ' \
+          'but unreferenced' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = 1',
+        '  bar = 2',
+        '  foo = 3',
+        '  puts bar',
+        'end'
+      ]
+    end
+
+    it 'registers offences for each asignment' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(2)
+
+      expect(cop.offences[0].message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences[0].line).to eq(2)
+
+      expect(cop.offences[1].message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences[1].line).to eq(4)
+
+      expect(cop.highlights).to eq(%w(foo foo))
+    end
+  end
+
+  context 'when a referenced variable is reassigned ' \
+          'but not re-referenced' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = 1',
+        '  puts foo',
+        '  foo = 3',
+        'end'
+      ]
+    end
+
+    it 'registers an offence for the non-re-referenced assignment' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(4)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when an unreferenced variable is reassigned ' \
+          'and re-referenced' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = 1',
+        '  foo = 3',
+        '  puts foo',
+        'end'
+      ]
+    end
+
+    it 'registers an offence for the unreferenced assignment' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(2)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when an unreferenced variable is reassigned in a block' do
+    let(:source) do
+      [
+        'def const_name(node)',
+        '  const_names = []',
+        '  const_node = node',
+        '',
+        '  loop do',
+        '    namespace_node, name = *const_node',
+        '    const_names << name',
+        '    break unless namespace_node',
+        '    break if namespace_node.type == :cbase',
+        '    const_node = namespace_node',
+        '  end',
+        '',
+        "  const_names.reverse.join('::')",
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a referenced variable is reassigned in a block' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = 1',
+        '  puts foo',
+        '  1.times do',
+        '    foo = 2',
+        '  end',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a block local variable is declared but not assigned' do
+    let(:source) do
+      [
+        '1.times do |i; foo|',
+        'end'
+      ]
+    end
+
+    it 'registers an offence for the declaration' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(1)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a block local variable is assigned and unreferenced' do
+    let(:source) do
+      [
+        '1.times do |i; foo|',
+        '  foo = 2',
+        'end'
+      ]
+    end
+
+    it 'registers offences for the assignment' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(2)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is assigned in loop body and unreferenced' do
+    let(:source) do
+      [
+        'def some_method',
+        '  while true',
+        '    foo = 1',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(3)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is reassigned at the end of loop body ' \
+          'and would be referenced in next iteration' do
+    let(:source) do
+      [
+        'def some_method',
+        '  total = 0',
+        '  foo = 0',
+        '',
+        '  while total < 100',
+        '    total += foo',
+        '    foo += 1',
+        '  end',
+        '',
+        '  total',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is reassigned at the end of loop body ' \
+          'and would be referenced in loop condition' do
+    let(:source) do
+      [
+        'def some_method',
+        '  total = 0',
+        '  foo = 0',
+        '',
+        '  while foo < 100',
+        '    total += 1',
+        '    foo += 1',
+        '  end',
+        '',
+        '  total',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context "when a variable is reassigned in loop body but won't " \
+          'be referenced either next iteration or loop condition' do
+    let(:source) do
+      [
+        'def some_method',
+        '  total = 0',
+        '  foo = 0',
+        '',
+        '  while total < 100',
+        '    total += 1',
+        '    foo += 1',
+        '  end',
+        '',
+        '  total',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(7)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a referenced variable is reassigned ' \
+          'but not re-referenced in a method defined in loop' do
+    let(:source) do
+      [
+        'while true',
+        '  def some_method',
+        '    foo = 1',
+        '    puts foo',
+        '    foo = 3',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(5)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable that has same name as outer scope variable ' \
+          'is not referenced in a method defined in loop' do
+    let(:source) do
+      [
+        'foo = 1',
+        '',
+        'while foo < 100',
+        '  foo += 1',
+        '  def some_method',
+        '    foo = 1',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(6)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is assigned in single branch if ' \
+          'and unreferenced' do
+    let(:source) do
+      [
+        'def some_method(flag)',
+        '  if flag',
+        '    foo = 1',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(3)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a unreferenced variable is reassigned in same branch ' \
+          'and referenced after the branching' do
+    let(:source) do
+      [
+        'def some_method(flag)',
+        '  if flag',
+        '    foo = 1',
+        '    foo = 2',
+        '  end',
+        '',
+        '  foo',
+        'end'
+      ]
+    end
+
+    it 'registers an offence for the unreferenced assignment' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(3)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is reassigned in single branch if ' \
+          'and referenced after the branching' do
+    let(:source) do
+      [
+        'def some_method(flag)',
+        '  foo = 1',
+        '',
+        '  if flag',
+        '    foo = 2',
+        '  end',
+        '',
+        '  foo',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned in each branch of if ' \
+          'and referenced after the branching' do
+    let(:source) do
+      [
+        'def some_method(flag)',
+        '  if flag',
+        '    foo = 2',
+        '  else',
+        '    foo = 3',
+        '  end',
+        '',
+        '  foo',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is reassigned in single branch if ' \
+          'and referenced in the branch' do
+    let(:source) do
+      [
+        'def some_method(flag)',
+        '  foo = 1',
+        '',
+        '  if flag',
+        '    foo = 2',
+        '    puts foo',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence for the unreferenced assignment' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(2)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is assigned in each branch of if ' \
+          'and referenced in the else branch' do
+    let(:source) do
+      [
+        'def some_method(flag)',
+        '  if flag',
+        '    foo = 2',
+        '  else',
+        '    foo = 3',
+        '    puts foo',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence for the assignment in the if branch' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(3)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is assigned in branch of modifier if ' \
+          'that references the variable in its conditional clause' +
+          'and referenced after the branching' do
+    let(:source) do
+      [
+        'def some_method(flag)',
+        '  foo = 1 unless foo',
+        '  puts foo',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned in branch of modifier if ' \
+          'that references the variable in its conditional clause' +
+          'and unreferenced' do
+    let(:source) do
+      [
+        'def some_method(flag)',
+        '  foo = 1 unless foo',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(2)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is assigned on each side of && ' \
+          'and referenced after the &&' do
+    let(:source) do
+      [
+        'def some_method',
+        '  (foo = do_something_returns_object_or_nil) && (foo = 1)',
+        '  foo',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a unreferenced variable is reassigned ' \
+          'on the left side of && and referenced after the &&' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = 1',
+        '  (foo = do_something_returns_object_or_nil) && do_something',
+        '  foo',
+        'end'
+      ]
+    end
+
+    it 'registers an offence for the unreferenced assignment' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(2)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a unreferenced variable is reassigned ' \
+          'on the right side of && and referenced after the &&' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = 1',
+        '  do_something_returns_object_or_nil && foo = 2',
+        '  foo',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is reassigned ' \
+          'while referencing itself in rhs and referenced' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = [1, 2]',
+        '  foo = foo.map { |i| i + 1 }',
+        '  puts foo',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is reassigned ' \
+          'with binary operator assignment and referenced' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = 1',
+        '  foo += 1',
+        '  foo',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is reassigned ' \
+          'with logical operator assignment and referenced' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = do_something_returns_object_or_nil',
+        '  foo ||= 1',
+        '  foo',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is reassigned with binary operator ' \
+           'assignment while assigning to itself in rhs ' +
+           'then referenced' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = 1',
+        '  foo += foo = 2',
+        '  foo',
+        'end'
+      ]
+    end
+
+    it 'registers an offence for the assignment in rhs' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(3)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is assigned first with ||= and referenced' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo ||= 1',
+        '  foo',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned with ||= ' \
+          'at the last expression of the scope' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = do_something_returns_object_or_nil',
+        '  foo ||= 1',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message).to eq(
+        'Useless assignment to variable - foo. Use just operator ||.'
+      )
+      expect(cop.offences.first.line).to eq(3)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is assigned with ||= ' \
+          'before the last expression of the scope' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = do_something_returns_object_or_nil',
+        '  foo ||= 1',
+        '  some_return_value',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(3)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is assigned with multiple assignment ' \
+          'and unreferenced' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo, bar = do_something',
+        '  puts foo',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message).to eq(
+        'Useless assignment to variable - bar. ' \
+        'Use _ or _bar as a variable name ' +
+        "to indicate that it won't be used."
+      )
+      expect(cop.offences.first.line).to eq(2)
+      expect(cop.highlights).to eq(['bar'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is reassigned with multiple assignment ' \
+          'while referencing itself in rhs and referenced' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = 1',
+        '  foo, bar = do_something(foo)',
+        '  puts foo, bar',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned in loop body ' \
+          'and referenced in post while condition' do
+    let(:source) do
+      [
+        'begin',
+        '  a = (a || 0) + 1',
+        '  puts a',
+        'end while a <= 2'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned in loop body ' \
+          'and referenced in post until condition' do
+    let(:source) do
+      [
+        'begin',
+        '  a = (a || 0) + 1',
+        '  puts a',
+        'end until a > 2'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned ' \
+          'in main body of begin with rescue but unreferenced' do
+    let(:source) do
+      [
+        'begin',
+        '  do_something',
+        '  foo = true',
+        'rescue',
+        '  do_anything',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(3)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned in main body of begin, rescue ' \
+          'and else then referenced after the begin' do
+    let(:source) do
+      [
+        'begin',
+        '  do_something',
+        '  foo = :in_begin',
+        'rescue FirstError',
+        '  foo = :in_first_rescue',
+        'rescue SecondError',
+        '  foo = :in_second_rescue',
+        'else',
+        '  foo = :in_else',
+        'end',
+        '',
+        'puts foo'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is reassigned multiple times ' \
+          'in main body of begin then referenced after the begin' do
+    let(:source) do
+      [
+        'begin',
+        '  status = :initial',
+        '  connect_sometimes_fails!',
+        '  status = :connected',
+        '  fetch_sometimes_fails!',
+        '  status = :fetched',
+        'rescue',
+        '  do_something',
+        'end',
+        '',
+        'puts status'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is reassigned multiple times ' \
+          'in main body of begin then referenced in rescue' do
+    let(:source) do
+      [
+        'begin',
+        '  status = :initial',
+        '  connect_sometimes_fails!',
+        '  status = :connected',
+        '  fetch_sometimes_fails!',
+        '  status = :fetched',
+        'rescue',
+        '  puts status',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is reassigned multiple times ' \
+          'in main body of begin then referenced in ensure' do
+    let(:source) do
+      [
+        'begin',
+        '  status = :initial',
+        '  connect_sometimes_fails!',
+        '  status = :connected',
+        '  fetch_sometimes_fails!',
+        '  status = :fetched',
+        'ensure',
+        '  puts status',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is reassigned multiple times in rescue ' \
+          'and referenced after the begin' do
+    let(:source) do
+      [
+        'foo = false',
+        '',
+        'begin',
+        '  do_something',
+        'rescue',
+        '  foo = true',
+        '  foo = true',
+        'end',
+        '',
+        'puts foo'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(6)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is reassigned multiple times ' \
+          'in rescue with ensure then referenced after the begin' do
+    let(:source) do
+      [
+        'foo = false',
+        '',
+        'begin',
+        '  do_something',
+        'rescue',
+        '  foo = true',
+        '  foo = true',
+        'ensure',
+        '  do_anything',
+        'end',
+        '',
+        'puts foo'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(6)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is reassigned multiple times ' \
+          'in ensure with rescue then referenced after the begin' do
+    let(:source) do
+      [
+        'begin',
+        '  do_something',
+        'rescue',
+        '  do_anything',
+        'ensure',
+        '  foo = true',
+        '  foo = true',
+        'end',
+        '',
+        'puts foo'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(6)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a variable is assigned at the end of rescue ' \
+          'and would be referenced with retry' do
+    let(:source) do
+      [
+        'retried = false',
+        '',
+        'begin',
+        '  do_something',
+        'rescue',
+        '  fail if retried',
+        '  retried = true',
+        '  retry',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned ' \
+          'in main body of begin, rescue and else ' +
+          'and reassigned in ensure then referenced after the begin' do
+    let(:source) do
+      [
+        'begin',
+        '  do_something',
+        '  foo = :in_begin',
+        'rescue FirstError',
+        '  foo = :in_first_rescue',
+        'rescue SecondError',
+        '  foo = :in_second_rescue',
+        'else',
+        '  foo = :in_else',
+        'ensure',
+        '  foo = :in_ensure',
+        'end',
+        '',
+        'puts foo'
+      ]
+    end
+
+    it 'registers offences for each assignment before ensure' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(4)
+
+      expect(cop.offences[0].line).to eq(3)
+      expect(cop.offences[1].line).to eq(5)
+      expect(cop.offences[2].line).to eq(7)
+      expect(cop.offences[3].line).to eq(9)
+    end
+  end
+
+  context 'when a method argument is reassigned ' \
+          'and zero arity super is called' do
+    let(:source) do
+      [
+        'def some_method(foo)',
+        '  foo = 1',
+        '  super',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a local variable is unreferenced ' \
+          'and zero arity super is called' do
+    let(:source) do
+      [
+        'def some_method(bar)',
+        '  foo = 1',
+        '  super',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(2)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a method argument is reassigned ' \
+          'but not passed to super' do
+    let(:source) do
+      [
+        'def some_method(foo, bar)',
+        '  foo = 1',
+        '  super(bar)',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(2)
+      expect(cop.highlights).to eq(['foo'])
+    end
+  end
+
+  context 'when a named capture is unreferenced in top level' do
+    let(:source) do
+      [
+        "/(?<foo>\w+)/ =~ 'FOO'"
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(1)
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a named capture is unreferenced ' \
+          'in other than top level' do
+    let(:source) do
+      [
+        'def some_method',
+        "  /(?<foo>\w+)/ =~ 'FOO'",
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(2)
+      expect(cop.highlights).to eq(["/(?<foo>\w+)/"])
+    end
+
+    # MRI 2.0 accepts this case, but I have no idea why it does so
+    # and there's no convincing reason to conform to this behavior,
+    # so RuboCop does not mimic MRI in this case.
+  end
+
+  context 'when a named capture is referenced' do
+    let(:source) do
+      [
+        'def some_method',
+        "  /(?<foo>\w+)(?<bar>\s+)/ =~ 'FOO'",
+        '  puts foo',
+        '  puts bar',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is referenced ' \
+          'in rhs of named capture expression' do
+    let(:source) do
+      [
+        'def some_method',
+        "  foo = 'some string'",
+        "  /(?<foo>\w+)/ =~ foo",
+        '  puts foo',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+  end
+
+  context 'when a variable is assigned in begin ' \
+          'and referenced outside' do
+    let(:source) do
+      [
+        'def some_method',
+        '  begin',
+        '    foo = 1',
+        '  end',
+        '  puts foo',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is shadowed by a block argument ' \
+          'and unreferenced' do
+    let(:source) do
+      [
+        'def some_method',
+        '  foo = 1',
+        '  1.times do |foo|',
+        '    puts foo',
+        '  end',
+        'end'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(2)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1', 'unused variable'
+  end
+
+  context 'when a variable is not used and the name starts with _' do
+    let(:source) do
+      [
+        'def some_method',
+        '  _foo = 1',
+        '  bar = 2',
+        '  puts bar',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a method argument is not used' do
+    let(:source) do
+      [
+        'def some_method(arg)',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when an optional method argument is not used' do
+    let(:source) do
+      [
+        'def some_method(arg = nil)',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a block method argument is not used' do
+    let(:source) do
+      [
+        'def some_method(&block)',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a splat method argument is not used' do
+    let(:source) do
+      [
+        'def some_method(*args)',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a optional keyword method argument is not used' do
+    let(:source) do
+      [
+        'def some_method(name: value)',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts' unless RUBY_VERSION < '2.0'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a keyword splat method argument is used' do
+    let(:source) do
+      [
+        'def some_method(name: value, **rest_keywords)',
+        '  p rest_keywords',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts' unless RUBY_VERSION < '2.0'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a keyword splat method argument is not used' do
+    let(:source) do
+      [
+        'def some_method(name: value, **rest_keywords)',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts' unless RUBY_VERSION < '2.0'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a block argument is not used' do
+    let(:source) do
+      [
+        '1.times do |i|',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when there is only one AST node and it is unused variable' do
+    let(:source) do
+      [
+        'foo = 1'
+      ]
+    end
+
+    it 'registers an offence' do
+      inspect_source(cop, source)
+      expect(cop.offences.size).to eq(1)
+      expect(cop.offences.first.message)
+        .to eq('Useless assignment to variable - foo')
+      expect(cop.offences.first.line).to eq(1)
+      expect(cop.highlights).to eq(['foo'])
+    end
+
+    include_examples 'mimics MRI 2.1'
+  end
+
+  context 'when a variable is assigned ' \
+          'while being passed to a method taking block' do
+
+    context 'and the variable is used' do
+      let(:source) do
+        [
+          'some_method(foo = 1) do',
+          'end',
+          'puts foo'
+        ]
+      end
+
+      include_examples 'accepts'
+      include_examples 'mimics MRI 2.1'
+    end
+
+    context 'and the variable is not used' do
+      let(:source) do
+        [
+          'some_method(foo = 1) do',
+          'end'
+        ]
+      end
+
+      it 'registers an offence' do
+        inspect_source(cop, source)
+        expect(cop.offences.size).to eq(1)
+        expect(cop.offences.first.message)
+          .to eq('Useless assignment to variable - foo')
+        expect(cop.offences.first.line).to eq(1)
+        expect(cop.highlights).to eq(['foo'])
+      end
+
+      include_examples 'mimics MRI 2.1'
+    end
+  end
+
+  context 'when a variabled is assigned ' \
+          'and passed to a method followed by method taking block'  do
+    let(:source) do
+      [
+        "pattern = '*.rb'",
+        'Dir.glob(pattern).map do |path|',
+        'end'
+      ]
+    end
+
+    include_examples 'accepts'
+    include_examples 'mimics MRI 2.1'
+  end
+end