Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

NullObject

Null Object Design Pattern Ruby implementation

travis-ci

Intent

The intent of a Null Object is to encapsulate the absence of an object by providing a substitutable alternative that offers suitable default do nothing behavior. In short, a design where “nothing will come of nothing”

More about Null Object Pattern you can find here:

See also the avdi/naught gem for extended variations of the null object pattern for Ruby 1.9.

Usage

# examples from http://avdi.org/devblog/2011/05/30/null-objects-and-falsiness/

Null::Object.instance.foobar.baz.buz

def Maybe(value)
  case value
  when nil then Null::Object.instance
  else value
  end
end

def slug(title)
  Maybe(title).strip.downcase.tr('^[0-9a-z]', '-')
end

h = {}

slug(h[:missing_key]) # => ""

foo = Null::Object.instance

foo.to_s # => ""
foo.to_a # => []
foo.to_i # => 0
foo.to_f # => 0.0
foo.nil? # => true

# Custom Null Object

class FooNullObject
  include Null

  def to_bar
    "nothing here"
  end
end

foo = FooNullObject.instance
foo.to_bar # => "nothing here"
foo.to_s   # => ""

Setup

If you are using bundler add nullobject to your Gemfile:

gem 'nullobject'

Then run:

bundle install

Otherwise install the gem:

gem install nullobject

and require it in your project:

require 'nullobject'

Development

Source hosted at GitHub. Report Issues/Feature requests on GitHub Issues.

Tests can be ran with rake test

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

Copyright

Copyright (c) 2012 Marcin Ciunelis. See LICENSE for details.

About

Null Object Design Pattern Ruby implementation

Resources

License

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages