roca 0.0.1

data/.autotest

@@ -0,0 +1,5 @@
+begin
+  require "autotest/fsevent"
+  require "autotest/growl"
+rescue LoadError
+end

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+coverage/*

data/.rspec

@@ -0,0 +1,2 @@
+--colour
+--format progress

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in roca.gemspec
+gemspec

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/roca/connector.rb

@@ -0,0 +1,20 @@
+module Roca
+  class Connector
+
+    def initialize(args = {})
+      @xmlrpc_client  = args[:xmlrpc_client] || build_xmlrpc_client(args[:endpoint])
+      @session_string = args[:session_string]
+    end
+
+    def execute(method, *args)
+      args = args.unshift(@session_string)
+      @xmlrpc_client.call_async(method, *args)
+    end
+
+  private
+
+    def build_xmlrpc_client(endpoint)
+      XMLRPC::Client.new2(endpoint)
+    end
+  end
+end

data/lib/roca/connector_helper.rb

@@ -0,0 +1,22 @@
+module Roca
+  module ConnectorHelper
+    def connector
+      self.class.connector
+    end
+
+    def connector=(_connector)
+      self.class.connector = _connector
+    end
+
+    module ClassMethods
+      def connector
+        # todo: inject endpoint and session_string
+        @connector ||= Connector.new(endpoint: endpoint, session_string: session_string)
+      end
+
+      def connector=(_connector)
+        @connector = _connector
+      end
+    end
+  end
+end

data/lib/roca/group.rb

@@ -0,0 +1,42 @@
+module Roca
+  class Group
+    include ConnectorHelper
+    extend  ConnectorHelper::ClassMethods
+
+    attr_reader :group_id, :name
+
+    def self.create(attributes = {})
+      success_flag, group_id, error_code = connector.execute("one.group.allocate", attributes[:name])
+      attributes[:group_id] = group_id
+      success_flag ? Group.build_from_hash(attributes) : false
+    end
+
+    def self.find(group_id)
+      success_flag, xml_object_description, error_code = connector.execute("one.group.info", group_id)
+      success_flag ? Group.build_from_xml(xml_object_description) : false
+    end
+
+    def self.build_from_hash(attributes = {})
+      Group.new(attributes)
+    end
+
+    def self.build_from_xml(xml_description)
+      doc = Nokogiri::Slop(xml_description)
+
+      Group.build_from_hash(
+        group_id: doc.GROUP.ID.content.to_i,
+        name:     doc.GROUP.NAME.content
+      )
+    end
+
+    def initialize(attributes = {})
+      @name     = attributes[:name]
+      @group_id = attributes[:group_id]
+    end
+
+    def delete
+      success_flag, xml_object_description, error_code = connector.execute("one.group.delete", group_id)
+      success_flag
+    end
+  end
+end

data/lib/roca/template.rb

@@ -0,0 +1,63 @@
+module Roca
+  class Template
+    include ConnectorHelper
+    extend  ConnectorHelper::ClassMethods
+
+    attr_reader :template_id, :user_id, :group_id, :user_name, :group_name, :name, :template
+
+    def self.find(template_id)
+      success_flag, xml_object_description, error_code = connector.execute("one.template.info", template_id)
+      success_flag ? Template.build_from_xml(xml_object_description) : false
+    end
+
+    def self.build_from_hash(attributes = {})
+      Template.new(attributes)
+    end
+
+    def self.build_from_xml(xml_description)
+      doc = Nokogiri::Slop(xml_description)
+
+      Template.build_from_hash(
+        template_id:  doc.VMTEMPLATE.ID.content.to_i,
+        user_id:      doc.VMTEMPLATE.UID.content.to_i,
+        group_id:     doc.VMTEMPLATE.GID.content.to_i,
+        user_name:    doc.VMTEMPLATE.UNAME.content,
+        group_name:   doc.VMTEMPLATE.GNAME.content,
+        name:         doc.VMTEMPLATE.NAME.content,
+        public:       !doc.VMTEMPLATE.PUBLIC.content.to_i.zero?,
+        regtime:      doc.VMTEMPLATE.REGTIME.content.to_i,
+        xml_template: doc.VMTEMPLATE.TEMPLATE.to_xml
+      )
+    end
+
+    def initialize(attributes = {})
+      @template_id  = attributes[:template_id]
+      @user_id      = attributes[:user_id]
+      @group_id     = attributes[:group_id]
+      @user_name    = attributes[:user_name]
+      @group_name   = attributes[:group_name]
+      @name         = attributes[:name]
+      @public       = attributes[:public]
+      @regtime      = attributes[:regtime]
+      @xml_template = attributes[:xml_template]
+    end
+
+    def instantiate(attributes = {})
+      virtual_machine_name = attributes[:virtual_machine_name] || ""
+      success_flag, virtual_machine_id, error_code = connector.execute("one.template.instantiate", template_id, virtual_machine_name)
+      success_flag ? virtual_machine_name : false
+    end
+
+    def public?
+      @public
+    end
+
+    def registration_time
+      @regtime_as_time_object ||= Time.at(@regtime)
+    end
+
+    def group
+      @group ||= Group.find(@group_id)
+    end
+  end
+end

data/lib/roca/template_pool.rb

@@ -0,0 +1,18 @@
+module Roca
+  class TemplatePool
+    include ConnectorHelper
+    extend  ConnectorHelper::ClassMethods
+
+    def self.all
+      success_flag, xml_templates, error_code = connector.execute("one.templatepool.info", -2, -1, -1)
+      result = []
+      if success_flag then
+        doc = Nokogiri::Slop(xml_templates)
+        doc.VMTEMPLATE_POOL.children.each do |xml_template|
+           result << Template.build_from_xml(xml_template.to_s)
+        end
+      end
+      result
+    end
+  end
+end

data/lib/roca/version.rb

@@ -0,0 +1,3 @@
+module Roca
+  VERSION = "0.0.1"
+end

data/lib/roca/virtual_machine.rb

@@ -0,0 +1,42 @@
+module Roca
+  class VirtualMachine
+    include ConnectorHelper
+    extend  ConnectorHelper::ClassMethods
+
+    def self.build_from_hash(attributes = {})
+      VirtualMachine.new(attributes)
+    end
+
+    def self.build_from_xml(xml_description)
+      doc = Nokogiri::Slop(xml_description)
+
+      VirtualMachine.build_from_hash(
+        virtual_machine_id:  doc.VM.ID.content.to_i,
+        user_id:             doc.VM.UID.content.to_i,
+        group_id:            doc.VM.GID.content.to_i,
+        user_name:           doc.VM.UNAME.content,
+        group_name:          doc.VM.GNAME.content,
+        name:                doc.VM.NAME.content,
+        last_poll:           doc.VM.LAST_POLL.content.to_i,
+        state:               doc.VM.STATE.content.to_i,
+        lcm_state:           doc.VM.LCM_STATE.content.to_i,
+        stime:               doc.VM.STIME.content.to_i,
+        etime:               doc.VM.ETIME.content.to_i
+      )
+    end
+
+    def initialize(attributes = {})
+      @virtual_machine_id = attributes[:virtual_machine_id],
+      @user_id            = attributes[:user_id],
+      @group_id           = attributes[:group_id],
+      @user_name          = attributes[:user_name],
+      @group_name         = attributes[:group_name],
+      @name               = attributes[:name],
+      @last_poll          = attributes[:last_poll],
+      @state              = attributes[:state],
+      @lcm_state          = attributes[:lcm_state],
+      @stime              = attributes[:stime],
+      @etime              = attributes[:etime]
+    end
+  end
+end

data/lib/roca.rb

@@ -0,0 +1,16 @@
+# require "roca/version"
+require "nokogiri"
+require "xmlrpc/client"
+
+module Roca
+  autoload :Connector,       "roca/connector"
+  autoload :ConnectorHelper, "roca/connector_helper"
+  autoload :Group,           "roca/group"
+  autoload :Template,        "roca/template"
+  autoload :TemplatePool,    "roca/template_pool"
+  # autoload :Host,            "roca/host"
+  # autoload :Image,           "roca/image"
+  # autoload :User,            "roca/user"
+  # autoload :VirtualMachine,  "roca/virtual_machine"
+  # autoload :VirtualNetwork,  "roca/virtual_network"
+end

data/roca.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "roca/version"
+
+Gem::Specification.new do |s|
+  s.name        = "roca"
+  s.version     = Roca::VERSION
+  s.authors     = ["Nicolai Reuschling"]
+  s.email       = ["gemdev@reuschling.name"]
+  s.homepage    = ""
+  s.summary     = %q{Ruby library for OpenNebula's XML-RPC API}
+  s.description = %q{This is a very experimental Ruby library for OpenNebula's XML-RPC API}
+
+  s.required_ruby_version = ">= 1.9.3"
+  # s.rubyforge_project = "roca"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "autotest"
+  s.add_development_dependency "autotest-fsevent"
+  s.add_development_dependency "autotest-growl"
+  s.add_development_dependency "simplecov"
+  s.add_runtime_dependency     "activesupport"
+  s.add_runtime_dependency     "nokogiri"
+end

data/spec/connector_helper_spec.rb

@@ -0,0 +1,5 @@
+require "spec_helper"
+
+describe "ConnectorHelper" do
+  pending
+end

data/spec/connector_spec.rb

@@ -0,0 +1,5 @@
+require "spec_helper"
+
+describe "Connector" do
+  pending
+end

data/spec/group_spec.rb

@@ -0,0 +1,42 @@
+require "spec_helper"
+
+describe "Group" do
+  it "should keep a name and group_id" do
+    group = Group.new(name: "group name", group_id: 105)
+    group.name.should == "group name"
+    group.group_id.should == 105
+  end
+
+  it "should create a group" do
+    Group.connector = double(Connector, :execute => [true, 105, 0])
+
+    group = Group.create(name: "group name")
+    group.group_id.should == 105
+    group.name.should == "group name"
+  end
+
+  it "should find a specific group" do
+    Group.connector = double(Connector, :execute => [true, "<GROUP><ID>105</ID><NAME>group name</NAME><USERS/></GROUP>", 0])
+
+    group = Group.find(105)
+    group.group_id.should == 105
+    group.name.should == "group name"
+  end
+
+  it "can be deleted" do
+    fake_connector = double(Connector)
+    fake_connector.should_receive(:execute)
+                  .with("one.group.delete", 105)
+                  .and_return([true, "<GROUP><ID>105</ID><NAME>group name</NAME><USERS/></GROUP>", 0])
+    Group.connector = fake_connector
+
+    group = Group.new(name: "group name", group_id: 105)
+    group.delete
+  end
+
+  it "should parse an XML group description to a new Group instance" do
+    group = Group.build_from_xml "<GROUP><ID>105</ID><NAME>group name</NAME><USERS/></GROUP>"
+    group.group_id.should == 105
+    group.name.should == "group name"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require "simplecov"
+SimpleCov.start
+
+Bundler.require(:default, :development)
+
+include Roca

data/spec/template_spec.rb

@@ -0,0 +1,14 @@
+require "spec_helper"
+
+describe "Template" do
+  it "should parse an XML group description to a new Group instance" do
+    template = Template.build_from_xml("<VMTEMPLATE><ID>99</ID><UID>1</UID><GID>2</GID><UNAME>user name</UNAME><GNAME>group name</GNAME><NAME>template name</NAME><PUBLIC>0</PUBLIC><REGTIME>1326974817</REGTIME><TEMPLATE><CONTEXT><HOSTNAME><![CDATA[$NAME]]></HOSTNAME><PRIV_BC><![CDATA[192.168.2.255]]></PRIV_BC><PRIV_IP><![CDATA[$NIC[IP,NETWORK_ID=\"1\"]]]></PRIV_IP><PRIV_NM><![CDATA[255.255.255.0]]></PRIV_NM><PRIV_NW><![CDATA[192.168.2.0]]></PRIV_NW><PUB_BC><![CDATA[8.8.8.8]]></PUB_BC><PUB_GW><![CDATA[8.8.8.8]]></PUB_GW><PUB_IP><![CDATA[$NIC[IP,NETWORK_ID=\"1\"]]]></PUB_IP><PUB_NM><![CDATA[255.255.255.240]]></PUB_NM><PUB_NS><![CDATA[8.8.8.8]]></PUB_NS><PUB_NW><![CDATA[8.8.8.8]]></PUB_NW></CONTEXT><CPU><![CDATA[0.5]]></CPU><DISK><BUS><![CDATA[virtio]]></BUS><READONLY><![CDATA[no]]></READONLY><SOURCE><![CDATA[/var/lib/one/images/image.img]]></SOURCE><TARGET><![CDATA[blubber]]></TARGET></DISK><FEATURES><ACPI><![CDATA[no]]></ACPI></FEATURES><GRAPHICS><LISTEN><![CDATA[127.0.0.1]]></LISTEN><TYPE><![CDATA[vnc]]></TYPE></GRAPHICS><MEMORY><![CDATA[512]]></MEMORY><NAME><![CDATA[testvm4_vm]]></NAME><NIC><MODEL><![CDATA[virtio]]></MODEL><NETWORK_ID><![CDATA[1]]></NETWORK_ID></NIC><NIC><MODEL><![CDATA[virtio]]></MODEL><NETWORK_ID><![CDATA[1]]></NETWORK_ID></NIC><OS><ARCH><![CDATA[x86_64]]></ARCH><BOOT><![CDATA[hd]]></BOOT></OS><RAW><TYPE><![CDATA[kvm]]></TYPE></RAW><TEMPLATE_ID><![CDATA[10]]></TEMPLATE_ID><VCPU><![CDATA[1]]></VCPU></TEMPLATE></VMTEMPLATE>")
+    template.template_id.should == 99
+    template.user_id.should == 1
+    template.group_id.should == 2
+    template.user_name.should == "user name"
+    template.group_name.should == "group name"
+    template.name.should == "template name"
+    template.registration_time.should == Time.at(1326974817)
+  end
+end

data/spec/version_spec.rb

@@ -0,0 +1,7 @@
+require "spec_helper"
+
+describe "Gem version" do
+  it "should be 0.0.1" do
+    Roca::VERSION.should == "0.0.1"
+  end
+end

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: roca
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Nicolai Reuschling
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70295818659180 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70295818659180
+- !ruby/object:Gem::Dependency
+  name: autotest
+  requirement: &70295818658400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70295818658400
+- !ruby/object:Gem::Dependency
+  name: autotest-fsevent
+  requirement: &70295818657700 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70295818657700
+- !ruby/object:Gem::Dependency
+  name: autotest-growl
+  requirement: &70295818657000 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70295818657000
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &70295818656100 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70295818656100
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: &70295818662560 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70295818662560
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: &70295818661440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70295818661440
+description: This is a very experimental Ruby library for OpenNebula's XML-RPC API
+email:
+- gemdev@reuschling.name
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .autotest
+- .gitignore
+- .rspec
+- Gemfile
+- Rakefile
+- lib/roca.rb
+- lib/roca/connector.rb
+- lib/roca/connector_helper.rb
+- lib/roca/group.rb
+- lib/roca/template.rb
+- lib/roca/template_pool.rb
+- lib/roca/version.rb
+- lib/roca/virtual_machine.rb
+- roca.gemspec
+- spec/.gitkeep
+- spec/connector_helper_spec.rb
+- spec/connector_spec.rb
+- spec/group_spec.rb
+- spec/spec_helper.rb
+- spec/template_spec.rb
+- spec/version_spec.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: Ruby library for OpenNebula's XML-RPC API
+test_files:
+- spec/connector_helper_spec.rb
+- spec/connector_spec.rb
+- spec/group_spec.rb
+- spec/spec_helper.rb
+- spec/template_spec.rb
+- spec/version_spec.rb