Merge pull request #7 from bensheldon/require-support

Recommend usage of `require: rubocop-rails-accessibility`; rename RuboCop department to "RailsAccessibility"

Author: Adrián Bolonio

.rubocop.yml

@@ -1,3 +1,6 @@
+require:
+  - rubocop-rails-accessibility
+
 inherit_gem:
   rubocop-github:
     - config/default.yml
@@ -7,3 +10,4 @@ Naming/FileName:
   Enabled: true
   Exclude:
     - "rubocop-rails-accessibility.gemspec"
+    - "lib/rubocop-rails-accessibility.rb"

Gemfile.lock

@@ -31,6 +31,8 @@ GEM
       crass (~> 1.0.2)
       nokogiri (>= 1.5.9)
     minitest (5.16.3)
+    nokogiri (1.13.8-arm64-darwin)
+      racc (~> 1.4)
     nokogiri (1.13.8-x86_64-darwin)
       racc (~> 1.4)
     nokogiri (1.13.8-x86_64-linux)
@@ -91,6 +93,7 @@ GEM
     unicode-display_width (2.2.0)
 
 PLATFORMS
+  arm64-darwin-21
   x86_64-darwin-19
   x86_64-linux
 
@@ -105,4 +108,4 @@ DEPENDENCIES
   rubocop-rails-accessibility!
 
 BUNDLED WITH
-   2.3.17
+   2.3.22

README.md

@@ -25,9 +25,8 @@ You need to tell RuboCop to load RuboCop Rails Accessibility.
 Put this into your `.rubocop.yml`.
 
 ``` yaml
-inherit_gem:
-  rubocop-rails-accessibility:
-    - config/default.yml
+require:
+  - rubocop-rails-accessibility
 ```
 
 ## Testing
@@ -47,14 +46,14 @@ bundle exec rake
 ## The Cops
 
 All cops are located under
-[`lib/rubocop/cop/rubocop-rails-accessibility`](lib/rubocop/cop/rubocop-rails-accessibility), and contain
+[`lib/rubocop/cop/rails_accessibility`](lib/rubocop/cop/rails_accessibility), and contain
 examples/documentation.
 
 ## Rules
 
-- [RuboCop::Cop::Accessibility::ImageHasAlt](guides/image-has-alt.md)
-- [RuboCop::Cop::Accessibility::NoPositiveTabindex](guides/no-positive-tabindex.md)
-- [RuboCop::Cop::Accessibility::NoRedundantImageAlt](guides/no-redundant-image-alt.md)
+- [RailsAccessibility/ImageHasAlt](guides/image-has-alt.md)
+- [RailsAccessibility/NoPositiveTabindex](guides/no-positive-tabindex.md)
+- [RailsAccessibility/NoRedundantImageAlt](guides/no-redundant-image-alt.md)
 
 ## Contributing
 

config/default.yml

@@ -1,15 +1,11 @@
-require:
-  - rubocop/cop/rubocop_rails_accessibility_cops
-
-AllCops:
-  DisabledByDefault: true
-
-RubocopRailsAccessibility/ImageHasAlt:
+RailsAccessibility/ImageHasAlt:
   Enabled: true
   StyleGuide: https://github.com/github/rubocop-rails-accessibility/blob/master/guides/image-has-alt.md
-RubocopRailsAccessibility/NoPositiveTabindex:
+
+RailsAccessibility/NoPositiveTabindex:
   Enabled: true
   StyleGuide: https://github.com/github/rubocop-rails-accessibility/blob/master/guides/no-positive-tabindex.md
-RubocopRailsAccessibility/NoRedundantImageAlt:
+
+RailsAccessibility/NoRedundantImageAlt:
   Enabled: true
   StyleGuide: https://github.com/github/rubocop-rails-accessibility/blob/master/guides/no-redundant-image-alt.md

guides/image-has-alt.md

@@ -1,4 +1,4 @@
-# RubocopRailsAccessibility/ImageHasAlt
+# RailsAccessibility/ImageHasAlt
 
 ## Rule Details
 
@@ -26,4 +26,4 @@ Images should have an alt prop with meaningful text or an empty string for decor
 ```erb
 <!-- also good -->
 <%= image_tag "spinners/octocat-spinner-16px.gif", size: "12x12", alt: "" %>
-```
+```

guides/no-positive-tabindex.md

@@ -1,4 +1,4 @@
-# RubocopRailsAccessibility/NoPositiveTabindex
+# RailsAccessibility/NoPositiveTabindex
 
 ## Rule Details
 
@@ -21,4 +21,4 @@ Positive tabindex is error-prone and often inaccessible.
 ```erb
 <!-- good -->
 <%= button_tag "Continue", :tabindex => -1 %>
-```
+```

guides/no-redundant-image-alt.md

@@ -1,4 +1,4 @@
-# RubocopRailsAccessibility/NoRedundantImageAlt
+# RailsAccessibility/NoRedundantImageAlt
 
 ## Rule Details
 
