class Platform

Constants

CURRENT

A platform-specific gem that is built for the packaging ruby's platform. This will be replaced with Gem::Platform::local.

DEPRECATED_CONSTS
RUBY

A pure-ruby gem that may use Gem::Specification#extensions to build binary files.

RbConfig

Attributes

cpu[RW]
os[RW]
version[RW]

Public Class Methods

const_missing(name) click to toggle source
# File lib/more/facets/platform.rb, line 35
def self.const_missing(name) # TODO remove six months from 2007/12
  if DEPRECATED_CONSTS.include? name then
    raise NameError, "#{name} has been removed, use CURRENT instead"
  else
    super
  end
end
local() click to toggle source
# File lib/more/facets/platform.rb, line 43
def self.local
  arch = RbConfig::CONFIG['arch']
  arch = "#{arch}_60" if arch =~ %rmswin32$/
  @local ||= new(arch)
end
match(platform) click to toggle source
# File lib/more/facets/platform.rb, line 49
def self.match(platform)
  supported.any? do |local_platform|
    platform.nil? or local_platform == platform or
      (local_platform != Platform::RUBY and local_platform =~ platform)
  end
end
new(arch) click to toggle source
# File lib/more/facets/platform.rb, line 67
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 !~ %r\d/ then # reassemble x86-linux-gnu
      extra = arch.pop
      arch.last << "-#{extra}"
    end

    cpu = arch.shift

    @cpu = case cpu
           when %ri\d86/ then 'x86'
           else cpu
           end

    if arch.length == 2 and arch.last =~ %r^\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 %raix(\d+)/ then             [ 'aix',       $1  ]
                    when %rcygwin/ then               [ 'cygwin',    nil ]
                    when %rdarwin(\d+)?/ then         [ 'darwin',    $1  ]
                    when %rfreebsd(\d+)/ then         [ 'freebsd',   $1  ]
                    when %rhpux(\d+)/ then            [ 'hpux',      $1  ]
                    when %r^java$/, %r^jruby$/ then    [ 'java',      nil ]
                    when %r^java([\d.]*)/ then        [ 'java',      $1  ]
                    when %rlinux/ then                [ 'linux',     $1  ]
                    when %rmingw32/ then              [ 'mingw32',   nil ]
                    when %r(mswin\d+)(\_(\d+))?/ then
                      os, version = $1, $3
                      @cpu = 'x86' if @cpu.nil? and os =~ %r32$/
                      [os, version]
                    when %rnetbsdelf/ then            [ 'netbsdelf', nil ]
                    when %ropenbsd(\d+\.\d+)/ then    [ 'openbsd',   $1  ]
                    when %rsolaris(\d+\.\d+)/ then    [ 'solaris',   $1  ]
                    # test
                    when %r^(\w+_platform)(\d+)/ then [ $1,          $2  ]
                    else                             [ 'unknown',   nil ]
                    end
  when Platform then
    @cpu = arch.cpu
    @os = arch.os
    @version = arch.version
  else
    raise ArgumentError, "invalid argument #{arch.inspect}"
  end
end
supported() click to toggle source

Array of supported platforms (ie. pure-Ruby and local platform).

# File lib/more/facets/platform.rb, line 31
def self.supported
  @suported ||= [Platform::RUBY, Platform.local]
end

Public Instance Methods

==(other) click to toggle source
# File lib/more/facets/platform.rb, line 136
def ==(other)
  self.class === other and
    @cpu == other.cpu and @os == other.os and @version == other.version
end
===(other) click to toggle source
# File lib/more/facets/platform.rb, line 141
def ===(other)
  return nil unless Platform === other

  # cpu
  (@cpu == 'universal' or other.cpu == 'universal' or @cpu == other.cpu) and

  # os
  @os == other.os and

  # version
  (@version.nil? or other.version.nil? or @version == other.version)
end
=~(other) click to toggle source
# File lib/more/facets/platform.rb, line 154
def =~(other)
  case other
  when Platform then # nop
  when String then
    # This data is from http://gems.rubyforge.org/gems/yaml on 19 Aug 2007
    other = case other
            when %r^i686-darwin(\d)/ then     ['x86',       'darwin',  $1]
            when %r^i\d86-linux/ then         ['x86',       'linux',   nil]
            when 'java', 'jruby' then        [nil,         'java',    nil]
            when %rmswin32(\_(\d+))?/ then    ['x86',       'mswin32', $2]
            when 'powerpc-darwin' then       ['powerpc',   'darwin',  nil]
            when %rpowerpc-darwin(\d)/ then   ['powerpc',   'darwin',  $1]
            when %rsparc-solaris2.8/ then     ['sparc',     'solaris', '2.8']
            when %runiversal-darwin(\d)/ then ['universal', 'darwin',  $1]
            else                             other
            end

    other = Platform.new other
  else
    return nil
  end

  self === other
end
big_endian?() click to toggle source
# File lib/more/facets/platform.rb, line 200
def big_endian?
  ByteOrder.big_endian?
end
byte_order() click to toggle source

Determine byte order of underlying machine.

# File lib/more/facets/platform.rb, line 192
def byte_order
  ByteOrder.byte_order
end
inspect() click to toggle source
# File lib/more/facets/platform.rb, line 124
def inspect
  "#<%s:0x%x @cpu=%p, @os=%p, @version=%p>" % [self.class, object_id, *to_a]
end
little_endian?() click to toggle source
# File lib/more/facets/platform.rb, line 196
def little_endian?
  ByteOrder.little_endian?
end
to_a() click to toggle source
# File lib/more/facets/platform.rb, line 128
def to_a
  [@cpu, @os, @version]
end
to_s() click to toggle source
# File lib/more/facets/platform.rb, line 132
def to_s
  to_a.compact.join '-'
end