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 options[:method], :do_this

  before options[: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.