aquarium 0.1.0

data/spec/aquarium/spec_example_classes.rb

@@ -0,0 +1,117 @@
+# :enddoc:
+# Declares classes, etc. that support several different module specs.
+class ExampleParentClass
+  def == other
+    self.object_id == other.object_id or self.class == other.class
+  end
+  alias :eql? :==
+end
+
+class ClassWithPublicInstanceMethod < ExampleParentClass
+  def public_instance_test_method
+  end
+end
+class ClassWithPublicInstanceMethod2 < ExampleParentClass
+  def public_instance_test_method2
+  end
+end
+class ClassWithProtectedInstanceMethod < ExampleParentClass
+  protected
+  def protected_instance_test_method
+  end
+end
+class ClassWithPrivateInstanceMethod < ExampleParentClass
+  private
+  def private_instance_test_method
+  end
+end
+
+class ClassWithPublicClassMethod < ExampleParentClass
+  def self.public_class_test_method
+  end
+end
+class ClassWithPrivateClassMethod < ExampleParentClass
+  def self.private_class_test_method
+  end
+  private_class_method :private_class_test_method
+end
+
+class ClassWithAttribs < ExampleParentClass
+  attr_accessor :attrRW_ClassWithAttribs, :name
+  attr_reader   :attrR_ClassWithAttribs
+  attr_writer   :attrW_ClassWithAttribs
+  def initialize
+    @name = "Name"
+  end
+  def eql? other
+    super(other) && name.eql?(other.name)
+  end
+  alias :== :eql?
+end
+
+class Watchful 
+  class WatchfulError < Exception
+    def initialize message = nil
+      super
+    end
+  end
+  
+  def eql? other
+    super && instance_variables.each do |var|
+      return false unless instance_variable_get(var) == other.instance_variable_get(var)
+    end
+  end
+  alias :== :eql?
+
+  %w[public protected private].each do |protection|
+    class_eval(<<-EOF, __FILE__, __LINE__)
+      public
+      attr_accessor :#{protection}_watchful_method_args, :#{protection}_watchful_method_that_raises_args
+      #{protection}
+      def #{protection}_watchful_method *args
+        @#{protection}_watchful_method_args = args
+        yield *args if block_given?
+      end
+      def #{protection}_watchful_method_that_raises *args
+        @#{protection}_watchful_method_that_raises_args = args
+        yield *args if block_given?
+        raise WatchfulError.new #("#{protection}_watchful_method_that_raises")
+      end
+    EOF
+  end
+
+  %w[public private].each do |protection|
+    class_eval(<<-EOF, __FILE__, __LINE__)
+      @@#{protection}_class_watchful_method_args = nil
+      @@#{protection}_class_watchful_method_that_raises_args = nil
+      class << self
+        public
+        def #{protection}_class_watchful_method_args
+          @@#{protection}_class_watchful_method_args
+        end
+        def #{protection}_class_watchful_method_args= args
+          @@#{protection}_class_watchful_method_args = args
+        end
+        def #{protection}_class_watchful_method_that_raises_args
+          @@#{protection}_class_watchful_method_that_raises_args
+        end
+        def #{protection}_class_watchful_method_that_raises_args args
+          @@#{protection}_class_watchful_method_that_raises_args = args
+        end
+      
+        def #{protection}_class_watchful_method *args
+          @@#{protection}_class_watchful_method_args = args
+          yield *args if block_given?
+        end
+        def #{protection}_class_watchful_method_that_raises *args
+          @@#{protection}_class_watchful_method_that_raises_args = args
+          yield *args if block_given?
+          raise WatchfulError.new #("#{protection}_class_watchful_method_that_raises")
+        end
+        #{protection} :#{protection}_class_watchful_method, :#{protection}_class_watchful_method_that_raises
+      end
+    EOF
+  end
+end
+
+class WatchfulChild < Watchful; end

data/spec/aquarium/spec_helper.rb

