virtual_box 0.0.1 → 0.1.0

metadata

@@ -1,108 +1,227 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: virtual_box
-version: !ruby/object:Gem::Version 
-  version: 0.0.1
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Victor Costan
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2009-08-21 00:00:00 -04:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: echoe
+date: 2012-05-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: uuid
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.3.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.3.5
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.1.3
   type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 3.1.1
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: flexmock
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.1.3
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.8.3
   type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 0.8.6
-    version: 
-description: Ruby API for VirtualBox (Sun's OSS virtualization software).
-email: victor@zergling.net
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.8.3
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.12.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.12.1
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.7.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.7.5
+description: Drives the VirtualBox command-line to manage VMs
+email: victor@costan.us
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
-- CHANGELOG
-- lib/virtual_box/command_line.rb
-- lib/virtual_box/version.rb
-- lib/virtual_box/vm/general_settings.rb
-- lib/virtual_box/vm/identity.rb
-- lib/virtual_box/vm/lifecycle.rb
-- lib/virtual_box/vm.rb
+extra_rdoc_files:
+- LICENSE.txt
+- README.markdown
+files:
+- .autotest
+- .document
+- .project
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.markdown
+- Rakefile
+- VERSION
 - lib/virtual_box.rb
-- LICENSE
-- README.textile
-files: 
-- CHANGELOG
-- lib/virtual_box/command_line.rb
+- lib/virtual_box/board.rb
+- lib/virtual_box/cli.rb
+- lib/virtual_box/dhcp.rb
+- lib/virtual_box/disk.rb
+- lib/virtual_box/io_bus.rb
+- lib/virtual_box/net.rb
+- lib/virtual_box/nic.rb
 - lib/virtual_box/version.rb
-- lib/virtual_box/vm/general_settings.rb
-- lib/virtual_box/vm/identity.rb
-- lib/virtual_box/vm/lifecycle.rb
 - lib/virtual_box/vm.rb
-- lib/virtual_box.rb
-- LICENSE
-- Manifest
-- Rakefile
-- README.textile
-- test/command_line_test.rb
-- test/general_settings_test.rb
-- test/lifecycle_test.rb
-- test/version_test.rb
-- testdata/golden_general_params.txt
+- test/helper.rb
+- test/tasks/tinycore.rake
+- test/virtual_box/board_test.rb
+- test/virtual_box/cli_test.rb
+- test/virtual_box/dhcp_test.rb
+- test/virtual_box/disk_test.rb
+- test/virtual_box/integration_test.rb
+- test/virtual_box/io_bus_test.rb
+- test/virtual_box/net_test.rb
+- test/virtual_box/nic_test.rb
+- test/virtual_box/version_test.rb
+- test/virtual_box/vm_test.rb
 - virtual_box.gemspec
-has_rdoc: true
-homepage: http://github.com/costan/virtual_box
-licenses: []
-
+homepage: http://github.com/csail/police
+licenses:
+- MIT
 post_install_message: 
-rdoc_options: 
-- --line-numbers
-- --inline-source
-- --title
-- Virtual_box
-- --main
-- README.textile
-require_paths: 
+rdoc_options: []
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "1.2"
-  version: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3916852811291954048
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: zerglings
-rubygems_version: 1.3.5
+rubyforge_project: 
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
-summary: Ruby API for VirtualBox (Sun's OSS virtualization software).
-test_files: 
-- test/command_line_test.rb
-- test/general_settings_test.rb
-- test/lifecycle_test.rb
-- test/version_test.rb
+summary: VirtualBox driver
+test_files: []

data/CHANGELOG

@@ -1 +0,0 @@
-v0.0.1. Initial release.

data/LICENSE

@@ -1,21 +0,0 @@
-The MIT License
-
-Copyright (c) 2009 Zergling.Net
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

data/Manifest

@@ -1,17 +0,0 @@
-CHANGELOG
-lib/virtual_box/command_line.rb
-lib/virtual_box/version.rb
-lib/virtual_box/vm/general_settings.rb
-lib/virtual_box/vm/identity.rb
-lib/virtual_box/vm/lifecycle.rb
-lib/virtual_box/vm.rb
-lib/virtual_box.rb
-LICENSE
-Manifest
-Rakefile
-README.textile
-test/command_line_test.rb
-test/general_settings_test.rb
-test/lifecycle_test.rb
-test/version_test.rb
-testdata/golden_general_params.txt

data/README.textile

@@ -1,19 +0,0 @@
-h1. VirtualBox
-
-This gem is a Ruby API for VirtualBox, Sun's open-source virtualization software
-that supports Linux, Mac OS X, and Windows.
-
-h2. Features
-
-Currently, the gem supports the following features:
-* (work in progress) creating and starting virtual machines
-* VirtualBox version detection (OSE vs. regular)
-
-h2. Contributions
-
-Please don't hesitate to fork the project and send pull requests.
-
-Right now, the API is built on top of the VBoxManage command-line utility. This
-is an easy implementation, but the performance leaves to be desired. If someone
-cares enough, VirtualBox has a binary API based on XPCOM (Linux, OS X) / COM
-(Windows). Changes for using the binary API would be greatly appreciated.

data/lib/virtual_box/command_line.rb

@@ -1,27 +0,0 @@
-# Interface to the command line. 
-#
-# Author:: Victor Costan
-# Copyright:: Copyright (C) 2009 Zergling.Net
-# License:: MIT
-
-require 'english'
-
-# :nodoc: namespace
-module VirtualBox
-  
-  
-# Runs a command in a sub-shell, waiting until the command completes.
-#
-# Args:
-#   command:: a string containing the command to be executed
-#
-# Returns:
-#   a hash with the following keys:
-#       :status:: the command's exit status
-#       :output:: a string with the command's output 
-def self.shell_command(command)
-  output = Kernel.`(command) 
-  { :status => $CHILD_STATUS, :output => output }
-end
-
-end  # namespace VirtualBox

data/lib/virtual_box/vm/general_settings.rb

@@ -1,136 +0,0 @@
-# General VM settings, covered in section 8.5.1 of the VirtualBox User Manual.
-#
-# Author:: Victor Costan
-# Copyright:: Copyright (C) 2009 Zergling.Net
-# License:: MIT
-
-# :nodoc: namespace
-module VirtualBox
-  
-# :nodoc: documented in vm.rb
-class VM
-
-
-# Mix-in for the VM class covering the general VM settings.
-module GeneralSettings
-  # The amount of megabytes of RAM in the VM.
-  attr_accessor :ram
-  # The amount of megabytes of video RAM in the VM.
-  attr_accessor :video_ram
-  
-  # Whether the VM supports PAE (36-bit address space).
-  attr_accessor :pae  
-  # Whether the VM supports ACPI.
-  attr_accessor :acpi
-  # Whether the VM supports I/O APIC.
-  #
-  # This is necessary for 64-bit OSes, but makes the virtualization slower.
-  attr_accessor :io_apic
-  
-  # Whether the VM attempts to use hardware support (Intel VT-x or AMD-V).
-  #
-  # Hardware virtualization can increase VM performance, especially used in
-  # conjunction with the other hardware virtualization options. However, using
-  # hardware virtualzation in conjunction with other hypervisors can crash the
-  # host machine.
-  attr_accessor :hardware_virtualization
-  # Whether the VM uses hardware support for nested paging.
-  #
-  # The option is used only if hardware_virtualization is set.
-  attr_accessor :nested_paging
-  # Whether the VM uses hardware support for tagged TLB (VPID).
-  #
-  # The option is used only if hardware_virtualization is set.  
-  attr_accessor :tagged_tlb
-  
-  # Whether the VM supports 3D acceleration.
-  #
-  # 3D acceleration will only work with the proper guest extensions.
-  attr_accessor :accelerate_3d
-  
-  # Whether the BIOS logo will fade in when the VM boots.
-  attr_accessor :bios_logo_fade_in
-  # Whether the BIOS logo will fade out when the VM boots.
-  attr_accessor :bios_logo_fade_out
-  # The number of seconds to display the BIOS logo when the VM boots.
-  attr_accessor :bios_logo_display_time
-  # Whether the BIOS allows the user to temporarily override the boot VM device. 
-  #
-  # If +false+, no override is allowed. Otherwise, the user can press F12 at
-  # boot time to select a boot device. The user gets a prompt at boot time if
-  # the value is +true+. If the value is +:menu_only+ the user does not get a
-  # prompt, but can still press F12 to select a device.  
-  attr_accessor :bios_boot_menu  
-  # Indicates the boot device search order for the VM's BIOS.
-  #
-  # This is an array that can contain the following symbols: +:floppy+, +:dvd+,
-  # +:disk+, +:net+. Symbols should not be repeated.
-  attr_accessor :boot_order
-
-  # Resets the VM's general settings to their defaults.
-  #
-  # The defaults are chosen somewhat arbitrarily by the gem's author.
-  def reset_general_settings
-    self.ram = 512
-    self.video_ram = 12
-    
-    self.pae = false        
-    self.acpi = true
-    self.io_apic = false
-    
-    self.hardware_virtualization = true
-    self.nested_paging = true
-    self.tagged_tlb = true
-    
-    self.accelerate_3d = false
-    
-    self.bios_logo_fade_in = false
-    self.bios_logo_fade_out = false
-    self.bios_logo_display_time = 0
-    self.bios_boot_menu = false
-    
-    self.boot_order = [:disk, :net, :dvd]
-  end
-    
-  # Arguments to "VBoxManage modifyvm" describing the VM's general settings.
-  def modifyvm_general_params
-    params = ''
-    params << " --memory #{ram}"
-    params << " --vram #{video_ram}"
-        
-    params << " --pae #{pae ? 'on' : 'off'}"
-    params << " --acpi #{acpi ? 'on' : 'off'}"
-    params << " --io_apic #{io_apic ? 'on' : 'off'}"
-    
-    params << " --hwvirtex #{hardware_virtualization ? 'on' : 'off'}"
-    nested_paging_enabled = hardware_virtualization && nested_paging
-    params << " --nestedpaging #{nested_paging_enabled ? 'on' : 'off'}"
-    tagged_tlb_enabled = hardware_virtualization && tagged_tlb
-    params << " --vtxvpid #{tagged_tlb_enabled ? 'on' : 'off'}"
-    
-    params << " --bioslogofadein #{@bios_logo_fade_in ? 'on' : 'off'}"
-    params << " --bioslogofadeout #{@bios_logo_fade_out ? 'on' : 'off'}"
-    params << " --bioslogodisplaytime #{@bios_logo_display_time}"
-    bios_boot_menu_str = case @bios_boot_menu
-    when false
-      'disabled'
-    when true
-      'messageandmenu'
-    when :menu_only
-      'message'
-    else
-      nil
-    end    
-    params << " --biosbootmenu #{bios_boot_menu_str}"
-    unique_boot_order = boot_order.uniq
-    1.upto(4) do |i|
-      params << " --boot#{i} #{unique_boot_order[i - 1] || 'none'}"
-    end
-    
-    params
-  end
-end  # module GeneralSettings
-
-end  # class VM
-  
-end  # namespace VirtualBox

data/lib/virtual_box/vm/identity.rb

@@ -1,43 +0,0 @@
-# VM identity (name and UUID) management. 
-#
-# Author:: Victor Costan
-# Copyright:: Copyright (C) 2009 Zergling.Net
-# License:: MIT
-
-# :nodoc: namespace
-module VirtualBox
-  
-# :nodoc: documented in vm.rb
-class VM
-
-
-# Mix-in for the VM class covering identity management.
-module Identity
-  # The VM's user-friendly name.
-  attr_accessor :name
-  
-  # The VM's UUID  (unique id).
-  attr_accessor :uuid
-
-  # Resets the VM's name and UUID.
-  def reset_identity
-    @name = nil
-    @uuid = nil    
-  end
-  
-  # :nodoc: documented as attribute
-  def uuid
-    # TODO(overmind): obtain UUID from name if it's not available
-    @uuid
-  end
-
-  # :nodoc: documented as attribute
-  def name
-    # TODO(overmind): obtain name from UUID if it's not available
-    @name
-  end
-end  # module Lifecycle
-
-end  # class VM
-  
-end  # namespace VirtualBox

data/lib/virtual_box/vm/lifecycle.rb

@@ -1,42 +0,0 @@
-# VM life-cycle management. 
-#
-# Author:: Victor Costan
-# Copyright:: Copyright (C) 2009 Zergling.Net
-# License:: MIT
-
-# :nodoc: namespace
-module VirtualBox
-  
-# :nodoc: documented in vm.rb
-class VM
-
-
-# Mix-in for the VM class covering life-cycle management.
-module Lifecycle 
-  # Starts the virtual machine.
-  #
-  # The following options are supported:
-  #   :gui:: if set to true, VMs will be started in a GUI; this is intended to
-  #          help debugging
-  #   :rdp:: if set to true, RDP support will be enabled; by default, RDP
-  #          support is disabled; VirtualBox OSE does not support RDP, so the
-  #          call will raise an exception
-  def start(options = {})
-    if options[:gui]
-      command = "VBoxManage startvm #{uuid} --type gui"
-    else
-      command = "VBoxHeadless --startvm #{uuid}"
-    end      
-      
-    if VirtualBox.ose?
-      raise 'Cannot enable RDP support on VirtualBox OSE' if options[:rdp]
-    else
-      command += " --vrdp #{options[:rdp] ? 'on' : 'off'}"
-    end
-    VirtualBox.shell_command(command)[:status] == 0
-  end  
-end  # module Lifecycle
-
-end  # class VM
-  
-end  # namespace VirtualBox

data/test/command_line_test.rb

@@ -1,19 +0,0 @@
-# Interface to the command line. 
-#
-# Author:: Victor Costan
-# Copyright:: Copyright (C) 2009 Zergling.Net
-# License:: MIT
-
-require 'virtual_box'
-require 'test/unit'
-
-
-class CommandLineTest < Test::Unit::TestCase
-  def test_shell_command
-    golden = { :status => 0, :output => "Hello\n" }
-    VirtualBox.shell_command 'echo Hello'
-    
-    golden = { :status => 1, :output => "Boom\n" }
-    VirtualBox.shell_command 'ruby -e "print :Hello; exit 1"'
-  end
-end

data/test/general_settings_test.rb

@@ -1,20 +0,0 @@
-# Author:: Victor Costan
-# Copyright:: Copyright (C) 2009 Zergling.Net
-# License:: MIT
-
-require 'virtual_box'
-require 'test/unit'
-
-
-class GeneralSettingsTest < Test::Unit::TestCase
-  def setup
-    @testdata_path = File.join(File.dirname(__FILE__), '..', 'testdata')    
-    @vm = VirtualBox::VM.new
-  end
-  
-  def test_modifyvm_general_params
-    golden_params = File.read File.join(@testdata_path,
-                                        'golden_general_params.txt')
-    assert_equal golden_params, @vm.modifyvm_general_params
-  end
-end