rubocop-rspec-guide 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dbcc5261e61c2e9d16ccfa146e62046779e7e48f782a8fdb5003203cd55a99a4
-  data.tar.gz: 3b8c2dae7e97d1d892ba9077944c93de7370803ed3c92edfeb2e43e33a4f9c3f
+  metadata.gz: 0c6e4154c7d3d386bd161fa1405ac9e36eb2152fbf38f568a3fa15698a53e7ab
+  data.tar.gz: 86b32810a2ad0c401d6757297ca6880d454966d9355aa7de45f69026cf4426d3
 SHA512:
-  metadata.gz: f599508c8ad0870461f04847d6b6c727647557c645231b46df9e8bc63737e2118f50d9590fe7cfbec29668941170fe138187bb939bb0d750938f696c5de4bb2c
-  data.tar.gz: 8c9820bc4f21d0a7e82b1711f3abfc85a7131bc7b27b7b46b72c719f02c9426b4ad53f42512e6050677aa41ba903a1db1d45444fba35cd80fe609f0252b75b56
+  metadata.gz: 59676351d5629e7947ce2123819409a90657976b064b0386f1488f5593f7760b65f81d9a1911468e5ed4ebf85ce529f15dbaf3ce4249d51fb0f4ab4cbd122770
+  data.tar.gz: 43841a5b040e380c13f8210c55ac1297b7b7b6570a4438d0d4f30951b7a29313ae4af55295fe8d4069e8434a3f33b0b542d15de76b6d80524a40fd976dd9f820

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+## [0.2.1] - 2025-10-29
+
+### Changed
+- **RSpecGuide/HappyPathFirst**: Allow corner case contexts when examples (it/specify) appear before first context
+  - Examples before contexts are considered happy path
+  - No offense if at least one example exists before the first context
+
 ## [0.2.0] - 2025-10-28
 
 ### Changed

data/lib/rubocop/cop/rspec_guide/happy_path_first.rb

@@ -6,6 +6,10 @@ module RuboCop
       # Checks that corner cases are not the first context in a describe block.
       # Happy path should come first for better readability.
       #
+      # The cop allows corner case contexts to appear first if there are
+      # example blocks (it/specify) before the first context, as those examples
+      # represent the happy path.
+      #
       # @example
       #   # bad
       #   describe '#process' do
@@ -37,6 +41,17 @@ module RuboCop
       #     end
       #   end
       #
+      #   # good - examples before first context represent happy path
+      #   describe '#add_child' do
+      #     it 'adds child to children collection' do
+      #       # ...
+      #     end
+      #
+      #     context 'but child is already in collection' do
+      #       # ...
+      #     end
+      #   end
+      #
       class HappyPathFirst < Base
         MSG = "Place happy path contexts before corner cases. " \
               "First context appears to be a corner case: %<description>s"
@@ -67,6 +82,10 @@ module RuboCop
           contexts = collect_direct_child_contexts(node)
           return if contexts.size < 2
 
+          # If there are any examples (it/specify) before the first context,
+          # this is a happy path, so no offense
+          return if has_examples_before_first_context?(node, contexts.first)
+
           # Check first context
           context_with_description?(contexts.first) do |description|
             if corner_case_context?(description)
@@ -80,6 +99,30 @@ module RuboCop
 
         private
 
+        def has_examples_before_first_context?(node, first_context)
+          body = node.body
+          return false unless body
+
+          children = body.begin_type? ? body.children : [body]
+
+          children.each do |child|
+            # Stop when we reach the first context
+            break if child == first_context
+
+            # Check if this is an example (it/specify)
+            return true if example?(child)
+          end
+
+          false
+        end
+
+        def example?(node)
+          return false unless node.block_type?
+
+          send_node = node.send_node
+          send_node.method?(:it) || send_node.method?(:specify)
+        end
+
         def collect_direct_child_contexts(node)
           body = node.body
           return [] unless body

data/lib/rubocop/rspec/guide/version.rb

@@ -3,7 +3,7 @@
 module RuboCop
   module RSpec
     module Guide
-      VERSION = "0.2.0"
+      VERSION = "0.2.1"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubocop-rspec-guide
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Alexey Matskevich