@@ -0,0 +1,3 @@
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../../lib'
+require 'rubygems'
+require 'spec'

data/spec/aquarium/utils/array_utils_spec.rb

@@ -0,0 +1,47 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+require 'aquarium/utils/array_utils'
+require 'set'
+
+describe Aquarium::Utils::ArrayUtils, "make_array" do
+  
+  it "should return an empty array if the input is nil." do
+    make_array(nil).should == []
+  end
+  
+  it "should return an empty array if an input array contains all nils." do
+    make_array([nil, nil]).should == []
+  end
+  
+  it "should return an empty array if an input Set contains all nils." do
+    make_array(Set.new([nil, nil])).should == []
+  end
+  
+  it "should return an array with all nils removed from the input array." do
+    make_array([nil, 1, 2, nil, 3, 4]).should == [1, 2, 3, 4]
+  end
+
+  it "should return an array with all nils removed from the input Set." do
+    make_array(Set.new([nil, 1, 2, nil, 3, 4])).should == [1, 2, 3, 4]
+  end
+
+  it "should return an 1-element array with an empty element if the input is empty." do
+    make_array("").should == [""]
+  end
+
+  it "should return an 1-element array with an element that matched the input element." do
+    make_array("123").should == ["123"]
+  end
+
+  it "should return an input array unchanged if it contains no nil elements." do
+    make_array([1,2,"123"]).should == [1,2,"123"]
+  end
+
+  it "should return an input Set#to_a if it contains no nil elements." do
+    make_array(Set.new([1,2,"123"])).should == [1,2,"123"]
+  end
+
+  it "should accept a list of arguments instead of an array or Set." do
+    make_array(nil, nil).should == []
+    make_array(nil, 1, 2, nil, 3, 4).should == [1, 2, 3, 4]
+  end
+end

data/spec/aquarium/utils/hash_utils_spec.rb

@@ -0,0 +1,48 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+require File.dirname(__FILE__) + '/../spec_example_classes'
+require 'aquarium/utils/hash_utils'
+
+describe Aquarium::Utils::HashUtils, "#make_hash" do
+  
+  it "should return an empty hash if the input is nil." do
+    make_hash(nil).should == {}
+  end
+
+  it "should return an empty hash if the input hash is empty." do
+    make_hash({}).should == {}
+  end
+
+  it "should return a hash with all nil keys and their corresponding values removed." do
+    make_hash({nil => 'nil', :a => 'a'}).should == {:a => 'a'}
+  end
+
+  it "should return an unmodified hash if the input hash has no nil keys." do
+    make_hash({:a => 'a', :b => 'b'}).should == {:a => 'a', :b => 'b'}
+  end
+
+  it "should return a 1-element hash with an empty key and a nil value if the input is empty." do
+    make_hash("").should == {"" => nil}
+  end
+
+  it "should return a 1-element hash with the input item as a key and nil as the corresponding value if a single input value is given and no block is given." do
+    make_hash("123").should == {"123" => nil}
+  end
+
+  it "should return a 1-element hash with the input item as a key and the value of the block as the corresponding value if a single input value is given." do
+    make_hash("123"){|x| x+x}.should == {"123" => "123123"}
+  end
+
+  it "should return a hash with the input list items as keys with any nils removed." do
+    make_hash(["123", nil, nil, "22", nil]).should == {"123" => nil, "22" => nil}
+  end
+
+  it "should return a hash with the input list items as keys and nils as the corresponding values, if no block is given." do
+    make_hash(["123", "22"]).should == {"123" => nil, "22" => nil}
+  end
+
+  it "should return a hash with the input list items as keys and the value of the block as the corresponding value." do
+    make_hash(["123", "22"]){|x| x+x}.should == {"123" => "123123", "22" => "2222"}
+  end
+
+end
+

data/spec/aquarium/utils/html_escaper_spec.rb

