ae 1.0.0 → 1.1.0

data/lib/ae.rb

@@ -3,5 +3,6 @@ module AE
 end
 
 require 'ae/assert'
+#require 'ae/expect'
 
 # Copyright (c) 2008,2009 Thomas Sawyer

data/lib/ae/assertor.rb

@@ -47,6 +47,20 @@ class Assertor
     __assert__(pass, msg)
   end
 
+  #
+  #def expect(*args, &block)
+  #  return self if args.empty? && !block_given?
+  #  block = args.shift if !block_given? && Proc === args.first
+  #  if block
+  #    pass = block.arity > 0 ? block.call(@delegate) : block.call  #@delegate.instance_eval(&block)
+  #    msg = args.shift || @message || block.inspect
+  #  else
+  #    pass = args.shift  # truthiness
+  #    msg  = args.shift
+  #  end
+  #  __assert__(pass, msg)
+  #end
+
   #
   def flunk(msg=nil)
     fail Assertion.new(msg || @message, :backtrace=>@backtrace)

data/lib/ae/core_ext.rb

@@ -10,8 +10,8 @@ module Kernel
   #
   # TODO: Can we call this #fail (overriding built-in)?
   #
-  def flunk(reason="flunk")
-    raise Assertion.new(reason, :backtrace=>caller)
+  def flunk(reason=nil, backtrace=nil)
+    raise Assertion.new((reason || 'flunk'), :backtrace=>(backtrace || caller))
   end
 
   # Is literally true.

data/lib/ae/expect.rb

@@ -0,0 +1,124 @@
+require 'ae/assertion'
+
+module AE
+
+  # = Expect
+  #
+  #   "When love and skill work together, expect a masterpiece."
+  #                                 --John Ruskin (1819 - 1900)
+  #
+  module Expect
+
+    # The #expect method is a convenient tool for defining
+    # certain sets of expectations in your specifications.
+    #
+    # Expect is used to expect a result from a block of code.
+    # If the argument to expect is a subclass of Exception
+    # or instance thereof, then the block is monitored for
+    # the raising of such an exception.
+    #
+    #   expect StandardError do
+    #     raise ArgumentError
+    #   end 
+    #
+    # All other expectations are compared using case equality (#===). 
+    # This allows one to verify matching Regexp.
+    #
+    #   expect /x/ do
+    #     "x"
+    #   end 
+    #
+    # As well as checking that an object is an instance of a given Class.
+    #
+    #   expect String do
+    #     "x"
+    #   end 
+    #
+    # Like #assert it can be used to designate an expectation
+    # via a *functor*.
+    #
+    #   4.expect == 3
+    #
+    #
+    def expect(*args, &block)
+      return Assertor.new(self, :backtrace=>caller) if args.empty? && !block
+      block = args.shift if !block_given? && Proc === args.first
+      if block
+        exp = args.empty? ? self : args.shift
+        if Exception === exp || (Class===exp && exp.ancestors.include?(Exception))
+          begin
+            block.call
+            pass = false
+            msg  = "#{exp} not raised"
+          rescue exp => error
+            pass = true
+          rescue Exception => error
+            pass = false
+            msg  = "#{exp} expected but #{error.class} was raised"
+          end
+        else
+          res  = block.call
+          pass = (exp === res)
+          msg  = "#{exp} === #{res}"
+        end
+      else
+        pass = (exp === self)
+        msg  = "#{exp} === #{self}"
+      end
+      flunk(msg, caller) unless pass
+    end
+
+    # Designate a negated expectation. Read this as "expect not".
+    #
+    # See #expect.
+    #
+    def expect!(exp=NoArgument, &block)
+      return Assertor.new(self, :backtrace=>caller) if args.empty? && !block
+      block = args.shift if !block_given? && Proc === args.first
+      if block
+        exp = args.empty? ? self : args.shift
+        if Exception === exp || (Class===exp && exp.is?(Exception))
+          begin
+            block.call
+            pass = true
+          rescue exp => error
+            pass = false
+            msg  = "#{exp} raised"
+          rescue Exception => error
+            pass = true
+            #msg  = "#{exp} expected but #{error.class} was raised"
+          end
+        else
+          res  = block.call
+          pass = !(exp === res)
+          msg  = "not #{exp} === #{res}"
+        end
+      else
+        pass = !(exp === self)
+        msg  = "not #{exp} === #{self}"
+      end
+      flunk(msg, caller) unless pass
+    end
+
+    # Alias for #expect! method.
+    alias_method :forbid, :expect!
+
+    # Like #expect but uses the reciever as the object
+    # of expectation.
+    #
+    #   /x/.expected do
+    #     "oooxooo"
+    #   end
+    #
+    def expected(*args, &block)
+      expect(self, *args, &block)
+    end
+
+  end
+
+end#module QED
+
+class ::Object #:nodoc:
+  include AE::Expect
+end
+

data/meta/homepage

@@ -1 +1 @@
-http://ae.rubyforge.org
+http://proutils.rubyforge.org/ae

data/meta/version

@@ -1 +1 @@
-1.0.0
+1.1.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ae
 version: !ruby/object:Gem::Version 
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors: 
 - trans <admin@tigerops.org>
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-09-03 00:00:00 -04:00
+date: 2009-09-06 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
@@ -23,21 +23,23 @@ executables: []
 extensions: []
 
 extra_rdoc_files: 
-- README
 - MANIFEST
 - LICENSE
+- README.rdoc
 - HISTORY
 files: 
 - demo/01_overview.rdoc
 - demo/02_assertion.rdoc
 - demo/03_assert.rdoc
 - demo/04_subjunctive.rdoc
+- demo/05_expect.qed
 - doc/qedoc/index.html
 - doc/qedoc/jquery.js
 - lib/ae/assert.rb
 - lib/ae/assertion.rb
 - lib/ae/assertor.rb
 - lib/ae/core_ext.rb
+- lib/ae/expect.rb
 - lib/ae/subjunctive/must.rb
 - lib/ae/subjunctive/should.rb
 - lib/ae/subjunctive.rb
@@ -57,11 +59,11 @@ files:
 - meta/title
 - meta/version
 - LICENSE
-- README
+- README.rdoc
 - HISTORY
 - MANIFEST
 has_rdoc: true
-homepage: http://ae.rubyforge.org
+homepage: http://proutils.rubyforge.org/ae
 licenses: []
 
 post_install_message: 
@@ -69,8 +71,6 @@ rdoc_options:
 - --inline-source
 - --title
 - ae api
-- --main
-- README
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -87,7 +87,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   version: 
 requirements: []
 
-rubyforge_project: ae
+rubyforge_project: proutils
 rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3