Open-Source Testing · splitwise

super_diff

SuperDiff is a Ruby gem that improves how RSpec displays differences between complex data structures during testing. Instead of showing hard-to-read string diffs, it formats output to clearly highlight what changed in hashes, arrays, objects, and other data types.

Talk to DEV.co Discuss Implementation

Source: GitHub — github.com/splitwise/super_diff

GitHub stars

Forks

Ruby

Primary language

MIT

License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

Field	Value
Repository	splitwise/super_diff
Owner	splitwise
Primary language	Ruby
License	MIT — OSI-approved
Stars	1k
Forks	64
Open issues	45
Latest release	v0.19.0 (2026-05-01)
Last updated	2026-06-23
Source	https://github.com/splitwise/super_diff

What super_diff is

SuperDiff replaces RSpec's default PrettyPrinter-based diffing with a specialized diff engine for structured data. It inspects both expected and actual values, builds an inspection tree, and renders human-readable diffs that preserve semantic context for nested objects, arrays, and custom classes.

Quickstart

Get the super_diff source

Clone the repository and explore it locally.

terminalbash

1git clone https://github.com/splitwise/super_diff.git2cd super_diff3# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

API Response Validation

Compare actual JSON/hash responses from APIs against expected payloads. SuperDiff clearly shows which fields differ in value, structure, or presence, making it faster to debug integration test failures.

Database Record Assertions

Validate database query results by comparing full record objects or collections. Nested associations and attribute mismatches become immediately visible rather than buried in wall-of-text diffs.

Complex Object State Testing

Test state transitions in domain models where multiple nested attributes or custom object types change. SuperDiff's inspector-based rendering handles custom classes gracefully without requiring manual string conversion.

Implementation considerations

Add to Gemfile under test group; requires RSpec 3.x and Ruby >= 3.1. No additional configuration needed for basic usage.
Optional: require 'super_diff/binary_string' if hex-dump diffs for binary data are needed.
SuperDiff hooks into RSpec matchers (eq, match, include, have_attributes); no explicit calls required in existing tests.
Custom objects must have sensible #inspect or custom inspection logic; SuperDiff will call these to build diffs.
Check CI/CD pipelines for Ruby version compatibility (>= 3.1) and ensure RSpec version is 3.x or newer.

When to avoid it — and what to weigh

Non-Ruby Codebases — SuperDiff is Ruby-only and tightly integrated with RSpec. Projects not using Ruby or relying on other test frameworks will not benefit.
Simple String or Numeric Diffs — For comparing plain text or single values, RSpec's built-in diff is sufficient. SuperDiff's value is primarily for complex nested structures.
Performance-Critical Test Suites — SuperDiff performs inspection tree construction and rendering on failure. High-volume test runs with many failures may experience overhead; requires benchmarking for your use case.
Binary Data Comparison — While binary string support exists as an optional extension, SuperDiff is optimized for readable structured data. Direct binary file or blob comparison is not a primary use case.

License & commercial use

SuperDiff is released under the MIT License. MIT is a permissive OSI-approved license allowing commercial and proprietary use, modification, and distribution with minimal restrictions.

MIT license explicitly permits commercial use. You may use SuperDiff in proprietary applications, modify the source, and distribute derivatives as long as license and copyright notices are retained. No patent guarantees or liability disclaimers apply; review MIT license terms for full legal detail.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

Signal	Assessment
Maintenance	Active
Documentation	Strong
License clarity	Clear
Deployment complexity	Low
DEV.co fit	Good
Assessment confidence	High

Security considerations

SuperDiff is a development/test-time gem, not a runtime dependency in production. No network calls, external services, or credential handling. Review custom #inspect implementations in your domain models—SuperDiff calls them to build diffs and may expose sensitive data in test output (logs, CI). Exclude secrets from objects under test.

Alternatives to consider

RSpec built-in diff (no gem)

Use if you only compare strings or simple values. Sufficient for basic eq/match matchers but produces unreadable diffs for nested hashes and custom objects.

AwesomePrint + manual inspection

Pretty-prints values but does not generate diffs. Useful for debugging but requires manual comparison and does not integrate with RSpec matchers.

Equivalent Matcher (rspec-puppet) or custom matchers

Domain-specific matchers may provide better error messages for particular types (e.g., Puppet resources). Consider if you have specialized assertion needs beyond general structure comparison.

Software development agency

Build on super_diff with DEV.co software developers

SuperDiff makes debugging test failures faster by showing clear, readable diffs of complex data structures. Add it to your test suite in minutes.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

rubocop-rspec test-prof shellspec

Related on DEV.co

Explore the category and the services that help you build with it.

Open-Source Testing Application Development API Development Talk to DEV.co

super_diff FAQ

Does SuperDiff work with minitest or other test frameworks?

No, SuperDiff is RSpec-specific. It integrates by hooking into RSpec matchers. Other test frameworks would require alternative diff libraries or custom implementations.

Will SuperDiff slow down my test suite?

SuperDiff only runs on test failure when building the diff output. Passing tests are unaffected. If you have many failures, diff rendering may add latency; benchmark in your CI for impact.

Can I customize how SuperDiff displays certain object types?

SuperDiff respects custom #inspect methods on your objects. For full control, refer to user documentation on custom inspectors; implementation details are not covered in the README excerpt.

Is SuperDiff production-safe as a dependency?

Yes if included in test-only Gemfile group (e.g., :test, :development). It is not a runtime library and should never ship in production. Verify with 'bundle list' in production environment.

Custom software development services

Adopting super_diff is usually one piece of a larger software development effort. As a software development agency, DEV.co provides software development services and web development expertise — pairing senior software developers and web developers with your team to design, build, and operate open-source testing software in production.

Ready to improve your RSpec test output?

SuperDiff makes debugging test failures faster by showing clear, readable diffs of complex data structures. Add it to your test suite in minutes.

Talk to DEV.co Schedule a Consultation