boxt_ruby_style_guide 7.2.1 → 7.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c33f8a553a049bb92d0a05f2db91337de1ba0d210b8799c74632f9ed73ef77d
-  data.tar.gz: ec711fb499081ed58f3b60916c67161e7c65b4558313873878aad4269c9edf84
+  metadata.gz: 3269906781941588a2da2ed478c324852a270245e9aeb64cddc877835d6ede19
+  data.tar.gz: 9b1255d5557fd33a70e3cb5f6fccf61d5c7ac44f37055bff8e193108927e00d8
 SHA512:
-  metadata.gz: bdb25540762d772df538cc2d4deab4ee97dff944931641960ecee46f11550c8c28c490ad15c6a524eacd1fefe46cf26776b19696b6ee412f5f6c671356821aac
-  data.tar.gz: 5e18ff9b8966467313273e217d4cecd3d7f202b6008eded7a7260bf6d8ad898d185194305bee451a9dfbb5cd60dcb238a5aa384b8c72469343f2f09939070b61
+  metadata.gz: d1ce04bee4be54bdc9b5bdb4fa55695d364e32546f0c7a0fa93fb458c72d38510cc48667f51809387e39ab12e37058592a3ac4ea3d43e7910177e17f2da6179b
+  data.tar.gz: 4516330c35be5df90616fa65cf8370afa368b441fe3d495da0e5b9542bafd12d0218b1a331eeaa3c548cf93d3ea4f1a26098c5ad7da25ff6b8906dd5b4f543b6

data/README.md

@@ -41,10 +41,10 @@ Add a `.rubocop.yml` file to the root of your project with the following setting
 inherit_gem:
   boxt_ruby_style_guide:
     - default.yml # use default cops
-    - pending.yml # use pending cops 
+    - pending.yml # use pending cops
     - rails.yml # use Rails cops - see Additional Extensions/Cops
-    - rails-pending.yml # use pending rails cops 
-    - rspec.yml # use rspec cops 
+    - rails-pending.yml # use pending rails cops
+    - rspec.yml # use rspec cops
 ```
 
 ### Additional Extensions/Cops
@@ -60,7 +60,7 @@ To enable add the following to your `.rubocop.yml` file.
 ```yml
 inherit_gem:
   boxt_ruby_style_guide:
-  # .... add cops 
+  # .... add cops
 
 require:
   - rubocop-faker # if your project is using the Faker gem then add this
@@ -75,9 +75,17 @@ Lint tasks to run against files listed as changed by Git.
 To run `rubocop` against any changed files use:
 
 ```sh
-rake lint:rubocop
+rake lint:rubocop RUBOCOP_LINT_BASE=your-base-branch
 ```
 
+To run `rubocop` with autofix, use one of the following:
+
+```sh
+rake lint:rubocop_a RUBOCOP_LINT_BASE=your-base-branch
+rake lint:rubocop_A RUBOCOP_LINT_BASE=your-base-branch
+```
+
+
 If there are no changed files the commands will run against all files.
 
 ## Editor Plugins

data/Rakefile

@@ -4,7 +4,7 @@ require "bundler/gem_tasks"
 require "rake/testtask"
 require "rspec/core/rake_task"
 
-import "./tasks/lint.rake"
+import "lib/tasks/lint.rake"
 
 RSpec::Core::RakeTask.new(:spec) do |t|
   t.pattern = Dir.glob("spec/**/*_spec.rb")

data/VERSION

@@ -1 +1 @@
-7.2.1
+7.7.0

data/lib/boxt_ruby_style_guide.rb

@@ -4,17 +4,13 @@ require "boxt_ruby_style_guide/railtie" if defined?(Rails)
 require "boxt_ruby_style_guide/version"
 
 module BoxtRubyStyleGuide
-  class << self
-    def install_tasks
-      Dir[File.join(gem_spec.gem_dir, "tasks/*.rake")].each do |file|
-        load(file)
-      end
-    end
+  module_function
 
-    private
-
-    def gem_spec
-      Gem::Specification.find_by_name("boxt_ruby_style_guide")
-    end
+  ##
+  # Provide a root path helper for the gem root dir
+  #
+  # Returns Pathname
+  def root
+    Pathname.new(File.dirname(__dir__))
   end
 end

data/lib/boxt_ruby_style_guide/filepath_matcher.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module BoxtRubyStyleGuide
+  ##
+  # Sanitizes a list of filepaths based on Rubocops exclusions
+  class FilepathMatcher
+    require "yaml"
+
+    ##
+    # Compare a given filepath with a grep-style filename pattern
+    FILEPATH_PATTERN_MATCH = proc do |filepath, pattern|
+      File.fnmatch(pattern, filepath)
+    end
+
+    ##
+    # Array of file patterns to make sure we only check files that are Ruby files
+    INCLUDE_PATTERNS = %w[
+      Gemfile
+      Rakefile
+      *.gemspec
+      **/*.rb
+      **/*.rake
+    ].freeze
+
+    ##
+    # Array of the excluded files from Rubocop default.yml config
+    EXCLUDE_PATTERNS = YAML.load_file(
+      BoxtRubyStyleGuide.root.join("default.yml")
+    ).dig("AllCops", "Exclude")
+
+    attr_reader :filepaths
+
+    def initialize(*filepaths)
+      @filepaths = filepaths
+    end
+
+    def all_matches
+      filepaths.select do |filepath|
+        filepath_proc = FILEPATH_PATTERN_MATCH.curry.call(filepath)
+        INCLUDE_PATTERNS.any?(filepath_proc) && EXCLUDE_PATTERNS.none?(filepath_proc)
+      end
+    end
+  end
+end

