threetee-rightscale-api 0.4.2

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/Rakefile

@@ -0,0 +1,17 @@
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), 'lib', 'rightscale-api')
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "rightscale-api"
+    gemspec.summary = "A Ruby Wrapper for the RightScale API"
+    gemspec.description = "A Ruby Wrapper for the RightScale API"
+    gemspec.email = "david.michael@sonymusic.com"
+    gemspec.homepage = "http://github.com/dmichael/rightscale-api"
+    gemspec.authors = ["David Michael"]
+    gemspec.add_dependency "httparty"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/VERSION

@@ -0,0 +1 @@
+0.4.2

data/lib/rightscale-api.rb

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

data/lib/rightscale-api/api.rb

@@ -0,0 +1,49 @@
+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}"] || response
+    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-api/client.rb

@@ -0,0 +1,49 @@
+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={})
+      request :get, path, options
+    end
+    
+    def post(path, options={})
+      request :post, path, options
+    end
+    
+    def request(method, path, options={})
+      options.merge!({
+        :basic_auth => {:username => @email, :password => @password},
+        :headers    => {'X-API-VERSION' => '1.0'}
+      })
+
+      response = self.class.send(method, "#{path}", options)
+      # puts response.inspect
+      return response
+    end
+  
+    def deployments  
+      @deployments ||= Deployments.new(self)
+    end
+    
+    def servers
+      @servers ||= Servers.new(self)
+    end
+
+    def server_arrays
+      @server_arrays ||= ServerArrays.new(self, :resource => 'server_arrays')
+    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-api/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-api/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-api/server_arrays.rb

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

data/lib/rightscale-api/servers.rb

@@ -0,0 +1,38 @@
+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)
+      return response
+    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-api/statuses.rb

@@ -0,0 +1,16 @@
+module RightScale
+  class Statuses < API
+    # 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/threetee-rightscale-api.gemspec

@@ -0,0 +1,49 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "threetee-rightscale-api"
+  s.version = "0.4.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["David Michael"]
+  s.date = "2012-04-05"
+  s.description = "A Ruby Wrapper for the RightScale API"
+  s.email = "david.michael@sonymusic.com"
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    "README.markdown",
+    "Rakefile",
+    "VERSION",
+    "lib/rightscale-api.rb",
+    "lib/rightscale-api/api.rb",
+    "lib/rightscale-api/client.rb",
+    "lib/rightscale-api/deployments.rb",
+    "lib/rightscale-api/right_scripts.rb",
+    "lib/rightscale-api/server_arrays.rb",
+    "lib/rightscale-api/servers.rb",
+    "lib/rightscale-api/statuses.rb",
+    "threetee-rightscale-api.gemspec"
+  ]
+  s.homepage = "http://github.com/dmichael/rightscale-api"
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.15"
+  s.summary = "A Ruby Wrapper for the RightScale API"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, [">= 0"])
+    else
+      s.add_dependency(%q<httparty>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<httparty>, [">= 0"])
+  end
+end
+

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: threetee-rightscale-api
+version: !ruby/object:Gem::Version
+  version: 0.4.2
+  prerelease: 
+platform: ruby
+authors:
+- David Michael
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: &70214742184360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70214742184360
+description: A Ruby Wrapper for the RightScale API
+email: david.michael@sonymusic.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.markdown
+files:
+- README.markdown
+- Rakefile
+- VERSION
+- lib/rightscale-api.rb
+- lib/rightscale-api/api.rb
+- lib/rightscale-api/client.rb
+- lib/rightscale-api/deployments.rb
+- lib/rightscale-api/right_scripts.rb
+- lib/rightscale-api/server_arrays.rb
+- lib/rightscale-api/servers.rb
+- lib/rightscale-api/statuses.rb
+- threetee-rightscale-api.gemspec
+homepage: http://github.com/dmichael/rightscale-api
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: A Ruby Wrapper for the RightScale API
+test_files: []