a11y-lint 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c000b195d8308dc83a3480df00e9a469e064535305ece969f779ee05b93fc87
-  data.tar.gz: cf3ec59befbf3057ff5f1a9d971925656fbf0f0c001e40780202abd862bd67a2
+  metadata.gz: df2381933d808c2694937750b55b63897d22feb8b3726e8635504afa6bcb320b
+  data.tar.gz: 5b04343e74f0ebb363cb2b2c065d67b9b20398d4b5bd12e86e89fe38a7bcfa8d
 SHA512:
-  metadata.gz: ad3e23e799fce7418f9e28224a9ec63120f42d5a04bd27710637df12e278118728af0a3baf47c5fe8b3cfa2a12e6bfbc366d8f334a453b385111b1befc2828df
-  data.tar.gz: 8be4c61819523edcbb0a11bb4959ab5834b0552d0fe27be2fc71aa30362dc18eb5ca8f9d25bffa5578f7f77d0af11b5e1716e8429b4c2a865fcd3a243031ede0
+  metadata.gz: 4a71a89a925316ae52107958bed1cdc927d653ccc0425b81ad2bca612f694cdc63b52d9c277f24c1957976e5972ed5c810b831f150c353393014908e7e187a6d
+  data.tar.gz: d9982d126da0a7f412d8d43b68e90b27fcde739a3b08c2b6cc0e948241eb18b95e9e42542e5bb7ce75048f389fec11351901da0e900076369c3889d1e8c16b0a

data/.rubocop.yml

@@ -6,3 +6,7 @@ Style/StringLiterals:
 
 Style/StringLiteralsInInterpolation:
   EnforcedStyle: double_quotes
+
+Metrics/ClassLength:
+  Exclude:
+    - "test/**/*"

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-03-27
+
+### Added
+
+- ERB template support: scans `.erb` files using Nokogiri for HTML parsing
+  - Both `ImgMissingAlt` and `ImageTagMissingAlt` rules now work on ERB templates
+  - CLI automatically detects and routes `.slim` and `.erb` files to the appropriate runner
+
+### Changed
+
+- **Breaking:** `Runner` has been renamed to `SlimRunner`
+
 ## [0.3.1] - 2026-03-27
 
 ### Fixed

data/CLAUDE.md

@@ -19,8 +19,11 @@ a11y-lint is a Ruby gem (v0.1.0) for accessibility linting. It uses the `A11y::L
 
 ## Architecture
 
-- **CLI:** `lib/a11y/lint/cli.rb` — command-line interface; executable at `exe/a11y-lint`
+- **CLI:** `lib/a11y/lint/cli.rb` — command-line interface; executable at `exe/a11y-lint`; routes `.slim` files to `SlimRunner` and `.erb` files to `ErbRunner`
 - **Entry point:** `lib/a11y/lint.rb` — defines the `A11y::Lint` module and `A11y::Lint::Error` exception
+- **Slim pipeline:** `SlimRunner` parses Slim templates via `Slim::Parser`; `Node` wraps Slim S-expressions
+- **ERB pipeline:** `ErbRunner` parses ERB templates via Nokogiri; `ErbNode` wraps Nokogiri nodes and extracted `<%= %>` Ruby code
+- **Rules:** `lib/a11y/lint/rules/` — rules implement `check(node)` against the shared node interface (`tag_name`, `attribute?`, `attributes`, `ruby_code`, `line`)
 - **Version:** `lib/a11y/lint/version.rb`
 - **Type signatures (RBS):** `sig/a11y/lint.rbs`
 - **Tests:** `test/` directory using Minitest; test helper at `test/test_helper.rb`

data/README.md

@@ -33,7 +33,7 @@ a11y-lint app/views/
 a11y-lint app/views/home.html.slim app/views/about.html.slim
 ```
 
