Class: Platform

Class | Platform
In: | lib/more/facets/platform.rb
Parent: | Object

### Methods

== === =~ big_endian? byte_order const_missing inspect little_endian? local match new supported to_a to_s

### Classes and Modules

Module Platform::ByteOrder

### Constants

RbConfig | = | Config unless defined? ::RbConfig
DEPRECATED_CONSTS | = | [ :DARWIN, :LINUX_586, :MSWIN32, :PPC_DARWIN, :WIN32, :X86_LINUX
RUBY | = | 'ruby' |  | A pure-ruby gem that may use Gem::Specification#extensions to build binary files.
CURRENT | = | 'current' |  | A platform-specific gem that is built for the packaging ruby‘s platform. This will be replaced with Gem::Platform::local.

### Attributes

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

### Public Class methods

const_missing(name)

[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()

[Source]

    # File lib/more/facets/platform.rb, line 43
      def self.local
        arch = RbConfig::CONFIG['arch']
        arch = "#{arch}_60" if arch =~ /mswin32$/
        @local ||= new(arch)
      end

match(platform)

[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)

[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 !~ /\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+$/ 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 /freebsd(\d+)/ then         [ 'freebsd',   $1  ]
                          when /hpux(\d+)/ then            [ 'hpux',      $1  ]
                          when /^java$/, /^jruby$/ then    [ 'java',      nil ]
                          when /^java([\d.]*)/ then        [ 'java',      $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 Platform then
          @cpu = arch.cpu
          @os = arch.os
          @version = arch.version
        else
          raise ArgumentError, "invalid argument #{arch.inspect}"
        end
      end

supported()

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

[Source]

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

### Public Instance methods

==(other)

[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)

[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)

[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 /^i686-darwin(\d)/ then     ['x86',       'darwin',  $1]
                  when /^i\d86-linux/ then         ['x86',       'linux',   nil]
                  when 'java', 'jruby' then        [nil,         'java',    nil]
                  when /mswin32(\_(\d+))?/ then    ['x86',       'mswin32', $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 = Platform.new other
        else
          return nil
        end

        self === other
      end

big_endian?()

[Source]

    # File lib/more/facets/platform.rb, line 200
      def big_endian?
        ByteOrder.big_endian?
      end

byte_order()

Determine byte order of underlying machine.

[Source]

    # File lib/more/facets/platform.rb, line 192
      def byte_order
        ByteOrder.byte_order
      end

inspect()

[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?()

[Source]

    # File lib/more/facets/platform.rb, line 196
      def little_endian?
        ByteOrder.little_endian?
      end

to_a()

[Source]

    # File lib/more/facets/platform.rb, line 128
      def to_a
        [@cpu, @os, @version]
      end

to_s()

[Source]

    # File lib/more/facets/platform.rb, line 132
      def to_s
        to_a.compact.join '-'
      end

[Validate]