Back to Repositories

Testing AdapterRegistry Name Resolution Implementation in Faraday

This test suite validates the AdapterRegistry class in Faraday, focusing on its initialization and name resolution capabilities. The tests ensure proper handling of class lookups using both strings and symbols, along with verification of the caching mechanism.

Test Coverage Overview

The test suite provides comprehensive coverage of the AdapterRegistry initialization and lookup functionality.

Key areas tested include:

Error handling for invalid class names
String-based class resolution
Symbol-based class resolution
Caching behavior for both implicit and explicit name mappings

Implementation Analysis

The testing approach utilizes RSpec’s describe and context blocks to organize related test cases. The implementation leverages subject blocks for clean test setup and expectation matching for precise assertions.

Notable patterns include:

Error expectation testing using raise_error matcher
Class resolution verification using eq matcher
Registry manipulation through set/get operations

Technical Details

Testing tools and configuration:

RSpec testing framework
Frozen string literal pragma
Subject-based test organization
Implicit and explicit class name resolution
Error handling validation

Best Practices Demonstrated

The test suite exemplifies several testing best practices in Ruby and RSpec.

Notable practices include:

Clear test case isolation
Consistent error handling validation
Efficient test setup using subject blocks
Comprehensive edge case coverage
Clean and maintainable test organization

lostisland/faraday

spec/faraday/adapter_registry_spec.rb

            
# frozen_string_literal: true

RSpec.describe Faraday::AdapterRegistry do
  describe '#initialize' do
    subject(:registry) { described_class.new }

    it { expect { registry.get(:FinFangFoom) }.to raise_error(NameError) }
    it { expect { registry.get('FinFangFoom') }.to raise_error(NameError) }

    it 'looks up class by string name' do
      expect(registry.get('Faraday::Connection')).to eq(Faraday::Connection)
    end

    it 'looks up class by symbol name' do
      expect(registry.get(:Faraday)).to eq(Faraday)
    end

    it 'caches lookups with implicit name' do
      registry.set :symbol
      expect(registry.get('symbol')).to eq(:symbol)
    end

    it 'caches lookups with explicit name' do
      registry.set 'string', :name
      expect(registry.get(:name)).to eq('string')
    end
  end
end