Aspect Oriented Programming for Ruby
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
examples
lib
performance-tests
spec
.document
.gitignore
.rspec
.rvmrc
Gemfile
Gemfile.lock
Guardfile
LICENSE
README.rdoc
Rakefile
VERSION
aspect4r.gemspec

README.rdoc

aspect4r

Aspect Oriented Programming support for Ruby

Feature

  • extract common logic from multiple methods into before, after, around advices

  • before_filter (works like before_filters in web application)

  • advices can be customized (e.g. to take an optional method name argument)

  • well-tested and optimized

Usage

API documentation: github.com/gcao/aspect4r/wiki/Api

class A
  include Aspect4r

  before :test, :do_this

  before_filter :test do |*args|
    authorized?
  end

  after :test, :do_that

  around :test do |*args, &block|
    ...
    block.call *args
    ...
  end

  def test value
    ...
  end

  def do_this value
    ...
  end

  def do_that result, value
    ...
    result
  end

  def authorized?
    ...
  end

end

How does it work?

Execution model: gcao.posterous.com/aspect4r-documentation-advice-execution-model

TODO

See github issues github.com/gcao/aspect4r/issues

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 © 2010 Guoliang Cao. See LICENSE for details.