eager_eye 0.7.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8d34dc13a536c66ca82e9495ba5e53b81c31f1e2764dea3ba8d64c434da69ec
-  data.tar.gz: d63753e0d80c366cc9b87fe6bcc5bc2f2ee1ba537e7363c2b6aadafffd5a4a05
+  metadata.gz: 171872ece399f7fb40631980c6a9a3691388f510f56bc1bf23307c47f4e71881
+  data.tar.gz: bc1d7e10759c6b20d3a05719891124e3221981ac5452a3bfd410c274c4ab09ab
 SHA512:
-  metadata.gz: bf3ff2ba24314b8b6e22385c82685d8909729f12ffc9d48531bd7fe4c6a1683e2aadb5692934ec300430dfdbc0cde795489e9a68a98072658a9452cd8e6e338b
-  data.tar.gz: fd73786c8c983b2bcc3d3860bf1036dc1525523dcce8ef06767760dfce57b813ee415679fa42cc7631830e8c4780f0bbbdecc61ae4563b964a983ada5c2c0d42
+  metadata.gz: cda4195e0e168cc83ec5fd069ff39bb9094d6b9f17c00b62f58241d694d4a0d1b8d97d8e94f467d0d01ac80fc44f2ac76b448d94c752cdaf65ff52a1d2b3914d
+  data.tar.gz: 79d78b12ffd9b6a6d087df6a25132b3e96832f375a0f29869ad3c630a30e73c8280a79af34190725ddcf02218302a506a5a8f5bfff477bb8c8f06231ba5b2535

data/CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.0] - 2025-12-16
+
+### Added
+
+- **VS Code Extension** - Released as a separate package
+  - Real-time diagnostics on file save
+  - Problem highlighting with squiggly underlines
+  - Quick fix actions for common issues
+  - Status bar showing issue count
+  - Commands: Analyze Current File, Analyze Workspace, Clear Diagnostics
+  - Configuration options for enabling/disabling features
+  - See: https://marketplace.visualstudio.com/items?itemName=hamzagedikkaya.eager-eye
+
+## [0.8.0] - 2025-12-16
+
+### Added
+
+- **RSpec Integration** - RSpec matchers for testing your codebase
+  - `pass_eager_eye` matcher for testing files and directories
+  - `only` option to run specific detectors
+  - `exclude` option to exclude files by glob pattern
+  - `max_issues` option for gradual migration (allows up to N issues)
+  - `require "eager_eye/rspec"` for easy integration
+  - Helpful failure messages with issue details
+
 ## [0.7.0] - 2025-12-15
 
 ### Added

data/README.md

