Big Spoon

Big Spoon adds ActiveRecord::Base-style before_* and after_* callbacks around ANY Ruby method.

It's like a sandwich, where your method is the meat and your callbacks are the bread.

Basic Usage

Out-of-the box, Big Spoon adds callbacks that are similar to ActiveRecord::Base. Of course there's, like, at least three ways to do that. So Big Spoon supports all of 'em. Whatever form you choose, it'll swaddle your methods in the warm of before and after hooks.

ActiveRecord::Base-style

The most straightforward way is to do it ActiveRecord::Base style, which is to define a callback in the top of your class like so:

class User
  before_believe_in_a_thing_called_love :listen_to_the_rhythm_of_my_heart

  def believe_in_a_thing_called_love
    puts "We'll be rockin til the sun goes down!"
  end

  def listen_to_the_rhythm_of_my_heart
    listen("127.0.0.1") do
      match /(lub|dub)/ do
        puts "Edgar Allan Poe!"
      end
    end
  end

DataMapper-style

DataMapper has what I consider a slightly better API for doing this, specifically:

class User
  after :save, :get_your_hands_off_of_my_woman
 end

So Big Spoon supports that notation, too! This is in order to avoid conflicts with Rails callbacks and their siblings. But if'n you're a real scofflaw, you can just do it normal-like.

Block-style

If you're STILL interested in avoiding any potential conflicts, you can isolate your hooks completely by wrapping them in a block. Big Spoon adds a method named spoon that accepts a block to define hooks in. spoon is aliased as hooks, which in some cases conflicts with other libraries. See below:

class User
  hooks do
    before :get_your_hands_off_of_my_woman, :listen_to_the_darkness
  end

  # This is the same as:
  spoon do
  	before :get_your_hands_off_of_my_woman, :listen_to_the_darkness
  end

  protected
  def listen_to_the_darkness!
    `osascript "tell iTunes to play some awesome"`
  end
end

So. Add hooks. To any Ruby method. That's pretty damn awesome, where I come form. I SAID "FORM," son!

But, as they say, "love is only a feeling." So spoon like there's no tomorrow.

But there's (conditionally) more!

Because ActiveModel callbacks are just so damn delightful, I've added some fun conditional sugar to match their wonderful. So g'head and add some :if conditions to your callbacks:

class User
  before :love_on_the_rocks, :add_ice, :if => :no_ice?

  def love_on_the_rocks
    puts "Loo-OOOVE ON THE ROCKS! YOU'D DO ANYTHING FOR A QUIET LIFE!"
  end

  def no_ice?
    Ice.empty?
  end

  protected
  def add_ice
    Ice.create!
  end
end

Conditional callbacks also support :unless, just like their ActiveModel ancestors. Or should I say "inspiritors?" Is that word? Shut up, of course it is. Anyway:

class User
  before :love_on_the_rocks, :add_ice, :unless => :in_tys_mazada?

  def not_in_tys_mazada?
    (mazda = User.find_by_name("Ty").car) && mazda.has_rad_bass?
  end
end

And to recap! Just as with the believing-in-things-called-love example, both could be re-written along these lines:

before_love_on_the_rocks :add_ice, :if => :no_ice?
# or
hooks do
  before :love_on_the_rocks, :add_if, :if => :no_ice?
end

HAPPY CALLING-OF-THE-BACK, FRIENDS!

Copyright © 2012 Delightful Widgets Inc. No warranty so don't sue me or my company THANKS!