magic-support 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa812d41502d5c332298c520006236fb6c6535e8403e0beb253354712f7694e8
-  data.tar.gz: 2029e9de5202d7c451264ae71ef471d76723e89451556b3db6c511b51102f05d
+  metadata.gz: e3dffa896a85c7423e7b1ad3efe36699cad07cf6703c97ba6ed4c4c28d5ad388
+  data.tar.gz: 8897d2aad72a04861e835d5483d5a426210a284594e1da521609689399c25da4
 SHA512:
-  metadata.gz: 987615bca255fc3fe46178003bcea2e96df7ce8b55ae07f3b73551c8631209ddb0dea1da5931bc48396b1c983538507b96c185ebde57cbbcab40e828366753fc
-  data.tar.gz: 4cce946f3b7dc0211041516e9d9fa5ab083b6610af51fd63e9f2f062bbedd5d383bb4039d4e6c7f02a0009272f938fe826480b782f9229c6a1b22308a82e5499
+  metadata.gz: 3aa49f7609147b8452ed86157288b4aa5b039fee7920a94ea9c0cc967032d54a8060f1473e39d7b32e9a9d0f25f5c1f2ca4bf8967954c5e13b429547e08951e3
+  data.tar.gz: 34e4287e50b6354b5af181c1cea9e15fb1ebdfa9ff9e117b28fd074af1b630d5c49d4fdfe3ea01716207c1fa0f12e958580478b1df120b9404fee690817c91b9

data/CHANGELOG.md

@@ -1,5 +1,43 @@
+## [0.3.0] — 2025-05-18
+
+### RSpec
+
+#### Method specs
+
+##### Changed
+
+- Set tested method’s owner to an overridden subject if any.
+
+##### Added
+
+- Support for nesting of method specs.
+- Support for named overridden subjects to follow the original RSpec API.
+
+##### Fixed
+
+- `receiver` should always be equal to `subject.receiver`.
+
+
+## [0.2.1] — 2025-05-13
+
+### RSpec
+
+#### Method specs
+
+##### Fixed
+
+- Method specs with implicit subjects got broken in v0.2.0.
+
+
 ## [0.2.0] — 2025-05-13
 
+### Core extensions
+
+#### Fixed
+
+- Don’t forget to `require 'pathname'` as it’s not a core class.
+- Don’t load all core extensions unless required explicitly.
+
 ### RSpec
 
 #### Method specs

data/README.md

