solusvm 0.3.3

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Site5 LLC 
+
+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/README.rdoc

@@ -0,0 +1,17 @@
+= solusvm
+
+Description goes here.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Justin Mazzi. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,53 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "solusvm"
+    gem.summary = "Wrapper for the SolusVM Admin::API"
+    gem.description = "Solusvm allows for easy interaction with the SolusVM Admin::API."
+    gem.email = "jmazzi@gmail.com"
+    gem.homepage = "http://github.com/site5/solusvm"
+    gem.authors = ["Justin Mazzi"]
+    gem.add_dependency 'xml-simple'
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "solusvm #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+:minor: 3
+:build: 
+:patch: 3
+:major: 0

data/lib/solusvm.rb

@@ -0,0 +1,36 @@
+require 'net/http'
+require 'net/https'
+require 'cgi'
+require 'rubygems'
+require 'xmlsimple'
+
+module Solusvm
+  class << self
+    attr_accessor :api_endpoint, :api_id, :api_key, :api_options
+
+    # Sepcifies the login and url for making requests
+    #
+    # example:
+    #
+    #   Solusvm.config('id', 'key', :url => 'http://www.example.com/api', :logger => RAILS_LOGGER, :logger_method => :log_info)
+    #
+    # Options:
+    # * <tt>:logger</tt> - Log object used for logging API responses
+    # * <tt>:logger_method</tt> - The method that performs the logging on the Log object
+    def config(api_id, api_key, options={})
+      @api_id       = api_id
+      @api_key      = api_key
+      @api_endpoint = URI.parse(options.delete(:url))
+      @api_options  = options
+    end
+  end
+end
+
+directory = File.expand_path(File.dirname(__FILE__))
+
+require File.join(directory, 'solusvm', 'exceptions')
+require File.join(directory, 'solusvm', 'hash')
+require File.join(directory, 'solusvm', 'base')
+require File.join(directory, 'solusvm', 'general')
+require File.join(directory, 'solusvm', 'client')
+require File.join(directory, 'solusvm', 'server')

data/lib/solusvm/base.rb

@@ -0,0 +1,82 @@
+module Solusvm
+  # Solusvm::Base is the main class for mapping API resources as subclasses.
+  class Base
+    attr_reader :returned_parameters, :statusmsg
+    VALID_SERVER_TYPES = ['openvz', 'xen', 'xen hvm']
+
+    # Prepares and sends the API request to the URL specificed in Solusvm.config
+    #
+    #
+    #  class MyClass < Base
+    #    def create_server(name)
+    #      perform_request(:action => 'name', :id => 1)
+    #    end
+    #  end
+    # Options:
+    # * <tt>:action</tt> - Specifies which API method to execute
+    # All other options passed in are converted to http query arguments and are passed along to the API
+    def perform_request(options = {})
+      options.merge!(api_login)
+      http = Net::HTTP.new(api_endpoint.host, api_endpoint.port)
+      if api_endpoint.port == 443
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      end
+      http.start do |http|
+        request = Net::HTTP::Get.new("#{api_endpoint.path}?#{options.to_query}")
+        response = http.request(request)
+        @returned_parameters = parse_response(response.body)
+        log_messages(options)
+      end
+      successful?
+    end
+
+    # Converts the XML response to a Hash
+    def parse_response(body)
+      body = "<solusrequest>#{body}</solusrequest>"
+      XmlSimple.xml_in(body, 'ForceArray' => false)
+    end
+
+    # Returns true when a request has been successful
+    # 
+    #   my_class = MyClass.new
+    #   my_class.create_server('example.com')
+    #   my_class.successful? # => true
+    def successful?
+      returned_parameters['status'] == 'success'
+    end
+
+    # URI parsed API URL
+    def api_endpoint
+      Solusvm.api_endpoint
+    end
+
+    def api_login
+      {:id => Solusvm.api_id, :key => Solusvm.api_key}
+    end
+
+    # TODO: clean this up
+    def log_messages(options)
+      if Solusvm.api_options[:logger] && Solusvm.api_options[:logger].respond_to?(Solusvm.api_options[:logger_method])
+        Solusvm.api_options[:logger].send(Solusvm.api_options[:logger_method], "[Start] => #{options[:action]}")
+        returned_parameters.each do |k,v|
+          Solusvm.api_options[:logger].send(Solusvm.api_options[:logger_method], "   #{k} => #{v}")
+        end
+        Solusvm.api_options[:logger].send(Solusvm.api_options[:logger_method], "[End] => #{options[:action]}")
+      end
+    end
+
+    # API response message
+    def statusmsg
+      returned_parameters['statusmsg']
+    end
+
+    # Raises an exception unless a valid type is specified
+    def validate_server_type!(type)
+      type.strip!
+      unless VALID_SERVER_TYPES.include?(type)
+        raise SolusvmError, "Invalid Virtual Server type: #{type}"
+      end
+    end
+  end
+end

data/lib/solusvm/client.rb

@@ -0,0 +1,23 @@
+module Solusvm
+  # Solusvm::Client is the class for working with clients
+  class Client < Base
+    # Creates a client
+    #
+    # Options:
+    # * <tt>:username</tt>
+    # * <tt>:password</tt>
+    # * <tt>:email</tt>
+    # * <tt>:firstname</tt>
+    # * <tt>:lastname</tt>
+    def create(options ={})
+      options.merge!(:action => 'client-create')
+      perform_request(options)
+    end
+
+    # Verify a clients login. Returns true when the specified login is correct
+    def authenticate(username, password)
+      perform_request({:action => 'client-authenticate', :username => username, :password => password})
+      statusmsg.match /validated/i
+    end
+  end
+end

data/lib/solusvm/exceptions.rb

@@ -0,0 +1,4 @@
+module Solusvm
+  class SolusvmError < StandardError
+  end
+end

data/lib/solusvm/general.rb

@@ -0,0 +1,20 @@
+module Solusvm
+  class General < Base
+    def nodes(type)
+      validate_server_type!(type)
+      perform_request(:action => 'listnodes', :type => type)
+      returned_parameters['nodes'].split(',')
+    end
+
+    def templates(type)
+      validate_server_type!(type)
+      perform_request(:action => 'listtemplates', :type => type)
+      returned_parameters['templates'].split(',')
+    end
+
+    def node_statistics(nodeid)
+      perform_request(:action => 'node-statistics', :nodeid => nodeid)
+      returned_parameters
+    end
+  end
+end

data/lib/solusvm/hash.rb

@@ -0,0 +1,23 @@
+class Hash
+  unless method_defined?(:to_query)
+    def to_query
+      elements = []
+      self.each do |key, value|
+        elements << "#{CGI::escape(key.to_s)}=#{CGI::escape(value.to_s)}"
+      end
+      elements.join('&')
+    end
+  end
+
+  unless method_defined?(:reverse_merge)
+    def reverse_merge(other_hash)
+      other_hash.merge(self)
+    end
+  end
+
+  unless method_defined?(:reverse_merge!)
+    def reverse_merge!(other_hash)
+      replace(reverse_merge(other_hash))
+    end
+  end
+end

data/lib/solusvm/server.rb

@@ -0,0 +1,60 @@
+module Solusvm
+  class Server < Base
+    def create(hostname, password, options = {})
+      options.reverse_merge!(
+        :type         => 'xen',
+        :username     => nil,
+        :ips          => 1,
+        :node         => nil,
+        :plan         => nil,
+        :template     => nil,
+        :password     => password,
+        :hostname     => hostname
+      ).merge!(:action => 'vserver-create')
+      perform_request(options)
+      returned_parameters
+    end
+
+    def boot(vid)
+      perform_request(:action => 'vserver-boot', :vserverid => vid)
+    end
+
+    def reboot(vid)
+      perform_request(:action => 'vserver-reboot', :vserverid => vid)
+    end
+
+    def suspend(vid)
+      perform_request(:action => 'vserver-suspend', :vserverid => vid)
+    end
+
+    def resume(vid)
+      perform_request(:action => 'vserver-unsuspend', :vserverid => vid)
+    end
+
+    def shutdown(vid)
+      perform_request(:action => 'vserver-shutdown', :vserverid => vid)
+    end
+
+    def terminate(vid, deleteclient = false)
+      perform_request(:action => 'vserver-terminate', :vserverid => vid, :deleteclient => deleteclient)
+    end
+
+    def exists?(vid)
+      perform_request(:action => 'vserver-checkexists', :vserverid => vid)
+      !statusmsg.match(/Virtual server exists/i).nil?
+    end
+
+    def status(vid)
+      perform_request(:action => 'vserver-status', :vserverid => vid)
+      statusmsg
+    end
+
+    def add_ip(vid)
+      perform_request(:action => 'vserver-addip', :vserverid => vid)
+    end
+
+    def change_plan(vid, plan)
+      perform_request(:action => 'vserver-change', :vserverid => vid, :plan => plan)
+    end
+  end
+end

data/solusvm.gemspec

