Rails 5 Test Prescriptions: Build a Healthy Codebase

Cover......Page 1
Table of Contents......Page 7
Acknowledgments......Page 12
 What’s in This Book......Page 13
 A Word About Tools, Best Practices, and Teaching TDD......Page 14
 Changes in This Edition......Page 15
 Online Resources......Page 16
1. A Test-Driven Fable......Page 17
 Testing First Drives Design......Page 19
 What Is TDD Good For?......Page 21
 When TDD Needs Some Help......Page 23
 What You’ve Done......Page 25
 Infrastructure......Page 26
 Installing RSpec......Page 27
 Where to Start?......Page 29
 Running the Test......Page 34
 Making the Test Pass......Page 36
 The Second Test......Page 39
 Back on Task......Page 43
 Adding Some Math......Page 45
 The First Date......Page 48
 Using the Time Data......Page 51
 What You’ve Done......Page 55
 Let’s Write Some Rails......Page 56
 The Days Are Action-Packed......Page 63
 Who Controls the Controller?......Page 72
 A Test with a View......Page 74
 Testing for Failure......Page 78
 What You’ve Done......Page 81
 The Big One......Page 82
 Cost and Value......Page 83
 SWIFT: The Five Qualities of Valuable Tests......Page 85
 What You’ve Done......Page 92
 What Can You Do in a Model Test?......Page 93
 Okay, Funny Man, What Makes a Good Set of Model Tests?......Page 94
 Refactoring Models......Page 95
 A Note on Assertions per Test......Page 101
 Testing What Rails Gives You......Page 103
 Testing ActiveRecord Finders......Page 105
 Testing Shared Modules and ActiveSupport Concerns......Page 108
 Writing Your Own RSpec Matchers......Page 110
 What You’ve Done......Page 113
6. Adding Data to Tests......Page 114
 What’s the Problem?......Page 115
 Fixtures......Page 116
 Factories......Page 122
 Dates and Times......Page 136
 What You’ve Done......Page 141
7. Using Test Doubles as Mocks and Stubs......Page 142
 Test Doubles Defined......Page 143
 Creating Stubs......Page 145
 Mock Expectations......Page 150
 Using Mocks to Simulate Database Failure......Page 151
 Using Mocks to Specify Behavior......Page 154
 More Expectation Annotations......Page 157
 Mock Tips......Page 160
 What You’ve Done......Page 162
8. Integration Testing with Capybara and Cucumber......Page 163
 A Field Guide to Integration and System Tests......Page 164
 Setting Up Capybara......Page 165
 Using Feature Tests to Build a Feature......Page 166
 What to Test in an RSpec System Test......Page 172
 Outside-in Testing......Page 173
 Making the Capybara Test Pass......Page 175
 Retrospective......Page 183
 Setting Up Cucumber......Page 184
 Writing Cucumber Features......Page 185
 Writing Cucumber Steps......Page 187
 Advanced Cucumber......Page 189
 Is Cucumber Worth It?......Page 191
 What You’ve Done......Page 192
 Integration-Testing JavaScript with Capybara......Page 193
 Let’s Talk About Drivers......Page 196
 Making the Test Pass......Page 198
 Webpack in Developer Mode......Page 201
 What You’ve Done......Page 202
10. Unit-Testing JavaScript......Page 203
 Setting Up JavaScript Unit Tests......Page 204
 Writing a Sample Test......Page 208
 TDD in JavaScript......Page 209
 Jasmine Matchers......Page 213
 Testing Ajax Calls......Page 214
 Using testdouble.js......Page 216
 Connecting the JavaScript to the Server Code......Page 225
 What You’ve Done......Page 227
11. Testing Rails Display Elements......Page 228
 Testing Routes......Page 229
 Testing Helper Methods......Page 230
 Testing Controllers and Requests......Page 233
 Simulating Requests......Page 235
 What to Expect in a Request Spec......Page 236
 Older Rails Controller Tests......Page 238
 Testing Mailers......Page 240
 Testing Views and View Markup......Page 244
 Using Presenters......Page 248
 Testing Jobs and Cables......Page 250
 What You’ve Done......Page 251
12. Minitest......Page 252
 Minitest Basics......Page 253
 Running Minitest......Page 256
 Minitest Setup......Page 258
 Mocha......Page 260
 System Tests and Others......Page 264
 Minitest Helper Tests......Page 268
 Minitest and Routing......Page 270
 What You’ve Done......Page 271
 User Authentication and Authorization......Page 272
 Adding Users and Roles......Page 275
 Restricting Access......Page 279
 More Access-Control Testing......Page 283
 Using Roles......Page 285
 Protection Against Form Modification......Page 291
 Mass Assignment Testing......Page 293
 What You’ve Done......Page 295
 External Testing Strategy......Page 296
 The Service Integration Test......Page 298
 Introducing VCR......Page 300
 Client Unit Tests......Page 304
 Why an Adapter?......Page 306
 Adapter Tests......Page 307
 Testing for Error Cases......Page 309
 Smoke Tests and VCR Options......Page 310
 What You’ve Done......Page 312
 General Principles......Page 314
 The Humble Print Statement......Page 315
 Git Bisect......Page 320
 RSpec or Minitest Bisect......Page 321
 Pry......Page 322
 What You’ve Done......Page 328
 Running Smaller Groups of Tests......Page 329
 Running Rails in the Background......Page 333
 Running Tests Automatically with Guard......Page 337
 Writing Faster Tests by Bypassing Rails......Page 341
 Recommendations for Faster Tests......Page 352
 What You’ve Done......Page 353
 What’s a Legacy?......Page 354
 Set Expectations......Page 355
 Getting Started with Legacy Code......Page 356
 Test-Driven Exploration......Page 358
 Dependency Removal......Page 361
 Find the Seam......Page 365
 Don’t Look Back......Page 368
 What You’ve Done......Page 369
Bibliography......Page 370
 – A –......Page 371
 – B –......Page 372
 – C –......Page 373
 – D –......Page 374
 – E –......Page 376
 – F –......Page 377
 – G –......Page 378
 – I –......Page 379
 – J –......Page 380
 – M –......Page 381
 – P –......Page 383
 – R –......Page 384
 – S –......Page 386
 – T –......Page 388
 – U –......Page 389
 – W –......Page 390
 – Y –......Page 391