aspekt 0.0.1

data/Gemfile

@@ -0,0 +1,3 @@
+source 'http://rubygems.org'
+
+gem 'is_same'

data/README.rdoc

@@ -0,0 +1,19 @@
+= IN THE MAKING, NOT USABLE
+
+== Installation
+
+Add to your Gemfile:
+  gem 'aspekt'
+
+And run:
+  bundle install
+
+Or run:
+  gem install aspekt
+
+
+== Usage examples
+
+=== Including before, after and around methods support into Object or Class
+
+=== Creating aspects

data/lib/aspekt.rb

@@ -0,0 +1,137 @@
+require 'is_same'                     # https://github.com/tione/is_same
+
+
+# Supports only already existing objects (and classes) and methods Weaving.
+# Aspects defined in folder ./aspects will add runtime loading.
+#
+# @see Aspekt::Pointcut
+# @see Aspekt::Advice
+module Aspekt
+
+
+
+  # All Aspekt's objects are extended from Aspekt::Object.
+  class Object < Hash
+
+    # Creates a new Aspekt::Object with base class Hash and registres self in class :@all.
+    def initialize opts
+      self.merge! opts
+      self.class.all << self
+    end
+
+    # Returns all Objects created.
+    def self.all
+      @all ||= []
+    end
+
+  end
+
+
+  class Pointcut < Aspekt::Object
+
+    # === Example usage
+    #   class SomeClass
+    #
+    #     def self.some_method
+    #       return "some_value_from_singleton"
+    #     end
+    #
+    #     def some_method
+    #       return "some_value"
+    #     end
+    #
+    #     def other_method
+    #       return "other_value"
+    #     end
+    #
+    #   end
+    #
+    #   some_object = SomeClass.new
+    #
+    # ==== Pointcuts for instance with types
+    #   pointcut = Aspekt::Pointcut.new( class: :SomeClass, method: :some_method )
+    #   pointcut = Aspekt::Pointcut.new( class: SomeClass, method: /some/ )
+    #   pointcut = Aspekt::Pointcut.new( class: /Some/, method: /some/ )
+    #
+    # ==== Pointcut for class method (singleton method)
+    #   pointcut = Aspekt::Pointcut.new( object: SomeClass, method: :some_method )
+    #   pointcut = Aspekt::Pointcut.new( object: /Some/, method: /some/)
+    #   pointcut = Aspekt::Pointcut.new( class: (class SomeClass; class<<self; self; end; end, method: :some_method )
+    #
+    # ==== Pointcut for only one object
+    #   pointcut = Aspekt::Pointcut.new( object: some_object, method: :some_method)
+    #
+    # === Arguments
+    # - object: object, method: :method
+    # - [{object: object, method: :method}, {object: object2, method: :method2
+    # - objects: [object, object2], methods: [:method, :method2]
+    # - class: :SomeClass, methods: [:method, :method2]
+    # - [{objects: [Hash, Array], method: new}, {class: Array, method: :push}, {classes: [Hash, Array, SomeClass], method: /_id/}]
+    #
+    # ==== Limitations
+    # Instances of Regexp, Symbol and Constant are used as finders not thought of as objects.
+    # TODO: Fix. Possibly add a new hash key value?
+
+    def initialize *matchers 
+      matchers = matchers.flatten.each do |matcher|
+        matcher[:classes] = [matcher.delete(:class)].flatten if matcher.has_key?(:class)
+        matcher[:objects] = [matcher.delete(:object)].flatten if matcher.has_key?(:object)
+        matcher[:methods] = [matcher.delete(:method)].flatten if matcher.has_key?(:method)
+      end
+      super matchers: matchers
+    end
+
+    # === Example usage
+    #   pointcut = Aspekt::Pointcut.new( class: :SomeClass, method: :some_method ).is_matching?( object: SomeClass.new )
+    #   pointcut = Aspekt::Pointcut.new( object: :SomeClass, method: :some_method ).is_matching?( object: SomeClass )
+    #
+    # === Arguments
+    # - object: object
+    # - object: object, method: :method
+    def is_matching? opts
+      raise ArgumentError, "has to include keys 'object', may include 'method'." unless opts[:object]
+
+      self[:matchers].each do |matcher|
+        # object matching
+        return true if
+        (matcher.has_key(:objects) and matcher[:objects].select{|object| object.is_same?(opts[:object])}.length > 0) or
+        (matcher.has_key(:classes) and matcher[:classes].select{|klass| klass.is_same?(opts[:object].class.name)}.length > 0)
+        # method matching
+        return true unless opts.has_key?(:methods) or
+        (matcher.has_key(:methods) and matcher[:methods].select{|klass| klass.is_same?(opts[:methods].class.name)}.length > 0)
+      end
+
+      return false
+    end
+
+   end
+
+
+
+  class Advice < Aspekt::Object
+
+    # == Example usage
+    #   advice = Aspekt::Advice.new ( type: :before, pointcut: pointcut ) do |joinpoint|
+    #     puts "before #{joinpoint}"
+    #   end
+    #
+    #   advice = Aspekt::Advice.new ( type: :around, pointcuts: [pointcut1, pointcut2]) do |joinpoint|
+    #     puts "around :start for #{joinpoint}"
+    #     return_value = joinpoint.proceed
+    #     puts "around :end for #{joinpoint}"
+    #   end
+    #
+    def initialize opts
+      opts[:pointcuts] = [opts.delete(:pointcut)].flatten if opts[:pointcut]
+      super opts
+      raise ArgumentError, "type has to be Symbol: before, after or around" unless [:before, :after, :around].include?(self[:type])
+      raise ArgumentError, "no pointcut defined" unless self[:pointcuts].length   
+    end
+
+  end
+
+
+
+end
+
+

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: aspekt
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Margus Pärt
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-13 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: is_same
+  requirement: &22453880 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *22453880
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &22453420 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *22453420
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: &22453000 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *22453000
+description: Before, after and around method calls. Supports Regexp matching.
+email: margus@tione.eu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.rdoc
+- Gemfile
+- lib/aspekt.rb
+homepage: https://github.com/tione/aspekt
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: IN THE MAKING, NOT USABLE.
+test_files: []