nephophobia 0.0.1

data/lib/nephophobia/image.rb

@@ -0,0 +1,78 @@
+module Nephophobia
+  class ImageData
+    attr_reader :architecture, :image_id, :image_location, :image_owner_id
+    attr_reader :image_type, :kernel_id, :is_public, :state
+
+    def initialize hash
+      @architecture   = hash['architecture']
+      @id             = hash['id']
+      @image_id       = hash['imageId']
+      @image_location = hash['imageLocation']
+      @image_owner_id = hash['imageOwnerId']
+      @image_type     = hash['imageType']
+      @is_public      = hash['isPublic']
+      @kernel_id      = hash['kernelId']
+      @state          = hash['imageState']
+    end
+  end
+
+  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
+
+      Nephophobia.coerce(response.body['DescribeImagesResponse']['imagesSet']['item']).collect do |data|
+        ImageData.new data
+      end
+    end
+
+    ##
+    # Returns information about the specified 'image_id'.
+    #
+    # +image_id+: A String representing the ID of the image.
+
+    def find image_id
+      filter = {
+        "ImageId.1" => image_id
+      }
+
+      response = @client.action "DescribeImages", filter
+
+      ImageData.new response.body['DescribeImagesResponse']['imagesSet']['item']
+    end
+
+    ##
+    # Return information about all public images.
+
+    def public
+      all.select do |image|
+        public? image
+      end
+    end
+
+  private
+    ##
+    # images which do not have a valid kernel_id are not runnable.
+
+    def public? image
+      image.is_public == "true" && image.kernel_id != "true"
+    end
+  end
+end

data/lib/nephophobia/project.rb

@@ -0,0 +1,113 @@
+module Nephophobia
+  class ProjectData
+    attr_reader :name, :manager_id, :description
+
+    def initialize hash
+      @name        = hash['projectname']
+      @manager_id  = hash['projectManagerId']
+      @description = hash['description']
+    end
+  end
+
+  class Project
+    def initialize client
+      @client = client
+    end
+
+    ##
+    # Adds the given 'user_name' to the specified "project_name".
+    # Returns a response to the state change.
+    #
+    # +user_name+: A String representing a nova user_name.
+    # +project_name+: A String representing a nova project_name name.
+
+    def add_member user_name, project_name
+      modify_membership user_name, "add", project_name
+    end
+
+    ##
+    # Returns information about all projects.
+
+    def all
+      response = @client.action "DescribeProjects", {}
+
+      Nephophobia.coerce(response.body['DescribeProjectsResponse']['projectSet']['item']).collect do |data|
+        ProjectData.new data
+      end
+    end
+
+    ##
+    # Creates the given 'project_name'.
+    # Returns a response to the state change.
+    #
+    # +user_name+: A String representing a nova user_name.
+    # +project_name+: A String representing a nova project name.
+
+    def create project_name, user_name
+      filter = {
+        "Name"        => project_name,
+        "ManagerUser" => user_name
+      }
+
+      response = @client.action "RegisterProject", filter
+
+      ProjectData.new response.body['RegisterProjectResponse']
+    end
+
+    ##
+    # Removes the given 'project_name'.
+    # Returns a response to the state change.
+    #
+    # +project_name+: A String representing a nova project name.
+
+    def destroy project_name
+      response = @client.action "DeregisterProject", "Name" => project_name
+
+      ResponseData.new response.body['DeregisterProjectResponse']
+    end
+
+    ##
+    # Returns information about the given 'project_name'.
+    #
+    # +project_name+: A String representing a nova project name.
+
+    def find project_name
+      response = @client.action "DescribeProject", "Name" => project_name
+
+      ProjectData.new response.body['DescribeProjectResponse']
+    end
+
+    ##
+    # Returns information about all members of the given 'project_name'.
+
+    def members project_name
+      response = @client.action "DescribeProjectMembers", "Name" => project_name
+
+      response.body['DescribeProjectMembersResponse']['members']['item']
+    end
+
+    ##
+    # Removes the given 'user_name' from the specified "project_name".
+    # Returns a response to the state change.
+    #
+    # +user_name+: A String representing a nova user_name.
+    # +project_name+: A String representing a nova project_name name.
+
+    def remove_member user_name, project_name
+      modify_membership user_name, "remove", project_name
+    end
+
+  private
+    def modify_membership user_name, operation, project_name
+      params = {
+        "User"      => user_name,
+        "Project"   => project_name,
+        "Operation" => operation
+      }
+
+      response = @client.action "ModifyProjectMember", params
+
+      ResponseData.new response.body['ModifyProjectMemberResponse']
+    end
+  end
+end

data/lib/nephophobia/role.rb

@@ -0,0 +1,5 @@
+module Nephophobia
+  class Role
+    DEFAULT = "sysadmin"
+  end
+end

data/lib/nephophobia/user.rb

@@ -0,0 +1,86 @@
+module Nephophobia
+  class UserData
+    attr_reader :accesskey, :username, :secretkey
+
+    def initialize hash
+      @accesskey = hash['accesskey']
+      @username  = hash['username']
+      @secretkey = hash['secretkey']
+    end
+  end
+
+  class User
+    def initialize client
+      @client = client
+    end
+
+    ##
+    # Adds the given 'user_name' to the specified "project_name's" 'Role::DEFAULT'.
+    # Returns a response to the state change.
+    #
+    # +user_name+: A String representing a nova user_name.
+    # +project_name+: A String representing a nova project_name name.
+
+    def add_role user_name, project_name
+      modify_role user_name, "add", project_name
+    end
+
+    ##
+    # Creates the given 'user_name'.
+    # Returns a response to the state change.
+    #
+    # +user_name+: A String representing a nova user_name.
+
+    def create user_name
+      response = @client.action "RegisterUser", "Name" => user_name
+
+      UserData.new response.body['RegisterUserResponse']
+    end
+
+    ##
+    # Removes the given 'user_name'.
+    # Returns a response to the state change.
+    #
+    # +user_name+: A String representing a nova user_name.
+
+    def destroy user_name
+      response = @client.action "DeregisterUser", "Name" => user_name
+
+      ResponseData.new response.body['DeregisterUserResponse']
+    end
+
+    ##
+    # Returns information about the given 'user_name'.
+    #
+    # +user_name+: A String representing the user_name.
+
+    def find user_name
+      response = @client.action "DescribeUser", "Name" => user_name
+
+      UserData.new response.body['DescribeUserResponse']
+    end
+
+    ##
+    # Removes the given 'user_name' from the specified "project_name's" 'Role::DEFAULT'.
+    #
+    # +user_name+: A String representing a nova user_name.
+    # +project_name+: A String representing a nova project_name name.
+
+    def remove_role user_name, project_name
+      modify_role user_name, "remove", project_name
+    end
+
+  private
+    def modify_role user_name, operation, project_name
+      params = {
+        "User"      => user_name,
+        "Role"      => Role::DEFAULT,
+        "Operation" => operation
+      }
+
+      response = @client.action "ModifyUserRole", params
+
+      ResponseData.new response.body['ModifyUserRoleResponse']
+    end
+  end
+end

data/lib/nephophobia/version.rb

@@ -0,0 +1,3 @@
+module Nephophobia
+  VERSION = "0.0.1"
+end

data/nephophobia.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "nephophobia/version"
+
+Gem::Specification.new do |s|
+  s.name        = "nephophobia"
+  s.version     = Nephophobia::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["John Dewey", "Josh Kleinpeter"]
+  s.email       = ["jdewey@attinteractive.com", "jkleinpeter@attinteractive.com"]
+  s.homepage    = ""
+  s.summary     = %q{Bindings to EC2/OpenStack}
+  s.description = %q{This gem is a simple binding to the EC2 API. It has specific extensions to allow extra functionality provided by OpenStack.}
+
+  s.rubyforge_project = "nephophobia"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency "hugs", "~> 2.5.0"
+
+  s.add_development_dependency "autotest-standalone"
+  s.add_development_dependency "fakeweb", "~> 1.3.0"
+  s.add_development_dependency "minitest", "~> 2.0.2"
+  s.add_development_dependency "nokogiri", "~> 1.4.4"
+  s.add_development_dependency "rake", "~> 0.8.7"
+  s.add_development_dependency "vcr", "1.5.0"
+end

