rspec/rspec-rails

Features

• Behavioral Specifications - Implements a conversational BDD structure of examples and contexts to define application behavior.
• Behavior Driven Development - Provides a framework for defining application behavior using a descriptive and conversational specification syntax.
• CLI Execution - Provides a dedicated command-line executable to run the complete suite of behavioral specifications.
• Method Stubbing - Implements method stubbing to define pre-determined return values or behaviors for objects during testing.
• Dynamic Response Configurations - Allows defining return values using logic blocks to calculate results dynamically based on input.
• Shared Test Contexts - Provides reusable blocks of setup and configuration shared across multiple test examples via metadata tags.
• Dependency-Mocked Unit Testers - Isolates units of logic by replacing real system components with mocks, stubs, or spies.
• Test Grouping Utilities - Organizes tests into nested groups to manage shared setup, teardown, and configuration inheritance.
• Mocking and Spying Libraries - Ships a comprehensive suite for creating test doubles, mocks, and spies to isolate dependencies.
• Request Cycle Testing - Validates the full request-response pipeline, including routing and middleware, by simulating HTTP requests.
• Ruby on Rails Testing Frameworks - Integrates behavioral specifications with the Ruby on Rails framework to verify various application layers.
• Shared Example Groups - Defines reusable sets of specifications and contexts that can be mixed into multiple test groups.
• End-to-End Testing - Simulates complete user workflows across the entire application stack and browser to verify functional correctness.
• Test Double Libraries - Provides a suite of test doubles, including mocks, stubs, and spies, to simulate external components.
• Database Result Assertions - Provides assertions to verify that a database query returns the exact set of expected records.
• Test Specification Templates - Creates boilerplate specification files by applying predefined templates to component names via a CLI.
• Rails Component Generators - Automatically generates boilerplate specification files tailored to Rails models, controllers, and background jobs.
• Test Execution Configurations - Manages test runner behavior through a command-line interface or a persistent configuration file.
• Model Logic Testing - Includes frameworks and macros to verify the behavioral logic and data integrity of database-backed models.
• Browser Interaction Testing - Simulates user browser interactions to verify high-level application functionality from an external perspective.
• Controller Logic Testing - Simulates HTTP requests to controllers to verify rendered templates, redirects, and instance variables.
• Test Metadata - Stores descriptive tags and location data for test groups to facilitate selective execution and reporting.
• HTTP Response Assertions - Ships matchers to validate that HTTP responses return specific numeric status codes or categories.
• Call Argument Matchers - Validates that methods are invoked with specific values using built-in or custom matching criteria.
• Object Instrumentation - Adds mock behavior to existing real objects to intercept calls and return test data.
• Rails Component Specifications - Provides specialized test configurations and helper modules tailored for Rails models, controllers, mailers, jobs, and views.
• Class-Wide Stubbing - Applies stubs or expectations to every instance of a specific class for consistent behavior across tests.
• Collection Membership Assertions - Includes assertions to verify that a collection contains specific items or matches another array exactly.
• Exception Assertions - Verifies that a block of code raises a specific exception class or error message.
• Mock Expectation Verifiers - Requires specific methods to be called before a test ends to ensure expected interactions occur.
• Application Stack Flow Testing - Drives behavior through the entire application stack across multiple requests and sessions.
• View Template Rendering Tests - Provides tools to verify that view templates render the correct content by simulating controller and path contexts.
• Component-Specific Test Helpers - Loads specialized support functions and helper modules based on the type of Rails component being tested.
• State Assertions - Compares objects for identity, equivalence, or type membership to ensure they match expected values.
• Template Rendering Assertions - Verifies that a specific request results in the rendering of the intended view template or layout.
• Test Boilerplate Generators - Automatically creates skeleton specification files for Rails components such as models and controllers.
• Test Execution Filtering - Allows selective execution of test subsets based on descriptive tags and properties.
• Interaction Spies - Records calls to an object and verifies they occurred after the fact using interaction spies.
• Nested Setup Nodes - Provides hierarchical initialization structures through nested blocks to refine the test environment in a BDD tree.
• Ruby Frameworks and Tools - RSpec testing framework for Rails.
• Testing - Testing framework for Rails.
• More to explore - Provides a testing framework.

Star history