Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Null Object Design Pattern Ruby implementation
Ruby
Branch: master

Merge pull request #8 from nilbus/naught

Avdi's new null object gem (avdi/naught)
latest commit c56cede1b1
@martinciu authored
Failed to load latest commit information.
lib version bump
spec add to_ary
.gitignore first commit
.travis.yml travis.yml updated
Gemfile first commit
LICENSE first commit
README.md Reference Avdi's null object gem
Rakefile first commit
nullobject.gemspec typo

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.

Something went wrong with that request. Please try again.