@@ -0,0 +1,18 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+require 'aquarium/utils/array_utils'
+require 'set'
+
+describe Aquarium::Utils::HtmlEscaper, ".escape" do
+  it "should replace < with &lt; and > with &gt;" do
+    Aquarium::Utils::HtmlEscaper.escape("<html></html>").should == "&lt;html&gt;&lt;/html&gt;"
+  end
+end
+
+describe Aquarium::Utils::HtmlEscaper, "#escape" do
+  it "should replace < with &lt; and > with &gt;" do
+    class Escaper
+      include Aquarium::Utils::HtmlEscaper
+    end
+    Escaper.new.escape("<html></html>").should == "&lt;html&gt;&lt;/html&gt;"
+  end
+end

data/spec/aquarium/utils/method_utils_spec.rb

@@ -0,0 +1,50 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+require 'aquarium/utils/method_utils'
+
+describe "Aquarium::Utils::MethodUtils.method_args_to_hash" do
+
+  it "should return an empty hash for no arguments." do
+    Aquarium::Utils::MethodUtils.method_args_to_hash().should == {}
+  end
+  
+  it "should return an empty hash for a nil argument." do
+    Aquarium::Utils::MethodUtils.method_args_to_hash(nil).should == {}
+  end
+  
+  it "should return a hash with the input arguments as keys and nil for each value, if no block is given and the last argument is not a hash." do
+    Aquarium::Utils::MethodUtils.method_args_to_hash(:a, :b).should == {:a => nil, :b => nil}
+  end
+    
+  it "should return a hash with the input arguments as keys and the block result for each value, if a block is given and the last argument is not a hash." do
+    Aquarium::Utils::MethodUtils.method_args_to_hash(:a, :b){|key| key.to_s}.should == {:a => 'a', :b => 'b'}
+  end
+    
+  it "should return the input hash if the input arguments consist of a single hash." do
+    Aquarium::Utils::MethodUtils.method_args_to_hash(:a =>'a', :b => 'b'){|key| key.to_s}.should == {:a => 'a', :b => 'b'}
+  end
+    
+  it "should return the input hash if the input arguments consist of a single hash, ignoring a given block." do
+    Aquarium::Utils::MethodUtils.method_args_to_hash(:a =>'a', :b => 'b'){|key| key.to_s+key.to_s}.should == {:a => 'a', :b => 'b'}
+  end
+    
+  it "should treat a hash that is not at the end of the argument list as a non-hash argument." do
+    hash_arg = {:a =>'a', :b => 'b'}
+    h = Aquarium::Utils::MethodUtils.method_args_to_hash(hash_arg, :c){|key| "foo"}
+    h.size.should == 2
+    h[hash_arg].should == "foo"
+    h[:c].should == "foo"
+  end
+    
+  it "should return a hash containing an input hash at the end of the input arguments." do
+    Aquarium::Utils::MethodUtils.method_args_to_hash(:x, :y, :a =>'a', :b => 'b').should == {:a => 'a', :b => 'b', :x => nil, :y => nil}
+  end
+    
+  it "should ignore whether or not the trailing input hash is wrapped in {}." do
+    Aquarium::Utils::MethodUtils.method_args_to_hash(:x, :y, {:a =>'a', :b => 'b'}).should == {:a => 'a', :b => 'b', :x => nil, :y => nil}
+  end
+    
+  it "should return a hash with the non-hash arguments mapped to key-value pairs with value specified by the input block (or null) and the input unchanged." do
+    Aquarium::Utils::MethodUtils.method_args_to_hash(:x, :y, :a =>'a', :b => 'b'){|a| a.to_s.capitalize}.should == {:a => 'a', :b => 'b', :x => 'X', :y => 'Y'}
+  end
+    
+end

data/spec/aquarium/utils/nil_object_spec.rb

