/
README
51 lines (32 loc) · 1.5 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
merb_stories
=========
A plugin for the Merb framework that provides helper functionality for running stories in the rSpec testing framework.
== Stories
merb_stories supports rSpec story generation for regular Merb apps. See http://rspec.info for more information
on using rSpec plain text stories.
When using the generators for the first time, a few extra helper files will be generated.
=== Generation Examples
==== Simple
To generate a simple story use:
{{{merb-gen story my_story}}}
This will generate all files needed to support that story.
- steps/my_story.rb
- stories/my_story
- stories/my_story.rb
==== Complex
You can keep your stories organized by putting stories into sub-directories. To do this with the generator use:
{{{merb-gen story complex/story_group/story_file}}}
This will generate the following files:
- steps/complex_story_group_story_file.rb
- stories/complex/story_group/story_file
- stories/complex/story_group/story_file.rb
=== Usage Examples
merb_stories has a rake task for running your stories. To include it you need to make merb_stories a dependency in your app.
To make the rake file available, in config/init.rb include the following line:
{{{dependency "merb_stories" if Merb.environment == "test"}}}
Once you have the rake file available you can run the stories:
rake story[my_story]
OR for complex examples
rake story[complex/story_group/story_file]
OR to run all the stories
rake story[all]