minitest-substitute 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ada3a9ae885b2050d30579935751f6f6d6d3a668b299def79602098549897ff6
-  data.tar.gz: 2892e09363f655605a9c7f19da56cc40f2229d44cb332e4b583d50f193c18cef
+  metadata.gz: 5f27cada1056bf6ab2bc4d31d05eb6434d7434f196d59f43a449377d46e258df
+  data.tar.gz: 85aa4a49208eb50dd5f52826489ddb96b636896b56e3f2242990ab2e650f4075
 SHA512:
-  metadata.gz: 3222b3c80b2cf6aee7451d14f602b6aa154367a4ef95b873bc1917d2c76ab240df9183a2322c917507737059eb7a83b3d17f5952c8363f23874c04e4eaa81eda
-  data.tar.gz: d85e9ea4fb25448a7065c0d0c32a0aa28b00df47cc03495d72b2f8df8134c43fb7aadb920dda4c1b71792012a0bf048f1ac7f0e863bf55b4b30d4a6b780449bb
+  metadata.gz: 8564e7186a0967d7e8bf94b140c76640e8aea84c0d3e7144a1d312c05d7461c59a04b4450b9e279616be85adca22db87abcffbd88de5e743d5c0b6e560881191
+  data.tar.gz: 780c0a5bfd68c52e27fd5ce6786c18845ddb5d7e26bb4c1133dccf1f2189e306845900e3011744e9026b6e836147abe5b6fe9b64e1d6a10fea8d625b12ec9093

data/CHANGELOG.md

@@ -2,9 +2,15 @@
 
 Nothing so far
 
+## 0.3.0
+
+#### Additions
+* Substition of constants
+
 ## 0.2.1
 
-Nothing so far
+#### Changes
+* Defer evaluation of the substitution value block for specs
 
 ## 0.2.0
 

data/README.md

@@ -18,7 +18,7 @@ This comes in very handy when you have to derive from default configuration in o
 This gem is [cryptographically signed](https://guides.rubygems.org/security/#using-gems) in order to assure it hasn't been tampered with. Unless already done, please add the author's public key as a trusted certificate now:
 
 ```
-gem cert --add <(curl -Ls https://raw.github.com/svoop/minitest-substitute/main/certs/svoop.pem)
+gem cert --add <(curl -Ls https://bitcetera.com/downloads/gem-public_cert.pem)
 ```
 
 Add the following to the <tt>Gemfile</tt> or <tt>gems.rb</tt> of your [Bundler](https://bundler.io) powered Ruby project:
@@ -87,7 +87,7 @@ end
 $verbose           # => false
 ```
 
-And it works for hashes as well which comes in handy when you have to temporarily override the value of an environment variable:
+And it works for globals like `ENV` as well which comes in handy when you have to temporarily override the value of an environment variable:
 
 ```ruby
 ENV['EDITOR']     # => 'vi'
@@ -97,6 +97,43 @@ end
 ENV['EDITOR']     # => 'vi'
 ```
 
+You can even substitute constants, however, you have to use their absolute name starting with `::`:
+
+```ruby
+module Animals
+  DOG_MAKES = 'woof'
+  CAT_MAKES = 'meow'
+end
+
+Animals::DOG_MAKES     # => 'woof'
+with '::Animals::DOG_MAKES', Animals::CAT_MAKES do
+  Animals::DOG_MAKES   # => 'meow'
+end
+Animals::DOG_MAKES     # => 'woof'
+```
+
+Remember that class declarations are assigned to constants as well:
+
+```ruby
+class Dog
+  self.makes
+    'woof'
+  end
+end
+
+class Cat
+  self.makes
+    'meow'
+  end
+end
+
+Dog.makes     # => 'woof'
+with '::Dog', Cat do
+  Dog.makes   # => 'meow'
+end
+Dog.makes     # => 'woof'
+```
+
 It's safe to nest multiple `with` statements.
 
 ### Group of Tests

data/lib/minitest/substitute/spec.rb

@@ -9,13 +9,13 @@ Minitest::Spec::DSL.class_eval do
   # @param variable [String] instance or global variable name
   # @param substitute [Object] temporary substitution value
   # @param on [Object, Symbol, nil] substitute in the context of this object
-  #   or in the context of the declared subject if +:subject+ is set
+  #   or in the context of the declared subject if +nil+
   # @yield temporary substitution value (takes precedence over +substitute+ param)
-  def with(variable, substitute=nil, on: :subject, &block)
+  def with(variable, substitute=nil, on: nil, &block)
     substitutor = Minitest::Substitute::Substitutor.new(variable, on: on)
     before do
       substitutor.substitute(block ? instance_eval(&block) : substitute)
-      substitutor.on = subject if on == :subject && respond_to?(:subject)
+      substitutor.on = subject if on.nil? && respond_to?(:subject)
       substitutor.commit
     end
     after do
@@ -29,7 +29,7 @@ Minitest::Spec::DSL.class_eval do
     include(Module.new do
       define_method(:setup) do
         super()
-        instance_eval &block
+        instance_eval(&block)
       end
     end) # .then &:include
   end
@@ -38,7 +38,7 @@ Minitest::Spec::DSL.class_eval do
   def after(_type=nil, &block)
     include(Module.new do
       define_method(:teardown) do
-        instance_eval &block
+        instance_eval(&block)
       ensure
         super()
       end

data/lib/minitest/substitute/substitutor.rb

@@ -4,12 +4,10 @@ module Minitest
   module Substitute
     class Substitutor
 
-      EVAL_METHODS = [:instance_eval, :instance_eval, :class_eval].freeze
-
       attr_writer :on
 
-      def initialize(variable, on:)
-        @variable, @on = variable, on
+      def initialize(target, on:)
+        @target, @on = target, on
       end
 
       def substitute(value)
@@ -28,16 +26,32 @@ module Minitest
 
       private
 
-      def eval_method
-        EVAL_METHODS[@variable.count('@')]
-      end
-
       def get
-        @on.send(eval_method, @variable.to_s)
+        case @target
+        when /^@@/   # class variable
+          @on.class_eval @target.to_s
+        else   # constant, instance or global variable
+          @on.instance_eval @target.to_s
+        end
       end
 
       def set(value)
-        @on.send(eval_method, "#{@variable} = value")
+        case @target
+        when /^::/
+          remove_const @target
+          eval "#{@target} = value"
+        when /^@@/   # class variable
+          @on.class_eval "#{@target} = value"
+        else    # instance or global variable
+          @on.instance_eval "#{@target} = value"
+        end
+      end
+
+      # Remove constant without warning
+      def remove_const(const)
+        namespace, _, name = const.rpartition('::')
+        receiver = namespace == '' ? Object : Object.const_get(namespace)
+        receiver.send(:remove_const, name)
       end
 
     end

data/lib/minitest/substitute/version.rb

@@ -2,6 +2,6 @@
 
 module Minitest
   module Substitute
-    VERSION = '0.2.1'
+    VERSION = '0.3.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minitest-substitute
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Sven Schwyn
@@ -29,7 +29,7 @@ cert_chain:
   kAyiRqgxF4dJviwtqI7mZIomWL63+kXLgjOjMe1SHxfIPo/0ji6+r1p4KYa7o41v
   fwIwU1MKlFBdsjkd
   -----END CERTIFICATE-----
-date: 2023-09-06 00:00:00.000000000 Z
+date: 2023-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest