ruby-try 1.0.0 → 1.0.1

data/Rakefile

@@ -1,2 +1,21 @@
 require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
 
+RSpec::Core::RakeTask.new(:ensure_all_specs_pass)
+
+
+task :ensure_all_commited do
+ untracked = `git ls-files --others --exclude-standard`
+ modified = `git ls-files -m`
+ uncommited_changed = `git diff --shortstat --staged`
+ if untracked.length > 0 || modified.length > 0 || uncommited_changed.length > 0
+  abort("Commit your changes first and leave directory clean.")
+ end
+end
+
+task :check
+
+task :check => :ensure_all_commited
+task :check => :ensure_all_specs_pass
+
+task :build => :check

data/lib/ruby-try.rb

@@ -1,4 +1,43 @@
 class Object
+   # Invokes the public method whose name goes as first argument just like
+  # +public_send+ does, except that if the receiver does not respond to it the
+  # call returns +nil+ rather than raising an exception.
+  #
+  # This method is defined to be able to write
+  #
+  #   @person.try(:name)
+  #
+  # instead of
+  #
+  #   @person ? @person.name : nil
+  #
+  # +try+ returns +nil+ when called on +nil+ regardless of whether it responds
+  # to the method:
+  #
+  #   nil.try(:to_i) # => nil, rather than 0
+  #
+  # Arguments and blocks are forwarded to the method if invoked:
+  #
+  #   @posts.try(:each_slice, 2) do |a, b|
+  #     ...
+  #   end
+  #
+  # The number of arguments in the signature must match. If the object responds
+  # to the method the call is attempted and +ArgumentError+ is still raised
+  # otherwise.
+  #
+  # If +try+ is called without arguments it yields the receiver to a given
+  # block unless it is +nil+:
+  #
+  #   @person.try do |p|
+  #     ...
+  #   end
+  #
+  # Please also note that +try+ is defined on +Object+, therefore it won't work
+  # with instances of classes that do not have +Object+ among their ancestors,
+  # like direct subclasses of +BasicObject+. For example, using +try+ with
+  # +SimpleDelegator+ will delegate +try+ to the target instead of calling it on
+  # delegator itself.
   def try(*a, &b)
     if a.empty? && block_given?
       yield self
@@ -32,7 +71,7 @@ class Object
 end
 
 class NilClass
-  # Calling +try+ on +nil+ returns +nil+
+    # Calling +try+ on +nil+ always returns +nil+.
   # It becomes specially helpful when navigating through associations that may return +nil+.
   #
   #   nil.try(:name) # => nil
@@ -42,11 +81,14 @@ class NilClass
   #
   # With +try+
   #   @person.try(:children).try(:first).try(:name)
-  #
   def try(*args)
     nil
   end
 
+  def try!(*args)
+    nil
+  end
+
   # Calling +try?+ on +nil+ returns +false+
   # With +try?+
   #   @person.try(:children).try(:first).try?(:has_dark_hairs?)
@@ -57,8 +99,4 @@ class NilClass
       raise ArgumentError, "For non-boolean methods use only try()"
     end
   end
-
-  def try!(*args)
-    nil
-  end
 end

data/ruby-try.gemspec

@@ -4,18 +4,10 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name        = 'ruby-try'
-  spec.version     = '1.0.0'
-  spec.date        = '2014-08-01'
+  spec.version     = '1.0.1'
+  spec.date        = '2014-08-02'
   spec.summary     = "Provides RoR try() and extends it by new try?() method."
-  spec.description = <<-DESC
-    This gem has two versions of `try()`. 
-
-    Vanilla `try()`
-      This is RoR vanilla `try()` and `try!()` methods. Nothing new.
-    Boolean `try?()`
-      It is returns `false` instead of `nil`, when trying to call something like 
-      `nil.try?(:some_boolean_method?)`
-  DESC
+  spec.description = "Provides RoR try() and extends it by new try?() method."
   spec.authors     = ["Oleg Orlov"]
   spec.email       = 'orelcokolov@gmail.com'
   spec.homepage    = 'http://rubygems.org/gems/ruby-try'

data/spec/ruby_try_spec.rb

@@ -59,8 +59,6 @@ describe Object do
 
   describe "#try" do
     context "for existing method" do
-      include_context "#try, method exists" 
-
       it "should return value for general method" do
         subject.try(:get_zero).should eq(0)
       end
@@ -72,7 +70,6 @@ describe Object do
 
     context "for non-existing method" do
       include_context "#try, method not exists" 
-
     end
 
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-try
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-01 00:00:00.000000000 Z
+date: 2014-08-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -43,10 +43,7 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '10.0'
-description: ! "    This gem has two versions of `try()`. \n\n    Vanilla `try()`\n
-  \     This is RoR vanilla `try()` and `try!()` methods. Nothing new.\n    Boolean
-  `try?()`\n      It is returns `false` instead of `nil`, when trying to call something
-  like \n      `nil.try?(:some_boolean_method?)`\n"
+description: Provides RoR try() and extends it by new try?() method.
 email: orelcokolov@gmail.com
 executables: []
 extensions: []