data/test/fixtures/cassettes/compute_all.yml

@@ -0,0 +1,28 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.1.170.32:8773/services/Cloud?AWSAccessKeyId=9c01b833-3047-4f2e-bb2a-5c8dc7c8ae9c%3Aproduction&Action=DescribeInstances&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=WH%2BC76b336Lc35DuC%2Fk7f8UTkiKH0nl6rKYrSlzUqDM%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "1598"
+      date: 
+      - Mon, 21 Feb 2011 20:09:55 GMT
+      connection: 
+      - keep-alive
+    body: <?xml version="1.0" ?><DescribeInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2010-11-15/"><requestId>W6P62OURN04XF89JYL86</requestId><reservationSet><item><ownerId>production</ownerId><groupSet><item><groupId>default</groupId></item></groupSet><reservationId>r-6p9fdt2e</reservationId><instancesSet><item><displayDescription/><displayName>Server 199</displayName><keyName>None (production, e3ab3)</keyName><instanceId>i-000000c7</instanceId><instanceState><code>1</code><name>running</name></instanceState><publicDnsName/><imageId>ami-usc3oydl</imageId><productCodesSet/><privateDnsName>10.1.171.8</privateDnsName><dnsName>10.1.171.8</dnsName><launchTime>2011-02-21 17:54:35</launchTime><placement><availabilityZone>nova</availabilityZone></placement><amiLaunchIndex>0</amiLaunchIndex><instanceType>m1.small</instanceType></item></instancesSet></item><item><ownerId>jtran</ownerId><groupSet><item><groupId>default</groupId></item></groupSet><reservationId>r-5oexkoz1</reservationId><instancesSet><item><displayDescription/><displayName>Server 198</displayName><keyName>None (jtran, cm-02)</keyName><instanceId>i-000000c6</instanceId><instanceState><code>1</code><name>running</name></instanceState><publicDnsName/><imageId>ami-usc3oydl</imageId><productCodesSet/><privateDnsName>10.1.173.17</privateDnsName><dnsName>10.1.173.17</dnsName><launchTime>2011-02-20 07:17:03</launchTime><placement><availabilityZone>nova</availabilityZone></placement><amiLaunchIndex>0</amiLaunchIndex><instanceType>m1.small</instanceType></item></instancesSet></item></reservationSet></DescribeInstancesResponse>
+    http_version: "1.1"

data/test/fixtures/cassettes/compute_all_with_filter.yml

@@ -0,0 +1,30 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.1.170.32:8773/services/Cloud?AWSAccessKeyId=9c01b833-3047-4f2e-bb2a-5c8dc7c8ae9c%3Aproduction&Action=DescribeInstances&Filter.1.Name=instance-type&Filter.1.Value.1=m1.small&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=A%2Foo6aKfI7sbuEdwy8TCgZQq9TPUgu%2BEgrwliuiygZ0%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 400
+      message: Bad Request
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "223"
+      date: 
+      - Sun, 27 Feb 2011 05:55:55 GMT
+      connection: 
+      - keep-alive
+    body: |-
+      <?xml version="1.0"?>
+      <Response><Errors><Error><Code>UnknownError</Code><Message>An unknown error has occurred. Please try your request again.</Message></Error></Errors><RequestID>XPM759MGOM2Y8IHPY5T5</RequestID></Response>
+    http_version: "1.1"

data/test/fixtures/cassettes/compute_all_with_string_into_int_error.yml

