rightscale-api 0.0.1

data/README.markdown

@@ -0,0 +1,37 @@
+RightScale API
+===================
+
+This is a light Ruby wrapper around the RightScale API.
+It, like the RightScale API itself is a little incomplete. It should however be ready soon for general use as it is being developed for a production application. 
+Below is an example of usage. Please contact if with bug reports or if you would like to contribute.
+
+At the moment only GET requests are implemented. 
+Depends upon [HTTParty](http://github.com/jnunemaker/httparty)
+
+Usage
+-----
+
+    account  = 1234
+    username = 'alibaba@example.com'
+    password = 'opensezme'
+     
+    rightscale  = RightScale::Client.new(account, username, password)
+    
+    deployments = rightscale.deployments
+    servers     = rightscale.servers
+    right_scripts = rightscale.right_scripts
+
+
+    production = deployments.index.find {|d| d['nickname'] == 
+      'Production Deployment V1' 
+    }
+
+    production['servers'].each {|server|
+      settings = servers.settings(server['href'])
+      dns      = settings['dns_name']
+      pp IPSocket.getaddress(dns) if dns
+    }
+
+    pp rightscale.right_scripts.show(1234)
+    pp rightscale.deployments.show(1234)
+    pp rightscale.servers.show(1234)

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/rightscale/api.rb

@@ -0,0 +1,48 @@
+module RightScale
+  class API
+    attr_reader :client
+    
+    def initialize(client, options = {})
+      @client = client
+      @resource = options[:resource] || self.class.name.split('::').last.downcase
+      @singular = @resource.chop
+      @format = 'xml'
+    end
+    
+    def index
+      response = client.get("/#{@resource}.#{@format}")
+      return response["#{@resource}"]
+    end
+    
+    def show(identifier)
+      puts formatted_uri(identifier)
+      response = client.get formatted_uri(identifier)
+      return response["#{@singular}"]
+    end
+    
+    def create
+      # implement in derivative classes
+    end
+    
+    def update
+      # implement in derivative classes
+    end
+    
+    def destroy(identifier)
+      response = client.delete("/#{@resource}/#{identifier}")
+    end
+    
+    # As discussed in more detail in the RightScale API Overview Guide, every
+    # major resource exported by the RightScale API will always have an href
+    # field that corresponds to the URL of the resource listed. 
+    
+    def formatted_uri(identifier)
+      if identifier.is_a?(String)
+        identifier.gsub(client.class.base_uri, '')
+      else
+        "/#{@resource}/#{identifier}.#{@format}"
+      end
+    end
+    
+  end
+end

data/lib/rightscale/client.rb

@@ -0,0 +1,35 @@
+module RightScale
+  class Client
+    include HTTParty
+    
+    def initialize(account, email, password)
+      @account, @email, @password = account, email, password
+      self.class.base_uri "https://my.rightscale.com/api/acct/#{@account}"
+    end
+
+    def get(path, options={})
+      options.merge!({
+        :basic_auth => {:username => @email, :password => @password},
+        :headers    => {'X-API-VERSION' => '1.0'}
+      })
+      
+      self.class.get("#{path}", options)
+    end
+  
+    def deployments  
+      @deployments ||= Deployments.new(self)
+    end
+    
+    def servers
+      @servers ||= Servers.new(self)
+    end
+    
+    def statuses
+      @statuses ||= Statuses.new(self)
+    end
+    
+    def right_scripts
+      @right_scripts ||= RightScripts.new(self, :resource => 'right_scripts')
+    end
+  end  
+end

data/lib/rightscale/deployments.rb

@@ -0,0 +1,5 @@
+module RightScale
+  # http://support.rightscale.com/15-References/RightScale_API_Reference_Guide/02-Management/01-Deployments
+  class Deployments < API
+  end
+end

data/lib/rightscale/right_scripts.rb

@@ -0,0 +1,5 @@
+module RightScale
+  # http://support.rightscale.com/15-References/RightScale_API_Reference_Guide/02-Management/01-Deployments
+  class RightScripts < API
+  end
+end

data/lib/rightscale/servers.rb

@@ -0,0 +1,37 @@
+module RightScale 
+  # http://support.rightscale.com/15-References/RightScale_API_Reference_Guide/02-Management/02-Servers
+  class Servers < API
+    def start(identifier)
+      response = client.post("/servers/#{identifier}/start")
+    end
+    
+    def stop(identifier)
+      response = client.post("/servers/#{identifier}/stop")
+    end
+    
+    def reboot(identifier)
+      response = client.post("/servers/#{identifier}/reboot")
+    end
+    
+    def run_script(identifier, right_script_href, params = {})
+      query = {:server => {:right_script_href => right_script_href}}
+      query[:server].merge(params) if !params.empty?
+
+      response = client.post("/servers/#{identifier}/run_script", :query => query)
+    end
+    
+    def attach_volume(ec2_ebs_volume_href, device)
+      response = client.post("/servers/#{identifier}/attach_volume", :query => {
+        :server => {
+          :ec2_ebs_volume_href => ec2_ebs_volume_href,
+          :device => device
+        }
+      })
+    end
+    
+    def settings(identifier)
+      response = client.get("#{formatted_uri(identifier)}/settings")
+      return response['settings']
+    end
+  end
+end

data/lib/rightscale/statuses.rb

@@ -0,0 +1,16 @@
+module RightScale
+  class Statuses
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+      @@resource = self.class.name.split('::').last.downcase
+      @@format = 'xml'
+    end
+  
+    def show(identifier)
+      response = client.get("/#{@@resource}/#{identifier}.#{@@format}")
+      return response["#{@@resource.chop}"]
+    end
+  end
+end

data/lib/rightscale.rb

@@ -0,0 +1,17 @@
+require 'pathname'
+require 'rubygems'
+require 'httparty'
+require 'pp'
+require 'socket'
+
+dir = Pathname(__FILE__).dirname.expand_path
+ 
+require dir + 'rightscale/api'
+require dir + 'rightscale/client'
+
+# Management API
+require dir + 'rightscale/deployments'
+require dir + 'rightscale/servers'
+require dir + 'rightscale/right_scripts'
+
+

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification 
+name: rightscale-api
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- David Michael
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-30 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: A Ruby Wrapper for the RightScale API
+email: david.michael@sonymusic.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- README.markdown
+- VERSION
+- lib/rightscale.rb
+- lib/rightscale/api.rb
+- lib/rightscale/client.rb
+- lib/rightscale/deployments.rb
+- lib/rightscale/right_scripts.rb
+- lib/rightscale/servers.rb
+- lib/rightscale/statuses.rb
+has_rdoc: true
+homepage: http://github.com/dmichael/rightscale-api
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A Ruby Wrapper for the RightScale API
+test_files: []
+