riot 0.9.8 → 0.9.9

data/README.markdown

@@ -72,8 +72,27 @@ Notice that you do not define a class anywhere. That would be the entire content
 
 Sometimes it's more clear to say "this **should** be that" and sometimes it's better to say "**asserts** this is that". I promise you that Riot will get no more redundant than this, but also that besides speed, Riot will aim at being expressive with a minimal amount of syntax.
 
+The other important thing to note in the examples above is the use of the `topic`. Calling `topic` within any assertion will actually return the value of whatever was evaluated and returned from calling setup in the given context. In the examples above, `User.new` was returned, and is therefor accessible as the `topic`.
+
 I'm going to use `asserts` for the rest of this introduction, but you should know that you can replace any instance of `asserts` with `should` and nothing would change.
 
+#### Example: Shortcut - Asserting the topic itself
+
+Over the course of developing Riot it became somewhat obvious to some of us that we were creating assertions that returned the `topic` just so we could assert things about the topic itself. For instance, were doing this:
+
+    context "a billionaire" do
+      setup { MoneyMaker.build(:billionaire) }
+      
+      should("be a Billionaire") { topic }.kind_of(Billionaire)
+    end
+
+This is awfully redundant - not to mention, contrived. So, we wrote a shortcut to generate an assertion that returns topic. This means we can now do this:
+
+    context "a billionaire" do
+      setup { MoneyMaker.build(:billionaire) }
+      topic.kind_of(Billionaire)
+    end
+
 #### Example: Equality
 
 One of the most common assertions you will (or do already) utilize is that of equality; is this equal to that? Riot supports this in a slightly different manner than most other frameworks. With Riot, you add the expectation to the assertion itself.
@@ -344,7 +363,7 @@ For instance, let's say you wanted to add a macro for verifying that the result
     module Custom
       module AssertionMacros
         def kind_of(expected_class)
-          actual.kind_of?(expected) || failure("expected kind of #{expected}, not #{actual.inspect}")
+          actual.kind_of?(expected) || fail("expected kind of #{expected}, not #{actual.inspect}")
         end
       end # AssertionMacros
     end # Custom

data/VERSION

@@ -1 +1 @@
-0.9.8
+0.9.9

data/lib/riot/context.rb

@@ -32,6 +32,7 @@ module Riot
     def context(description, &block) Context.new(description, @reporter, self, &block); end
     def asserts(what, &block) add_assertion("asserts #{what}", &block); end
     def should(what, &block) add_assertion("should #{what}", &block); end
+    def topic; asserts("topic") { topic }; end
   private
     def add_assertion(what, &block)
       (assertions << Assertion.new("#{to_s} #{what}", @situation, &block)).last

data/riot.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{riot}
-  s.version = "0.9.8"
+  s.version = "0.9.9"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Justin 'Gus' Knowlden"]
-  s.date = %q{2009-10-10}
+  s.date = %q{2009-10-15}
   s.description = %q{An extremely fast, expressive, and context-driven unit-testing framework. A replacement for all other testing frameworks. Protest the slow test.}
   s.email = %q{gus@gusg.us}
   s.extra_rdoc_files = [

data/test/context_test.rb

@@ -25,6 +25,10 @@ context "any context" do
     asserts "topic becomes available to test as result of setup" do
       @context.should("bar") { topic }.actual
     end.equals("foo")
+
+    asserts "calling topic in context will return assertion that returns topic as the actual" do
+      @context.topic.actual
+    end.equals("foo")
   end # when running setup
 end # any context
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: riot
 version: !ruby/object:Gem::Version 
-  version: 0.9.8
+  version: 0.9.9
 platform: ruby
 authors: 
 - Justin 'Gus' Knowlden
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-10-10 00:00:00 -05:00
+date: 2009-10-15 00:00:00 -05:00
 default_executable: 
 dependencies: []