@@ -0,0 +1,28 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.1.170.32:8773/services/Cloud?AWSAccessKeyId=9c01b833-3047-4f2e-bb2a-5c8dc7c8ae9c%3Aproduction&Action=DescribeInstances&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=WH%2BC76b336Lc35DuC%2Fk7f8UTkiKH0nl6rKYrSlzUqDM%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "871"
+      date: 
+      - Fri, 04 Mar 2011 01:56:26 GMT
+      connection: 
+      - keep-alive
+    body: <?xml version="1.0" ?><DescribeInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2010-11-15/"><requestId>8L9E--E0D-DACB097WCL</requestId><reservationSet><item><ownerId>production</ownerId><groupSet><item><groupId>default</groupId></item></groupSet><reservationId>r-g3b3ggz0</reservationId><instancesSet><item><displayDescription/><displayName>Server 260</displayName><keyName/><instanceId>i-00000104</instanceId><instanceState><code>1</code><name>running</name></instanceState><publicDnsName/><imageId>ami-srgo1p2s</imageId><productCodesSet/><privateDnsName>10.3.172.8</privateDnsName><dnsName>10.3.172.8</dnsName><launchTime>2011-02-25 17:50:23</launchTime><placement><availabilityZone>nova</availabilityZone></placement><amiLaunchIndex>0</amiLaunchIndex><instanceType>m1.small</instanceType></item></instancesSet></item></reservationSet></DescribeInstancesResponse>
+    http_version: "1.1"

data/test/fixtures/cassettes/compute_create.yml

@@ -0,0 +1,28 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.1.170.32:8773/services/Cloud?AWSAccessKeyId=9c01b833-3047-4f2e-bb2a-5c8dc7c8ae9c%3Aproduction&Action=RunInstances&ImageId=ami-usc3oydl&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=Pj%2Bk1BhY5X1256%2Bu8lMPvPdoxkDsm0bJPXqF2PGUzwY%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "807"
+      date: 
+      - Sun, 27 Feb 2011 05:55:56 GMT
+      connection: 
+      - keep-alive
+    body: <?xml version="1.0" ?><RunInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2010-11-15/"><requestId>ECX3QKATTRPYC9NNJG1M</requestId><ownerId>production</ownerId><groupSet><item><groupId>default</groupId></item></groupSet><reservationId>r-6l687lh5</reservationId><instancesSet><item><displayDescription/><displayName>Server 1145</displayName><keyName>None (production, None)</keyName><instanceId>i-00000479</instanceId><instanceState><code/><name>scheduling</name></instanceState><publicDnsName/><imageId>ami-usc3oydl</imageId><productCodesSet/><privateDnsName/><dnsName/><launchTime>2011-02-27 05:55:56</launchTime><placement><availabilityZone>unknown zone</availabilityZone></placement><amiLaunchIndex>0</amiLaunchIndex><instanceType>m1.small</instanceType></item></instancesSet></RunInstancesResponse>
+    http_version: "1.1"

data/test/fixtures/cassettes/compute_create_with_optional_params.yml

@@ -0,0 +1,28 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.1.170.32:8773/services/Cloud?AWSAccessKeyId=9c01b833-3047-4f2e-bb2a-5c8dc7c8ae9c%3Aproduction&Action=RunInstances&DisplayDescription=test%20description&DisplayName=testserver1&ImageId=ami-usc3oydl&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=1999-12-31T19%3A59%3A59Z&Version=2010-11-15&Signature=zCOhKyLotYPqEmkGUsSh387A10CDB4ySLuuM2ZIhRbQ%3D
+    body: 
+    headers: 
+      accept: 
+      - application/xml
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/xml
+      content-length: 
+      - "843"
+      date: 
+      - Fri, 04 Mar 2011 17:29:48 GMT
+      connection: 
+      - keep-alive
+    body: <?xml version="1.0" ?><RunInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2010-11-15/"><requestId>8SZ3U7WY7ZSI70GT5X9-</requestId><ownerId>production</ownerId><groupSet><item><groupId>default</groupId></item></groupSet><reservationId>r-hmlklbap</reservationId><instancesSet><item><displayDescription>test description</displayDescription><displayName>testserver1</displayName><keyName>None (production, None)</keyName><instanceId>i-0000048f</instanceId><instanceState><code/><name>scheduling</name></instanceState><publicDnsName/><imageId>ami-usc3oydl</imageId><productCodesSet/><privateDnsName/><dnsName/><launchTime>2011-03-04 17:29:48</launchTime><placement><availabilityZone>unknown zone</availabilityZone></placement><amiLaunchIndex>0</amiLaunchIndex><instanceType>m1.small</instanceType></item></instancesSet></RunInstancesResponse>
+    http_version: "1.1"