data/lib/boxt_ruby_style_guide/git_diff.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module BoxtRubyStyleGuide
+  # Returns a list of files that have changed, as detected by `git-diff`
+  #
+  # TODO: Write tests for this to ensure we're pulling the desired diff files
+  # see: https://github.com/ruby-git/ruby-git
+  class GitDiff
+    require "git"
+
+    ##
+    # List of Git statuses we should test
+    # See: https://git-scm.com/docs/git-status#_short_format
+    TEST_STATUSES = %w[M A U].freeze
+
+    attr_reader :base
+
+    def initialize(base = "master")
+      @base = base
+    end
+
+    ##
+    # A list of the local file paths of Ruby files with committed changes.
+    #
+    # Returns Array
+    def all
+      @all ||= begin
+        git.diff(base).name_status.select { |_, stat| TEST_STATUSES.include?(stat) }.keys
+      end
+    end
+
+    private
+
+    def git
+      @git ||= Git.open(".")
+    end
+  end
+end

data/lib/boxt_ruby_style_guide/railtie.rb

@@ -5,7 +5,7 @@ require "rails"
 module BoxtRubyStyleGuide
   class Railtie < Rails::Railtie
     rake_tasks do
-      files = File.join(File.dirname(__FILE__), "../../tasks/*.rake")
+      files = BoxtRubyStyleGuide.root.join("lib", "tasks", "*.rake")
       Dir[files].each { |file| load(file) }
     end
   end

data/lib/tasks/lint.rake

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "boxt_ruby_style_guide"
+require "rubocop"
+
+require "boxt_ruby_style_guide/git_diff"
+require "boxt_ruby_style_guide/filepath_matcher"
+
+##
+# The base branch to compare HEAD with for changes
+BASE_BRANCH = "develop"
+
+##
+# Name of the master Rubocop lint task to run
+RUBOCOP_TASK_NAME = :"lint:execute_rubocop"
+
+##
+# Pattern for matching autofix options
+AUTO_REGEX = /\A-a\Z/i.freeze
+
+namespace :lint do
+  desc "Runs rubocop against all files with committed changes different from base branch"
+  task :rubocop do
+    Rake::Task[RUBOCOP_TASK_NAME].invoke
+  end
+
+  desc "Runs rubocop against all files using -a (soft autofix) option"
+  task :rubocop_a do
+    Rake::Task[RUBOCOP_TASK_NAME].invoke("-a")
+  end
+
+  desc "Runs rubocop against all files using -A (hard autofix) option"
+  task :rubocop_A do
+    Rake::Task[RUBOCOP_TASK_NAME].invoke("-A")
+  end
+
+  task :execute_rubocop, [:auto_flag] do |_t, args|
+    if sanitized_file_paths.any?
+      # Sanitize args to make sure only a single "a" or "A" is accepted
+      auto_flag = AUTO_REGEX.match(args[:auto_flag])
+      exec("bundle exec rubocop $RUBOCOP_CHANGED_FILES #{auto_flag}".strip)
+    else
+      puts "No matching Ruby files changed"
+    end
+  end
+end
+
+private
+
+# Returns Array
+def sanitized_file_paths
+  base = ENV.fetch("RUBOCOP_LINT_BASE", BASE_BRANCH)
+  changed_files = BoxtRubyStyleGuide::GitDiff.new(base).all
+  BoxtRubyStyleGuide::FilepathMatcher.new(*changed_files).all_matches
+end

metadata

@@ -1,29 +1,63 @@
 --- !ruby/object:Gem::Specification
 name: boxt_ruby_style_guide
 version: !ruby/object:Gem::Version
-  version: 7.2.1
+  version: 7.7.0
 platform: ruby
 authors:
 - Boxt
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-25 00:00:00.000000000 Z
+date: 2020-10-19 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.4.0
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.91.1
+        version: 0.92.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.91.1
+        version: 0.92.0
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
 - !ruby/object:Gem::Dependency
   name: rubocop-faker
   requirement: !ruby/object:Gem::Requirement
@@ -80,6 +114,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0.1
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -128,14 +190,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.18'
+        version: '0.19'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.18'
+        version: '0.19'
 description: Ruby styleguide info for the BOXT projects, as well as config settings
   for Rubocop
 email:
@@ -150,8 +212,11 @@ files:
 - VERSION
 - default.yml
 - lib/boxt_ruby_style_guide.rb
+- lib/boxt_ruby_style_guide/filepath_matcher.rb
+- lib/boxt_ruby_style_guide/git_diff.rb
 - lib/boxt_ruby_style_guide/railtie.rb
 - lib/boxt_ruby_style_guide/version.rb
+- lib/tasks/lint.rake
 - pending.yml
 - rails-pending.yml
 - rails.yml
@@ -160,7 +225,7 @@ homepage: https://github.com/boxt/ruby-style-guide
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -175,8 +240,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key:
+rubygems_version: 3.1.2
+signing_key: 
 specification_version: 4
 summary: Ruby styleguide info for the BOXT Ruby projects
 test_files: []