probably 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6b8b28306080e9a070f9e0ac0376ae725c25e8e5
+  data.tar.gz: 4c7386aa29a5e8cae34724156a335aad25a32d4e
+SHA512:
+  metadata.gz: e4511ea755487976ec503b81e6ce2dc997b9aa8e55ff4a99dbaf05ab418cd7e1d3e1e51c213fa5f2f34c62663f4fef7c313cb18423ec3b76acc85c78045de5f4
+  data.tar.gz: 80229fc66dc551135bba8ffa214f3d26d66b4dec24bbbe055fbbeeb2ad021725b4a2c8d7fb424d522d4362eb3a00a98086da667fdc6e45df3733f7de607361d4

data/License.txt

@@ -0,0 +1,25 @@
+Copyright (c)2014, Yi Wei
+
+All rights reserved.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+

data/README.md

@@ -0,0 +1,36 @@
+Probably
+=============
+
+Probably is an extremely lightweight and simple tool. It only exists for one reason: to avoid checking for nil or exception in a calls chain. So, instead of writing like this:
+```ruby
+visitors.most_recent.try(:last).first_name || "NoSuchAnUser"
+```
+you write like this
+```ruby
+visitors.probably.most_recent.last.first_name.or("NoSuchAnUser")
+```
+or in a more natural way:
+```ruby
+probably(visitors).most_recent.last.first_name.or("NoSuchAnUser")
+```
+
+
+Usage
+_____
+
+The simplest scenario
+
+```ruby
+class Statistics
+  include Probably
+  attr_reader :visitors
+
+  def latest_visitor
+    probably(visitors).most_recent.last.first_name.or("NoSuchAnUser")
+  end
+end
+
+end
+```
+you many want to check probably_spec.rb for more examples, they are quite simple and intutive!
+

data/lib/probably.rb

@@ -0,0 +1,9 @@
+$:.unshift File.dirname(__FILE__)
+
+require 'probably/delayed_invocation'
+
+module Probably
+  def probably(target = nil)
+    DelayedInvocation.new(target || self)
+  end
+end

data/lib/probably/delayed_invocation.rb

@@ -0,0 +1,29 @@
+class DelayedInvocation
+  def initialize(target)
+    @target = target
+    @methods = []
+    @args = []
+    @blocks = []
+  end
+
+  def method_missing(name, *args, &block)
+    @methods << name
+    @args << args
+    @blocks << (block.nil? ? nil : block)
+    self
+  end
+
+  def or(value)
+    @methods.reduce(@target) do |t, m|
+      block = @blocks.shift
+      unless block.nil?
+        t.__send__(m, *(@args.shift), &block)
+      else
+        t.__send__(m, *(@args.shift))
+      end
+    end
+  rescue
+    value
+  end
+end
+

data/lib/probably/version.rb

@@ -0,0 +1,9 @@
+module Probably#:nodoc:
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 1
+    TINY  = 0
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/spec/probably_spec.rb

@@ -0,0 +1,66 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper.rb')
+
+require 'probably'
+
+describe Probably, "Basic Behaviour" do
+  context "basic syntax" do
+    before do
+      class Object
+        include Probably
+      end
+    end
+
+    it "triggers methods when the source is not nil" do
+      expect(5.probably.succ.or(0)).to eq 6
+      expect(0.probably.succ.or(7)).to eq 1
+      expect(5.probably.succ.succ.or(1)).to eq 7
+
+      expect("test string".probably.split.count.or(1)).to eq 2
+      expect("internationalization".probably.split('n').count.or(1)).to eq 4
+
+      expect(15.probably.succ.or(10).pred).to eq 15
+      expect([1, 2, 3].probably.reduce(0) {|sum, i| sum = sum + i }.or(17)).to eq 6
+    end
+
+    it "returns 'or' value when nil occurs in the calls chain" do
+      expect(nil.probably.succ.succ.or(5)).to eq 5
+      expect(nil.probably.split.count.or(0)).to eq 0
+    end
+
+    it "return 'or' value when exception occurs" do
+      expect(15.probably.split.or(12)).to eq 12
+      expect(false.probably.succ.or(true)).to eq true
+    end
+  end
+
+  context "more natural syntax" do
+    before do
+      class Object
+        include Probably
+      end
+    end
+
+    it "triggers methods when the source is not nil" do
+      expect(probably(5).succ.or(0)).to eq 6
+      expect(probably(0).succ.or(7)).to eq 1
+      expect(probably(5).succ.succ.or(1)).to eq 7
+
+      expect(probably("test string").split.count.or(1)).to eq 2
+      expect(probably("internationalization").split('n').count.or(1)).to eq 4
+
+      expect(probably(15).succ.or(10).pred).to eq 15
+      expect(probably([1, 2, 3]).reduce(0) {|sum, i| sum = sum + i }.or(17)).to eq 6
+    end
+
+    it "returns 'or' value when nil occurs in the calls chain" do
+      expect(probably(nil).succ.succ.or(5)).to eq 5
+      expect(probably(nil).split.count.or(0)).to eq 0
+    end
+
+    it "return 'or' value when exception occurs" do
+      expect(probably(15).split.or(12)).to eq 12
+      expect(probably(false).succ.or(true)).to eq true
+    end
+
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+require 'rspec'
+require File.dirname(__FILE__) + '/../lib/probably'

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: probably
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Yi Wei
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-11 00:00:00.000000000 Z
+dependencies: []
+description: ''
+email: yiwei.in.cyber@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- License.txt
+- README.md
+- lib/probably.rb
+- lib/probably/delayed_invocation.rb
+- lib/probably/version.rb
+- spec/probably_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/zeninpalm/probably/
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Enables you to chain calls without explicitly checking nils or exceptions
+test_files:
+- spec/probably_spec.rb
+- spec/spec_helper.rb