simple_stack 0.0.28 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 564184d6c196cb5f443bc0ceda251d9c2b7e68f5
-  data.tar.gz: ac515a412f16537fb71f22119073c48ad732743d
+  metadata.gz: ec7852762d8fb5388f29dbcb6d0c889958c4409e
+  data.tar.gz: 9b6c5482c4d1ff94cf126a6656292b8bf92f5f69
 SHA512:
-  metadata.gz: 8a0f4da480ab25fd95b088984a31872c61be55a5edfd048c1ed603d5a05a7e5717dd52759f5d53b35567c8b0494c845708975e20ba5bcb12d07ceb4cefc8b40f
-  data.tar.gz: 4d5bb43f57d3709ca6a559d669a88a9a7610c5cd5467cc089899a3f8c110f616d573a8a807466e1ca139e48399fc1812ff6a8c4e2dec3ba9938aae5578c37e21
+  metadata.gz: 4cf1159e2b0ba0c68cd11bd2f587e314959a37e5999b69683af636fb790efe93e76c25e6ca5acafdc2cb694e2bb8073ffaadee48128f5c70cd3db142838f0d15
+  data.tar.gz: 0572cb6541a74fa415a9c836b18e54dd5581465fb07ef5e9eedf5b95ed24342b285688046cb5b44d39ab67ac8490c72db775b45e77e8e8fadd870efd148fc508

data/Gemfile

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

data/README.markdown

@@ -0,0 +1,72 @@
+Simplestack ruby client
+=======================
+
+A simple gem to deal with Simple Stack project.
+
+Get a simplestack class:
+
+    stack = SimpleStack::Connection.new :url => url, :username => username, :password => password
+
+Connecting to hypervisor:
+
+    vmware = stack.connect_to("vmware", :host => host, :username => username, :password => password)
+
+Pool informations:
+
+    vmware.info
+    vmware.guests
+
+    # TODO:
+    # vmware.used_memory
+    # vmware.total_memory
+    # vmware.import vm_file
+
+Working with Guests
+-------------------
+
+    guest = vmware.guests.find(vm.uuid)
+    guest.info
+    guest.update(:name => "Guest name", :memory => 512)
+    guest.delete
+
+Shutdown and power on and reboot
+
+    guest.stop
+    guest.start
+    guest.reboot
+
+Force the guest shutdown
+
+    guest.force_stop
+
+Resume and suspend guests
+
+    guest.resume
+    guest.pause
+
+TODO:
+
+    file = guest.export :to => file_path
+
+Snapshots
+---------
+
+List snapshots
+
+    guest.snapshots
+
+Find a snapshot
+
+    guest.snapshots.find(snap.uuid)
+
+Create a new snapshot
+
+    snap = guest.snapshots.create :name => :snapshot_name
+
+Delete a snapshot
+
+    snap.delete
+
+Revert a snapshot
+
+    snap.use

data/Rakefile

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

data/lib/simple_stack/cacheable.rb

@@ -0,0 +1,24 @@
+module SimpleStack
+  module Cacheable
+    def reload
+      @cached_attributes = {}
+      self
+    end
+
+    def cacheable?
+      if respond_to? :connection
+        connection.cache_enabled
+      else
+        false
+      end
+    end
+
+    def cached_attributes
+      if cacheable?
+        @cached_attributes ||= {}
+      else
+        {}
+      end
+    end
+  end
+end

data/lib/simple_stack/collection.rb

