eager_eye 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 031e0f3547538856718932cd6121ac990ad8c11a43682ec076f68bb591943d55
-  data.tar.gz: 433563980a743704c361304dff56866fe4cc9795a1d6f927cd0b4a8fc0367c8f
+  metadata.gz: 34e0c9e78e18d9d8c9a6cad8ee96a91c89ac469d9dc662e43a51f09d361a3200
+  data.tar.gz: 90554fbbe09380116398c8139c6d09ca5851d1e12d2eb52c32cf85f8c8fdc76a
 SHA512:
-  metadata.gz: 5c9f874001fb0c71eb8c1858ef2739181482992b7455925afc696acfa1b7bebfa91888d305936ab6189f64ea1542afd7844b95c4ba453218d0c706d40d17304b
-  data.tar.gz: 93750c566392f234cb5009d30873130182a4e80722b9f29402b662caacc0c961a31a8c109937c378f9a04b3d0f6e134326a0edeb0d138255debc2c9fb4ceb9a3
+  metadata.gz: 86605c1632ed47aaae05e26d810c6611dac2f356503502b71a94a389b1d58148cbb5146e5e6cbc5e9f809f4b6bf2b78d983cbf8484c0bab6d1e9a046ab0a242b
+  data.tar.gz: bb3e07e2b8e799067aa475f6b8ffea6a303e797e3eac252f46f597eec751f42451f91fd97eacf024aae8a6129267ef2b425fdd26163a6b893714cb22c2d9ddfa

data/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2025-12-15
+
+### Added
+
+- **Inline Suppression Comments** - RuboCop-style comment directives for suppressing false positives
+  - `# eager_eye:disable DetectorName` - Disable for single line (inline) or start block
+  - `# eager_eye:disable-next-line DetectorName` - Disable only the next line
+  - `# eager_eye:disable-file DetectorName` - Disable for entire file (must be in first 5 lines)
+  - `# eager_eye:enable DetectorName` - End a disable block
+  - Support for multiple detectors: `# eager_eye:disable LoopAssociation, CountInIteration`
+  - Support for reason comments: `# eager_eye:disable DetectorName -- reason here`
+  - `all` keyword to disable all detectors at once
+  - Both CamelCase (`LoopAssociation`) and snake_case (`loop_association`) detector names accepted
+
+### Changed
+
+- Updated README with inline suppression documentation
+- Added `CommentParser` module for parsing suppression directives
+
 ## [0.5.0] - 2025-12-15
 
 ### Added

data/README.md

@@ -272,6 +272,50 @@ Post.where(user_id: User.active.select(:id))
 | `pluck` + `where` | 2 | ~80KB for IDs | ~45ms |
 | `select` subquery | 1 | None | ~20ms |
 
+## Inline Suppression
+
+Suppress false positives using inline comments (RuboCop-style):
+
+```ruby
+# Disable for single line
+user.posts.count  # eager_eye:disable CountInIteration
+
+# Disable for next line
+# eager_eye:disable-next-line LoopAssociation
+@users.each { |u| u.profile }
+
+# Disable block
+# eager_eye:disable LoopAssociation, SerializerNesting
+@users.each do |user|
+  user.posts.each { |p| p.author }
+end
+# eager_eye:enable LoopAssociation, SerializerNesting
+
+# Disable entire file (must be in first 5 lines)
+# eager_eye:disable-file CustomMethodQuery
+
+# With reason
+user.posts.count  # eager_eye:disable CountInIteration -- using counter_cache
+
+# Disable all detectors
+# eager_eye:disable all
+```
+
+### Available Detector Names
+
+Both CamelCase and snake_case formats are accepted:
+
+| Detector | CamelCase | snake_case |
+|----------|-----------|------------|
+| Loop Association | `LoopAssociation` | `loop_association` |
+| Serializer Nesting | `SerializerNesting` | `serializer_nesting` |
+| Missing Counter Cache | `MissingCounterCache` | `missing_counter_cache` |
+| Custom Method Query | `CustomMethodQuery` | `custom_method_query` |
+| Count in Iteration | `CountInIteration` | `count_in_iteration` |
+| Callback Query | `CallbackQuery` | `callback_query` |
+| Pluck to Array | `PluckToArray` | `pluck_to_array` |
+| All Detectors | `all` | `all` |
+
 ## Configuration
 
 ### Config File (.eager_eye.yml)

data/lib/eager_eye/analyzer.rb

@@ -58,8 +58,16 @@ module EagerEye
       ast = parse_source(source)
       return unless ast
 
+      comment_parser = CommentParser.new(source)
+
       enabled_detectors.each do |detector|
         file_issues = detector.detect(ast, file_path)
+
+        # Filter suppressed issues
+        file_issues.reject! do |issue|
+          comment_parser.disabled_at?(issue.line_number, issue.detector)
+        end
+
         @issues.concat(file_issues)
       end
     rescue Errno::ENOENT, Errno::EACCES => e

