The Cucumber Book: Behaviour-Driven Development for Testers and Developers

Cover......Page 1
Table of Contents......Page 8
Foreword......Page 12
Acknowledgments......Page 14
Who This Book Is For......Page 16
What Is Not in This Book......Page 18
Getting Help......Page 19
Part I—Cucumber Fundamentals......Page 21
1. Why Cucumber?......Page 22
Behaviour-Driven Development......Page 23
Living Documentation......Page 25
How Cucumber Works......Page 26
What We Just Learned......Page 27
Understanding Our Goal......Page 29
Creating a Feature......Page 30
Creating Step Definitions......Page 32
Implementing Our First Step Definition......Page 34
Running Our Program......Page 35
Changing Formatters......Page 36
Adding an Assertion......Page 37
Making It Pass......Page 38
What We Just Learned......Page 41
What\'s Gherkin For?......Page 43
Format and Syntax......Page 46
Feature......Page 47
Scenario......Page 48
Comments......Page 51
Spoken languages......Page 52
What We Just Learned......Page 53
4. Step Definitions: From the Outside......Page 56
Steps and Step Definitions......Page 57
Capturing Arguments......Page 62
Multiple Captures......Page 66
Flexibility......Page 67
Returning Results......Page 69
What We Just Learned......Page 75
Background......Page 78
Data Tables......Page 81
Scenario Outline......Page 87
Nesting Steps......Page 92
Doc Strings......Page 95
Staying Organized with Tags and Subfolders......Page 96
What We Just Learned......Page 99
6. When Cucumbers Go Bad......Page 101
Feeling the Pain......Page 102
Working Together......Page 105
Caring for Your Tests......Page 113
Stop the Line and Defect Prevention......Page 121
What We Just Learned......Page 122
Part II—A Worked Example......Page 125
7. Step Definitions: On the Inside......Page 126
Sketching Out the Domain Model......Page 127
Removing Duplication with Transforms......Page 132
Adding Custom Helper Methods to the World......Page 135
Organizing the Code......Page 143
What We Just Learned......Page 146
8. Support Code......Page 148
Fixing the Bug......Page 149
Bootstrapping the User Interface......Page 156
Making the Switch......Page 157
Using Hooks......Page 162
Building the User Interface......Page 165
What We Just Learned......Page 169
Our New Asynchronous Architecture......Page 172
How to Synchronize......Page 173
Implementing the New Architecture......Page 176
Fixing the Flickering Scenario......Page 180
What We Just Learned......Page 186
10. Databases......Page 188
Introducing ActiveRecord......Page 189
Refactoring to Use a Database......Page 190
Reading and Writing to the Database......Page 193
Cleaning the Database with Transactions......Page 196
Cleaning the Database with Truncation......Page 200
What We Just Learned......Page 201
Part III—Cucumber Applied......Page 203
Cucumber\'s Command-Line Options......Page 204
Running a Subset of Scenarios......Page 205
Changing Cucumber\'s Output......Page 207
Specifying the Location of Step Definitions......Page 209
Managing Your Work in Progress (WIP)......Page 210
Running Cucumber from Rake......Page 211
Running Cucumber in Continuous Integration......Page 212
What We Just Learned......Page 213
12. Testing a REST Web Service......Page 214
In-Process Testing of Rack-Based REST APIs......Page 215
Out-of-Process Testing of Any REST API......Page 226
What We Just Learned......Page 233
13. Adding Tests to a Legacy Application......Page 234
Characterization Tests......Page 235
Squashing Bugs......Page 237
Adding New Behavior......Page 238
What We Just Learned......Page 240
14. Bootstrapping Rails......Page 242
Running the Generators......Page 243
Creating a User......Page 245
Posting a Message......Page 249
Associating a Message with a User......Page 252
Creating a Controller by Hand......Page 253
Implementing the View......Page 255
What We Just Learned......Page 256
Try this......Page 257
15. Using Capybara to Test Ajax Web Applications......Page 258
Implementing a Simple Search Without Ajax......Page 260
Searching with Ajax......Page 270
The Capybara API......Page 281
Taking Screenshots......Page 284
What We Just Learned......Page 285
Simple Interfaces......Page 287
Our First Aruba Feature......Page 288
Working with Files and Executables......Page 292
Interacting with User Input......Page 300
Using Aruba\'s Ruby DSL......Page 303
What We Just Learned......Page 304
A1. Using Cucumber with Other Platforms......Page 306
Installing Ruby......Page 309
HTTP Proxy Settings......Page 310
Installing Other Gems......Page 311
Choosing a Text Editor......Page 312
A3. Ruby Gem Versions......Page 313
A4. Bibliography......Page 315
Index......Page 317