nephophobia 0.3.0 → 0.3.6

data/lib/nephophobia.rb

@@ -2,52 +2,41 @@ require "aws"
 require "hashify"
 require "date"
 require "nephophobia/client"
-require "nephophobia/compute"
-require "nephophobia/credential"
-require "nephophobia/image"
-require "nephophobia/project"
-require "nephophobia/role"
-require "nephophobia/user"
+require "nephophobia/util"
+require "nephophobia/response/address"
+require "nephophobia/response/compute"
+require "nephophobia/response/credential"
+require "nephophobia/response/image"
+require "nephophobia/response/member"
+require "nephophobia/response/project"
+require "nephophobia/response/return"
+require "nephophobia/response/role"
+require "nephophobia/response/user"
+require "nephophobia/response/vnc"
+require "nephophobia/resource/compute"
+require "nephophobia/resource/credential"
+require "nephophobia/resource/image"
+require "nephophobia/resource/project"
+require "nephophobia/resource/role"
+require "nephophobia/resource/user"
 
 require "hugs"
 
-module Nephophobia
-  class ResponseData
-    attr_reader :return, :request_id
-
-    attr_accessor :attributes
-
-    def initialize attributes
-      @attributes = attributes
-
-      @request_id = attributes["requestId"]
-      @return     = attributes["return"] == "true"
-    end
-  end
-
-  ##
-  # Wraps a Hash with an Array.
-  #
-  # +obj+: The Object to be tested for wrapping.
-
-  def self.coerce obj
-    (obj.is_a? Hash) ? [obj] : obj
-  end
-end
-
 ##
 # Allow Data Classes to comply with ActiveModel.
 
 module Nephophobia
   class Rails
     CLASSES = [
-      ::Nephophobia::ComputeData,
-      ::Nephophobia::CredentialData,
-      ::Nephophobia::ImageData,
-      ::Nephophobia::MemberData,
-      ::Nephophobia::ProjectData,
-      ::Nephophobia::RoleData,
-      ::Nephophobia::UserData
+      ::Nephophobia::Response::Address,
+      ::Nephophobia::Response::Compute,
+      ::Nephophobia::Response::Credential,
+      ::Nephophobia::Response::Image,
+      ::Nephophobia::Response::Member,
+      ::Nephophobia::Response::Project,
+      ::Nephophobia::Response::Role,
+      ::Nephophobia::Response::User,
+      ::Nephophobia::Response::Vnc
     ].freeze
 
     def self.insert

data/lib/nephophobia/client.rb

@@ -59,7 +59,7 @@ module Nephophobia
 
     def compute
       @path      = "/services/Cloud"
-      @compute ||= Nephophobia::Compute.new self
+      @compute ||= Nephophobia::Resource::Compute.new self
     end
 
     ##
@@ -67,7 +67,7 @@ module Nephophobia
 
     def credential
       @path         = "/services/Cloud"
-      @credential ||= Nephophobia::Credential.new self
+      @credential ||= Nephophobia::Resource::Credential.new self
     end
 
     ##
@@ -75,7 +75,7 @@ module Nephophobia
 
     def image
       @path    = "/services/Cloud"
-      @image ||= Nephophobia::Image.new self
+      @image ||= Nephophobia::Resource::Image.new self
     end
 
     ##
@@ -83,7 +83,7 @@ module Nephophobia
 
     def project
       @path      = "/services/Admin"
-      @project ||= Nephophobia::Project.new self
+      @project ||= Nephophobia::Resource::Project.new self
     end
 
     ##
@@ -91,7 +91,7 @@ module Nephophobia
 
     def user
       @path   = "/services/Admin"
-      @user ||= Nephophobia::User.new self
+      @user ||= Nephophobia::Resource::User.new self
     end
 
     ##
@@ -99,7 +99,7 @@ module Nephophobia
 
     def role
       @path   = "/services/Admin"
-      @role ||= Nephophobia::Role.new self
+      @role ||= Nephophobia::Resource::Role.new self
     end
   end
 end

data/lib/nephophobia/resource/compute.rb

