vagrant-shell 0.2.9 → 0.2.11

data/demo/templates/vendor/bundle/ruby/1.9.1/gems/ffi-1.8.1/lib/ffi/struct.rb

@@ -1,356 +0,0 @@
-#
-# Copyright (C) 2008-2010 Wayne Meissner
-# Copyright (C) 2008, 2009 Andrea Fazzi
-# Copyright (C) 2008, 2009 Luc Heinrich
-#
-# All rights reserved.
-#
-# This file is part of ruby-ffi.
-#
-# This code is free software: you can redistribute it and/or modify it under
-# the terms of the GNU Lesser General Public License version 3 only, as
-# published by the Free Software Foundation.
-#
-# This code is distributed in the hope that it will be useful, but WITHOUT
-# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License
-# version 3 for more details.
-#
-# You should have received a copy of the GNU Lesser General Public License
-# version 3 along with this work.  If not, see <http://www.gnu.org/licenses/>.
-#
-
-require 'ffi/platform'
-require 'ffi/struct_layout_builder'
-
-module FFI
-
-  class StructLayout
-
-    # @return [Array<Array(Symbol, Numeric)>
-    # Get an array of tuples (field name, offset of the field).
-    def offsets
-      members.map { |m| [ m, self[m].offset ] }
-    end
-
-    # @return [Numeric]
-    # Get the offset of a field.
-    def offset_of(field_name)
-      self[field_name].offset
-    end
-
-    # An enum {Field} in a {StructLayout}.
-    class Enum < Field
-
-      # @param [AbstractMemory] ptr pointer on a {Struct}
-      # @return [Object]
-      # Get an object of type {#type} from memory pointed by +ptr+.
-      def get(ptr)
-        type.find(ptr.get_int(offset))
-      end
-
-      # @param [AbstractMemory] ptr pointer on a {Struct}
-      # @param  value
-      # @return [nil]
-      # Set +value+ into memory pointed by +ptr+.
-      def put(ptr, value)
-        ptr.put_int(offset, type.find(value))
-      end
-
-    end
-
-    class InnerStruct < Field
-      def get(ptr)
-        type.struct_class.new(ptr.slice(self.offset, self.size))
-      end
-
-     def put(ptr, value)
-       raise TypeError, "wrong value type (expected #{type.struct_class}" unless value.is_a?(type.struct_class)
-       ptr.slice(self.offset, self.size).__copy_from__(value.pointer, self.size)
-     end
-    end
-
-    class Mapped < Field
-      def initialize(name, offset, type, orig_field)
-        super(name, offset, type)
-        @orig_field = orig_field
-      end
-
-      def get(ptr)
-        type.from_native(@orig_field.get(ptr), nil)
-      end
-
-      def put(ptr, value)
-        @orig_field.put(ptr, type.to_native(value, nil))
-      end
-    end
-  end
-
-  
-  class Struct
-
-    # Get struct size
-    # @return [Numeric]
-    def size
-      self.class.size
-    end
-
-    # @return [Fixnum] Struct alignment
-    def alignment
-      self.class.alignment
-    end
-    alias_method :align, :alignment
-
-    # (see FFI::StructLayout#offset_of)
-    def offset_of(name)
-      self.class.offset_of(name)
-    end
-
-    # (see FFI::StructLayout#members)
-    def members
-      self.class.members
-    end
-
-    # @return [Array]
-    # Get array of values from Struct fields.
-    def values
-      members.map { |m| self[m] }
-    end
-
-    # (see FFI::StructLayout#offsets)
-    def offsets
-      self.class.offsets
-    end
-
-    # Clear the struct content.
-    # @return [self]
-    def clear
-      pointer.clear
-      self
-    end
-
-    # Get {Pointer} to struct content.
-    # @return [AbstractMemory]
-    def to_ptr
-      pointer
-    end
-
-    # Get struct size
-    # @return [Numeric]
-    def self.size
-      defined?(@layout) ? @layout.size : defined?(@size) ? @size : 0
-    end
-
-    # set struct size
-    # @param [Numeric] size
-    # @return [size]
-    def self.size=(size)
-      raise ArgumentError, "Size already set" if defined?(@size) || defined?(@layout)
-      @size = size
-    end
-
-    # @return (see Struct#alignment)
-    def self.alignment
-      @layout.alignment
-    end
-
-    # (see FFI::Type#members)
-    def self.members
-      @layout.members
-    end
-
-    # (see FFI::StructLayout#offsets)
-    def self.offsets
-      @layout.offsets
-    end
-
-    # (see FFI::StructLayout#offset_of)
-    def self.offset_of(name)
-      @layout.offset_of(name)
-    end
-
-    def self.in
-      ptr(:in)
-    end
-
-    def self.out
-      ptr(:out)
-    end
-
-    def self.ptr(flags = :inout)
-      @ref_data_type ||= Type::Mapped.new(StructByReference.new(self))
-    end
-
-    def self.val
-      @val_data_type ||= StructByValue.new(self)
-    end
-
-    def self.by_value
-      self.val
-    end
-
-    def self.by_ref(flags = :inout)
-      self.ptr(flags)
-    end
-
-    class ManagedStructConverter < StructByReference
-
-      # @param [Struct] struct_class
-      def initialize(struct_class)
-        super(struct_class)
-
-        raise NoMethodError, "release() not implemented for class #{struct_class}" unless struct_class.respond_to? :release
-        @method = struct_class.method(:release)
-      end
-
-      # @param [Pointer] ptr
-      # @param [nil] ctx
-      # @return [Struct]
-      def from_native(ptr, ctx)
-        struct_class.new(AutoPointer.new(ptr, @method))
-      end
-    end
-
-    def self.auto_ptr
-      @managed_type ||= Type::Mapped.new(ManagedStructConverter.new(self))
-    end
-
-
-    class << self
-      public
-
-      # @return [StructLayout]
-      # @overload layout
-      #  @return [StructLayout]
-      #  Get struct layout.
-      # @overload layout(*spec)
-      #  @param [Array<Symbol, Integer>,Array(Hash)] spec
-      #  @return [StructLayout]
-      #  Create struct layout from +spec+.
-      #  @example Creating a layout from an array +spec+
-      #    class MyStruct < Struct
-      #      layout :field1, :int,
-      #             :field2, :pointer,
-      #             :field3, :string
-      #    end
-      #  @example Creating a layout from an array +spec+ with offset
-      #    class MyStructWithOffset < Struct
-      #      layout :field1, :int,
-      #             :field2, :pointer, 6,  # set offset to 6 for this field
-      #             :field3, :string
-      #    end
-      #  @example Creating a layout from a hash +spec+ (Ruby 1.9 only)
-      #    class MyStructFromHash < Struct
-      #      layout :field1 => :int,
-      #             :field2 => :pointer,
-      #             :field3 => :string
-      #    end
-      #  @note Creating a layout from a hash +spec+ is supported only for Ruby 1.9.
-      def layout(*spec)
-#        raise RuntimeError, "struct layout already defined for #{self.inspect}" if defined?(@layout)
-        return @layout if spec.size == 0
-
-        builder = StructLayoutBuilder.new
-        builder.union = self < Union
-        builder.packed = @packed if defined?(@packed)
-        builder.alignment = @min_alignment if defined?(@min_alignment)
-
-        if spec[0].kind_of?(Hash)
-          hash_layout(builder, spec)
-        else
-          array_layout(builder, spec)
-        end
-        builder.size = @size if defined?(@size) && @size > builder.size
-        cspec = builder.build
-        @layout = cspec unless self == Struct
-        @size = cspec.size
-        return cspec
-      end
-
-
-      protected
-
-      def callback(params, ret)
-        mod = enclosing_module
-        FFI::CallbackInfo.new(find_type(ret, mod), params.map { |e| find_type(e, mod) })
-      end
-
-      def packed(packed = 1)
-        @packed = packed
-      end
-      alias :pack :packed
-      
-      def aligned(alignment = 1)
-        @min_alignment = alignment
-      end
-      alias :align :aligned
-
-      def enclosing_module
-        begin
-          mod = self.name.split("::")[0..-2].inject(Object) { |obj, c| obj.const_get(c) }
-          (mod < FFI::Library || mod < FFI::Struct || mod.respond_to?(:find_type)) ? mod : nil
-        rescue Exception
-          nil
-        end
-      end
-
-
-      def find_field_type(type, mod = enclosing_module)
-        if type.kind_of?(Class) && type < Struct
-          FFI::Type::Struct.new(type)
-
-        elsif type.kind_of?(Class) && type < FFI::StructLayout::Field
-          type
-
-        elsif type.kind_of?(::Array)
-          FFI::Type::Array.new(find_field_type(type[0]), type[1])
-
-        else
-          find_type(type, mod)
-        end
-      end
-
-      def find_type(type, mod = enclosing_module)
-        if mod
-          mod.find_type(type)
-        end || FFI.find_type(type)
-      end
-
-      private
-
-      # @param [StructLayoutBuilder] builder
-      # @param [Hash] spec
-      # @return [builder]
-      # @raise if Ruby 1.8
-      # Add hash +spec+ to +builder+.
-      def hash_layout(builder, spec)
-        raise "Ruby version not supported" if RUBY_VERSION =~ /1.8.*/
-        spec[0].each do |name, type|
-          builder.add name, find_field_type(type), nil
-        end
-      end
-
-      # @param [StructLayoutBuilder] builder
-      # @param [Array<Symbol, Integer>] spec
-      # @return [builder]
-      # Add array +spec+ to +builder+.
-      def array_layout(builder, spec)
-        i = 0
-        while i < spec.size
-          name, type = spec[i, 2]
-          i += 2
-
-          # If the next param is a Integer, it specifies the offset
-          if spec[i].kind_of?(Integer)
-            offset = spec[i]
-            i += 1
-          else
-            offset = nil
-          end
-
-          builder.add name, find_field_type(type), offset
-        end
-      end
-    end
-  end
-end

