Back to Repositories

Testing DateTime Format Conversion in rails_admin

This test suite validates the datetime format conversion functionality in the RailsAdmin support module, specifically focusing on converting strftime formats to Flatpickr compatible formats. The tests ensure accurate date-time string formatting across different localization patterns and edge cases.

Test Coverage Overview

The test suite provides comprehensive coverage of the datetime format conversion functionality:

Tests multiple date-time format patterns including standard, localized, and custom formats
Verifies correct handling of special characters and escape sequences
Validates error handling for unsupported directives
Covers international date formats with various separators and localizations

Implementation Analysis

The testing approach utilizes RSpec’s describe/it blocks with a hash-based test structure to efficiently test multiple format combinations. The implementation leverages RSpec’s expectation syntax for assertions and employs proper error handling validation patterns.

The tests demonstrate thorough validation of the to_flatpickr_format method’s ability to handle various datetime format strings.

Technical Details

Testing Framework: RSpec
Test Environment: Ruby
Key Components: RailsAdmin::Support::Datetime module
Testing Pattern: Hash-based test cases
Error Handling: Exception testing

Best Practices Demonstrated

The test suite exemplifies several testing best practices:

DRY principle through iterative test cases
Clear test case organization and naming
Comprehensive edge case coverage
Proper error scenario testing
Consistent formatting and structure

railsadminteam/rails_admin

spec/rails_admin/support/datetime_spec.rb

            
# frozen_string_literal: true

require 'spec_helper'

RSpec.describe RailsAdmin::Support::Datetime do
  describe '#to_flatpickr_format' do
    {
      '%D de %M de %Y, %H:%M:%S' => 'm/d/y \d\e i \d\e Y, H:i:S',
      '%d/%-m/%Y, %H:%M:%S' => 'd/n/Y, H:i:S',
      '%d de %B de %Y' => 'd \d\e F \d\e Y',
      '%-d %B %Y' => 'j F Y',
      '%F %T' => 'Y-m-d H:i:S',
      '%Y-%m-%dT%H:%M:%S%:z' => 'Y-m-d\TH:i:S+00:00',
      '%HH%MM%SS' => 'H\Hi\MS\S',
      'a%-Ha%-Ma%-Sa%:za' => '\aH\ai\as\a+00:00\a',
      '%B %-d at %-l:%M %p' => 'F j \a\t h:i K',
    }.each do |strftime_format, flatpickr_format|
      it "convert strftime_format to flatpickr_format - example #{strftime_format}" do
        expect(RailsAdmin::Support::Datetime.to_flatpickr_format(strftime_format)).to eq flatpickr_format
      end
    end

    it 'raises an error with unsupported directive' do
      expect do
        RailsAdmin::Support::Datetime.to_flatpickr_format('%C')
      end.to raise_error(/Unsupported/)
    end
  end
end