specflow-takedown's Introduction

specflow-takedown

A clean and cutdown template for writing acceptance tests against API endpoints.

##Setup

Ensure you have installed the Visual Studio integration packages for Specflow as documented here http://www.specflow.org/getting-started.

##Usage

To run an acceptance test:

Build solution
Open desired feature file located within 'Features' folder
Right click a feature or scenario title
Click 'Run Specflow Scenarios'

Or even better use the command line to run all the tests:

Navigate to the root of the specflow-takedown project (cd [file_location]\specflow-takedown\api-acceptance-tests)
Execute the command line test runner by typing 'runtests.cmd' and hit [Enter]

##Auto generated documentation

Running acceptance tests via the CLI means we can generate some useful reports and documentation.

SpecRun provides a nice reporting structure for your acceptance tests. These reports can be found within the 'TestResults' folder. More information on SpecRun reporting here http://www.specflow.org/documentation/Reporting/.

Pickles is a tool that will output features as human readable documentation. These files are generated within the 'Documentation' folder. More information on Pickles reporting here http://docs.picklesdoc.com/en/latest/StartSimple/

It is recommended that any generated reports should be downloadable artifacts generated by your automated build process.

##Troubleshooting

The acceptance tests make a GET request to various endpoints within jsonplaceholder.typicode.com. In case of request timeouts please check your connection to jsonplaceholder.typicode.com.

##Credits

Shout outs to Specflow, SpecRun, Shouldly and EasyHttp.

Recommend Projects