@@ -0,0 +1,45 @@
+module SimpleStack
+  class Collection
+    include SimpleStack::Cacheable
+
+    attr_accessor :hypervisor, :parent, :url, :clazz
+
+    def initialize(hypervisor, parent, url, clazz)
+      self.hypervisor = hypervisor
+      self.parent = parent
+      self.url = url.to_s
+      self.clazz = clazz
+    end
+
+    def to_a
+      cached_attributes[:items] ||= hypervisor.get(url).map do |item|
+        clazz.new hypervisor, self, "#{url}/#{item["id"]}"
+      end
+    end
+
+    def find(id)
+      clazz.new hypervisor, self, "#{url}/#{id}"
+    end
+
+    def create(options={})
+      response = hypervisor.post(url, options)
+      entity_path = response.headers["location"].sub(/^\//, "").sub(/\/$/, "")
+      entity_url = "#{connection.url}/#{entity_path}"
+      new_item = clazz.new hypervisor, self, entity_url
+      reload if cacheable?
+      new_item
+    end
+
+    def method_missing(method, *args, &block)
+      to_a.send(method, *args, &block)
+    end
+
+    def inspect
+      to_a.inspect
+    end
+
+    def connection
+      hypervisor.connection
+    end
+  end
+end

data/lib/simple_stack/connection.rb

@@ -0,0 +1,21 @@
+module SimpleStack
+  class Connection
+    attr_accessor :url, :graceful_degradation, :cache_enabled, :timeout, :read_timeout
+
+    def initialize(options = {})
+      self.url = options[:url].to_s.sub(/\/$/, "")
+      self.graceful_degradation = options[:graceful_degradation]
+      self.cache_enabled = options[:cache_enabled]
+      self.timeout = options[:timeout] || 60
+      self.read_timeout = options[:read_timeout] || timeout
+    end
+
+    def connect_to(type, options)
+      SimpleStack::Hypervisor.new self, type, options
+    end
+
+    def token
+      "TODO"
+    end
+  end
+end

data/lib/simple_stack/disk.rb

@@ -0,0 +1,4 @@
+module SimpleStack
+  class Disk < Entity
+  end
+end

data/lib/simple_stack/entity.rb

@@ -0,0 +1,44 @@
+module SimpleStack
+  class Entity
+    include SimpleStack::Cacheable
+
+    attr_accessor :hypervisor, :parent, :url
+
+    def initialize(hypervisor, parent, url)
+      self.hypervisor = hypervisor
+      self.parent = parent
+      self.url = url.to_s
+    end
+
+    def info
+      cached_attributes[:info] ||= hypervisor.get(url).parsed_response
+    end
+
+    def update(attributes = {})
+      hypervisor.put url, attributes
+    end
+
+    def delete
+      response = hypervisor.delete url
+      parent.reload if cacheable?
+      response
+    end
+
+    def inspect
+      "#<#{self.class} info=#{info.to_json}>"
+    end
+
+    def connection
+      hypervisor.connection
+    end
+
+    def method_missing(method, *args, &block)
+      entity_info = info
+      if entity_info.keys.include?(method.to_s)
+        entity_info[method.to_s]
+      else
+        super
+      end
+    end
+  end
+end

data/lib/simple_stack/exception.rb

@@ -0,0 +1,87 @@
+module SimpleStack
+  class Exception < ::Exception
+    def self.factory(error)
+      return Exception.new(error.inspect) if !error.is_a?(Hash)
+      case error["error"]
+      when "EntityNotFound"
+        EntityNotFound.new(error["message"])
+      when "FeatureNotImplemented"
+        NotImplemented.new(error["message"])
+      when "FeatureNotAvailable"
+        NotImplemented.new(error["message"])
+      when "HypervisorError"
+        HypervisorError.new(error["message"])
+      else
+        Exception.new(error.inspect)
+      end
+    end
+  end
+
+  class EntityNotFound < Exception
+  end
+
+  class HypervisorError < Exception
+  end
+
+  class NotImplemented < Exception
+  end
+
+  class GracefulObject
+    def [](key)
+      GracefulObject.new
+    end
+
+    def []=(key, value)
+      GracefulObject.new
+    end
+
+    def +(other)
+      other + self
+    end
+
+    def -(other)
+      -(other - self)
+    end
+
+    def *(other)
+      other * self
+    end
+
+    def to_i
+      0
+    end
+
+    def to_f
+      0.0
+    end
+
+    def to_str
+      "GracefulObject"
+    end
+    alias :to_s :to_str
+
+    def to_ary
+      []
+    end
+    alias :to_a :to_ary
+
+    def to_hash
+      {}
+    end
+
+    def coerce(other)
+      coerced = if other.is_a? Fixnum
+        self.to_i
+      elsif other.is_a? String
+        self.to_s
+      elsif other.is_a? Array
+        self.to_a
+      elsif other.is_a? Hash
+        self.to_hash
+      else
+        nil
+      end
+      [coerced, other]
+    end
+  end
+end

data/lib/simple_stack/guest.rb

@@ -0,0 +1,86 @@
+module SimpleStack
+  class Guest < Entity
+    def disks
+      cached_attributes[:disks] ||= SimpleStack::Collection.new hypervisor, self, "#{url}/disks", SimpleStack::Disk
+    end
+
+    def network_interfaces
+      cached_attributes[:network_interfaces] ||= SimpleStack::Collection.new hypervisor, self, "#{url}/network_interfaces", SimpleStack::NetworkInterface
+    end
+
+    def snapshots
+      cached_attributes[:snapshots] ||= SimpleStack::Collection.new hypervisor, self, "#{url}/snapshots", SimpleStack::Snapshot
+    end
+
+    def tags
+      cached_attributes[:tags] ||= hypervisor.get("#{url}/tags").parsed_response
+    end
+
+    def add_tag(tag)
+      hypervisor.post "#{url}/tags", :name => tag
+      reload if cacheable?
+      tag
+    end
+
+    def remove_tag(tag)
+      hypervisor.delete "#{url}/tags/#{tag}"
+      reload if cacheable?
+      tag
+    end
+
+    def reboot(opts={:force => false})
+      hypervisor.put "#{url}/reboot", :force => opts[:force]
+    end
+
+    def export(opts={})
+      opts = {:to => "/tmp/export_file"}.merge(opts)
+      file = File.open(opts[:to], "wb")
+
+      hypervisor.get_stream("#{url}/export", file)
+
+      opts[:to]
+    ensure
+      file.close rescue nil
+    end
+
+    def revert_to(snapshot)
+      snapshot.revert
+    end
+
+    def clone(opts={})
+      response = hypervisor.post("#{url}/clone", opts)
+      entity_path = response.headers["location"].sub(/^\//, "").sub(/\/$/, "")
+      entity_url = "#{connection.url}/#{entity_path}"
+      new_item = SimpleStack::Guest.new hypervisor, self, entity_url
+    end
+
+    def insert_media(media_name, opts={})
+      media_options = opts.merge(:name => media_name)
+      hypervisor.put("#{url}/media_device", media_options)
+      reload if cacheable?
+    end
+
+    def eject_media
+      hypervisor.put("#{url}/media_device", :name => nil)
+      reload if cacheable?
+    end
+
+    def inserted_media
+      if cached_attributes.key? :inserted_media
+        cached_attributes[:inserted_media]
+      else
+        cached_attributes[:inserted_media] = hypervisor.get("#{url}/media_device").parsed_response["name"]
+      end
+    end
+
+    def power_state=(state)
+      hypervisor.put "#{url}/power", :state => state
+    end
+
+    ["start", "stop", "force_stop", "pause", "resume"].each do |state|
+      define_method(state) do
+        self.power_state = state
+      end
+    end
+  end
+end

data/lib/simple_stack/host.rb

@@ -0,0 +1,4 @@
+module SimpleStack
+  class Host < Entity
+  end
+end

data/lib/simple_stack/hypervisor.rb

@@ -0,0 +1,130 @@
+module SimpleStack
+  class Hypervisor
+    include SimpleStack::Cacheable
+
+    attr_accessor :connection, :type, :host, :username, :password
+
+    def initialize(connection, type, options)
+      self.connection = connection
+      self.type = type
+      self.host = options[:host]
+      self.username = options[:username]
+      self.password = options[:password]
+    end
+
+    def url
+      "#{connection.url}/#{type}/#{host}"
+    end
+
+    def headers
+      {
+        "x-simplestack-version" => "1.0",
+        "x-simplestack-token"   => connection.token,
+        "x-simplestack-hypervisor-token" => token,
+        "Content-Type" => "application/json"
+      }
+    end
+
+    def http_options
+      {
+        :timeout => connection.timeout,
+        :read_timeout => connection.read_timeout,
+        :no_follow => true,
+        :headers => headers
+      }
+    end
+
+    def token
+      Base64.encode64("#{username}:#{password}").split("\n").join("")
+    end
+
+    def info
+      cached_attributes[:info] ||= self.get url
+    end
+
+    def hosts
+      cached_attributes[:hosts] ||= SimpleStack::Collection.new self, self, "#{url}/hosts", SimpleStack::Host
+    end
+
+    def storages
+      cached_attributes[:storages] ||= SimpleStack::Collection.new self, self, "#{url}/storages", SimpleStack::Storage
+    end
+
+    def guests
+      cached_attributes[:guests] ||= SimpleStack::Collection.new self, self, "#{url}/guests", SimpleStack::Guest
+    end
+
+    def import(opts={})
+      file = File.open(opts[:from], "rb")
+
+      response = post_stream("#{url}/guests", file)
+      entity_path = response["location"].sub(/^\//, "").sub(/\/$/, "")
+      entity_url = "#{connection.url}/#{entity_path}"
+      SimpleStack::Guest.new self, guests.reload, entity_url
+    ensure
+      file.close rescue nil
+    end
+
+    def get(url)
+      http_call { HTTParty.get(url, http_options) }
+    end
+
+    def get_stream(url, io)
+      uri  = URI.parse url
+      http = Net::HTTP.new(uri.host, uri.port)
+      request = Net::HTTP::Get.new(uri.path)
+
+      headers.each_pair do |k, v|
+        request.add_field(k, v)
+      end
+
+      http.request(request) do |res|
+        res.read_body {|chunk| io.write chunk }
+      end
+    end
+
+    def post(url, body)
+      http_call { HTTParty.post(url, http_options.merge(:body => JSON.dump(body))) }
+    end
+
+    def put(url, body)
+      http_call { HTTParty.put(url, http_options.merge(:body => JSON.dump(body))) }
+    end
+
+    def post_stream(url, io)
+      uri  = URI.parse url
+      http = Net::HTTP.new(uri.host, uri.port)
+      request = Net::HTTP::Post.new(uri.path, {})
+
+      headers.each_pair do |k, v|
+        request.add_field(k, v)
+      end
+
+      request.body_stream = io
+      request.content_length = io.size
+      response = http.request(request)
+
+      if response.code.to_i >= 400
+        parsed_response = JSON.load(response.body) rescue response.body
+        raise SimpleStack::Exception.factory(parsed_response)
+      end
+
+      response
+    end
+
+    def delete(url)
+      http_call { HTTParty.delete(url, http_options) }
+    end
+
+    def http_call
+      response = yield
+      return SimpleStack::GracefulObject.new if response.code == 501 && connection.graceful_degradation
+      raise SimpleStack::Exception.factory(response.parsed_response) if response.code >= 400
+      response
+    end
+
+    def inspect
+      "#<#{self.class} url=#{url}>"
+    end
+  end
+end

data/lib/simple_stack/network_interface.rb

@@ -0,0 +1,4 @@
+module SimpleStack
+  class NetworkInterface < Entity
+  end
+end

data/lib/simple_stack/snapshot.rb

@@ -0,0 +1,11 @@
+module SimpleStack
+  class Snapshot < Entity
+    def use
+      revert
+    end
+
+    def revert
+      hypervisor.put "#{url}/revert", {}
+    end
+  end
+end

data/lib/simple_stack/storage.rb

@@ -0,0 +1,14 @@
+module SimpleStack
+  class Storage < Entity
+    def import(opts={})
+      file = File.open(opts[:from], "rb")
+
+      response = hypervisor.post_stream("#{url}/guests", file)
+      entity_path = response["location"].sub(/^\//, "").sub(/\/$/, "")
+      entity_url = "#{connection.url}/#{entity_path}"
+      SimpleStack::Guest.new hypervisor, hypervisor.guests.reload, entity_url
+    ensure
+      file.close rescue nil
+    end
+  end
+end

data/lib/simple_stack/version.rb

@@ -0,0 +1,3 @@
+module SimpleStack
+  VERSION = "0.1.0"
+end

data/lib/simple_stack.rb

@@ -0,0 +1,22 @@
+require "json"
+require "base64"
+require "httparty"
+require "simple_stack/version"
+require "simple_stack/exception"
+require "simple_stack/connection"
+require "simple_stack/cacheable"
+require "simple_stack/collection"
+require "simple_stack/hypervisor"
+require "simple_stack/entity"
+require "simple_stack/host"
+require "simple_stack/storage"
+require "simple_stack/guest"
+require "simple_stack/snapshot"
+require "simple_stack/network_interface"
+require "simple_stack/disk"
+
+module SimpleStack
+  def self.client
+    HTTParty
+  end
+end

data/simple_stack.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "simple_stack/version"
+
+Gem::Specification.new do |s|
+  s.name        = "simple_stack"
+  s.version     = SimpleStack::VERSION
+  s.authors     = ["Thiago Morello", "Willian Molinari"]
+  s.email       = ["thiago.morello@locaweb.com.br", "willian.molinari@locaweb.com.br"]
+  s.homepage    = "https://github.com/locaweb/ruby-simplestack-client"
+  s.summary     = %q{A simple gem to work with simplestack project}
+  s.description = s.summary
+
+  s.rubyforge_project = "simple_stack"
+
+  s.files = Dir["{lib}/**/*"] + ["Rakefile", "README.markdown", "Gemfile", "simple_stack.gemspec"]
+  s.executables   = s.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  s.test_files    = s.files.grep(%r{^(test|spec|features)/})
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec"
+  s.add_runtime_dependency "httparty"
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: simple_stack
 version: !ruby/object:Gem::Version
-  version: 0.0.28
+  version: 0.1.0
 platform: ruby
 authors:
 - Thiago Morello
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-09-03 00:00:00.000000000 Z
+date: 2013-09-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -46,7 +46,25 @@ email:
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- lib/simple_stack/snapshot.rb
+- lib/simple_stack/exception.rb
+- lib/simple_stack/network_interface.rb
+- lib/simple_stack/version.rb
+- lib/simple_stack/disk.rb
+- lib/simple_stack/collection.rb
+- lib/simple_stack/connection.rb
+- lib/simple_stack/hypervisor.rb
+- lib/simple_stack/entity.rb
+- lib/simple_stack/storage.rb
+- lib/simple_stack/host.rb
+- lib/simple_stack/cacheable.rb
+- lib/simple_stack/guest.rb
+- lib/simple_stack.rb
+- Rakefile
+- README.markdown
+- Gemfile
+- simple_stack.gemspec
 homepage: https://github.com/locaweb/ruby-simplestack-client
 licenses: []
 metadata: {}