-With no arguments, it scans the current directory recursively for `.slim` files:
+With no arguments, it scans the current directory recursively for `.slim` and `.erb` files:
 
 ```bash
 a11y-lint
@@ -45,7 +45,7 @@ a11y-lint
 require "a11y/lint"
 
 source = File.read("app/views/home.html.slim")
-runner = A11y::Lint::Runner.new([A11y::Lint::Rules::ImgMissingAlt.new])
+runner = A11y::Lint::SlimRunner.new([A11y::Lint::Rules::ImgMissingAlt.new])
 offenses = runner.run(source, filename: "app/views/home.html.slim")
 
 offenses.each do |offense|

data/lib/a11y/lint/cli.rb

@@ -17,7 +17,7 @@ module A11y
         files = resolve_files(@argv)
 
         if files.empty?
-          @stderr.puts("No .slim files found")
+          @stderr.puts("No .slim or .erb files found")
           return 0
         end
 
@@ -56,7 +56,7 @@ module A11y
 
       def expand_path(path)
         if File.directory?(path)
-          Dir.glob(File.join(path, "**", "*.slim"))
+          Dir.glob(File.join(path, "**", "*.{slim,erb}"))
         elsif File.file?(path)
           [path]
         else
@@ -66,10 +66,13 @@ module A11y
       end
 
       def lint_files(files)
-        runner = Runner.new(all_rules)
+        rules = all_rules
+        slim_runner = SlimRunner.new(rules)
+        erb_runner = ErbRunner.new(rules)
 
         files.flat_map do |file|
           source = File.read(file)
+          runner = file.end_with?(".erb") ? erb_runner : slim_runner
           runner.run(source, filename: file)
         end
       end

data/lib/a11y/lint/erb_node.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module A11y
+  module Lint
+    # Wraps a Nokogiri node or extracted ERB output tag as a queryable node for lint rules.
+    class ErbNode
+      attr_reader :line
+
+      def initialize(line:, nokogiri_node: nil, ruby_code: nil)
+        @nokogiri_node = nokogiri_node
+        @ruby_code_string = ruby_code
+        @line = line
+      end
+
+      def tag_name
+        @nokogiri_node&.name
+      end
+
+      def attribute?(name)
+        attributes.key?(name)
+      end
+
+      def attributes
+        @attributes ||= extract_attributes
+      end
+
+      def ruby_code
+        @ruby_code_string
+      end
+
+      private
+
+      def extract_attributes
+        return {} unless @nokogiri_node
+
+        @nokogiri_node.attributes.each_with_object({}) do |(name, _attr), result|
+          result[name] = true
+        end
+      end
+    end
+  end
+end

data/lib/a11y/lint/erb_runner.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require "nokogiri"
+
+module A11y
+  module Lint
+    # Parses ERB templates and checks them against accessibility rules.
+    class ErbRunner
+      ERB_TAG = /<%.*?%>/m
+      ERB_OUTPUT_TAG = /<%=\s*(.*?)\s*-?%>/m
+
+      def initialize(rules)
+        @rules = rules
+      end
+
+      def run(source, filename:)
+        @filename = filename
+        @offenses = []
+
+        check_html_nodes(source)
+        check_erb_output_tags(source)
+
+        @offenses
+      end
+
+      private
+
+      attr_reader :rules
+
+      def check_html_nodes(source)
+        html = source.gsub(ERB_TAG, "")
+        doc = Nokogiri::HTML4::DocumentFragment.parse(html)
+
+        doc.traverse do |nokogiri_node|
+          next unless nokogiri_node.element?
+
+          node = ErbNode.new(nokogiri_node: nokogiri_node, line: nokogiri_node.line)
+          check_node(node)
+        end
+      end
+
+      def check_erb_output_tags(source)
+        source.scan(ERB_OUTPUT_TAG) do
+          match = Regexp.last_match
+          code = match[1]
+          line_number = source[0...match.begin(0)].count("\n") + 1
+          node = ErbNode.new(ruby_code: code, line: line_number)
+          check_node(node)
+        end
+      end
+
+      def check_node(node)
+        rules.each do |rule|
+          message = rule.check(node)
+          next unless message
+
+          @offenses << Offense.new(
+            rule: rule.name,
+            filename: @filename,
+            line: node.line,
+            message: message
+          )
+        end
+      end
+    end
+  end
+end

data/lib/a11y/lint/{runner.rb → slim_runner.rb}

@@ -3,7 +3,7 @@
 module A11y
   module Lint
     # Parses Slim templates and checks them against accessibility rules.
-    class Runner
+    class SlimRunner
       def initialize(rules)
         @rules = rules
       end

data/lib/a11y/lint/version.rb

@@ -2,6 +2,6 @@
 
 module A11y
   module Lint
-    VERSION = "0.3.1"
+    VERSION = "0.4.0"
   end
 end

data/lib/a11y/lint.rb

@@ -1,13 +1,16 @@
 # frozen_string_literal: true
 
 require "slim"
+require "nokogiri"
 require_relative "lint/version"
 require_relative "lint/offense"
 require_relative "lint/node"
+require_relative "lint/erb_node"
 require_relative "lint/rule"
 require_relative "lint/rules/image_tag_missing_alt"
 require_relative "lint/rules/img_missing_alt"
-require_relative "lint/runner"
+require_relative "lint/slim_runner"
+require_relative "lint/erb_runner"
 
 module A11y
   module Lint

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: a11y-lint
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Abdullah Hashim
@@ -9,6 +9,20 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.13'
 - !ruby/object:Gem::Dependency
   name: slim
   requirement: !ruby/object:Gem::Requirement
@@ -42,12 +56,14 @@ files:
 - exe/a11y-lint
 - lib/a11y/lint.rb
 - lib/a11y/lint/cli.rb
+- lib/a11y/lint/erb_node.rb
+- lib/a11y/lint/erb_runner.rb
 - lib/a11y/lint/node.rb
 - lib/a11y/lint/offense.rb
 - lib/a11y/lint/rule.rb
 - lib/a11y/lint/rules/image_tag_missing_alt.rb
 - lib/a11y/lint/rules/img_missing_alt.rb
-- lib/a11y/lint/runner.rb
+- lib/a11y/lint/slim_runner.rb
 - lib/a11y/lint/version.rb
 - sig/a11y/lint.rbs
 homepage: https://github.com/Guided-Rails/a11y-lint