citrusbyte-stories 0.0.9 → 0.1.0

data/README.markdown

@@ -56,6 +56,17 @@ Or with a regular expression:
 
     $ ruby my_test.rb -n /yet_more_tests/
 
+Pending stories
+---------------
+
+Since Stories aims to improve your project's documentation, you can have pending stories:
+
+    class UserStoryTest < Test::Unit::TestCase
+      story "As a user I want to create stories so I can test if they pass"
+    end
+
+This is useful if you want to write all your stories upfront, even before you write the acceptance tests.
+
 Awesome output
 --------------
 
@@ -69,6 +80,11 @@ Now, if you want to impress everyone around you, try this:
 
 You will get a nicely formatted PDF with your user stories. It uses [Prawn](http://prawn.majesticseacreature.com/), so you will need to install it first.
 
+If you're using Rails, you can run the whole build with the following Rake tasks:
+
+    $ rake stories
+    $ rake stories:pdf
+
 Installation
 ------------
 

data/lib/stories.rb

@@ -1,6 +1,10 @@
 require "rubygems"
 require "contest"
 
+unless defined?(Test::Unit::AutoRunner)
+  gem "test-unit", ">= 1.2"
+end
+
 class Test::Unit::TestCase
   class << self
     alias story context

data/lib/stories/runner.rb

@@ -1,3 +1,5 @@
+# encoding: utf-8
+
 require 'test/unit/ui/console/testrunner'
 
 $stories = []
@@ -12,7 +14,10 @@ class Test::Unit::TestCase
 
       original_story(name) do
         @@story = story
-        class_eval(&block)
+
+        def self.story; @@story; end
+
+        class_eval(&block) if block_given?
       end
 
       $stories << story
@@ -26,7 +31,7 @@ class Test::Unit::TestCase
         instance_eval(&block)
       end
 
-      @@story.scenarios << scenario
+      self.story.scenarios << scenario
     end
   end
 end

data/lib/stories/runner/pdf.rb

@@ -1,3 +1,5 @@
+# encoding: utf-8
+
 gem "prawn", "~> 0.4"
 require "prawn"
 

data/test/all_test.rb

@@ -24,4 +24,6 @@ class UserStoryTest < Test::Unit::TestCase
       assert_equal 1, some_helper
     end
   end
+
+  story "Pending story"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: citrusbyte-stories
 version: !ruby/object:Gem::Version 
-  version: 0.0.9
+  version: 0.1.0
 platform: ruby
 authors: 
 - Damian Janowski
@@ -23,7 +23,7 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: "0.1"
     version: 
-description: 
+description: Write Stories and User Acceptance Tests using Contest, the tiny add on to Test::Unit that provides nested contexts and declarative tests.
 email: 
 - djanowski@dimaion.com
 - michel@soveran.com
@@ -65,10 +65,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   version: 
 requirements: []
 
-rubyforge_project: 
+rubyforge_project: stories
 rubygems_version: 1.2.0
 signing_key: 
 specification_version: 2
-summary: Write stories and user acceptance tests using the minimalist testing framework Contest.
+summary: Write Stories and User Acceptance Tests using the minimalist testing framework Contest.
 test_files: []