Version: 0.4.0 Release date: 2006-11-11 Home page: http://aspectr.sf.net/ Tarball: http://prdownloads.sf.net/aspectr/aspectr-0-3-5.tar.gz Authors: Avi Bryant and Robert Feldt Email: firstname.lastname@example.org, email@example.com Contributors: Guy Builta, Robert Herbig, Mark Karasek
Aspect-oriented programming concepts to Ruby. Essentially it allows you to wrap code around existing methods in your classes. This can be a good thing (and even affect how you design your code) since it separates different concerns into different parts of the code. It is somewhat similar to AspectJ, www.aspectj.org.
Main features of AspectR (in AspectJ lingo): * Join points:
See tests, try out any of the files in examples/ or check out the aspects in the aspects subdir.
AspectR lets a module wrap any number of methods in other classes (or objects) with the "advice" methods (in the lingo of Aspect/J) of the module.
require 'aspectr' include AspectR class MyAspect < Aspect def someAdviceMethod(method, object, exitstatus, *args) ... end ... some other advice methods ... end ma = MyAspect.new ma.wrap(someClassorObject, :preAdvice, :postAdvice, ... methods to wrap...) or ma.wrap(someClassorObject, :preAdvice, :postAdvice, /patternToWrap/) or AspectR.wrap_classes(ma, :preAdvice, :postAdvice, [Class1, Class2], ...methods to wrap...)
Advice methods are passed a variable number of parameters: the first is the name of the method currently being wrapped the second is the object receiving the method call the third is the exit/return status:
Array with return value(s) if the method exited normally true if the method exited with an exception nil if the method hasn't yet exited (for preAdvice)
the rest are the arguments that were passed to the wrapped method.
AspectR was originally called advice.rb and written by Avi Bryant. Later Robert Feldt changed/tweaked/extended it. Avi then refactored very nicely, Robert tweaked a bit more and on it goes... ;-) In late 2006, three students from Rose-Hulman Institute of Technology, www.rose-hulman.edu, updated AspectR to include several new features. For details see CHANGELOG.
All files in this package are
Copyright (c) 2001 Avi Bryant (firstname.lastname@example.org) and Robert Feldt (email@example.com)
and they are distributed under GPL. See COPYING.TXT.
See TODO. This is an alpha release so there might be (some) changes to the interface.
AspectJ features that AspectR is missing:
We'd appreciate if you drop us a note if you're using AspectR. If there are some known users we'll be more motivated to pack up additions / new versions and post them to RAA.
Avi and Robert Feldt