fixturama 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d125eca2dd9b59fd748fcda2748c0c115ecdb5958af0f3c2b5d398fdcd4d89f5
-  data.tar.gz: b98edf3a52f9df3513ddd92d444b1b75ea00a1caa29f014023a2f84bd17f21e6
+  metadata.gz: 48e09d4c2f2bc2eade2e53915d3a5e6ea365b7af3774da48f72bf9ca30fd1554
+  data.tar.gz: e451162201f818ca015827b3eb866ac87515730686cffb739fe8ca061e39800e
 SHA512:
-  metadata.gz: b33fdbb647c02d07974520a47212ea31187d16b7ac51fc216c9856c115206270518553b2963b735fac7bacc3e17db6a6d4258e67db802d7e50413c8d1b304797
-  data.tar.gz: b5f4722c8df63e599004c33d9afe383ce329124d9233daf1b3958ca283566f4eca24ca43c632073c8a5a7214a679ff9914fd17510303c5aaa41a8b37cc6f35f2
+  metadata.gz: 52394f8c73eb43946a084e830b0364106b3ce5dedcc9e7155bef17b25b0a7a6df1ccbb55c2252ff64565a64d299b5db7df2c09a2c6bfa2f649c422031126b89a
+  data.tar.gz: 273c09ddb0ef0f0b3270693c2d3eb38992ae91cd72821e1b0059198b840c8b91946aefe3ae32ca8413deeaaca5691f830fa5a5d9fff64fbd44ab1d8c4c2782aa

data/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.0.5] - [2018-06-04]
+
+### Added
+
+- Support for stubbing constants (nepalez)
+
+  ```yaml
+  # Stub constant TIMEOUT_SEC to 10
+  ---
+  - const: TIMEOUT_SEC
+    value: 10
+  ```
+
 ## [0.0.4] - [2018-05-22]
 
 ### Added
@@ -68,3 +81,4 @@ This is a first public release with features extracted from production app.
 [0.0.2]: https://github.com/nepalez/fixturama/compare/v0.0.1...v0.0.2
 [0.0.3]: https://github.com/nepalez/fixturama/compare/v0.0.2...v0.0.3
 [0.0.4]: https://github.com/nepalez/fixturama/compare/v0.0.3...v0.0.4
+[0.0.5]: https://github.com/nepalez/fixturama/compare/v0.0.4...v0.0.5

data/README.md

@@ -2,6 +2,8 @@
 
 Collection of helpers for dealing with fixtures in [RSpec][rspec]
 
+Read the [post about the library on dev.to][dev_to].
+
 <a href="https://evilmartians.com/">
 <img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" alt="Sponsored by Evil Martians" width="236" height="54"></a>
 
@@ -90,13 +92,20 @@ The seed (`seed_fixture`) file should be a YAML/JSON with opinionated parameters
 
 Use the `count: 2` key to create more objects at once.
 
-Another opinionated format we use for stubs (`stub_fixture`):
+Another opinionated format we use for stubs (`stub_fixture`). The gem supports stubbing both message chains and constants.
+
+For message chains:
 
 - `class` for stubbed class
 - `chain` for messages chain
 - `arguments` (optional) for specific arguments
 - `actions` for an array of actions for consecutive invocations of the chain
 
