ravello-sdk 0.9

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8e22bc14b505f0312ca1ec12dab8dc3ccaaebfce
+  data.tar.gz: 4f0a9072a6547b515dc3afb55e1c2e7b19b02cf8
+SHA512:
+  metadata.gz: e4f35dbecf51404a26d46851e67ec46a417940aeca29d6143ea6d2dc4900b74f89959c460e3d80bd5531f761603c58cbd4128fa56bc9581543d14dae62413b6d
+  data.tar.gz: 55c6a7da642fe7d0f70136e28285e82d55cb7eea6073563ef43a6fce74ef4ad60b661c5b3d8156e57c8a2f75ac0d3e6448738ecf16226ea7dbf599d12b887573

data/lib/ravello-sdk.rb

@@ -0,0 +1,427 @@
+require "uri"
+require "json"
+require "logger"
+require "base64"
+require "net/http"
+
+
+class Net::HTTPResponse
+
+  def entity
+    @entity if defined? @entity
+  end
+
+  def entity=(value)
+    @entity = value
+  end
+
+end
+
+module Ravello
+
+  DEFAULT_URL = "https://cloud.ravellosystems.com/services"
+
+  @@prng = Random.new
+
+  def deep_copy(o)
+    Marshal.load(Marshal.dump(o))
+  end
+
+  def random_luid
+    @@prng.rand 1<<63
+  end
+
+  def update_luids!(o)
+    if o.is_a? Hash
+      o.each_pair do |key,value|
+        o[key] = if key == 'id' then random_luid else update_luids! value end
+      end
+    elsif o.is_a? Array
+      o.map! do |x| update_luids! x end
+    end
+    o
+  end
+
+  def update_luids(o)
+    update_luids!(deep_copy o)
+  end
+
+  def application_state(app)
+    if !app.is_a? Hash
+      raise ArgumentError, "expecting a Hash, got #{app}"
+    elsif !app['deployment'].is_a? Hash
+      return  nil
+    elsif !app['deployment']['vms'].is_a? Array
+      return nil
+    end
+    states = app['deployment']['vms'].map { |vm| vm['state'] } .uniq
+    if states.length == 1 then states[0] else states end
+  end
+
+  module_function :deep_copy, :random_luid, :update_luids, :update_luids!
+
+  class Client
+
+    attr_accessor :retries, :timeout
+    attr_reader :url, :user_info
+
+    def initialize(options={})
+      @username = options[:username]
+      @password = options[:password]
+      @retries = options.fetch(:retries, 3)
+      @timeout = options.fetch(:timeout, 60)
+      @logger = Logger.new(STDERR)
+      @logger.level = if $DEBUG then Logger::DEBUG \
+                        elsif $VERBOSE then Logger::INFO else Logger::WARN end
+      @redirects = 3
+      @autologin = true
+      @cookies = nil
+      @user_info = nil
+      @connection = nil
+      set_url(options.fetch(:url, DEFAULT_URL))
+    end
+
+    def connected?
+      !@connection.nil?
+    end
+
+    def closed?
+      @connection.nil?
+    end
+
+    def logged_in?
+      !@cookies.nil?
+    end
+
+    def url=(url)
+      set_url(url)
+    end
+
+    def connect(url=nil)
+      url = url unless url.nil?
+      do_connect
+    end
+
+    def login(username=nil, password=nil)
+      raise "already logged in" if logged_in?
+      @username = username unless username.nil?
+      @password = password unless password.nil?
+      raise "username and password must be set" unless have_credentials?
+      do_login
+    end
+
+    def logout
+      do_logout if logged_in?
+    end
+
+    def close
+      @connection.finish if !@connection.nil?
+      @connection = nil
+      @cookies = nil
+    end
+
+    def request(method, path, entity=nil)
+      body = JSON.generate(entity) unless entity.nil?
+      response = make_request(method, path, body)
+      response.entity
+    end
+
+    def wait_for(obj, timeout, &block)
+      end_time = Time.now + timeout
+      raise 'object requires a "href" key' if !obj.key? 'href'
+      href = obj['href']
+      while end_time >= Time.now do
+        break if yield request(:GET, href)
+        sleep 5
+      end
+      raise 'timeout' if end_time < Time.now
+    end
+
+    def get_application(id)
+      if id.is_a? Hash then id = id['id'] end
+      request(:GET, "/applications/#{id}")
+    end
+
+    def get_applications(filter={})
+      result = request(:GET, '/applications')
+      result.select! do |app| match_filter(app, filter) end if !filter.empty?
+      result
+    end
+
+    def create_application(app)
+      request(:POST, '/applications', app)
+    end
+
+    def update_application(app)
+      request(:PUT, "/applications/#{app['id']}", app)
+    end
+
+    def delete_application(id)
+      if id.is_a? Hash then id = id['id'] end
+      request(:DELETE, "/applications/#{id}")
+    end
+
+    def publish_application(id, req={})
+      if id.is_a? Hash then id = id['id'] end
+      request(:POST, "/applications/#{id}/publish", req)
+    end
+
+    def start_application(id)
+      if id.is_a? Hash then id = id['id'] end
+      request(:POST, "/applications/#{id}/start")
+    end
+
+    def stop_application(id)
+      if id.is_a? Hash then id = id['id'] end
+      request(:POST, "/applications/#{id}/stop")
+    end
+
+    def restart_application(id)
+      if id.is_a? Hash then id = id['id'] end
+      request(:POST, "/applications/#{id}/restart")
+    end
+
+    def publish_application_updates(id)
+      if id.is_a? Hash then id = id['id'] end
+      request(:POST, "/applications/#{id}/publishUpdates")
+    end
+
+    def set_application_expiration(id, req)
+      if id.is_a? Hash then id = id['id'] end
+      request(:POST, "/applications/#{id}/setExpiration", req)
+    end
+
+    def start_vm(appid, vmid)
+      if appid.is_a? Hash then appid = appid['id'] end
+      if vmid.is_a? Hash then vmid = vmid['id'] end
+      request(:POST, "/applications/#{appid}/vms/#{vmid}/start")
+    end
+
+    def stop_vm(appid, vmid)
+      if appid.is_a? Hash then appid = appid['id'] end
+      if vmid.is_a? Hash then vmid = vmid['id'] end
+      request(:POST, "/applications/#{appid}/vms/#{vmid}/stop")
+    end
+
+    def restart_vm(appid, vmid)
+      if appid.is_a? Hash then appid = appid['id'] end
+      if vmid.is_a? Hash then vmid = vmid['id'] end
+      request(:POST, "/applications/#{appid}/vms/#{vmid}/restart")
+    end
+
+    def get_blueprint(id)
+      if id.is_a? Hash then id = id['id'] end
+      request(:GET, "/blueprints/#{id}")
+    end
+
+    def get_blueprints(filter={})
+      result = request(:GET, '/blueprints')
+      result.select! do |bp| match_filter(bp, filter) end if !filter.empty?
+      result
+    end
+
+    def create_blueprint(req)
+      request(:POST, '/blueprints', req)
+    end
+
+    def delete_blueprint(id)
+      if id.is_a? Hash then id = id['id'] end
+      request(:DELETE, "/blueprints/#{id}")
+    end
+    
+    def get_image(id)
+      if id.is_a? Hash then id = id['id'] end
+      request(:GET, "/images/#{id}")
+    end
+
+    def get_images(filter={})
+      result = request(:GET, '/images')
+      result.select! do |img| match_filter(img, filter) end if !filter.empty?
+      result
+    end
+
+    def update_image(image)
+      request(:PUT, "/images/#{image['id']}", image)
+    end
+
+    def delete_image(id)
+      if id.is_a? Hash then id = id['id'] end
+      request(:DELETE, "/images/#{id}")
+    end
+
+    def get_keypair(id)
+      if id.is_a? Hash then id = id['id'] end
+      request(:GET, "/keypairs/#{id}")
+    end
+
+    def get_keypairs(filter={})
+      result = request(:GET, '/keypairs')
+      result.select! do |kp| match_filter(kp, filter) end if !filter.empty?
+      result
+    end
+
+    def create_keypair(keypair)
+      request(:POST, '/keypairs', keypair)
+    end
+
+    def update_keypair(keypair)
+      request(:PUT, "/keypairs/#{keypair['id']}", keypair)
+    end
+
+    def delete_keypair(id)
+      if id.is_a? Hash then id = id['id'] end
+      request(:DELETE, "/keypairs/#{id}")
+    end
+
+    def generate_keypair
+      request(:POST, '/keypairs/generate')
+    end
+
+    def inspect
+      "#<RavelloClient:#{object_id}>"
+    end
+
+  private
+
+    def set_url(url)
+      raise 'cannot change URL when connected' if !closed?
+      parsed = URI.parse(url.chomp '/')
+      raise ArgumentError, 'https is required' if parsed.scheme != "https"
+      @url = parsed
+    end
+
+    def have_credentials?
+      !@username.nil? && !@password.nil?
+    end
+
+    def do_connect()
+      @connection = Net::HTTP.new(url.host, url.port)
+      @connection.use_ssl = true
+      @connection.set_debug_output $stderr if $DEBUG
+      @connection.start
+      @logger.debug("connected to #{url.host}:#{url.port}")
+    end
+
+    def do_login()
+      raise "should have credentials" if not have_credentials?
+      @logger.debug('performing a username/password login')
+      @autologin = false
+      auth = Base64.encode64("#{@username}:#{@password}").strip
+      headers = [['Authorization', "Basic #{auth}"]]
+      response = make_request(:POST, '/login', nil, headers)
+      cookies = response.get_fields('Set-Cookie')
+      @cookies = cookies.map{ |v| v.split(';')[0]}.join(', ')
+      @autologin = true
+      @user_info = response.entity
+    end
+
+    def do_logout
+      make_request(:POST, '/logout')
+      @cookies = nil
+    end
+
+    def make_request(method, path, body=nil, headers=nil)
+      uri = @url.merge(@url.path + path)
+      case method
+      when :GET
+        request = Net::HTTP::Get.new uri
+      when :POST
+        request = Net::HTTP::Post.new uri
+      when :DELETE
+        request = Net::HTTP::Delete.new uri
+      when :PUT
+        request = Net::HTTP::Put.new uri
+      when :PATCH
+        request = New::HTTP::Patch.new uri
+      else
+        raise ArgumentError, "unknown method: #{method.to_s}"
+      end
+      request['Accept'] = 'application/json'
+      request['Cookie'] = @cookies unless @cookies.nil?
+      request['Accept-Encoding'] = 'identity' if $DEBUG
+      headers.each { |kv| request.add_field(kv[0], kv[1]) } unless headers.nil?
+      request.body = body
+      request.content_type = 'application/json'
+      do_request(request)
+    end
+
+    def idempotent(request)
+      [:GET, :HEAD, :PUT].include? request.method
+    end
+
+    def do_request(request)
+      retries = redirects = 0
+      while retries < @retries and redirects < @redirects do
+        do_connect if !connected?
+        do_login if @autologin && have_credentials? && !logged_in?
+        begin
+          @logger.info("request: #{request.method} #{request.path}")
+          response = @connection.request(request)
+          @logger.info("response: #{response.code} #{response.message}")
+          case response.code.to_i
+          when 200..299
+            body = response.read_body
+            ctype = response.content_type
+            entity = JSON.parse(body) if ctype == 'application/json'
+            if entity.is_a?(Hash) && !entity['id'].nil? then
+              if response.key? 'Content-Location'
+                href = URI.parse(response['Content-Location']).path
+              elsif response.key? 'Location'
+                href = URI.parse(response['Location']).path
+              elsif request.method == 'POST'
+                # missing location header with e.g. /pubkeys
+                href = "#{request.uri.path}/#{entity['id']}"
+              else
+                href = request.uri.path
+              end
+              entity['href'] = href.sub(/^#{@url.path}/, '')
+            end
+            response.entity = entity
+          when 300..399
+            location = response['Location']
+            raise "no location for #{response.code} response" if location.nil?
+            url = URI.parse(location)
+            raise "will not redirect to #{url.to_s}" if url.route_from(@url).host
+            request.url = url
+            response.entity = nil
+            redirects += 1
+            next
+          when 404
+            response.entity = nil
+            break
+          else
+            message = "#{response.code} #{response.message.dump} " \
+                      "[#{response.fetch('ERROR-CODE', 'unknown')}: " \
+                      "#{response.fetch('ERROR-MESSAGE', 'unknown')}]"
+            raise response.error_type.new(message, response)
+          end
+        rescue Timeout::Error => e
+          @logger.debug("timeout: #{e.message}")
+          close
+          retries += 1
+          next if idempotent request
+          raise "not retrying #{request.method.to_s} request"
+        end
+        break
+      end
+      raise "maximum number of retries reached" if retries == @retries
+      raise "maximum number of redirects reached" if redirects == @redirects
+      response
+    end
+
+  def match_filter(obj, filter)
+    filter.each_pair do |fkey,fvalue|
+      obval = obj[fkey.to_s]
+      if obval.nil?
+        return false
+      elsif fvalue.is_a? Hash
+        return false if !obval.is_a? Hash || !match_filter(obval, fvalue)
+      elsif fvalue != obval
+        return false
+      end
+    end
+    true
+  end
+
+  end
+end

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification
+name: ravello-sdk
+version: !ruby/object:Gem::Version
+  version: '0.9'
+platform: ruby
+authors:
+- Geert Jansen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-10 00:00:00.000000000 Z
+dependencies: []
+description: 
+email: geert.jansen@ravellosystems.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ravello-sdk.rb
+homepage: https://github.com/ravello/ravello-ruby-sdk
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: A Ruby SDK for the Ravello Systems API
+test_files: []