reactive_support 0.5.0.beta → 0.5.0.beta2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e484324b27a831addea4d4f31a5a4343219dae84
-  data.tar.gz: 69b6a58c8ab40a915a92f6f2f87da0719edf918a
+  metadata.gz: 24b7a1145615fef1ac0807e4d156380e7a50df4b
+  data.tar.gz: c5a986289af301086f0edd20a4abca612febf9ab
 SHA512:
-  metadata.gz: 273d1eaf8a1db8b34e9b0e71dc08fd8af31ef0d6d4f4fa408d53d37d87e3e49a2e84bc8b17a51c459bf5458958fbbf662f8d4ad6f5c8a929a1d6bcb7dce9562c
-  data.tar.gz: c114dca660f79679fdb6a59ac7d6ca866c6a9806cf76492f88aa6a7ff1d307fa88f936272eec3b2f493d5f21e0f675abc346c8828a0aaa8bb64ed9b32d9757f5
+  metadata.gz: a580a90272eb5f566c4c6857811a94808b1fbc925407787bc07dc6cb02cbc6410c8b6494f4de13c3d42a8153fdd5f170c4fd9930b8d4bcf6f32fd2f7cc0420de
+  data.tar.gz: 4b0aed3dd541395299404d7611f9ee29f76d82c4f64bfecd1829347c11ac0bb5f1cb66141a33e4f2018c973e9abb1b59283eb95652172d19d4470518f1249bb3

data/README.md

@@ -5,24 +5,22 @@ The ReactiveSupport gem provides a re-implementation of certain [ActiveSupport](
 methods, allowing them to be used outside of the Rails ecosystem. This gem can 
 be used in any kind of project and is not dependent on any frameworks, gemsets, etc.
 To add ReactiveSupport to your project, add this to your Gemfile and run `bundle install`:
-<pre><code>gem 'reactive_support', '~> 0.4.0'</code></pre>
+<pre><code>gem 'reactive_support', '~> 0.5.0'</code></pre>
 To install locally:
 <pre><code>sudo gem install reactive_support</code></pre>
 Or if you're using RVM: 
 <pre><code>gem install reactive_support</code></pre>
 
 You can also point your Gemfile to this repo:
-<pre><code>gem 'reactive_support', '~> 0.4.0.beta', git: 'https://github.com/danascheider/reactive_support.git</code></pre>
+<pre><code>gem 'reactive_support', '~> 0.5.0.beta', git: 'https://github.com/danascheider/reactive_support.git</code></pre>
 
 Like ActiveSupport, ReactiveSupport is designed to load only the code you are actually
 using in your app. For that reason, you will need to specify in your project files
 exactly what you're using. For example, in Canto, I have the following requires:
-<pre><code>require 'reactive_support'
-require 'reactive_support/core_ext/object/blank'
+<pre><code>require 'reactive_support/core_ext/object/blank'
 require 'reactive_support/core_ext/object/inclusion'
 require 'reactive_support/core_ext/object/try'
-require 'reactive_support/extensions/reactive_extensions'</code></pre>
-The ReactiveExtensions module should be required as a whole. I do have plans to add the ability to require the entire gem, or broader parts of it, in the future. This would also be a welcome contribution to the project if you're interested.
+I do have plans to add the ability to require the entire gem, or broader parts of it, in the future. This would also be a welcome contribution to the project if you're interested.
 
 Please note that version 0.1.2 is the earliest available version of ReactiveSupport.
 
@@ -37,12 +35,6 @@ That means that, while not all ActiveSupport methods are available, those that a
 as of September 2014, be found in ActiveSupport's API documentation with no functional
 differences. (This is true of ReactiveSupport 0.1.x and ActiveSupport 4.1.6.)
 
-ReactiveSupport includes an extension module, ReactiveExtensions, that houses additional 
-methods in the spirit of, but not included in, ActiveSupport. This module needs to 
-be included separately; the default configuration is that only ActiveSupport methods 
-are added to your project. You can include ReactiveExtensions with a simple `require`:
-<pre><code>require 'reactive_support/extensions/reactive_extensions'</pre></code>
-
 ### FAQ
 ##### Why not just use ActiveSupport?
 There are three main reasons why you might prefer ReactiveSupport over ActiveSupport:

data/lib/reactive_support/core_ext/array/extract_options.rb

@@ -0,0 +1,25 @@
+class Hash
+
+  # By default, only instances of +Hash+ itself are extractable.
+  # Subclasses of +Hash+ may implement this method and return
+  # true to declare themselves extractable. +Array#extract_options!+
+  # then pops the hash if it comes as the last argument in a set of
+  # splat args.
+
+  def extractable_options?
+    instance_of? Hash 
+  end
+end
+
+class Array
+
+  # The +#extract_options!+ method retrieves a hash of options from
+  # the end of a set of splat args. If the last element of the set 
+  # is +Hash+ or instance of another class implementing the 
+  # +#extractable_options?+ method, +#extract_options!+ method pops
+  # and returns that object. Otherwise, it returns an empty +Hash+.
+
+  def extract_options!
+    return last.is_a?(Hash) && last.extractable_options? ? pop : {}
+  end
+end

data/spec/array_spec.rb

@@ -1,7 +1,27 @@
 require 'spec_helper' 
 
 describe Array do 
-  describe '#from method' do 
+  describe 'extract_options!' do 
+    context 'when there are options' do 
+      let(:array) { ['a', 'b', :foo => :bar] }
+
+      it 'returns the options' do 
+        expect(array.extract_options!).to eql({:foo => :bar})
+      end
+
+      it 'is destructive' do 
+        expect{ array.extract_options! }.to change(array, :length)
+      end
+    end
+
+    context 'when there are no options' do 
+      it 'returns an empty hash' do 
+        expect(['a', 'b'].extract_options!).to eql({})
+      end
+    end
+  end
+
+  describe 'from' do 
     context 'normal use' do 
       context 'positive position' do 
         it 'returns the end of the array' do 
@@ -35,7 +55,7 @@ describe Array do
     end
   end
 
-  describe '#to method' do 
+  describe 'to' do 
     context 'normal use' do 
       context 'positive position' do 
         it 'returns the beginning of the array' do 

data/version.rb

@@ -7,7 +7,7 @@ module ReactiveSupport
     MAJOR = '0'
     MINOR = '5'
     PATCH = '0'
-    PRE   = 'beta'
+    PRE   = 'beta2'
 
     STRING = [MAJOR, MINOR, PATCH, PRE].compact.join('.').chomp('.')
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: reactive_support
 version: !ruby/object:Gem::Version
-  version: 0.5.0.beta
+  version: 0.5.0.beta2
 platform: ruby
 authors:
 - Dana Scheider
@@ -79,6 +79,7 @@ files:
 - "./lib/reactive_support/core_ext.rb"
 - "./lib/reactive_support/core_ext/array.rb"
 - "./lib/reactive_support/core_ext/array/access.rb"
+- "./lib/reactive_support/core_ext/array/extract_options.rb"
 - "./lib/reactive_support/core_ext/hash.rb"
 - "./lib/reactive_support/core_ext/hash/keys.rb"
 - "./lib/reactive_support/core_ext/object.rb"