jeremymcanally-context 0.0.5 → 0.0.6

data/context.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name     = "context"
-  s.version  = "0.0.5"
+  s.version  = "0.0.6"
   s.date     = "2008-10-03"
   s.summary  = "Contexts and DSL sugar for your tests"
   s.email    = "jeremy@entp.com"

data/lib/context/context.rb

@@ -50,8 +50,7 @@ class Test::Unit::TestCase
       cls.class_eval(&block)
       (self.context_list ||= []) << cls
       
-      # TODO: Find a better way to uniquely identify classes
-      const_set("Test#{name.to_class_name}#{cls.object_id}", cls)
+      const_set("Test#{name.to_class_name}#{cls.object_id.abs}", cls)
       cls
     end
 

data/lib/context/lifecycle.rb

@@ -22,7 +22,7 @@ class Test::Unit::TestCase
       send("after_#{period}_callbacks") << block
     end
 
-    def gather_callbacks(callback_type, period)
+    def gather_callbacks(callback_type, period) # :nodoc:
       callbacks = superclass.respond_to?(:gather_callbacks) ? superclass.gather_callbacks(callback_type, period) : []
       callbacks.push(*send("#{callback_type}_#{period}_callbacks"))
     end
@@ -33,7 +33,7 @@ class Test::Unit::TestCase
   self.after_each_callbacks  = []
   self.after_all_callbacks   = []
 
-  def self.inherited(child)
+  def self.inherited(child) # :nodoc:
     super
     child.before_all_callbacks  = []
     child.before_each_callbacks = []
@@ -51,11 +51,11 @@ class Test::Unit::TestCase
     end
   end
 
-  def run_each_callbacks(callback_type)
+  def run_each_callbacks(callback_type) # :nodoc:
     self.class.gather_callbacks(callback_type, :each).each { |c| instance_eval(&c) }
   end
 
-  def run_all_callbacks(callback_type)
+  def run_all_callbacks(callback_type) # :nodoc:
     previous_ivars = instance_variables
     self.class.gather_callbacks(callback_type, :all).each { |c| instance_eval(&c) }
     (instance_variables - previous_ivars).inject({}) do |hash, ivar|
@@ -63,7 +63,7 @@ class Test::Unit::TestCase
     end
   end
 
-  def set_values_from_callbacks(values)
+  def set_values_from_callbacks(values) # :nodoc:
     values.each do |name, value|
       instance_variable_set name, value
     end

data/lib/context/shared_behavior.rb

@@ -1,25 +1,51 @@
-class SharedContext < Module
-  def self.create_from_behavior(beh)
-    mod = self.new
-    mod.behavior = beh
-    mod
-  end
-  
-  def behavior=(beh)
-    @behavior = beh
-  end
+module Context
+  class SharedBehavior < Module
+    def self.create_from_behavior(beh) # :nodoc:
+      mod = self.new
+      mod._behavior = beh
+      
+      mod
+    end
   
-  def behavior
-    @behavior
-  end
+    def _behavior=(beh) # :nodoc:
+      @_behavior = beh
+    end
   
-  def included(arg)
-    @behavior.call
+    def included(arg) # :nodoc:
+      @_behavior.call
+    end
   end
 end
 
 class Test::Unit::TestCase
   class << self
+    # Share behavior among different contexts.  This creates a module (actually, a Module subclass)
+    # that is included using the +use+ method (or one of its aliases) provided by context or +include+ 
+    # if you know the module's constant name.
+    #
+    # ==== Examples
+    #   
+    #   shared "other things" do
+    #     it "should do things but not some things" do
+    #       # behavior is fun
+    #     end
+    #   end
+    #
+    #   use "other things"
+    #   # or...
+    #   it_should_behave_like "other things"
+    #
+    #   shared :client do
+    #     it "should be a client to our server" do
+    #       # TODO: client behavior here
+    #     end
+    #   end
+    #
+    #   use :client
+    #   # or...
+    #   uses "client"
+    #   behaves_like "client"
+    #
     def shared(name, &block)
       case name.class.name
       when "String"
@@ -30,14 +56,33 @@ class Test::Unit::TestCase
         raise ArgumentError, "Provide a String or Symbol as the name of the shared behavior group"
       end
       
-      Object.const_set(name, SharedContext.create_from_behavior(block))
+      Object.const_set(name, Context::SharedBehavior.create_from_behavior(block))
     end
     
     %w(shared_behavior share_as share_behavior_as shared_examples_for).each {|m| alias_method m, :shared}
     
+    # Pull in behavior shared by +shared+ or a module.  
+    #
+    # ==== Examples
+    #   
+    #   shared "other things" do
+    #     it "should do things but not some things" do
+    #       # behavior is fun
+    #     end
+    #   end
+    #
+    #   use "other things"
+    #   # or...
+    #   it_should_behave_like "other things"
+    #
+    #   module Things
+    #   end
+    #
+    #   uses Things
+    #
     def use(shared_name)
       case shared_name.class.name
-      when "SharedContext", "Module"
+      when "Context::SharedBehavior", "Module"
         include shared_name
       when "String"
         include Object.const_get(shared_name.to_module_name)

data/lib/context/suite.rb

@@ -24,7 +24,7 @@ module Test
     class TestSuite
       # Runs the tests and/or suites contained in this
       # TestSuite.
-      def run(result, &progress_block)
+      def run(result, &progress_block) # :nodoc:
         yield(STARTED, name)
         ivars_from_callback = @tests.first.run_all_callbacks(:before) if @tests.first.is_a?(Test::Unit::TestCase)
         @tests.each do |test|

data/lib/context/version.rb

@@ -2,7 +2,7 @@ module Context
   module VERSION #:nodoc:
     MAJOR = 0
     MINOR = 0
-    TINY  = 5
+    TINY  = 6
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: jeremymcanally-context
 version: !ruby/object:Gem::Version 
-  version: 0.0.5
+  version: 0.0.6
 platform: ruby
 authors: 
 - Jeremy McAnally