nevir/rubocop-rspec

View on GitHub
Rakefile

Summary

Maintainability
Test Coverage
# frozen_string_literal: true

require 'open3'

require 'bundler'
require 'bundler/gem_tasks'

begin
  Bundler.setup(:default, :development)
rescue Bundler::BundlerError => e
  warn e.message
  warn 'Run `bundle install` to install missing gems'
  exit e.status_code
end

require 'rspec/core/rake_task'
require 'rubocop/rake_task'

Dir['tasks/**/*.rake'].each { |t| load t }

RSpec::Core::RakeTask.new(:spec) do |spec|
  spec.pattern = FileList['spec/**/*_spec.rb']
end

desc 'Run RuboCop over this gem'
RuboCop::RakeTask.new(:internal_investigation)

desc 'Build config/default.yml'
task :build_config do
  require 'yard'

  require 'rubocop-rspec'
  require 'rubocop/rspec/config_formatter'
  require 'rubocop/rspec/description_extractor'

  glob = File.join('lib', 'rubocop', 'cop', 'rspec', '*.rb')
  # Due to YARD's sensitivity to file require order (as of 0.9.25),
  # we have to prepend the list with our base cop, RuboCop::Cop::RSpec::Base.
  # Otherwise, cop's parent class for cops loaded before our base cop class
  # are detected as RuboCop::Cop::Base, and that complicates the detection
  # of their relation with RuboCop RSpec.
  rspec_cop_path = File.join('lib', 'rubocop', 'cop', 'rspec', 'base.rb')
  YARD::Tags::Library.define_tag('Cop Safety Information', :safety)
  YARD.parse(Dir[glob].prepend(rspec_cop_path), [])

  descriptions =
    RuboCop::RSpec::DescriptionExtractor.new(YARD::Registry.all(:class)).to_h
  current_config = if Psych::VERSION >= '4.0.0' # RUBY_VERSION >= '3.1.0'
                     YAML.unsafe_load_file('config/default.yml')
                   else
                     YAML.load_file('config/default.yml')
                   end

  File.write(
    'config/default.yml',
    RuboCop::RSpec::ConfigFormatter.new(current_config, descriptions).dump
  )
end

desc 'Confirm config/default.yml is up to date'
task confirm_config: :build_config do
  _, stdout, _, process =
    Open3.popen3('git diff --exit-code config/default.yml')

  raise <<~ERROR unless process.value.success?
    default.yml is out of sync:

    #{stdout.read}
    Please run `rake build_config`
  ERROR
end

desc 'Confirm documentation is up to date'
task confirm_documentation: :generate_cops_documentation do
  stdout, _stderr, status =
    Open3.capture3('git diff --exit-code docs/')

  unless status.success?
    warn 'Documentation is out of sync:'
    warn stdout
    warn 'Please run `rake generate_cops_documentation` ' \
         'and add docs/ to the commit.'
    exit 1
  end
end

task default: %i[build_config spec
                 internal_investigation
                 confirm_config
                 documentation_syntax_check
                 confirm_documentation]

desc 'Generate a new cop template'
task :new_cop, [:cop] do |_task, args|
  require 'rubocop'
  require_relative 'lib/rubocop/rspec/cop/generator'

  cop_name = args.fetch(:cop) do
    warn "usage: bundle exec rake 'new_cop[Department/Name]'"
    exit!
  end

  generator = RuboCop::RSpec::Cop::Generator.new(cop_name)
  generator.write_source
  generator.write_spec
  generator.inject_require(root_file_path: 'lib/rubocop/cop/rspec_cops.rb')
  generator.inject_config

  puts generator.todo
end