data/lib/eager_eye/comment_parser.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+module EagerEye
+  class CommentParser
+    DISABLE_PATTERN = /eager_eye:disable(?:-next-line|-file)?\s+(.+?)(?:\s+--|$)/i
+    ENABLE_PATTERN = /eager_eye:enable\s+(.+?)(?:\s+--|$)/i
+    INLINE_DISABLE_PATTERN = /eager_eye:disable\s+(.+?)(?:\s+--|$)/i
+    FILE_DISABLE_PATTERN = /eager_eye:disable-file\s+(.+?)(?:\s+--|$)/i
+    NEXT_LINE_PATTERN = /eager_eye:disable-next-line\s+(.+?)(?:\s+--|$)/i
+    BLOCK_DISABLE_PATTERN = /eager_eye:disable\s+(.+?)(?:\s+--|$)/i
+
+    def initialize(source_code)
+      @source_code = source_code
+      @lines = source_code.lines
+      @disabled_ranges = Hash.new { |h, k| h[k] = [] }
+      @file_disabled = Set.new
+      @current_disabled = Set.new
+      parse_comments
+    end
+
+    def disabled_at?(line_number, detector_name)
+      return true if @file_disabled.include?(detector_name.to_s)
+      return true if @file_disabled.include?("all")
+
+      detector = detector_name.to_s
+      @disabled_ranges[detector].any? { |range| range.cover?(line_number) } ||
+        @disabled_ranges["all"].any? { |range| range.cover?(line_number) }
+    end
+
+    private
+
+    def parse_comments
+      @lines.each_with_index do |line, index|
+        line_num = index + 1
+        process_line(line, line_num)
+      end
+
+      close_unclosed_blocks
+    end
+
+    def process_line(line, line_num)
+      directive = detect_directive(line, line_num)
+      apply_directive(directive, line_num) if directive
+    end
+
+    def detect_directive(line, line_num)
+      detect_file_directive(line, line_num) ||
+        detect_next_line_directive(line) ||
+        detect_block_directive(line) ||
+        detect_enable_directive(line) ||
+        detect_inline_directive(line)
+    end
+
+    def detect_file_directive(line, line_num)
+      return unless line_num <= 5 && line =~ FILE_DISABLE_PATTERN
+
+      { type: :file, detectors: parse_detector_names(::Regexp.last_match(1)) }
+    end
+
+    def detect_next_line_directive(line)
+      return unless line =~ NEXT_LINE_PATTERN
+
+      { type: :next_line, detectors: parse_detector_names(::Regexp.last_match(1)) }
+    end
+
+    def detect_block_directive(line)
+      return unless line =~ BLOCK_DISABLE_PATTERN && !inline_disable?(line)
+
+      { type: :block_start, detectors: parse_detector_names(::Regexp.last_match(1)) }
+    end
+
+    def detect_enable_directive(line)
+      return unless line =~ ENABLE_PATTERN
+
+      { type: :block_end, detectors: parse_detector_names(::Regexp.last_match(1)) }
+    end
+
+    def detect_inline_directive(line)
+      return unless line =~ INLINE_DISABLE_PATTERN
+
+      { type: :inline, detectors: parse_detector_names(::Regexp.last_match(1)) }
+    end
+
+    def apply_directive(directive, line_num)
+      case directive[:type]
+      when :file then apply_file_disable(directive[:detectors])
+      when :next_line then apply_next_line_disable(directive[:detectors], line_num)
+      when :block_start then apply_block_start(directive[:detectors], line_num)
+      when :block_end then apply_block_end(directive[:detectors], line_num)
+      when :inline then apply_inline_disable(directive[:detectors], line_num)
+      end
+    end
+
+    def apply_file_disable(detectors)
+      @file_disabled.merge(detectors)
+    end
+
+    def apply_next_line_disable(detectors, line_num)
+      next_line = line_num + 1
+      detectors.each { |d| @disabled_ranges[d] << (next_line..next_line) }
+    end
+
+    def apply_block_start(detectors, line_num)
+      detectors.each { |d| @current_disabled << { detector: d, start: line_num } }
+    end
+
+    def apply_block_end(detectors, line_num)
+      detectors.each do |d|
+        entry = @current_disabled.find { |e| e[:detector] == d }
+        next unless entry
+
+        @disabled_ranges[d] << (entry[:start]..line_num)
+        @current_disabled.delete(entry)
+      end
+    end
+
+    def apply_inline_disable(detectors, line_num)
+      detectors.each { |d| @disabled_ranges[d] << (line_num..line_num) }
+    end
+
+    def close_unclosed_blocks
+      @current_disabled.each do |entry|
+        @disabled_ranges[entry[:detector]] << (entry[:start]..@lines.size)
+      end
+    end
+
+    def inline_disable?(line)
+      code_part = line.split("#").first
+      code_part && !code_part.strip.empty?
+    end
+
+    def parse_detector_names(str)
+      str.split(/[,\s]+/).map(&:strip).reject(&:empty?).map do |name|
+        normalize_detector_name(name)
+      end
+    end
+
+    def normalize_detector_name(name)
+      name.gsub(/([A-Z])/) { "_#{::Regexp.last_match(1).downcase}" }
+          .sub(/^_/, "")
+          .downcase
+    end
+  end
+end

data/lib/eager_eye/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EagerEye
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

data/lib/eager_eye.rb

@@ -11,6 +11,7 @@ require_relative "eager_eye/detectors/custom_method_query"
 require_relative "eager_eye/detectors/count_in_iteration"
 require_relative "eager_eye/detectors/callback_query"
 require_relative "eager_eye/detectors/pluck_to_array"
+require_relative "eager_eye/comment_parser"
 require_relative "eager_eye/analyzer"
 require_relative "eager_eye/reporters/base"
 require_relative "eager_eye/reporters/console"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: eager_eye
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - hamzagedikkaya
@@ -59,6 +59,7 @@ files:
 - lib/eager_eye.rb
 - lib/eager_eye/analyzer.rb
 - lib/eager_eye/cli.rb
+- lib/eager_eye/comment_parser.rb
 - lib/eager_eye/configuration.rb
 - lib/eager_eye/detectors/base.rb
 - lib/eager_eye/detectors/callback_query.rb