+For constants:
+
+- `const` for stubbed constant
+- `value` for a value of the constant
+
 Every action either `return` some value, or `raise` some exception
 
 ```yaml
@@ -126,6 +135,9 @@ Every action either `return` some value, or `raise` some exception
   actions:
     - return: true
     - raise: ActiveRecord::RecordNotFound
+
+- const: NOTIFIER_TIMEOUT_SEC
+  value: 10
 ```
 
 ```graphql
@@ -168,3 +180,4 @@ The gem is available as open source under the terms of the [MIT License][license
 [license]: http://opensource.org/licenses/MIT
 [factory-bot]: https://github.com/thoughtbot/factory_bot
 [rspec]: https://rspec.info/
+[dev_to]: https://dev.to/evilmartians/a-fixture-based-approach-to-interface-testing-in-rails-2cd4

data/fixturama.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |gem|
   gem.name     = "fixturama"
-  gem.version  = "0.0.4"
+  gem.version  = "0.0.5"
   gem.author   = "Andrew Kozin (nepalez)"
   gem.email    = "andrew.kozin@gmail.com"
   gem.homepage = "https://github.com/nepalez/fixturama"

data/lib/fixturama/stubs/{actions → chain/actions}/raise.rb

@@ -1,4 +1,4 @@
-class Fixturama::Stubs::Actions::Raise
+class Fixturama::Stubs::Chain::Actions::Raise
   def call
     raise @exception
   end

data/lib/fixturama/stubs/{actions → chain/actions}/return.rb

@@ -1,4 +1,4 @@
-class Fixturama::Stubs::Actions::Return
+class Fixturama::Stubs::Chain::Actions::Return
   attr_reader :stub, :call
 
   #

data/lib/fixturama/stubs/{actions.rb → chain/actions.rb}

@@ -2,7 +2,7 @@ module Fixturama
   #
   # Factory to provide a specific action from options
   #
-  module Stubs::Actions
+  module Stubs::Chain::Actions
     extend self
 
     require_relative "actions/raise"

data/lib/fixturama/stubs/{arguments.rb → chain/arguments.rb}

@@ -2,7 +2,7 @@ module Fixturama
   #
   # Collection of arguments for a stub with a list of actions to be called
   #
-  class Stubs::Arguments
+  class Stubs::Chain::Arguments
     attr_reader :chain, :arguments
 
     #
@@ -15,7 +15,7 @@ module Fixturama
       actions.each do |settings|
         settings = Utils.symbolize_hash(settings)
         repeat   = [0, settings.fetch(:repeat, 1).to_i].max
-        repeat.times { list << Stubs::Actions.build(self, settings) }
+        repeat.times { list << Stubs::Chain::Actions.build(self, settings) }
       end
 
       self

data/lib/fixturama/stubs/chain.rb

@@ -3,8 +3,20 @@ module Fixturama
   # Stubbed chain of messages
   #
   class Stubs::Chain
+    require_relative "chain/actions"
+    require_relative "chain/arguments"
+
     attr_reader :receiver, :messages
 
+    #
+    # Human-readable representation of the chain
+    # @return [String]
+    #
+    def to_s
+      "#{receiver}.#{messages.join(".")}"
+    end
+    alias to_str to_s
+
     #
     # Register new action for some arguments
     #
@@ -12,11 +24,11 @@ module Fixturama
     # @option (see Fixturama::Stubs::Arguments#add_action)
     # @return [self]
     #
-    def add(actions:, arguments: nil, **)
+    def update!(actions:, arguments: nil, **)
       Utils.array(arguments).tap do |args|
         stub = find_by(args)
         unless stub
-          stub = Stubs::Arguments.new(self, args)
+          stub = Stubs::Chain::Arguments.new(self, args)
           stubs << stub
         end
         stub.add!(*actions)
@@ -27,31 +39,16 @@ module Fixturama
     end
 
     #
-    # Resets all counters
-    # @return [self] itself
+    # Apply the stub to RSpec example
     #
-    def reset!
-      tap { stubs.each(&:reset!) }
-    end
+    def apply!(example)
+      reset!
 
-    #
-    # Executes the corresponding action
-    # @return [Object]
-    # @raise  [StandardError]
-    #
-    def call!(actual_arguments)
-      stub = stubs.find { |item| item.applicable_to?(actual_arguments) }
-      raise "Unexpected arguments #{actual_arguments}" unless stub
-
-      stub.call_next!
-    end
+      call_action = example.send(:receive_message_chain, *messages) do |*args|
+        call! args
+      end
 
-    #
-    # Human-readable representation of the chain
-    # @return [String]
-    #
-    def to_s
-      "#{receiver}.#{messages.join(".")}"
+      example.send(:allow, receiver).to call_action
     end
 
     private
@@ -74,5 +71,16 @@ module Fixturama
     def find_by(arguments)
       stubs.find { |stub| stub.arguments == arguments }
     end
+
+    def reset!
+      tap { stubs.each(&:reset!) }
+    end
+
+    def call!(actual_arguments)
+      stub = stubs.find { |item| item.applicable_to?(actual_arguments) }
+      raise "Unexpected arguments #{actual_arguments}" unless stub
+
+      stub.call_next!
+    end
   end
 end

data/lib/fixturama/stubs/const.rb

@@ -0,0 +1,42 @@
+module Fixturama
+  #
+  # Definition for stubbing a constant
+  #
+  class Stubs::Const
+    attr_reader :const, :value
+
+    #
+    # Human-readable representation of the chain
+    # @return [String]
+    #
+    def to_s
+      const.to_s
+    end
+    alias to_str to_s
+
+    #
+    # Overload the definition for the constant
+    # @option [Object] value
+    # @return [self]
+    #
+    def update!(value:, **)
+      @value = value
+      self
+    end
+
+    #
+    # Apply the stub to RSpec example
+    # @return [self]
+    #
+    def apply!(example)
+      example.send(:stub_const, const, value)
+      self
+    end
+
+    private
+
+    def initialize(const:, **)
+      @const = const.to_s
+    end
+  end
+end

data/lib/fixturama/stubs.rb

@@ -3,47 +3,57 @@ module Fixturama
   # Collection of stubbed calls
   #
   class Stubs
-    require_relative "stubs/actions"
-    require_relative "stubs/arguments"
     require_relative "stubs/chain"
+    require_relative "stubs/const"
 
     #
     # Register new action and apply the corresponding stub
     #
-    # @option [#to_s]        :class Class to stub
-    # @option [Array<#to_s>] :chain Methods chain for stubbing
-    # @option (see Fixturama::Stubs::Method#add)
+    # @params [Hash<#to_s, _>] options
     # @return [self] itself
     #
     def add(options)
-      tap do
-        options = Utils.symbolize_hash(options)
-
-        options.select { |key| %i[class chain].include?(key) }.tap do |anchors|
-          chains[anchors] ||= Chain.new(anchors)
-          chains[anchors].add(options)
-        end
-      end
+      options = symbolize(options)
+      find_or_create_stub!(options)&.update!(options)
+      self
     end
 
     #
     # Applies the stub to RSpec example
     #
     def apply(example)
-      chains.values.each do |chain|
-        chain.reset!
-        call_action = \
-          example.send(:receive_message_chain, *chain.messages) do |*args|
-            chain.call! args
-          end
-        example.send(:allow, chain.receiver).to call_action
-      end
+      @stubs.values.each { |stub| stub.apply!(example) }
     end
 
     private
 
-    def chains
-      @chains ||= {}
+    def initialize
+      @stubs = {}
+    end
+
+    def find_or_create_stub!(options)
+      case stub_type(options)
+      when :message_chain
+        anchor = options.slice(:class, :chain)
+        @stubs[anchor] ||= Chain.new(anchor)
+      when :constant
+        anchor = options.slice(:const)
+        @stubs[anchor] ||= Const.new(anchor)
+      end
+    end
+
+    def stub_type(options)
+      return :message_chain if options[:class]
+      return :constant      if options[:const]
+
+      raise ArgumentError, <<~MESSAGE
+        Cannot figure out what to stub from #{options}.
+        You should define either a class and a message chain, or some const.
+      MESSAGE
+    end
+
+    def symbolize(options)
+      Hash(options).transform_keys { |key| key.to_s.to_sym }
     end
   end
 end

data/spec/fixturama/stub_fixture/_spec.rb

@@ -15,7 +15,7 @@ RSpec.describe "stub_fixture" do
     it { is_expected.to eq [5] }
   end
 
-  context "with stubbing" do
+  context "when message chain stubbed" do
     before { stub_fixture "#{__dir__}/stub.yml" }
 
     context "with a :raise option" do
@@ -66,4 +66,15 @@ RSpec.describe "stub_fixture" do
       end
     end
   end
+
+  context "when constant stubbed" do
+    before do
+      TIMEOUT = 20
+      stub_fixture "#{__dir__}/stub.yml"
+    end
+
+    it "stubs the constant" do
+      expect(TIMEOUT).to eq 10
+    end
+  end
 end

data/spec/fixturama/stub_fixture/stub.yml

@@ -45,3 +45,6 @@
     - return: 6
       repeat: 2
     - return: 0
+
+- const: TIMEOUT
+  value: 10

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fixturama
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Andrew Kozin (nepalez)
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-05-22 00:00:00.000000000 Z
+date: 2019-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: factory_bot
@@ -117,11 +117,12 @@ files:
 - lib/fixturama/rspec.rb
 - lib/fixturama/seed.rb
 - lib/fixturama/stubs.rb
-- lib/fixturama/stubs/actions.rb
-- lib/fixturama/stubs/actions/raise.rb
-- lib/fixturama/stubs/actions/return.rb
-- lib/fixturama/stubs/arguments.rb
 - lib/fixturama/stubs/chain.rb
+- lib/fixturama/stubs/chain/actions.rb
+- lib/fixturama/stubs/chain/actions/raise.rb
+- lib/fixturama/stubs/chain/actions/return.rb
+- lib/fixturama/stubs/chain/arguments.rb
+- lib/fixturama/stubs/const.rb
 - lib/fixturama/utils.rb
 - spec/fixturama/load_fixture/_spec.rb
 - spec/fixturama/load_fixture/data.json