class Bundler::RubyVersion
Constants
- PATTERN
@private
Attributes
engine[R]
engine_gem_version[R]
engine_versions[R]
gem_version[R]
patchlevel[R]
versions[R]
Public Class Methods
from_string(string)
click to toggle source
Returns a RubyVersion
from the given string. @param [String] the version string to match. @return [RubyVersion,Nil] The version if the string is a valid RubyVersion
description, and nil otherwise.
# File bundler/ruby_version.rb, line 58 def self.from_string(string) new($1, $2, $3, $4) if string =~ PATTERN end
new(versions, patchlevel, engine, engine_version)
click to toggle source
# File bundler/ruby_version.rb, line 12 def initialize(versions, patchlevel, engine, engine_version) # The parameters to this method must satisfy the # following constraints, which are verified in # the DSL: # # * If an engine is specified, an engine version # must also be specified # * If an engine version is specified, an engine # must also be specified # * If the engine is "ruby", the engine version # must not be specified, or the engine version # specified must match the version. @versions = Array(versions).map do |v| op, v = Gem::Requirement.parse(normalize_version(v)) op == "=" ? v.to_s : "#{op} #{v}" end @gem_version = Gem::Requirement.create(@versions.first).requirements.first.last @input_engine = engine&.to_s @engine = engine&.to_s || "ruby" @engine_versions = (engine_version && Array(engine_version)) || @versions @engine_gem_version = Gem::Requirement.create(@engine_versions.first).requirements.first.last @patchlevel = patchlevel || (@gem_version.prerelease? ? "-1" : nil) end
system()
click to toggle source
# File bundler/ruby_version.rb, line 104 def self.system ruby_engine = RUBY_ENGINE.dup ruby_version = Gem.ruby_version.to_s ruby_engine_version = RUBY_ENGINE == "ruby" ? ruby_version : RUBY_ENGINE_VERSION.dup patchlevel = RUBY_PATCHLEVEL.to_s @system ||= RubyVersion.new(ruby_version, patchlevel, ruby_engine, ruby_engine_version) end
Public Instance Methods
==(other)
click to toggle source
# File bundler/ruby_version.rb, line 66 def ==(other) versions == other.versions && engine == other.engine && engine_versions == other.engine_versions && patchlevel == other.patchlevel end
diff(other)
click to toggle source
Returns a tuple of these things:
[diff, this, other] The priority of attributes are 1. engine 2. ruby_version 3. engine_version
# File bundler/ruby_version.rb, line 87 def diff(other) raise ArgumentError, "Can only diff with a RubyVersion, not a #{other.class}" unless other.is_a?(RubyVersion) if engine != other.engine && @input_engine [:engine, engine, other.engine] elsif versions.empty? || !matches?(versions, other.gem_version) [:version, versions_string(versions), versions_string(other.versions)] elsif @input_engine && !matches?(engine_versions, other.engine_gem_version) [:engine_version, versions_string(engine_versions), versions_string(other.engine_versions)] elsif patchlevel && (!patchlevel.is_a?(String) || !other.patchlevel.is_a?(String) || !matches?(patchlevel, other.patchlevel)) [:patchlevel, patchlevel, other.patchlevel] end end
host()
click to toggle source
# File bundler/ruby_version.rb, line 73 def host @host ||= [ RbConfig::CONFIG["host_cpu"], RbConfig::CONFIG["host_vendor"], RbConfig::CONFIG["host_os"], ].join("-") end
single_version_string()
click to toggle source
# File bundler/ruby_version.rb, line 62 def single_version_string to_s(gem_version) end
to_s(versions = self.versions)
click to toggle source
# File bundler/ruby_version.rb, line 38 def to_s(versions = self.versions) output = String.new("ruby #{versions_string(versions)}") output << "p#{patchlevel}" if patchlevel && patchlevel != "-1" output << " (#{engine} #{versions_string(engine_versions)})" unless engine == "ruby" output end
versions_string(versions)
click to toggle source
# File bundler/ruby_version.rb, line 100 def versions_string(versions) Array(versions).join(", ") end
Private Instance Methods
matches?(requirements, version)
click to toggle source
# File bundler/ruby_version.rb, line 122 def matches?(requirements, version) # Handles RUBY_PATCHLEVEL of -1 for instances like ruby-head return requirements == version if requirements.to_s == "-1" || version.to_s == "-1" Array(requirements).all? do |requirement| Gem::Requirement.create(requirement).satisfied_by?(Gem::Version.create(version)) end end
normalize_version(version)
click to toggle source
Ruby’s official preview version format uses a ‘-`: Example: 3.3.0-preview2 However, RubyGems recognizes preview version format with a `.`: Example: 3.3.0.preview2 Returns version string after replacing `-` with `.`
# File bundler/ruby_version.rb, line 118 def normalize_version(version) version.tr("-", ".") end