Module: Railstest

Defined in:
lib/railstest.rb,
lib/railstest/cli.rb,
lib/railstest/version.rb,
lib/railstest/test_runner.rb,
lib/railstest/docker_manager.rb,
lib/railstest/database_manager.rb,
lib/railstest/supported_versions.rb

Defined Under Namespace

Classes: CLI, DatabaseManager, DockerManager, Error, TestRunner

Constant Summary collapse

VERSION = 
'0.3.1'
SUPPORTED_VERSIONS = 
{
  ruby: {
    minimum: '3.2',
    recommended: '4.0', # Latest stable
    supported: ['3.2', '3.3', '3.4', '4.0'],
    experimental: ['2.5', '2.6', '2.7', '3.0', '3.1'] # EOL
  },
  rails: {
    minimum: '7.0',
    recommended: '8.1', # Latest stable
    supported: ['7.2', '8.0', '8.1'],
    experimental: ['6.0', '6.1', '7.0', '7.1'] # EOL
  },
  # Ruby version => Working Rails versions
  # Verified combinations from self-testing + known requirements from Rails
  #
  # Ruby < 3.2 is intentionally absent: every Rails version we target depends
  # on zeitwerk, and zeitwerk >= 2.7.0 requires Ruby >= 3.2. A fresh
  # `gem install rails` resolves to the latest zeitwerk, so it can no longer
  # be installed on Ruby < 3.2 regardless of the Rails version requested.
  compatibility: {
    '4.0' => ['7.1', '7.2', '8.0', '8.1'],  # Rails 8.x requires Ruby >= 3.2
    '3.4' => ['7.1', '7.2', '8.0', '8.1'],  # Rails 8.x requires Ruby >= 3.2
    '3.3' => ['7.0', '7.1', '7.2', '8.0', '8.1'],  # Rails 8.x requires Ruby >= 3.2, verified 7.x-8.0
    '3.2' => ['7.0', '7.1', '7.2', '8.0', '8.1'],  # Rails 8.x requires Ruby >= 3.2, verified 7.x-8.0
    # zeitwerk >= 2.7.0 requires Ruby >= 3.2, so these can no longer
    # fresh-install any zeitwerk-based Rails (6.0+).
    '3.1' => [],
    '3.0' => [],
    '2.7' => [],
    '2.6' => [],
    '2.5' => []
  },
  notes: {
    '2.5' => 'Unsupported: Rails depends on zeitwerk, which requires Ruby >= 3.2',
    '2.6' => 'Unsupported: Rails depends on zeitwerk, which requires Ruby >= 3.2',
    '2.7' => 'Unsupported: Rails depends on zeitwerk, which requires Ruby >= 3.2',
    '3.0' => 'Unsupported: Rails depends on zeitwerk, which requires Ruby >= 3.2',
    '3.1' => 'Unsupported: Rails depends on zeitwerk, which requires Ruby >= 3.2',
    '8.0' => 'Requires Ruby 3.2+',
    '8.1' => 'Requires Ruby 3.2+'
  }
}.freeze

Class Method Summary collapse

Class Method Details

.compatible?(ruby_version, rails_version) ⇒ Boolean

Returns:

  • (Boolean) 


48
49
50
51
52
53
54
55
56
 
# File 'lib/railstest/supported_versions.rb', line 48

def self.compatible?(ruby_version, rails_version)
  ruby_major_minor = normalize_version(ruby_version)
  rails_major_minor = normalize_version(rails_version)

  compat = SUPPORTED_VERSIONS[:compatibility][ruby_major_minor]
  return nil unless compat # Unknown Ruby version

  compat.include?(rails_major_minor)
end

.normalize_version(version) ⇒ Object 



68
69
70
71
72
73
 
# File 'lib/railstest/supported_versions.rb', line 68

def self.normalize_version(version)
  # Convert "3.3.0" or "3.3" to "3.3"
  version.to_s.match(/^(\d+\.\d+)/)[1]
rescue NoMethodError
  version.to_s
end

.note_for(version) ⇒ Object 



63
64
65
66
 
# File 'lib/railstest/supported_versions.rb', line 63

def self.note_for(version)
  major_minor = normalize_version(version)
  SUPPORTED_VERSIONS[:notes][major_minor]
end

.recommended_rails_versions(ruby_version) ⇒ Object 



58
59
60
61
 
# File 'lib/railstest/supported_versions.rb', line 58

def self.recommended_rails_versions(ruby_version)
  ruby_major_minor = normalize_version(ruby_version)
  SUPPORTED_VERSIONS[:compatibility][ruby_major_minor] || []
end