telling-stories
Acceptance tests are great, they run at machine speed and validate all
your features are working as expected, this is awesome, what if we wanted
to show a human how our features behave?
Telling stories is an addon that plays your acceptance tests,
simulating an actual human using your app, doubling the value of your acceptance tests!
These are main features:
- See a list of all features contained in your application
- Demo your features just by clicking play
- See how a user would interact with the elements of your app
- Just works™
How does it work?
telling-stories
grabs all your acceptance tests and list them
so they can be show cased in a convenient way.
In order to reproduce the tests as a user would, telling-stories
relies on ember-cli-page-object
to interact with the page. This means
only tests written using the mentioned addon will enjoy the benefits of
telling-stories
Usage
$ ember install telling-stories
$ ember serve
Access http://localhost:4200/tests and you should see a new QUnit "Tell me the story" option on the top nav.
By enabling it, your tests will run in "human" mode.
Examples
Code Corps Video | Branch
Generate documentation site
To generate a visual documentation site for your app, just run
$ ember build:features
This command generates a documentation site on dist/ folder. You can check it
out locally by running
$ cd dist/
$ python -m SimpleHTTPServer
Development
$ ember install telling-stories
Building the app with logger enabled
$ DEBUG=telling-stories DEBUG_LEVEL=trace ember build
and then visit your app at http://localhost:4200.
Tests
$ npm test
License
telling-stories is licensed under the MIT license.
See LICENSE for the full license text.