@@ -0,0 +1,19 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+require File.dirname(__FILE__) + '/../spec_example_classes'
+require 'aquarium/utils/nil_object'
+
+describe Aquarium::Utils::NilObject, " (when a message is sent to it)" do
+  it "should return itself, by default, for methods not defined for Object" do
+    nil_object = Aquarium::Utils::NilObject.new
+    %w[a b foo].each do |method_name|
+      nil_object.send(method_name.to_sym).should == nil_object
+    end
+  end
+  
+  it "should invoke Object's methods, when defined" do
+    nil_object = Aquarium::Utils::NilObject.new
+    %w[to_s inspect].each do |method_name|
+      nil_object.send(method_name.to_sym).include?("Aquarium::Utils::NilObject").should be_true
+    end
+  end
+end

data/spec/aquarium/utils/set_utils_spec.rb

@@ -0,0 +1,60 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+require File.dirname(__FILE__) + '/../spec_example_classes'
+require 'aquarium/utils/set_utils'
+
+describe Aquarium::Utils::SetUtils, "make_set" do
+  
+  before :each do
+    @empty_set = Set.new
+  end
+  
+  it "should return an empty set if the input is empty." do
+    make_set().should == @empty_set
+  end
+  
+  it "should return an empty set if the input is an empty array." do
+    make_set([]).should == @empty_set
+  end
+  
+  it "should return an empty set if the input is nil." do
+    make_set(nil).should == @empty_set
+  end
+  
+  it "should return an empty set if the input set contains all nils." do
+    make_set([nil, nil]).should == @empty_set
+  end
+  
+  it "should return a set with all input nils removed." do
+    make_set([nil, 1, 2, nil, 3, 4]).should == Set.new([1, 2, 3, 4])
+  end
+
+  it "should return a 1-element set with an empty element if the input is empty." do
+    make_set("").should == Set.new([""])
+  end
+
+  it "should return a 1-element set with an element that matched the input element." do
+    make_set("123").should == Set.new(["123"])
+  end
+
+  it "should return an input set unchanged if it contains no nil elements." do
+    make_set([1,2,"123"]).should == Set.new([1,2,"123"])
+  end
+
+  it "should accept a single argument." do
+    make_set(nil).should == @empty_set
+    make_set(1).should == Set.new([1])
+  end
+  
+  it "should accept a list of arguments." do
+    make_set(nil, nil).should == @empty_set
+    make_set(nil, 1, 2, nil, 3, 4).should == Set.new([1, 2, 3, 4])
+  end
+  
+  it "should accept an array" do
+    make_set([nil, 1, 2, nil, 3, 4]).should == Set.new([1, 2, 3, 4])
+  end
+  
+  it "should accept a set" do
+    make_set(Set.new([nil, 1, 2, nil, 3, 4])).should == Set.new([1, 2, 3, 4])
+  end
+end

metadata