@@ -21,4 +21,4 @@ Alt prop should not contain `image` or `picture` as screen readers already annou
 ```erb
 <!-- good -->
 <%= image_tag "cat.gif", size: "12x12", alt: "A black cat" %>
-```
+```

lib/rubocop-rails-accessibility.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "rubocop"
+require "rubocop/rails_accessibility"
+require "rubocop/rails_accessibility/inject"
+require "rubocop/rails_accessibility/version"
+
+RuboCop::RailsAccessibility::Inject.defaults!
+
+require "rubocop/cop/rails_accessibility/image_has_alt"
+require "rubocop/cop/rails_accessibility/no_positive_tabindex"
+require "rubocop/cop/rails_accessibility/no_redundant_image_alt"

lib/rubocop/cop/inject.rb

@@ -4,7 +4,7 @@
 
 module RuboCop
   module Cop
-    module RubocopRailsAccessibility
+    module RailsAccessibility
       class ImageHasAlt < Base
         MSG = "Images should have an alt prop with meaningful text or an empty string for decorative images"
 

lib/rubocop/cop/rubocop-rails-accessibility/image_has_alt.rb renamed to lib/rubocop/cop/rails_accessibility/image_has_alt.rb

@@ -4,7 +4,7 @@
 
 module RuboCop
   module Cop
-    module RubocopRailsAccessibility
+    module RailsAccessibility
       class NoPositiveTabindex < Base
         MSG = "Positive tabindex is error-prone and often inaccessible."
 

lib/rubocop/cop/rubocop-rails-accessibility/no_positive_tabindex.rb renamed to lib/rubocop/cop/rails_accessibility/no_positive_tabindex.rb

@@ -4,7 +4,7 @@
 
 module RuboCop
   module Cop
-    module RubocopRailsAccessibility
+    module RailsAccessibility
       class NoRedundantImageAlt < Base
         MSG = "Alt prop should not contain `image` or `picture` as screen readers already announce the element as an image"
         REDUNDANT_ALT_WORDS = %w[image picture].freeze

lib/rubocop/cop/rubocop-rails-accessibility/no_redundant_image_alt.rb renamed to lib/rubocop/cop/rails_accessibility/no_redundant_image_alt.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "pathname"
+
+module RuboCop
+  module RailsAccessibility
+    PROJECT_ROOT   = Pathname.new(__dir__).parent.parent.expand_path.freeze
+    CONFIG_DEFAULT = PROJECT_ROOT.join("config", "default.yml").freeze
+  end
+end

lib/rubocop/cop/rubocop_rails_accessibility_cops.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require "rubocop"
+
+# The original code is from https://github.com/rubocop/rubocop-rspec/blob/main/lib/rubocop/rspec/inject.rb
+# See https://github.com/rubocop/rubocop-rspec/blob/main/MIT-LICENSE.md
+module RuboCop
+  module RailsAccessibility
+    module Inject
+      def self.defaults!
+        path = CONFIG_DEFAULT.to_s
+        hash = ::RuboCop::ConfigLoader.send(:load_yaml_configuration, path)
+        config = ::RuboCop::Config.new(hash, path).tap(&:make_excludes_absolute)
+        puts "configuration from #{path}" if ::RuboCop::ConfigLoader.debug?
+        config = ::RuboCop::ConfigLoader.merge_with_default(config, path)
+        ::RuboCop::ConfigLoader.instance_variable_set(:@default_configuration, config)
+      end
+    end
+  end
+end

lib/rubocop/cop/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module RailsAccessibility
+    VERSION = "0.1.2"
+  end
+end

lib/rubocop/rails_accessibility.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
-require_relative "lib/rubocop/cop/version"
+require_relative "lib/rubocop/rails_accessibility/version"
 
 Gem::Specification.new do |spec|
   spec.name = "rubocop-rails-accessibility"
-  spec.version = RubocopRailsAccessibility::VERSION
+  spec.version = RuboCop::RailsAccessibility::VERSION
   spec.authors = ["GitHub Accessibility Team"]
   spec.email = ["[email protected]"]
 
-  spec.summary = "Custom extension for RuboCop."
+  spec.summary = "Custom RuboCop rules for Rails Accessibility."
   spec.homepage = "https://github.com/github/rubocop-rails-accessibility"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 2.7.0"
@@ -28,14 +28,14 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rubocop-rails"
   spec.add_development_dependency "rubocop-performance"
 
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(File.expand_path(__dir__)) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
-    end
-  end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.files = Dir[
+    "config/*.yml",
+    "guides/*.md",
+    "lib/**/*.rb",
+    "CONTRIBUTING.md",
+    "LICENSE",
+    "README.md",
+  ]
+
   spec.require_paths = ["lib"]
 end

lib/rubocop/rails_accessibility/inject.rb

@@ -2,11 +2,11 @@
 
 require_relative "./cop_test"
 require "minitest/autorun"
-require "rubocop/cop/rubocop-rails-accessibility/image_has_alt"
+require "rubocop/cop/rails_accessibility/image_has_alt"
 
 class TestImageHasAlt < CopTest
   def cop_class
-    RuboCop::Cop::RubocopRailsAccessibility::ImageHasAlt
+    RuboCop::Cop::RailsAccessibility::ImageHasAlt
   end
 
   def test_image_has_alt_offense

lib/rubocop/rails_accessibility/version.rb

@@ -2,11 +2,11 @@
 
 require_relative "./cop_test"
 require "minitest/autorun"
-require "rubocop/cop/rubocop-rails-accessibility/no_positive_tabindex"
+require "rubocop/cop/rails_accessibility/no_positive_tabindex"
 
 class NoPositiveTabindex < CopTest
   def cop_class
-    RuboCop::Cop::RubocopRailsAccessibility::NoPositiveTabindex
+    RuboCop::Cop::RailsAccessibility::NoPositiveTabindex
   end
 
   def test_no_positive_tabindex_alt_offense

rubocop-rails-accessibility.gemspec

@@ -2,11 +2,11 @@
 
 require_relative "./cop_test"
 require "minitest/autorun"
-require "rubocop/cop/rubocop-rails-accessibility/no_redundant_image_alt"
+require "rubocop/cop/rails_accessibility/no_redundant_image_alt"
 
 class NoRedundantImageAlt < CopTest
   def cop_class
-    RuboCop::Cop::RubocopRailsAccessibility::NoRedundantImageAlt
+    RuboCop::Cop::RailsAccessibility::NoRedundantImageAlt
   end
 
   def test_no_redundant_image_alt_offense