@@ -4,6 +4,7 @@
 [![Gem Version](https://badge.fury.io/rb/eager_eye.svg)](https://badge.fury.io/rb/eager_eye)
 [![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.1-ruby.svg)](https://www.ruby-lang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![VS Code Extension](https://img.shields.io/badge/VS%20Code-Extension-blue.svg)](https://marketplace.visualstudio.com/items?itemName=hamzagedikkaya.eager-eye)
 
 **Static analysis tool for detecting N+1 queries in Rails applications.**
 
@@ -358,6 +359,46 @@ Apply this fix? [y/n/q] y
 
 > **Warning:** Auto-fix is experimental. Always review changes and run your test suite after applying fixes.
 
+## RSpec Integration
+
+EagerEye provides RSpec matchers for testing your codebase:
+
+```ruby
+# spec/rails_helper.rb
+require "eager_eye/rspec"
+
+# spec/eager_eye_spec.rb
+RSpec.describe "EagerEye Analysis" do
+  it "controllers have no N+1 issues" do
+    expect("app/controllers").to pass_eager_eye
+  end
+
+  it "serializers are clean" do
+    expect("app/serializers").to pass_eager_eye(only: [:serializer_nesting])
+  end
+
+  # Allow some issues during migration
+  it "legacy code is acceptable" do
+    expect("app/services/legacy").to pass_eager_eye(max_issues: 10)
+  end
+
+  it "models have no callback issues except legacy" do
+    expect("app/models").to pass_eager_eye(
+      only: [:callback_query],
+      exclude: ["app/models/legacy/**"]
+    )
+  end
+end
+```
+
+### Matcher Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `only` | `Array<Symbol>` | Run only specified detectors |
+| `exclude` | `Array<String>` | Glob patterns to exclude |
+| `max_issues` | `Integer` | Maximum allowed issues (default: 0) |
+
 ## Configuration
 
 ### Config File (.eager_eye.yml)
@@ -491,6 +532,18 @@ EagerEye uses static analysis, which means:
 
 For best results, use EagerEye alongside runtime tools like Bullet for comprehensive N+1 detection.
 
+## VS Code Extension
+
+EagerEye is also available as a VS Code extension for real-time analysis while coding.
+
+**Features:**
+- Real-time analysis on file save
+- Problem highlighting with squiggly underlines
+- Quick fix actions for common issues
+- Status bar showing issue count
+
+**Install:** Search for "EagerEye" in VS Code Extensions or visit the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=hamzagedikkaya.eager-eye).
+
 ## Development
 
 ```bash

data/lib/eager_eye/rspec/matchers.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module EagerEye
+  module RSpec
+    module Matchers
+      def pass_eager_eye(options = {})
+        PassEagerEyeMatcher.new(options)
+      end
+
+      class PassEagerEyeMatcher
+        def initialize(options = {})
+          @only = options[:only]
+          @exclude = options[:exclude] || []
+          @max_issues = options[:max_issues] || 0
+          @issues = []
+          @path = nil
+        end
+
+        def matches?(path)
+          @path = path
+          configure_eager_eye
+          analyzer = build_analyzer
+          @issues = analyzer.run
+          @issues.count <= @max_issues
+        end
+
+        def failure_message
+          message = "expected #{@path} to pass EagerEye analysis"
+          message += " (max #{@max_issues} issues)" if @max_issues.positive?
+          message += ", but found #{@issues.count} issue(s):\n\n"
+
+          @issues.group_by(&:file_path).each do |file, file_issues|
+            message += "#{file}:\n"
+            file_issues.each do |issue|
+              message += "  Line #{issue.line_number}: [#{issue.detector}] #{issue.message}\n"
+            end
+            message += "\n"
+          end
+
+          message
+        end
+
+        def failure_message_when_negated
+          "expected #{@path} to have EagerEye issues, but it passed"
+        end
+
+        def description
+          desc = "pass EagerEye analysis"
+          desc += " for #{@only.join(", ")}" if @only
+          desc += " (max #{@max_issues} issues)" if @max_issues.positive?
+          desc
+        end
+
+        private
+
+        def configure_eager_eye
+          EagerEye.reset_configuration!
+          EagerEye.configure do |config|
+            config.enabled_detectors = @only if @only
+            config.excluded_paths = @exclude unless @exclude.empty?
+            config.fail_on_issues = false
+          end
+        end
+
+        def build_analyzer
+          EagerEye::Analyzer.new(paths: [@path])
+        end
+      end
+    end
+  end
+end

data/lib/eager_eye/rspec.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "eager_eye"
+require "eager_eye/rspec/matchers"
+
+RSpec.configure do |config|
+  config.include EagerEye::RSpec::Matchers
+end

data/lib/eager_eye/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eager_eye
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - hamzagedikkaya
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-12-15 00:00:00.000000000 Z
+date: 2025-12-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ast
@@ -80,6 +80,8 @@ files:
 - lib/eager_eye/reporters/base.rb
 - lib/eager_eye/reporters/console.rb
 - lib/eager_eye/reporters/json.rb
+- lib/eager_eye/rspec.rb
+- lib/eager_eye/rspec/matchers.rb
 - lib/eager_eye/version.rb
 - sig/eager_eye.rbs
 homepage: https://github.com/hamzagedikkaya/eager_eye