maybe-nothing 0.0.1

data/History.txt

@@ -0,0 +1,3 @@
+== 0.0.1
+
+Initial setup.

data/README.md

@@ -0,0 +1,44 @@
+Introduction
+============
+
+This gem is based in its entirety on code and ideas found in Joe Ferris's post here:
+
+http://robots.thoughtbot.com/post/8181879506/if-you-gaze-into-nil-nil-gazes-also-into-you
+
+
+Usage
+=====
+
+If an object might be nil, call .maybe to wrap it:
+
+    def get_user(id)
+      Users.find(id).maybe
+    end
+
+You can unwrap objects like such:
+
+    user_wrapped = get_user
+    if user_wrapped.present?
+      user = user_wrapped.get
+    else
+      user = User.new
+    end
+
+
+Methods
+=======
+    
+To retrieve the object that has been wrapped, use .get. This method will raise an Unwrapped exception if called on nil.maybe.
+
+    object.maybe.get  # returns object
+    nil.maybe.get     # raises MaybeNothing::None::Unwrapped exception
+
+
+To check if the wrapped object is nil, use present? or blank?.
+    
+    object.maybe.present?  # returns true
+    object.maybe.blank?    # returns false
+    
+        
+    nil.maybe.present?  # returns false
+    nil.maybe.blank?    # returns true

data/lib/maybe-nothing.rb

@@ -0,0 +1,47 @@
+class Object
+  def maybe
+    MaybeNothing::Some.new(self)
+  end
+end
+
+class NilClass
+  def maybe
+    MaybeNothing::None.new
+  end
+end
+
+module MaybeNothing
+  class Some
+    def initialize(object)
+      @object = object
+    end
+  
+    def get
+      @object
+    end
+  
+    def present?
+      true
+    end
+  
+    def blank?
+      false
+    end
+  end
+  
+  class None
+    class Unwrapped < StandardError; end
+  
+    def get
+      raise Unwrapped
+    end
+  
+    def present?
+      false
+    end
+  
+    def blank?
+      true
+    end
+  end
+end

data/spec/maybe-nothing_spec.rb

@@ -0,0 +1,49 @@
+require File.dirname(__FILE__) + '/../lib/maybe-nothing.rb'
+
+describe '@non_nil.maybe' do
+
+  before :each do
+    @non_nil = Object.new
+  end
+
+  describe '.get' do
+    it 'should return @non_nil' do
+      @non_nil.maybe.get.should equal @non_nil
+    end
+  end
+  
+  describe '.present?' do
+    it 'should return true' do
+      @non_nil.maybe.present?.should equal true
+    end
+  end
+  
+  describe '.blank?' do
+    it 'should return false' do
+      @non_nil.maybe.blank?.should equal false
+    end
+  end
+  
+end
+
+describe 'nil.maybe' do
+
+  describe '.get' do
+    it 'should raise an exception' do
+      lambda{nil.maybe.get}.should raise_exception('MaybeNothing::None::Unwrapped')
+    end
+  end
+  
+  describe '.present?' do
+    it 'should return false' do
+      nil.maybe.present?.should equal false
+    end
+  end
+  
+  describe '.blank?' do
+    it 'should return true' do
+      nil.maybe.blank?.should equal true
+    end
+  end
+  
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: maybe-nothing
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Joe Ferris
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-07-29 00:00:00.000000000 +02:00
+default_executable: 
+dependencies: []
+description: 
+email: 
+executables: []
+extensions: []
+extra_rdoc_files:
+- History.txt
+- README.md
+files:
+- History.txt
+- README.md
+- lib/maybe-nothing.rb
+- spec/maybe-nothing_spec.rb
+has_rdoc: true
+homepage: https://github.com/jpadvo/maybe-nothing
+licenses: []
+post_install_message: 
+rdoc_options:
+- --main
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Adds a simple nil wrapping construct to Ruby
+test_files:
+- spec/maybe-nothing_spec.rb