@@ -0,0 +1,86 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{solusvm}
+  s.version = "0.3.3"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Justin Mazzi"]
+  s.date = %q{2010-06-21}
+  s.description = %q{Solusvm allows for easy interaction with the SolusVM Admin::API.}
+  s.email = %q{jmazzi@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION.yml",
+     "lib/solusvm.rb",
+     "lib/solusvm/base.rb",
+     "lib/solusvm/client.rb",
+     "lib/solusvm/exceptions.rb",
+     "lib/solusvm/general.rb",
+     "lib/solusvm/hash.rb",
+     "lib/solusvm/server.rb",
+     "solusvm.gemspec",
+     "test/fixtures/client_authenticate_error.txt",
+     "test/fixtures/client_authenticate_success.txt",
+     "test/fixtures/client_create_error.txt",
+     "test/fixtures/client_create_success.txt",
+     "test/fixtures/error.txt",
+     "test/fixtures/general_node_statistics_success.txt",
+     "test/fixtures/general_nodes_success.txt",
+     "test/fixtures/general_templates_success.txt",
+     "test/fixtures/server_boot_success.txt",
+     "test/fixtures/server_create_success.txt",
+     "test/fixtures/server_exists_success.txt",
+     "test/fixtures/server_reboot_success.txt",
+     "test/fixtures/server_resume_success.txt",
+     "test/fixtures/server_shutdown_success.txt",
+     "test/fixtures/server_suspend_success.txt",
+     "test/fixtures/server_terminate_success.txt",
+     "test/helper.rb",
+     "test/test_base.rb",
+     "test/test_client.rb",
+     "test/test_general.rb",
+     "test/test_hash.rb",
+     "test/test_server.rb",
+     "test/test_solusvm.rb"
+  ]
+  s.homepage = %q{http://github.com/site5/solusvm}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Wrapper for the SolusVM Admin::API}
+  s.test_files = [
+    "test/helper.rb",
+     "test/test_base.rb",
+     "test/test_client.rb",
+     "test/test_general.rb",
+     "test/test_hash.rb",
+     "test/test_server.rb",
+     "test/test_solusvm.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<xml-simple>, [">= 0"])
+    else
+      s.add_dependency(%q<xml-simple>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<xml-simple>, [">= 0"])
+  end
+end
+

data/test/fixtures/client_authenticate_error.txt

@@ -0,0 +1,2 @@
+<status>error</status>
+<statusmsg>invalid username or password</statusmsg>

data/test/fixtures/client_authenticate_success.txt

@@ -0,0 +1,2 @@
+<status>success</status>
+<statusmsg>validated</statusmsg>

data/test/fixtures/client_create_error.txt

@@ -0,0 +1,2 @@
+<status>error</status>
+<statusmsg>Empty username field</statusmsg>

data/test/fixtures/client_create_success.txt

@@ -0,0 +1,7 @@
+<status>success</status>
+<statusmsg>Successfully added client</statusmsg>
+<username>vps123</username>
+<password>123456</password>
+<email>email@address.com</email>
+<firstname>phill</firstname>
+<lastname>smith</lastname>

data/test/fixtures/error.txt

@@ -0,0 +1,2 @@
+<status>error</status>
+<statusmsg>error message</statusmsg>

data/test/fixtures/general_node_statistics_success.txt

@@ -0,0 +1,14 @@
+<status>success</status>
+<statusmsg></statusmsg>
+<id>1</id>
+<name>name</name>
+<ip>127.0.0.1</ip>
+<hostname>hostname.com</hostname>
+<country>country</country>
+<city>city</city>
+<sshport>22</sshport>
+<arch>x86_64</arch>
+<freememory>10</freememory>
+<freedisk>1000</freedisk>
+<virtualservers>2</virtualservers>
+<freeips>0</freeips>

data/test/fixtures/general_nodes_success.txt

@@ -0,0 +1,3 @@
+<status>success</status>
+<statusmsg></statusmsg>
+<nodes>node1,node2,node3,node4</nodes>

data/test/fixtures/general_templates_success.txt

@@ -0,0 +1,3 @@
+<status>success</status>
+<statusmsg></statusmsg>
+<templates>template1,template2,template3</templates>

data/test/fixtures/server_boot_success.txt

@@ -0,0 +1,2 @@
+<status>success</status>
+<statusmsg>Virtual server booted</statusmsg>

data/test/fixtures/server_create_success.txt

@@ -0,0 +1,10 @@
+<status>success</status>
+<statusmsg>Virtual server created</statusmsg>
+<mainipaddress>123.123.123.123</mainipaddress>
+<extraipaddress>122.122.122.122,111.111.111.111</extraipaddress>
+<rootpassword>123456</rootpassword>
+<vserverid>100</vserverid>
+<consoleuser>console-123</consoleuser>
+<consolepassword>123456</consolepassword>
+<hostname>server.hostname.com</hostname>
+<virtid>vm101|101</virtid>

data/test/fixtures/server_exists_success.txt

@@ -0,0 +1,2 @@
+<status>success</status>
+<statusmsg>Virtual server exists</statusmsg>

data/test/fixtures/server_reboot_success.txt

@@ -0,0 +1,2 @@
+<status>success</status>
+<statusmsg>Virtual server rebooted</statusmsg>

data/test/fixtures/server_resume_success.txt

@@ -0,0 +1,2 @@
+<status>success</status>
+<statusmsg>Virtual server unsuspended</statusmsg>

data/test/fixtures/server_shutdown_success.txt

@@ -0,0 +1,2 @@
+<status>success</status>
+<statusmsg>Virtual server shutdown</statusmsg>

data/test/fixtures/server_suspend_success.txt

@@ -0,0 +1,2 @@
+<status>success</status>
+<statusmsg>Virtual server suspended</statusmsg>

data/test/fixtures/server_terminate_success.txt

@@ -0,0 +1,2 @@
+<status>success</status>
+<statusmsg>Virtual server terminated</statusmsg>

data/test/helper.rb

@@ -0,0 +1,27 @@
+require 'rubygems'
+require 'test/unit'
+require 'redgreen'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'solusvm'
+require 'fake_web'
+
+class Test::Unit::TestCase
+  def load_response(name)
+    File.read(File.join(File.dirname(__FILE__), "fixtures/#{name}.txt"))
+  end
+
+  def base_uri
+    "#{Solusvm.api_endpoint}?id=api_id&key=api_key"
+  end
+
+  def api_login
+    {:id => 'api_id', :key => 'api_key'}
+  end
+
+  def setup_solusvm
+    Solusvm.config(api_login[:id], api_login[:key], :url => 'http://www.example.com/api')
+  end
+
+end

data/test/test_base.rb

@@ -0,0 +1,71 @@
+require File.dirname(__FILE__) + '/helper'
+
+class TestBase < Test::Unit::TestCase
+
+  def setup
+    FakeWeb.allow_net_connect = false
+    FakeWeb.clean_registry
+    setup_solusvm
+    @base = Solusvm::Base.new
+  end
+
+  def test_valid_server_types
+    assert_equal 3, Solusvm::Base::VALID_SERVER_TYPES.size
+    assert_equal ['openvz', 'xen', 'xen hvm'].sort, Solusvm::Base::VALID_SERVER_TYPES.sort
+  end
+
+  def test_parse_response
+    FakeWeb.register_uri(:get, "#{base_uri}&action=test&vserverid=1", :body => load_response('server_create_success'))
+    assert_nil @base.returned_parameters
+    @base.perform_request(:action => 'test', :vserverid => 1)
+    params = @base.returned_parameters
+
+    assert_equal 10, params.size
+    assert_equal '123.123.123.123', params['mainipaddress']
+    assert_equal 'console-123', params['consoleuser']
+    assert_equal '100', params['vserverid']
+    assert_equal 'Virtual server created', params['statusmsg']
+    assert_equal 'vm101|101', params['virtid']
+    assert_equal '123456', params['consolepassword']
+    assert_equal '122.122.122.122,111.111.111.111', params['extraipaddress']
+    assert_equal 'server.hostname.com', params['hostname']
+    assert_equal '123456', params['rootpassword']
+    assert_equal 'success', params['status']
+  end
+
+  def test_successful
+    FakeWeb.register_uri(:get, "#{base_uri}&action=testsuccess&vserverid=1", :body => load_response('server_create_success'))
+    FakeWeb.register_uri(:get, "#{base_uri}&action=testfail&vserverid=1", :body => load_response('error'))
+
+    @base.perform_request(:action => 'testsuccess', :vserverid => 1)
+    assert @base.successful?
+
+    assert ! @base.perform_request(:action => 'testfail', :vserverid => 1)
+    assert_equal "error message", @base.statusmsg
+  end
+
+  def test_api_login
+    assert_equal api_login, @base.api_login
+  end
+
+  def test_statusmsg
+    FakeWeb.register_uri(:get, "#{base_uri}&action=testsuccess&vserverid=1", :body => load_response('server_create_success'))
+    @base.perform_request(:action => 'testsuccess', :vserverid => 1)
+    assert_equal 'Virtual server created', @base.statusmsg
+  end
+
+  def test_validate_server_type
+    Solusvm::Base::VALID_SERVER_TYPES.each do |type|
+      assert_nothing_raised do
+        @base.validate_server_type!(type)
+      end
+    end
+
+    begin
+      @base.validate_server_type!('bob')
+      flunk "Shouldn't get here"
+    rescue Solusvm::SolusvmError => e
+      assert_equal 'Invalid Virtual Server type: bob', e.message
+    end
+  end
+end

data/test/test_client.rb

@@ -0,0 +1,41 @@
+require File.dirname(__FILE__) + '/helper'
+
+class TestClient < Test::Unit::TestCase
+
+  def setup
+    setup_solusvm
+    FakeWeb.allow_net_connect = false
+    FakeWeb.clean_registry
+    @client = Solusvm::Client.new
+  end
+
+  def test_create
+    options = {:username => 'vps123', :password=> '123456', :email=> 'email@address.com', :firstname => 'phill', :lastname => 'smith'}
+    FakeWeb.register_uri(:get, "#{base_uri}&action=client-create&#{options.to_query}", :body => load_response('client_create_success'))
+    assert @client.create(options)
+
+    params = @client.returned_parameters
+    assert_equal options[:username], params['username']
+    assert_equal options[:firstname], params['firstname']
+    assert_equal options[:lastname], params['lastname']
+    assert_equal options[:password], params['password']
+    assert_equal options[:email], params['email']
+    assert_equal 'Successfully added client', params['statusmsg']
+    assert_equal 'success', params['status']
+  end
+
+  def test_create_fail
+    FakeWeb.register_uri(:get, "#{base_uri}&action=client-create", :body => load_response('client_create_error'))
+    assert ! @client.create
+    assert_equal 'Empty username field', @client.statusmsg
+  end
+
+  def test_authenticate
+    FakeWeb.register_uri(:get, "#{base_uri}&action=client-authenticate&username=u&password=p", :body => load_response('client_authenticate_success'))
+    FakeWeb.register_uri(:get, "#{base_uri}&action=client-authenticate&username=u&password=notp", :body => load_response('client_authenticate_error'))
+    assert @client.authenticate('u', 'p')
+    assert ! @client.authenticate('u', 'notp')
+    assert_equal 'invalid username or password', @client.statusmsg
+    
+  end
+end

data/test/test_general.rb

@@ -0,0 +1,63 @@
+require File.dirname(__FILE__) + '/helper'
+
+class TestGeneral < Test::Unit::TestCase
+  def setup
+    FakeWeb.allow_net_connect = false
+    FakeWeb.clean_registry
+    setup_solusvm
+    @general = Solusvm::General.new
+  end
+
+  def test_nodes
+    FakeWeb.register_uri(:get, "#{base_uri}&action=listnodes&type=xen", :body => load_response('general_nodes_success'))
+    actual_nodes = @general.nodes('xen')
+    expected_nodes = %w(node1 node2 node3 node4)
+    assert_equal expected_nodes, actual_nodes
+  end
+
+  def test_nodes_error
+    FakeWeb.register_uri(:get, "#{base_uri}&action=listnodes&type=whatever", :body => load_response('error'))
+    begin
+      @general.nodes('whatever')
+      flunk "Shouldn't get here"
+    rescue Solusvm::SolusvmError => e
+      assert e.message.match /Invalid Virtual Server type/
+    end
+  end
+
+  def test_templates
+    FakeWeb.register_uri(:get, "#{base_uri}&action=listtemplates&type=xen", :body => load_response('general_templates_success'))
+    actual_templates = @general.templates('xen')
+    expected_templates = %w(template1 template2 template3)
+    assert_equal expected_templates, actual_templates
+  end
+
+  def test_template_error
+    FakeWeb.register_uri(:get, "#{base_uri}&action=listtemplates&type=whatever", :body => load_response('error'))
+    begin
+      @general.templates('whatever')
+      flunk "Shouldn't get here"
+    rescue Solusvm::SolusvmError => e
+      assert e.message.match /Invalid Virtual Server type/
+    end
+  end
+
+  def test_node_statistics
+    FakeWeb.register_uri(:get, "#{base_uri}&action=node-statistics&nodeid=1", :body => load_response('general_node_statistics_success'))
+    node_statistics = @general.node_statistics(1)
+    
+    assert_equal '1000', node_statistics['freedisk']
+    assert_equal '22', node_statistics['sshport']
+    assert_equal 'city', node_statistics['city']
+    assert_equal 'name', node_statistics['name']
+    assert_equal '0', node_statistics['freeips']
+    assert_equal 'country', node_statistics['country']
+    assert_equal 'x86_64', node_statistics['arch']
+    assert_equal '1', node_statistics['id']
+    assert_equal '10', node_statistics['freememory']
+    assert_equal '2', node_statistics['virtualservers']
+    assert_equal '127.0.0.1', node_statistics['ip']
+    assert_equal 'hostname.com', node_statistics['hostname']
+    assert_equal 'success', node_statistics['status']
+  end
+end

data/test/test_hash.rb

@@ -0,0 +1,27 @@
+require File.dirname(__FILE__) + '/helper'
+
+class TestHash < Test::Unit::TestCase
+  def test_reverse_merge
+    defaults = { :a => "x", :b => "y", :c => 10 }.freeze
+    options  = { :a => 1, :b => 2 }
+    expected = { :a => 1, :b => 2, :c => 10 }
+
+    # Should merge defaults into options, creating a new hash.
+    assert_equal expected, options.reverse_merge(defaults)
+    assert_not_equal expected, options
+
+    # Should merge! defaults into options, replacing options.
+    merged = options.dup
+    assert_equal expected, merged.reverse_merge!(defaults)
+    assert_equal expected, merged
+  end
+
+  def test_to_query
+    defaults = { :a => "x", :b => "y", :c => 10 }
+    expected = "a=x&b=y&c=10".split('&').sort
+    actual = defaults.to_query.split('&').sort
+
+    assert defaults.to_query.is_a?(String)
+    assert_equal expected, actual
+  end
+end

data/test/test_server.rb

@@ -0,0 +1,91 @@
+require File.dirname(__FILE__) + '/helper'
+
+class TestServer < Test::Unit::TestCase
+  def setup
+    setup_solusvm
+    FakeWeb.allow_net_connect = false
+    FakeWeb.clean_registry
+    @server = Solusvm::Server.new
+  end
+
+  def test_create
+    options = {:hostname => 'server.hostname.com', :type => 'xen', :username => 'bob', :password => '123456',
+               :node => 'node1', :plan => 'plan1', :template => 'mytpl', :ips => 1}
+    FakeWeb.register_uri(:get, "#{base_uri}&action=vserver-create&#{options.to_query}", :body => load_response('server_create_success'))
+    hostname = options.delete(:hostname)
+    password = options.delete(:password)
+    actual = @server.create(hostname, password, options)
+    assert_equal hostname, actual['hostname']
+    assert_equal options[:password], actual['rootpassword']
+    assert_equal '100', actual['vserverid']
+    assert_equal 'console-123', actual['consoleuser']
+    assert_equal '123456', actual['consolepassword']
+    assert_equal '123.123.123.123', actual['mainipaddress']
+    assert_equal 'vm101|101', actual['virtid']
+  end
+
+  def test_create_error
+    FakeWeb.register_uri(:get, "#{base_uri}&type=xen&plan=&action=vserver-create&template=&hostname=&ips=1&username=&password=&node=", :body => load_response('error'))
+    @server.create('', '')
+    assert ! @server.successful?
+  end
+
+  def test_boot
+    FakeWeb.register_uri(:get, "#{base_uri}&action=vserver-boot&vserverid=1", :body => load_response('server_boot_success'))
+    assert @server.boot(1)
+    assert_equal 'Virtual server booted', @server.statusmsg
+  end
+
+  def test_reboot
+    FakeWeb.register_uri(:get, "#{base_uri}&action=vserver-reboot&vserverid=1", :body => load_response('server_reboot_success'))
+    assert @server.reboot(1)
+    assert_equal 'Virtual server rebooted', @server.statusmsg
+  end
+
+  def test_suspend
+    FakeWeb.register_uri(:get, "#{base_uri}&action=vserver-suspend&vserverid=1", :body => load_response('server_suspend_success'))
+    assert @server.suspend(1)
+    assert_equal 'Virtual server suspended', @server.statusmsg
+  end
+
+  def test_resume
+    FakeWeb.register_uri(:get, "#{base_uri}&action=vserver-unsuspend&vserverid=1", :body => load_response('server_resume_success'))
+    assert @server.resume(1)
+    assert_equal 'Virtual server unsuspended', @server.statusmsg
+  end
+
+  def test_shutdown
+    FakeWeb.register_uri(:get, "#{base_uri}&action=vserver-shutdown&vserverid=1", :body => load_response('server_shutdown_success'))
+    assert @server.shutdown(1)
+    assert_equal 'Virtual server shutdown', @server.statusmsg
+  end
+
+  def test_terminate
+    FakeWeb.register_uri(:get, "#{base_uri}&action=vserver-terminate&vserverid=1&deleteclient=false", :body => load_response('server_terminate_success'))
+    FakeWeb.register_uri(:get, "#{base_uri}&action=vserver-terminate&vserverid=1&deleteclient=true", :body => load_response('server_terminate_success'))
+    assert @server.terminate(1)
+    assert_equal 'Virtual server terminated', @server.statusmsg
+
+    assert @server.terminate(1, true)
+    assert_equal 'Virtual server terminated', @server.statusmsg
+  end
+
+  def text_exists
+    FakeWeb.register_uri(:get, "#{base_uri}&action=vserver-checkexists&vserverid=1", :body => load_response('server_exists_success'))
+    assert @server.exists(1)
+    assert_equal 'Virtual server exists', @server.statusmsg
+  end
+
+  def test_status
+    flunk "Implement this"
+  end
+
+  def test_add_ip
+    flunk "This is broken on the SolusVM API Level"
+  end
+
+  def test_change_plan
+    flunk "Implement this"
+  end
+
+end

data/test/test_solusvm.rb

@@ -0,0 +1,12 @@
+require File.dirname(__FILE__) + '/helper'
+
+class TestSolusvm < Test::Unit::TestCase
+  def test_config
+    setup_solusvm
+    url = 'http://www.example.com/api'
+    assert_equal 'api_id', Solusvm.api_id
+    assert_equal 'api_key', Solusvm.api_key
+    assert_not_nil Solusvm.api_endpoint
+    assert_equal URI.parse(url), Solusvm.api_endpoint
+  end
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification 
+name: solusvm
+version: !ruby/object:Gem::Version 
+  hash: 21
+  prerelease: false
+  segments: 
+  - 0
+  - 3
+  - 3
+  version: 0.3.3
+platform: ruby
+authors: 
+- Justin Mazzi
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-21 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: xml-simple
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: Solusvm allows for easy interaction with the SolusVM Admin::API.
+email: jmazzi@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- lib/solusvm.rb
+- lib/solusvm/base.rb
+- lib/solusvm/client.rb
+- lib/solusvm/exceptions.rb
+- lib/solusvm/general.rb
+- lib/solusvm/hash.rb
+- lib/solusvm/server.rb
+- solusvm.gemspec
+- test/fixtures/client_authenticate_error.txt
+- test/fixtures/client_authenticate_success.txt
+- test/fixtures/client_create_error.txt
+- test/fixtures/client_create_success.txt
+- test/fixtures/error.txt
+- test/fixtures/general_node_statistics_success.txt
+- test/fixtures/general_nodes_success.txt
+- test/fixtures/general_templates_success.txt
+- test/fixtures/server_boot_success.txt
+- test/fixtures/server_create_success.txt
+- test/fixtures/server_exists_success.txt
+- test/fixtures/server_reboot_success.txt
+- test/fixtures/server_resume_success.txt
+- test/fixtures/server_shutdown_success.txt
+- test/fixtures/server_suspend_success.txt
+- test/fixtures/server_terminate_success.txt
+- test/helper.rb
+- test/test_base.rb
+- test/test_client.rb
+- test/test_general.rb
+- test/test_hash.rb
+- test/test_server.rb
+- test/test_solusvm.rb
+has_rdoc: true
+homepage: http://github.com/site5/solusvm
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Wrapper for the SolusVM Admin::API
+test_files: 
+- test/helper.rb
+- test/test_base.rb
+- test/test_client.rb
+- test/test_general.rb
+- test/test_hash.rb
+- test/test_server.rb
+- test/test_solusvm.rb