reactive_support 0.3.0.beta4 → 0.4.0.beta2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 81f05e52790af3ef46c2291c2aedbfb10cd6dc51
-  data.tar.gz: 41cfee452fb77ea758ac726eefaa060c64386c7a
+  metadata.gz: 59bff29f1a8eaf3b256c0bbeb988bcc3be5af4d3
+  data.tar.gz: 1bb1f2bffe4a3283a156b85fb3b35b15ecfa212d
 SHA512:
-  metadata.gz: 4f19048864c1426fecf482564bea6942e2be0c7a4d4cba59e7b151678ef965c745ce954e6d87251d78006d64a6e346ff3e017b181c0f3ed93efe06809e6cb26a
-  data.tar.gz: 413727a29f202747077068afb3c557ff59ebbdf22031ba25d6c45c4d87b8b9e1a604ce5922578a1d6aac1a35199531bc363429f62296c7a39c6b4a03391ffcfe
+  metadata.gz: 59870827ff9e3318bd6e007e942cd56b66554e46f87bb8312b8808bcfe3cca0a3da4826efac419aef61252605689410a2bc5cdc456c037f10422943c48f2feea
+  data.tar.gz: bc177dbad0251df83cdb602e90425189c799b612a9a1f612027f01ca0a73e00fdf146d08258314c0eab23848fe7e4b2bbb6d36ca4fd1f33a3ba2a19afb23b3f7

data/README.md

@@ -5,23 +5,31 @@ 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.1.3'</code></pre>
+<pre><code>gem 'reactive_support', '~> 0.4.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>
-Then, in your main project file, include:
-<pre><code>require 'reactive_support'</code></pre>
 
 You can also point your Gemfile to this repo:
-<pre><code>gem 'reactive_support', '~> 0.1.3', git: 'https://github.com/danascheider/reactive_support.git</code></pre>
+<pre><code>gem 'reactive_support', '~> 0.4.0.beta', git: 'https://github.com/danascheider/reactive_support.git</code></pre>
 
-Please note that version 0.1.2 is the earliest available version of ReactiveSupport, and is currently the only release labeled production ready.
+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'
+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.
+
+Please note that version 0.1.2 is the earliest available version of ReactiveSupport.
 
 ### Usage
-In its current version, ReactiveSupport adds methods to Ruby's `Object` class, so
-once required, its methods can be used on any object within your project, including
-core Ruby classes.
+In its current version, ReactiveSupport adds methods to several core Ruby classes
+(including `Object`), so once required, its methods can be used on any object within 
+your project.
 
 Currently, ReactiveSupport's methods are a strict subset of ActiveSupport's. (This may 
 change in future versions, or most saliently, if ActiveSupport's API changes.)
@@ -29,7 +37,7 @@ 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 additional 
+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`:

data/lib/reactive_support/extensions/object_extensions.rb

@@ -0,0 +1,48 @@
+class Object
+
+  # The +#try_rescue+ method extends ReactiveSupport's +#try+ method so it
+  # rescues NoMethodErrors and TypeErrors as well as returning +nil+ when
+  # called on a +nil+ value.
+  #
+  # Like the +#try+ method, +#try_rescue+ takes 1 or more arguments. The first
+  # argument is the method to be called on the calling object, passed as a 
+  # symbol. The others are zero or more arguments that will be passed through to 
+  # that method, and +&block+ is an optional block that will be similarly passed through.
+  #
+  # Example of usage identical to +#try+:
+  #     nil.try(:map) {|a| a.to_s }           # => nil
+  #     nil.try_rescue(:map) {|a| a.to_s }    # => nil
+  #     
+  # Example of usage calling a method that is not defined on the calling object:
+  #     10.try(:to_h)           # => TypeError
+  #     10.try_rescue(:to_h)    # => nil
+  #
+  # Example of usage with invalid arguments:
+  #     %w(foo, bar, baz).try(:join, [:hello, :world])        # => TypeError
+  #     %w(foo, bar, baz).try_rescue(:join, [:hello, :world]) # => nil
+
+  def try_rescue(*args, &block)
+    self.try(*args, &block) rescue nil
+  end
+end
+
+# The +#try_rescue+ method extends ReactiveSupport's +#try+ method so it rescues
+# NoMethodErrors and TypeErrors as well as returning +nil+ when called on a +nil+
+# value.
+# 
+# Like the +#try+ method, +#try_rescue+ takes 1 or more arguments. The first argument
+# is the method to be called on the calling object, passed as a symbol. The others
+# are zero or more arguments that will be passed through to that method, and an 
+# optional block to be likewise passed through.
+#
+# When called on NilClass, +#try_rescue+ always returns nil.
+#
+# Example:
+#     foo = nil 
+#     foo.try_rescue(:has_key?, :bar)     # => nil
+
+class NilClass
+  def try_rescue(*args, &block)
+    nil 
+  end
+end

data/lib/reactive_support/extensions/reactive_extensions.rb

@@ -1,3 +1,5 @@
+Dir['./lib/reactive_support/extensions/*.rb'].each {|f| require f }
+
 # The ReactiveExtensions module consists of methods I wish ActiveSupport provided.
 # These methods do not adhere to the ActiveSupport API. If you wish to include
 # them in your project, you will need to put this in your main project file:
@@ -7,34 +9,4 @@
 # requires for ReactiveSupport as it will raise a SystemStackError.
 
 module ReactiveExtensions
-  Dir['./lib/reactive_support/extensions/*'].each {|f| require f }
-
-  # The +#try_rescue+ method extends ReactiveSupport's +#try+ method so it
-  # rescues NoMethodErrors and TypeErrors as well as returning +nil+ when
-  # called on a +nil+ value.
-  #
-  # Like the +#try+ method, +#try_rescue+ takes 1 or more arguments. The first
-  # argument is the method to be called on the calling object, passed as a 
-  # symbol. The others are zero or more arguments that will be passed through to 
-  # that method, and +&block+ is an optional block that will be similarly passed through.
-  #
-  # Example of usage identical to +#try+:
-  #     nil.try(:map) {|a| a.to_s }           # => nil
-  #     nil.try_rescue(:map) {|a| a.to_s }    # => nil
-  #     
-  # Example of usage calling a method that is not defined on the calling object:
-  #     10.try(:to_h)           # => TypeError
-  #     10.try_rescue(:to_h)    # => nil
-  #
-  # Example of usage with invalid arguments:
-  #     %w(foo, bar, baz).try(:join, [:hello, :world])        # => TypeError
-  #     %w(foo, bar, baz).try_rescue(:join, [:hello, :world]) # => nil
-
-  def try_rescue(*args, &block)
-    self.try(*args, &block) rescue nil
-  end
-end
-
-class Object
-  include ReactiveExtensions
 end

data/version.rb

@@ -5,9 +5,9 @@ module ReactiveSupport
 
   module Version
     MAJOR = '0'
-    MINOR = '3'
+    MINOR = '4'
     PATCH = '0'
-    PRE   = 'beta4'
+    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.3.0.beta4
+  version: 0.4.0.beta2
 platform: ruby
 authors:
 - Dana Scheider
@@ -86,6 +86,7 @@ files:
 - "./lib/reactive_support/core_ext/object/try.rb"
 - "./lib/reactive_support/extensions/array_extensions.rb"
 - "./lib/reactive_support/extensions/hash_extensions.rb"
+- "./lib/reactive_support/extensions/object_extensions.rb"
 - "./lib/reactive_support/extensions/proc_extensions.rb"
 - "./lib/reactive_support/extensions/reactive_extensions.rb"
 - "./spec/array_spec.rb"