aspector
<img src=“https://secure.travis-ci.org/gcao/aspector.png” />
aspector = ASPECT Oriented Ruby programming
Highlights
-
Encapsulate logic as aspects and apply to multiple targets easily
-
Support before/before_filter/after/around advices
-
Work anywhere - inside/outside the target class, before/after methods are created
-
Small codebase, intuitive API
Installation
gem install aspector
Examples
class A
def test
puts 'test'
end
end
##############################
require 'aspector'
class TestAspect < Aspector::Base
target do
def do_this
puts 'do_this'
end
end
before [:method], :do_this
before [:method] do
puts 'do_that'
end
end
##############################
TestAspect.apply A, :method => :test
A.new.test
# Expected output:
# do_this
# do_that
# test
Notes
To use a different logger, e.g. Logem::Logger, run below command
ASPECTOR_LOGGER=Logem::Logger LOGEM_LOG_LEVEL=trace ruby -rlogem examples/cache_aspect.rb
Explanation:
ASPECTOR_LOGGER=Logem::Logger => set logger to Logem::Logger class
LOGEM_LOG_LEVEL=trace => set logem log level to trace
-rlogem => require logem otherwise it might not be available
when the logger is initialized. This could be handled by
bundler etc though.
Contributing to aspector
-
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 © 2011 Guoliang Cao. See LICENSE.txt for further details.