receptacle 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7cf73a17e7eb57b985f1b21d82784a2387ed5edc
-  data.tar.gz: 6964567a2581f9cb0d4e6be72ee52ac312a44fff
+  metadata.gz: 55b12e62420e5bd820d909846002084c473572d8
+  data.tar.gz: 60385bc42c56b0770b22e7703232686fcc6a150f
 SHA512:
-  metadata.gz: 3720c2ae69bc18032ef7b48663496559a83f0826afa81c12f58a60fbcf124fccd94960f6754131ab11be5368da06cf571aac9ee64808d9dd0e181528b3d5959e
-  data.tar.gz: 34f4e120c2c0d807dd65b9dc1772bfbad020dc010c43715214e931916ec873bb11b5b76180ca1694dcd5a1eac0aaaded4bff199d86fe1e0f5118897a5b376c10
+  metadata.gz: 24ea362cfb9be687030b24877c04895f5901bb29534ed6a7d86c611d2c41c901fb62d9e56563beed50e098a44726abcfb23b2231c904cb770e14b5c030af1688
+  data.tar.gz: 5532b99a99c6d49ca06c4f4e423ff2f9a4b75a092fe1775590a6b812967b0c7d056de0bbae5e0bc7a4270b8c9f1c53c66b10e69506a8eecf846bb88e77cac458

data/.rubocop.yml

@@ -1,5 +1,5 @@
 AllCops:
-  TargetRubyVersion: 2.3
+  TargetRubyVersion: 2.1
 
 Metrics/LineLength:
   Max: 99
@@ -22,6 +22,5 @@ Metrics/MethodLength:
   Exclude:
     - test/*
 
-
 Style/Documentation:
   Enabled: false

data/.travis.yml

@@ -1,17 +1,24 @@
 language: ruby
 cache: bundler
 rvm:
+  - 2.1.10
+  - 2.2.6
   - 2.3.3
   - 2.4.0
   - jruby-9.1.7.0
 jdk:
   - oraclejdk8
-  # - openjdk7
 env:
   - "JRUBY_OPTS='--dev'"
   - "JRUBY_OPTS='-Xcompile.invokedynamic=true'"
 matrix:
   exclude:
+    - rvm: 2.1.10
+      jdk: oraclejdk8
+      env: "JRUBY_OPTS='-Xcompile.invokedynamic=true'"
+    - rvm: 2.2.6
+      jdk: oraclejdk8
+      env: "JRUBY_OPTS='-Xcompile.invokedynamic=true'"
     - rvm: 2.3.3
       jdk: oraclejdk8
       env: "JRUBY_OPTS='-Xcompile.invokedynamic=true'"
@@ -22,6 +29,7 @@ matrix:
     - rvm: jruby-9.1.7.0
       jdk: oraclejdk8
       env: "JRUBY_OPTS='-Xcompile.invokedynamic=true'"
+
 before_install:
   - gem update --system
   - gem install bundler -v 1.14.3

data/CHANGELOG.md

@@ -4,6 +4,12 @@ Changelog
 master
 ---
 
+0.2.0
+---
+
+- update documentation
+- enable ruby 2.1+
+
 0.1.1
 ---
 

data/README.md

@@ -1,7 +1,7 @@
 # Receptacle
 
-
 [![Gem Version](https://badge.fury.io/rb/receptacle.svg)](https://badge.fury.io/rb/receptacle)
+[![Gem Downloads](https://img.shields.io/gem/dt/receptacle.svg)](https://rubygems.org/gems/receptacle)
 [![Build Status](https://travis-ci.org/andreaseger/receptacle.svg?branch=master)](https://travis-ci.org/andreaseger/receptacle)
 [![codecov](https://codecov.io/gh/andreaseger/receptacle/branch/master/graph/badge.svg)](https://codecov.io/gh/andreaseger/receptacle)
 
@@ -272,14 +272,21 @@ implemented in this way:
 
 ```ruby
 class MemoryStore
-  class << self; attr_accessor :store end
+  class << self
+    def store
+      @store || clear
+    end
+    def clear
+      @store = {}
+    end
+  end
   
   def clear
-    self.class.store = []
+    self.class.clear
   end
   
   private def store
-    self.class.store || clear
+    self.class.store
   end
 end
 ```
@@ -314,6 +321,14 @@ useful if you're not yet sure this is the correct or best possible gem,
 the [faraday](https://github.com/lostisland/faraday) gem is essentially doing
 this by giving all the different http libraries a common interface).
 
+## Testing
+
+A module called `TestSupport` can be found
+[here](https://github.com/andreaseger/receptacle/blob/master/lib/receptacle/test_support.rb).
+Right now it provides 2 helper methods `with_strategy` to easily toggle
+temporarily to another strategy and `ensure_method_delegators` to solve issues
+caused by Rspec when attempting to stub a repository method. Both methods and
+how to use them is described in more detail in the inline documentation. 
 
 ## Goals of this implementation
 

data/lib/receptacle/test_support.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 module Receptacle
   module TestSupport
+    # with_strategy
+    #
     # provides helpful method to toggle strategies during testing
     #
     # can be used in rspec like this
@@ -41,11 +43,20 @@ module Receptacle
       original_strategy = repo.strategy
       repo.strategy strategy
       yield
+    ensure
       repo.strategy original_strategy
     end
 
-    # rspec mocks/stubs don't like the lazy defined delegate methods use this to
-    # make sure the methods are already defined
+    # ensure_method_delegators
+    #
+    # When using something like `allow(SomeRepo).to receive(:find)` (where find
+    # is a mediated method) before the method was called the first time Rspec
+    # would stub the method with the wrong arity of 0 when also using jruby.
+    # This seems to be caused by the lazily defined methods. Simply calling the
+    # following method in a before hook when method stubbing is need solves this
+    # issue. As it's a problem which only affects mocking libraries it's
+    # currently not planned to change this behavior.
+    #
     def ensure_method_delegators(repo)
       Receptacle::Registration.repositories[repo].methods.each do |method_name|
         repo.__build_method(method_name)

data/lib/receptacle/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module Receptacle
-  VERSION = '0.1.1'
+  VERSION = "0.2.0".freeze
 end

data/performance/profile.rb

@@ -3,7 +3,7 @@
 # run with --profile.api in JRUBY_OPTS
 require 'bundler/inline'
 require 'jruby/profiler'
-PROFILE_NAME = 'receptacle'
+PROFILE_NAME = 'receptacle'.freeze
 
 gemfile false do
   source 'https://rubygems.org'

data/receptacle.gemspec

@@ -15,7 +15,7 @@ Gem::Specification.new do |spec|
   spec.homepage      = 'https://github.com/andreaseger/receptacle'
   spec.license       = 'MIT'
 
-  spec.required_ruby_version = '~> 2.2'
+  spec.required_ruby_version = '~> 2.1'
 
   spec.files = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: receptacle
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Andreas Eger
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-02-02 00:00:00.000000000 Z
+date: 2017-02-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -209,7 +209,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - "~>"
     - !ruby/object:Gem::Version
-      version: '2.2'
+      version: '2.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="