Rails Testing

What it does

This skill provides a comprehensive guide to Ruby on Rails testing best practices, maintained by Community. It offers 46 rules across eight categories, prioritized by impact, to assist with automated test generation, code review, and refactoring. The goal is to improve the quality and efficiency of Rails test suites.

When to use it

• When writing new RSpec tests for models, requests, system tests, or jobs.
• During setup of FactoryBot factories using traits and sequences.
• While writing Capybara system tests to cover user journeys.
• When reviewing existing test code for potential anti-patterns like flaky tests or slow specs.

Key capabilities

• Provides a prioritized list of 46 testing rules across eight categories (Test Design & Structure, Test Data Management, Model Testing, Request & Controller Testing, System & Acceptance Testing, Async & Background Job Testing, Test Performance & Reliability, and Test Organization & Maintenance).
• Offers specific guidelines for test design, such as using a four-phase test structure and focusing on observable behavior.
• Includes references to detailed documentation for each rule (e.g., design-four-phase-test).

Example prompts

• "Show me the rules related to Test Design & Structure."
• "What are the best practices for testing background jobs in Rails?"
• "How should I structure a test using FactoryBot?"

Tips & gotchas

• The skill focuses on RSpec and Capybara, common tools within the Ruby on Rails ecosystem.
• Prioritize rules based on their impact level (CRITICAL, HIGH, MEDIUM-HIGH, MEDIUM, LOW-MEDIUM) to focus your efforts effectively.
• Refer to the detailed documentation linked for each rule to understand implementation details.