@@ -0,0 +1,209 @@
+module Nephophobia
+  module Resource
+    class Compute
+      def initialize client
+        @client = client
+      end
+
+      ##
+      # Returns information about instances that +@client+ owns.
+      #
+      # +filter+: An optional Hash, intended for filtering.
+      #           See the API Reference for further details.
+      #           {
+      #             "Filter.1.Name"    => "instance-type",
+      #             "Filter.1.Value.1" => "m1.small"
+      #           }
+
+      def all filter = {}
+        response = @client.action "DescribeInstances", filter
+
+        item = response.body['DescribeInstancesResponse']['reservationSet']['item']
+        Nephophobia::Util.coerce(item).collect do |data|
+          Response::Compute.new data
+        end
+      end
+
+      ##
+      # Create a compute instance with the given 'image_id'.
+      # Returns information about the new instance.
+      #
+      # +image_id+: A String representing the ID of the image.
+      # +params+: An optional Hash.
+      #           See the API Reference for further details.
+      #           {
+      #             "DisplayName"        => "testserver1",
+      #             "DisplayDescription" => "test description"
+      #           }
+
+      def create image_id, params = {}
+        response = @client.action "RunInstances", { "ImageId" => image_id }.merge(params)
+
+        Response::Compute.new response.body['RunInstancesResponse']
+      end
+
+      ##
+      # Removes the given 'instance_id'.
+      # Returns instances response to a state change.
+      #
+      # +instance_id+: A String representing the ID of the instance.
+
+      def destroy instance_id
+        params = {
+          "InstanceId.1" => instance_id
+        }
+
+        response = @client.action "TerminateInstances", params
+
+        Response::Return.new response.body['TerminateInstancesResponse']
+      end
+
+      ##
+      # Returns information about the given 'instance_id'.
+      #
+      # +instance_id+: A String representing the ID of the instance.
+
+      def find instance_id
+        params = {
+          "InstanceId.1" => instance_id
+        }
+
+        response = @client.action "DescribeInstances", params
+
+        Response::Compute.new response.body['DescribeInstancesResponse']['reservationSet']['item']
+      end
+
+      ##
+      # Reboot the given 'instance_id'.
+      # Returns instances response to a state change.
+      #
+      # +instance_id+: A String representing the ID of the instance.
+
+      def reboot instance_id
+        params = {
+          "InstanceId.1" => instance_id
+        }
+
+        response = @client.action "RebootInstances", params
+
+        Response::Return.new response.body['RebootInstancesResponse']
+      end
+
+      ##
+      # Starts the given 'instance_id'.
+      # Returns instances current and previous state.
+      #
+      # +instance_id+: A String representing the ID of the instance.
+
+      def start instance_id
+        params = {
+          "InstanceId.1" => instance_id
+        }
+
+        response = @client.action "StopInstances", params
+
+        Response::Return.new response.body
+      end
+
+      ##
+      # Stops the given 'instance_id'
+      # Returns instances current and previous state.
+      #
+      # +instance_id+: A String representing the ID of the instance.
+
+      def stop instance_id
+        params = {
+          "InstanceId.1" => instance_id
+        }
+
+        response = @client.action "StartInstances", params
+
+        Response::Return.new response.body
+      end
+
+      ##
+      # Returns the VNC browser URL.  Used by the Portal.
+      # __Must__ execute as a user with the +admin+ role.
+      #
+      # +instance_id+: A String representing the ID of the instance.
+
+      def vnc_url instance_id
+        params = {
+          "InstanceId" => instance_id
+        }
+
+        response = @client.action "GetVncConsole", params
+
+        Response::Vnc.new response.body['GetVncConsoleResponse']
+      end
+
+      ##
+      # Acquires an elastic IP address.
+      # Returns an elastic IP.
+
+      def allocate_address
+        response = @client.action "AllocateAddress", {}
+
+        Response::Address.new response.body['AllocateAddressResponse']
+      end
+
+      ##
+      # Releases an elastic IP address.
+      #
+      # +floating_ip+: A String representing a floating IP address.
+
+      def release_address floating_ip
+        params = {
+          "PublicIp" => floating_ip
+        }
+
+        response = @client.action "ReleaseAddress", params
+
+        Response::Address.new response.body['ReleaseAddressResponse']['releaseResponse']
+      end
+
+      ##
+      # Associates an elastic IP address with an instance.
+      #
+      # +instance_id+: A String representing the ID of the instance.
+      # +floating_ip+: A String representing a floating IP address.
+
+      def associate_address instance_id, floating_ip
+        params = {
+          "InstanceId" => instance_id,
+          "PublicIp"   => floating_ip
+        }
+
+        response = @client.action "AssociateAddress", params
+
+        Response::Address.new response.body['AssociateAddressResponse']['associateResponse']
+      end
+
+      ##
+      # Disassociates the specified elastic IP address from the instance
+      # to which it is assigned.
+      #
+      # +instance_id+: A String representing the ID of the instance.
+      # +floating_ip+: A String representing a floating IP address.
+
+      def disassociate_address floating_ip
+        params = {
+          "PublicIp" => floating_ip
+        }
+
+        response = @client.action "DisassociateAddress", params
+
+        Response::Address.new response.body['DisassociateAddressResponse']['disassociateResponse']
+      end
+
+      def describe_addresses
+        response = @client.action "DescribeAddresses", {}
+
+        item = response.body['DescribeAddressesResponse']['addressesSet']['item']
+        Nephophobia::Util.coerce(item).collect do |data|
+          Response::Address.new data
+        end
+      end
+    end
+  end
+end