@@ -219,6 +219,12 @@ RSpec.describe MyModule do
 end
 ```
 
+##### Nesting
+
+One may nest method specs.
+This could be useful when a method being tested affects other methods.
+See the spec for examples.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/magic/support/version.rb

@@ -2,6 +2,6 @@
 
 module Magic
 	module Support
-		VERSION = '0.2.0'
+		VERSION = '0.3.0'
 	end
 end

data/lib/rspec/method/its.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module RSpec
+	module Method # :nodoc:
+		# Adds the `its_result` to RSpec method example groups.
+		# Included by default.
+		module Its
+			def its_result(*args, &) = its(args, &)
+		end
+
+		ExampleGroup::ClassMethods.include Its
+	end
+end

data/lib/rspec/method.rb

@@ -11,7 +11,7 @@ module RSpec # :nodoc:
 		}
 				.map { |name, pattern| "(?<#{name}>#{pattern})" }
 				.join
-				.then { /(?:^|\s)#{_1}(?:$|\s)/ } # may be surrounded by some text
+				.then { /(?:^|\s)#{_1}\b/ } # may be surrounded by some text
 
 		# @api public
 		# Container module for method specs.
@@ -21,39 +21,57 @@ module RSpec # :nodoc:
 			included do
 				metadata[:type] ||= :method
 
-				description.match(REFERENCE) in { scope:, name: } or
-						raise ArgumentError, "'#{description}' doesn't look like a method reference"
-
-				subject_method = instance_method :subject
-
-				while subject_method.owner.then { not _1.respond_to? :metadata or _1.metadata[:method] }
-					subject_method = subject_method.super_method or break
-				end
+				setup_method_context
+			end
 
-				let :receiver do
-					case [ scope, subject_method&.bind_call(self) || super() ]
-					in '#', receiver
-						receiver
-					in '.', Module => receiver
-						receiver
-					in '.', receiver
-						receiver.class
+			class_methods do
+				def subject(name = nil, &)
+					if name
+						alias_method :__subject__, let(name, &)
+
+						self::NamedSubjectPreventSuper.__send__ :define_method, name do
+							raise NotImplementedError, '`super` in named subjects is not supported'
+						end
+					else
+						let :__subject__, &
 					end
 				end
 
-				let(:method_name) { name.to_sym }
-			end
+				private
 
-			class_methods do
-				def subject(&)
-					prepend Module.new {
-						define_method(:subject) { super().unbind.bind instance_eval(&) }
-					}
+				def setup_method_context
+					description.match(REFERENCE) in { scope:, name: } or
+							raise ArgumentError, "'#{description}' doesn't look like a method reference"
+
+					backup_subject
+
+					let :receiver do
+						case [ scope, __subject__ ]
+						in '#', receiver
+							receiver
+						in '.', Module => receiver
+							receiver
+						in '.', receiver
+							receiver.class
+						end
+					end
+
+					let(:method_name) { name.to_sym }
 				end
 
-				next unless defined? RSpec::Its
+				def backup_subject
+					subject_method = instance_method :subject
+
+					while subject_method.owner.then { not _1.respond_to? :metadata or _1.metadata[:method] }
+						subject_method = subject_method.super_method or break
+					end
 
-				def its_result(*args, &) = its(args, &)
+					if subject_method
+						let(:__subject__) { subject_method.bind_call self }
+					else
+						let(:__subject__) { method(:subject).super_method[] }
+					end
+				end
 			end
 
 			def subject
@@ -69,6 +87,8 @@ module RSpec # :nodoc:
 		end
 	end
 
+	require_relative 'method/its' if defined? Its
+
 	shared_context :method, description: Method::REFERENCE do
 		include Method::ExampleGroup
 
@@ -88,6 +108,12 @@ module RSpec # :nodoc:
 		end
 	end
 
+	shared_context :nested_method, full_description: /(.*#{Method::REFERENCE}){2,}/ do
+		next unless metadata[:description].match? Method::REFERENCE
+
+		setup_method_context
+	end
+
 	configure do
 		_1.backtrace_exclusion_patterns << %r'/lib/rspec/method'
 	end

data/sig/rspec/method/its.rbs

@@ -0,0 +1,7 @@
+module RSpec
+	module Method
+		module Its
+			def its_result: (*untyped) -> void
+		end
+	end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: magic-support
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Alexander Senko
 bindir: bin
 cert_chain: []
-date: 2025-05-13 00:00:00.000000000 Z
+date: 2025-05-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -46,6 +46,7 @@ files:
 - lib/magic/support/authors.rb
 - lib/magic/support/version.rb
 - lib/rspec/method.rb
+- lib/rspec/method/its.rb
 - lib/rubygems/author.rb
 - sig/lib/magic/support/author.rbs
 - sig/magic/core_ext.rbs
@@ -53,13 +54,14 @@ files:
 - sig/magic/loader.rbs
 - sig/magic/support.rbs
 - sig/rspec/method.rbs
+- sig/rspec/method/its.rbs
 - sig/rubygems/author.rbs
 homepage: https://github.com/Alexander-Senko/magic-support
 licenses:
 - MIT
 metadata:
   source_code_uri: https://github.com/Alexander-Senko/magic-support
-  changelog_uri: https://github.com/Alexander-Senko/magic-support/blob/v0.2.0/CHANGELOG.md
+  changelog_uri: https://github.com/Alexander-Senko/magic-support/blob/v0.3.0/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib