Class: Gem::Platform
- Inherits:
-
Object
- Object
- Gem::Platform
- Defined in:
- lib/rubygems/platform.rb
Overview
Available list of platforms for targeting Gem installations.
See ‘gem help platform` for information on platform matching.
Constant Summary collapse
- RUBY =
A pure-Ruby gem that may use Gem::Specification#extensions to build binary files.
'ruby'
- CURRENT =
A platform-specific gem that is built for the packaging Ruby’s platform. This will be replaced with Gem::Platform::local.
'current'
Instance Attribute Summary collapse
-
#cpu ⇒ Object
Returns the value of attribute cpu.
-
#os ⇒ Object
Returns the value of attribute os.
-
#version ⇒ Object
Returns the value of attribute version.
Class Method Summary collapse
- .installable?(spec) ⇒ Boolean
- .local ⇒ Object
- .match(platform) ⇒ Object
-
.new(arch) ⇒ Object
:nodoc:.
Instance Method Summary collapse
-
#==(other) ⇒ Object
(also: #eql?)
Is
other
equal to this platform? Two platforms are equal if they have the same CPU, OS and version. -
#===(other) ⇒ Object
Does
other
match this platform? Two platforms match if they have the same CPU, or either has a CPU of ‘universal’, they have the same OS, and they have the same version, or either has no version. -
#=~(other) ⇒ Object
Does
other
match this platform? Ifother
is a String it will be converted to a Gem::Platform first. -
#hash ⇒ Object
:nodoc:.
-
#initialize(arch) ⇒ Platform
constructor
A new instance of Platform.
- #inspect ⇒ Object
- #to_a ⇒ Object
- #to_s ⇒ Object
Constructor Details
#initialize(arch) ⇒ Platform
Returns a new instance of Platform.
51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 |
# File 'lib/rubygems/platform.rb', line 51 def initialize(arch) case arch when Array then @cpu, @os, @version = arch when String then arch = arch.split '-' if arch.length > 2 and arch.last !~ /\d/ then # reassemble x86-linux-gnu extra = arch.pop arch.last << "-#{extra}" end cpu = arch.shift @cpu = case cpu when /i\d86/ then 'x86' else cpu end if arch.length == 2 and arch.last =~ /^\d+(\.\d+)?$/ then # for command-line @os, @version = arch return end os, = arch @cpu, os = nil, cpu if os.nil? # legacy jruby @os, @version = case os when /aix(\d+)?/ then [ 'aix', $1 ] when /cygwin/ then [ 'cygwin', nil ] when /darwin(\d+)?/ then [ 'darwin', $1 ] when /^macruby$/ then [ 'macruby', nil ] when /freebsd(\d+)?/ then [ 'freebsd', $1 ] when /hpux(\d+)?/ then [ 'hpux', $1 ] when /^java$/, /^jruby$/ then [ 'java', nil ] when /^java([\d.]*)/ then [ 'java', $1 ] when /^dalvik(\d+)?$/ then [ 'dalvik', $1 ] when /^dotnet$/ then [ 'dotnet', nil ] when /^dotnet([\d.]*)/ then [ 'dotnet', $1 ] when /linux/ then [ 'linux', $1 ] when /mingw32/ then [ 'mingw32', nil ] when /(mswin\d+)(\_(\d+))?/ then os, version = $1, $3 @cpu = 'x86' if @cpu.nil? and os =~ /32$/ [os, version] when /netbsdelf/ then [ 'netbsdelf', nil ] when /openbsd(\d+\.\d+)?/ then [ 'openbsd', $1 ] when /solaris(\d+\.\d+)?/ then [ 'solaris', $1 ] # test when /^(\w+_platform)(\d+)?/ then [ $1, $2 ] else [ 'unknown', nil ] end when Gem::Platform then @cpu = arch.cpu @os = arch.os @version = arch.version else raise ArgumentError, "invalid argument #{arch.inspect}" end end |
Instance Attribute Details
#cpu ⇒ Object
Returns the value of attribute cpu.
12 13 14 |
# File 'lib/rubygems/platform.rb', line 12 def cpu @cpu end |
#os ⇒ Object
Returns the value of attribute os.
14 15 16 |
# File 'lib/rubygems/platform.rb', line 14 def os @os end |
#version ⇒ Object
Returns the value of attribute version.
16 17 18 |
# File 'lib/rubygems/platform.rb', line 16 def version @version end |
Class Method Details
.installable?(spec) ⇒ Boolean
32 33 34 35 36 37 38 |
# File 'lib/rubygems/platform.rb', line 32 def self.installable?(spec) if spec.respond_to? :installable_platform? spec.installable_platform? else match spec.platform end end |
.local ⇒ Object
18 19 20 21 22 |
# File 'lib/rubygems/platform.rb', line 18 def self.local arch = RbConfig::CONFIG['arch'] arch = "#{arch}_60" if arch =~ /mswin(?:32|64)$/ @local ||= new(arch) end |
Instance Method Details
#==(other) ⇒ Object Also known as: eql?
Is other
equal to this platform? Two platforms are equal if they have the same CPU, OS and version.
128 129 130 |
# File 'lib/rubygems/platform.rb', line 128 def ==(other) self.class === other and to_a == other.to_a end |
#===(other) ⇒ Object
Does other
match this platform? Two platforms match if they have the same CPU, or either has a CPU of ‘universal’, they have the same OS, and they have the same version, or either has no version.
Additionally, the platform will match if the local CPU is ‘arm’ and the other CPU starts with “arm” (for generic ARM family support).
146 147 148 149 150 151 152 153 154 155 156 157 158 |
# File 'lib/rubygems/platform.rb', line 146 def ===(other) return nil unless Gem::Platform === other # cpu (@cpu == 'universal' or other.cpu == 'universal' or @cpu == other.cpu or (@cpu == 'arm' and other.cpu =~ /\Aarm/)) and # os @os == other.os and # version (@version.nil? or other.version.nil? or @version == other.version) end |
#=~(other) ⇒ Object
Does other
match this platform? If other
is a String it will be converted to a Gem::Platform first. See #=== for matching rules.
164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 |
# File 'lib/rubygems/platform.rb', line 164 def =~(other) case other when Gem::Platform then # nop when String then # This data is from http://gems.rubyforge.org/gems/yaml on 19 Aug 2007 other = case other when /^i686-darwin(\d)/ then ['x86', 'darwin', $1 ] when /^i\d86-linux/ then ['x86', 'linux', nil ] when 'java', 'jruby' then [nil, 'java', nil ] when /^dalvik(\d+)?$/ then [nil, 'dalvik', $1 ] when /dotnet(\-(\d+\.\d+))?/ then ['universal','dotnet', $2 ] when /mswin32(\_(\d+))?/ then ['x86', 'mswin32', $2 ] when /mswin64(\_(\d+))?/ then ['x64', 'mswin64', $2 ] when 'powerpc-darwin' then ['powerpc', 'darwin', nil ] when /powerpc-darwin(\d)/ then ['powerpc', 'darwin', $1 ] when /sparc-solaris2.8/ then ['sparc', 'solaris', '2.8' ] when /universal-darwin(\d)/ then ['universal', 'darwin', $1 ] else other end other = Gem::Platform.new other else return nil end self === other end |
#hash ⇒ Object
:nodoc:
134 135 136 |
# File 'lib/rubygems/platform.rb', line 134 def hash # :nodoc: to_a.hash end |
#inspect ⇒ Object
112 113 114 |
# File 'lib/rubygems/platform.rb', line 112 def inspect "#<%s:0x%x @cpu=%p, @os=%p, @version=%p>" % [self.class, object_id, *to_a] end |
#to_a ⇒ Object
116 117 118 |
# File 'lib/rubygems/platform.rb', line 116 def to_a [@cpu, @os, @version] end |
#to_s ⇒ Object
120 121 122 |
# File 'lib/rubygems/platform.rb', line 120 def to_s to_a.compact.join '-' end |