data/demo/templates/vendor/bundle/ruby/1.9.1/gems/ffi-1.8.1/lib/ffi/struct_layout_builder.rb

@@ -1,211 +0,0 @@
-#
-# Copyright (C) 2008-2010 Wayne Meissner
-#
-# All rights reserved.
-#
-# This file is part of ruby-ffi.
-#
-# This code is free software: you can redistribute it and/or modify it under
-# the terms of the GNU Lesser General Public License version 3 only, as
-# published by the Free Software Foundation.
-#
-# This code is distributed in the hope that it will be useful, but WITHOUT
-# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License
-# version 3 for more details.
-#
-# You should have received a copy of the GNU Lesser General Public License
-# version 3 along with this work.  If not, see <http://www.gnu.org/licenses/>.
-#
-
-module FFI
-  
-  # Build a {StructLayout struct layout}.
-  class StructLayoutBuilder
-    attr_reader :size
-    attr_reader :alignment
-    
-    def initialize
-      @size = 0
-      @alignment = 1
-      @min_alignment = 1
-      @packed = false
-      @union = false
-      @fields = Array.new
-    end
-
-    # @param [Numeric] size
-    # Set size attribute with +size+ only if +size+ is greater than attribute value.
-    def size=(size)
-      @size = size if size > @size
-    end
-
-    # @param [Numeric] alignment
-    # Set alignment attribute with +alignment+ only if it is greater than attribute value.
-    def alignment=(align)
-      @alignment = align if align > @alignment
-      @min_alignment = align
-    end
-
-    # @param [Boolean] is_union
-    # @return [is_union]
-    # Set union attribute.
-    # Set to +true+ to build a {Union} instead of a {Struct}.
-    def union=(is_union)
-      @union = is_union
-    end
-
-    # @return [Boolean]
-    # Building a {Union} or a {Struct} ?
-    def union?
-      @union
-    end
-
-    # Set packed attribute
-    # @overload packed=(packed)
-    #  @param [Fixnum] packed
-    #  @return [packed]
-    #  Set alignment and packed attributes to +packed+.
-    # @overload packed=(packed)
-    #  @param packed
-    #  @return [0,1]
-    #  Set packed attribute.
-    def packed=(packed)
-      if packed.is_a?(Fixnum)
-        @alignment = packed
-        @packed = packed
-      else
-        @packed = packed ? 1 : 0
-      end
-    end
-
-
-    # List of number types
-    NUMBER_TYPES = [
-      Type::INT8,
-      Type::UINT8,
-      Type::INT16,
-      Type::UINT16,
-      Type::INT32,
-      Type::UINT32,
-      Type::LONG,
-      Type::ULONG,
-      Type::INT64,
-      Type::UINT64,
-      Type::FLOAT32,
-      Type::FLOAT64,
-      Type::LONGDOUBLE,
-      Type::BOOL,
-    ]
-
-    # @param [String, Symbol] name name of the field
-    # @param [Array, DataConverter, Struct, StructLayout::Field, Symbol, Type] type type of the field
-    # @param [Numeric, nil] offset
-    # @return [self]
-    # Add a field to the builder.
-    # @note Setting +offset+ to +nil+ or +-1+ is equivalent to +0+.
-    def add(name, type, offset = nil)
-
-      if offset.nil? || offset == -1
-        offset = @union ? 0 : align(@size, @packed ? [ @packed, type.alignment ].min : [ @min_alignment, type.alignment ].max)
-      end
-
-      #
-      # If a FFI::Type type was passed in as the field arg, try and convert to a StructLayout::Field instance
-      #
-      field = type.is_a?(StructLayout::Field) ? type : field_for_type(name, offset, type)
-      @fields << field
-      @alignment = [ @alignment, field.alignment ].max unless @packed
-      @size = [ @size, field.size + (@union ? 0 : field.offset) ].max
-
-      return self
-    end
-
-    # @param (see #add)
-    # @return (see #add)
-    # Same as {#add}.
-    # @see #add
-    def add_field(name, type, offset = nil)
-      add(name, type, offset)
-    end
-    
-    # @param (see #add)
-    # @return (see #add)
-    # Add a struct as a field to the builder.
-    def add_struct(name, type, offset = nil)
-      add(name, Type::Struct.new(type), offset)
-    end
-
-    # @param name (see #add)
-    # @param type (see #add)
-    # @param [Numeric] count array length
-    # @param offset (see #add)
-    # @return (see #add)
-    # Add an array as a field to the builder.
-    def add_array(name, type, count, offset = nil)
-      add(name, Type::Array.new(type, count), offset)
-    end
-
-    # @return [StructLayout]
-    # Build and return the struct layout.
-    def build
-      # Add tail padding if the struct is not packed
-      size = @packed ? @size : align(@size, @alignment)
-      
-      layout = StructLayout.new(@fields, size, @alignment)
-      layout.__union! if @union
-      layout
-    end
-
-    private
-    
-    # @param [Numeric] offset
-    # @param [Numeric] align
-    # @return [Numeric]
-    def align(offset, align)
-      align + ((offset - 1) & ~(align - 1));
-    end
-
-    # @param (see #add)
-    # @return [StructLayout::Field]
-    def field_for_type(name, offset, type)
-      field_class = case
-      when type.is_a?(Type::Function)
-        StructLayout::Function
-
-      when type.is_a?(Type::Struct)
-        StructLayout::InnerStruct
-
-      when type.is_a?(Type::Array)
-        StructLayout::Array
-
-      when type.is_a?(FFI::Enum)
-        StructLayout::Enum
-
-      when NUMBER_TYPES.include?(type)
-        StructLayout::Number
-
-      when type == Type::POINTER
-        StructLayout::Pointer
-
-      when type == Type::STRING
-        StructLayout::String
-
-      when type.is_a?(Class) && type < StructLayout::Field
-        type
-
-      when type.is_a?(DataConverter)
-        return StructLayout::Mapped.new(name, offset, Type::Mapped.new(type), field_for_type(name, offset, type.native_type))
-
-      when type.is_a?(Type::Mapped)
-        return StructLayout::Mapped.new(name, offset, type, field_for_type(name, offset, type.native_type))
-
-      else
-        raise TypeError, "invalid struct field type #{type.inspect}"
-      end
-
-      field_class.new(name, offset, type)
-    end
-  end
-
-end