Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Add/remove advice around, before and after methods in Ruby.
Ruby
branch: master
Failed to load latest commit information.
example Minor whitespace changes.
lib Minor whitespace changes.
spec Avoid conflict with pre-existing Object#method.
.document
.gitignore Ignore Gemfile.lock
.rspec Initial commit to cheap_advice.
Gemfile Basic slides.
LICENSE.txt Initial commit to cheap_advice.
README.rdoc Update README.rdoc
Rakefile Gem release 1.0.0.
VERSION Version bump to 1.0.0
cheap_advice.gemspec
cheap_advice.slides.textile Cheap Advice is a gem.

README.rdoc

cheap_advice

Add/remove advice around, before or after methods in Ruby.

Example

class MyClass
  def foo
    42
  end
end

class MyOtherClass
  def bar
    43
  end
end

a = MyClass.new
b = MyOtherClass.new

trace_advice = CheapAdvice.new(:around) do | ar, body |
  ar.advice[:log].puts "#{Time.now.iso8601(6)} #{ar.rcvr.class} #{ar.method} #{ar.rcvr.object_id}"
  body.call
  ar.advice[:log].puts "#{Time.now.iso8601(6)} #{ar.rcvr.class} #{ar.method} #{ar.rcvr.object_id} => #{ar.result.inspect}"    
end
trace_advice[:log] = File.open("trace.log", "a+")
trace_advice.advise!(MyClass, :foo)
trace_advice.advise!(MyOtherClass, :bar)

a.foo
b.bar

trace_advice.disable!

a.foo
b.bar

trace.log will contain something like:

2011-01-17T16:33:27.882122-06:00 MyClass foo 69872883178280
2011-01-17T16:33:27.882262-06:00 MyClass foo 69872883178280 => 42
2011-01-17T16:33:27.882319-06:00 MyOtherClass bar 69872883178200
2011-01-17T16:33:27.882367-06:00 MyOtherClass bar 69872883178200 => 43

Other Features

  • CheapAdvice::Configuration provides a generic mechanism to configure multiple advices on different methods.

  • CheapAdvice::Trace provides an example advice factory for generic method tracing/logging. See examples/ex02.rb.

Issues

  • Rails-type autoloading can confuse CheapAdvice.

Slides

Contributing to cheap_advice

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet

  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it

  • Fork the project

  • Start a feature/bugfix branch

  • Commit and push until you are happy with your contribution

  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.

  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

Copyright

Copyright © 2008-2011 Kurt Stephens. See LICENSE.txt for further details.

Something went wrong with that request. Please try again.