data/lib/nephophobia/resource/credential.rb

@@ -0,0 +1,68 @@
+module Nephophobia
+  module Resource
+    class Credential
+      def initialize client
+        @client = client
+      end
+
+      ##
+      # Returns information about key pairs that +@client+ owns.
+
+      def all
+        response = @client.action "DescribeKeyPairs", {}
+
+        key_set = response.body['DescribeKeyPairsResponse']['keySet']
+        key_set && Nephophobia::Util.coerce(key_set['item']).collect do |data|
+          Response::Credential.new data
+        end
+      end
+
+      ##
+      # Create a key pair with the given 'key_name'.
+      # Returns information about the new key.
+      #
+      # +key_name+: A String containing a unique name for the key pair.
+
+      def create key_name
+        params = {
+          "KeyName" => key_name
+        }
+
+        response = @client.action "CreateKeyPair", params
+
+        Response::Credential.new response.body['CreateKeyPairResponse']
+      end
+
+      ##
+      # Import a key pair
+
+      def import_public_key key_name, pubkey, fprint=nil
+        params = { 
+          'KeyName' => key_name,
+          'PublicKey' => pubkey
+        }
+        params.merge!( 'Fingerprint' => fprint ) unless fprint.nil?
+
+        response = @client.action "ImportPublicKey", params
+
+        Response::Credential.new response.body["ImportPublicKeyResponse"]['return']
+      end
+
+      ##
+      # Deletes the key pair for the given 'key_name'.
+      # Returns a response to the state change.
+      #
+      # +key_name+: A String containing a unique name for the key pair.
+
+      def destroy key_name
+        params = {
+          "KeyName" => key_name
+        }
+
+        response = @client.action "DeleteKeyPair", params
+
+        Response::Return.new response.body['DeleteKeyPairResponse']
+      end
+    end
+  end
+end

data/lib/nephophobia/resource/image.rb

@@ -0,0 +1,65 @@
+module Nephophobia
+  module Resource
+    class Image
+      def initialize client
+        @client = client
+      end
+
+      ##
+      # Returns information about AMIs, AKIs, and ARIs. Images returned include
+      # public images, private images that +@client+ owns, and private images
+      # owned by other AWS accounts but for which +@client+ has explicit launch
+      # permissions.
+      #
+      # +filter+: An optional Hash, intended for filtering.
+      #           See the API Reference for further details.
+      #           {
+      #             "Filter.1.Name"    => "instance-type",
+      #             "Filter.1.Value.1" => "m1.small",
+      #             "ExecutableBy.1"   => "self",
+      #           }
+
+      def all filter = {}
+        response = @client.action "DescribeImages", filter
+
+        item = response.body['DescribeImagesResponse']['imagesSet']['item'].collect do |data|
+          Response::Image.new data
+        end
+      end
+
+      ##
+      # Returns information about the given 'image_id'.
+      #
+      # +image_id+: A String representing the ID of the image.
+
+      def find image_id
+        params = {
+          "ImageId.1" => image_id
+        }
+
+        response = @client.action "DescribeImages", params
+
+        Response::Image.new response.body['DescribeImagesResponse']['imagesSet']['item']
+      end
+
+      ##
+      # Return information about all public images.
+
+      def runnable
+        all.select do |image|
+          runnable? image
+        end
+      end
+
+    private
+      ##
+      # Images which do not have a valid kernel_id are not runnable.
+
+      def runnable? image
+        image.is_public == "true" &&
+        image.kernel_id != "true" &&
+        image.image_type == "machine"
+      end
+    end
+  end
+end