@@ -0,0 +1,132 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: aquarium
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+date: 2007-08-23 00:00:00 -05:00
+summary: Aquarium-0.1.0 (r7) - Aspect-Oriented Programming toolkit for Ruby http://aquarium.rubyforge.org
+require_paths: 
+- lib
+email: aquarium-devel@rubyforge.org
+homepage: http://aquarium.rubyforge.org
+rubyforge_project: aquarium
+description: Aquarium is a full-featured Aspect-Oriented Programming (AOP) framework for Ruby that is  designed to provide an intuitive syntax and support for large-scale, dynamic aspects.
+autorequire: aquarium
+default_executable: ""
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- - Aquarium Development Team
+files: 
+- CHANGES
+- EXAMPLES.rd
+- MIT-LICENSE
+- Rakefile
+- README
+- RELEASE-PLAN
+- UPGRADE
+- lib/aquarium/aspects/advice.rb
+- lib/aquarium/aspects/aspect.rb
+- lib/aquarium/aspects/default_object_handler.rb
+- lib/aquarium/aspects/dsl/aspect_dsl.rb
+- lib/aquarium/aspects/dsl.rb
+- lib/aquarium/aspects/join_point.rb
+- lib/aquarium/aspects/pointcut.rb
+- lib/aquarium/aspects/pointcut_composition.rb
+- lib/aquarium/aspects.rb
+- lib/aquarium/extensions/hash.rb
+- lib/aquarium/extensions/regexp.rb
+- lib/aquarium/extensions/set.rb
+- lib/aquarium/extensions/string.rb
+- lib/aquarium/extensions/symbol.rb
+- lib/aquarium/extensions.rb
+- lib/aquarium/extras/design_by_contract.rb
+- lib/aquarium/extras.rb
+- lib/aquarium/finders/finder_result.rb
+- lib/aquarium/finders/method_finder.rb
+- lib/aquarium/finders/object_finder.rb
+- lib/aquarium/finders/type_finder.rb
+- lib/aquarium/finders.rb
+- lib/aquarium/utils/array_utils.rb
+- lib/aquarium/utils/hash_utils.rb
+- lib/aquarium/utils/html_escaper.rb
+- lib/aquarium/utils/invalid_options.rb
+- lib/aquarium/utils/method_utils.rb
+- lib/aquarium/utils/nil_object.rb
+- lib/aquarium/utils/set_utils.rb
+- lib/aquarium/utils.rb
+- lib/aquarium/version.rb
+- lib/aquarium.rb
+- spec/aquarium/aspects/advice_chain_node_spec.rb
+- spec/aquarium/aspects/advice_spec.rb
+- spec/aquarium/aspects/aspect_invocation_spec.rb
+- spec/aquarium/aspects/aspect_spec.rb
+- spec/aquarium/aspects/aspect_with_nested_types_spec.rb
+- spec/aquarium/aspects/concurrent_aspects_spec.rb
+- spec/aquarium/aspects/concurrent_aspects_with_objects_and_types_spec.rb
+- spec/aquarium/aspects/concurrently_accessed.rb
+- spec/aquarium/aspects/dsl/aspect_dsl_spec.rb
+- spec/aquarium/aspects/join_point_spec.rb
+- spec/aquarium/aspects/pointcut_and_composition_spec.rb
+- spec/aquarium/aspects/pointcut_or_composition_spec.rb
+- spec/aquarium/aspects/pointcut_spec.rb
+- spec/aquarium/extensions/hash_spec.rb
+- spec/aquarium/extensions/regex_spec.rb
+- spec/aquarium/extensions/set_spec.rb
+- spec/aquarium/extensions/string_spec.rb
+- spec/aquarium/extensions/symbol_spec.rb
+- spec/aquarium/extras/design_by_contract_spec.rb
+- spec/aquarium/finders/finder_result_spec.rb
+- spec/aquarium/finders/method_finder_spec.rb
+- spec/aquarium/finders/method_sorting_spec.rb
+- spec/aquarium/finders/object_finder_spec.rb
+- spec/aquarium/finders/type_finder_spec.rb
+- spec/aquarium/spec_example_classes.rb
+- spec/aquarium/spec_helper.rb
+- spec/aquarium/utils/array_utils_spec.rb
+- spec/aquarium/utils/hash_utils_spec.rb
+- spec/aquarium/utils/html_escaper_spec.rb
+- spec/aquarium/utils/method_utils_spec.rb
+- spec/aquarium/utils/nil_object_spec.rb
+- spec/aquarium/utils/set_utils_spec.rb
+- examples/aspect_design_example.rb
+- examples/design_by_contract_example.rb
+- examples/method_missing_example.rb
+- examples/method_tracing_example.rb
+- rake_tasks/examples.rake
+- rake_tasks/examples_specdoc.rake
+- rake_tasks/examples_with_rcov.rake
+- rake_tasks/verify_rcov.rake
+test_files: []
+
+rdoc_options: 
+- --title
+- Aquarium
+- --line-numbers
+- --inline-source
+- --main
+- README
+extra_rdoc_files: 
+- README
+- CHANGES
+- MIT-LICENSE
+- UPGRADE
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+