nephophobia 0.0.1

data/.autotest

@@ -0,0 +1,29 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+Autotest.add_hook :initialize do |at|
+  at.testlib = 'minitest/spec'
+
+  %w{.git .svn .hg .swp .DS_Store ._* tmp}.each do |exception|
+    at.add_exception(exception)
+  end
+
+  at.clear_mappings
+  tests = %r%^test/lib/.*_test\.rb$%
+
+  at.add_mapping(%r%^lib/(.*)\.rb$%) do |_, m|
+    ["test/lib/#{m[1]}_test.rb"]
+  end
+
+  at.add_mapping(tests) do |filename, _|
+    filename
+  end
+
+  at.add_mapping(%r%^test/.*\.rb$%) do
+    at.files_matching tests
+  end
+end
+
+# require 'autotest/rcov'
+# Autotest::RCov.command = 'rcov_info'

data/.gitignore

@@ -0,0 +1,2 @@
+.bundle
+pkg/*

data/.rvmrc

@@ -0,0 +1 @@
+rvm ruby-1.9.2-p136@nephophobia

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in ..gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,35 @@
+PATH
+  remote: .
+  specs:
+    nephophobia (0.0.1)
+      hugs (~> 2.5.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    autotest-standalone (4.5.5)
+    fakeweb (1.3.0)
+    hugs (2.5.0)
+      multipart-post (~> 1.0.1)
+      net-http-persistent (~> 1.4.1)
+      nokogiri (~> 1.4.4)
+      yajl-ruby (~> 0.7.9)
+    minitest (2.0.2)
+    multipart-post (1.0.1)
+    net-http-persistent (1.4.1)
+    nokogiri (1.4.4)
+    rake (0.8.7)
+    vcr (1.5.0)
+    yajl-ruby (0.7.9)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  autotest-standalone
+  fakeweb (~> 1.3.0)
+  minitest (~> 2.0.2)
+  nephophobia!
+  nokogiri (~> 1.4.4)
+  rake (~> 0.8.7)
+  vcr (= 1.5.0)

data/README.md

@@ -0,0 +1,23 @@
+# Nephophobia
+
+Lean Ruby bindings to OpenStack's AWS EC2 endpoint.  Hands back a Hash (for now).
+
+## Why
+
+Compatibility with [VCR](https://github.com/myronmarston/vcr) largely drove this effort.
+
+## Usage
+
+### Bundler
+
+    gem "nephophobia"
+
+### Examples
+
+See the examples section in the [wiki](http://github.com/retr0h/nephophobia/wiki).
+
+## Testing
+
+Tests can run offline thanks to [VCR](https://github.com/myronmarston/vcr).
+
+    $ bundle exec rake

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler"
+Bundler::GemHelper.install_tasks
+
+require "rake/testtask"
+Rake::TestTask.new(:test) do |test|
+  test.libs   << "./lib" << "./test"
+  test.pattern = "test/**/*_test.rb"
+  test.verbose = true
+end
+
+task :default => :test

data/lib/aws.rb

@@ -0,0 +1,51 @@
+##
+# Taken from geemus/fog
+#
+# TODO: document
+
+require "cgi"
+require "openssl"
+require "base64"
+
+class AWS
+  def initialize options
+    @host       = options[:host]
+    @port       = options[:port]
+    @path       = options[:path]
+    @access_key = options[:access_key]
+    @secret_key = options[:secret_key]
+    @project    = options[:project]
+  end
+
+  def signed_params method, params
+    sign method, common_params.merge(params)
+  end
+
+private
+  def common_params
+    {
+      "AWSAccessKeyId"   => @project ? "#{@access_key}:#{@project}" : @access_key,
+      "SignatureMethod"  => "HmacSHA256",
+      "SignatureVersion" => "2",
+      "Timestamp"        => Time.now.utc.strftime("%Y-%m-%dT%H:%M:%SZ"),
+      "Version"          => "2010-11-15"
+    }
+  end
+
+  def sign method, params
+    sorted_params = sort_params params
+
+    data   = "#{method.upcase}\n#{@host}:#{@port}\n#{@path}\n" << sorted_params.chop
+    digest = OpenSSL::Digest::Digest.new "sha256"
+    signed = OpenSSL::HMAC.digest digest, @secret_key, data
+    sorted_params << "Signature=#{CGI.escape(Base64.encode64(signed).chomp!).gsub /\+/, '%20'}"
+
+    sorted_params
+  end
+
+  def sort_params params
+    params.keys.sort.inject("") do |result, key|
+      result << "#{key}=#{CGI.escape(params[key]).gsub(/\+/, '%20')}&" if params[key]
+    end 
+  end
+end

data/lib/hashify.rb

@@ -0,0 +1,29 @@
+class Hashify
+  ##
+  # Return a Hash from a Nokogiri::XML::Document.
+  #
+  # +node+: An Nokogiri::XML::Document.
+
+  def self.convert node
+    children    = {}
+    child_nodes = node.children
+
+    if child_nodes.first.nil?
+      children = nil
+    elsif child_nodes.first.text?
+      children = child_nodes.first.text
+    else
+      child_nodes.each do |child|
+        convert(child).each_pair do |k, v|
+          children[k] = if children.key? k
+            children[k].is_a?(Array) ? (children[k] << v) : ([children[k], v])
+          else
+            v
+          end
+        end
+      end
+    end
+
+    { node.name => children }
+  end
+end

data/lib/nephophobia.rb

@@ -0,0 +1,30 @@
+require "aws"
+require "hashify"
+require "nephophobia/client"
+require "nephophobia/compute"
+require "nephophobia/image"
+require "nephophobia/project"
+require "nephophobia/role"
+require "nephophobia/user"
+
+require "hugs"
+
+module Nephophobia
+  class ResponseData
+    attr_reader :return, :request_id
+
+    def initialize hash
+      @request_id = hash["requestId"]
+      @return     = hash["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

data/lib/nephophobia/client.rb

@@ -0,0 +1,73 @@
+module Nephophobia
+  class Client
+    ##
+    # Required:
+    # +host+: A String with the host to connect.
+    # +access_key+: A String containing the AWS Access Key.
+    # +secret_key+: A String containing the AWS Secret Key.
+    # +project+: A String containing the "Project Name" the
+    #            Acccess Key is intended for.
+
+    def initialize options
+      @port = options[:port] || 8773
+      @path = options[:path] || "/services/Cloud"
+
+      @connection = Hugs::Client.new(
+        :host     => options[:host],
+        :scheme   => options[:scheme] || "http",
+        :port     => @port,
+        :type     => options[:type] || :xml
+      )
+      @connection.raise_4xx = true
+      @connection.raise_5xx = true
+
+      @aws = AWS.new(
+        :host       => options[:host],
+        :port       => @port,
+        :path       => @path,
+        :access_key => options[:access_key],
+        :secret_key => options[:secret_key],
+        :project    => options[:project]
+      )
+    end
+
+    ##
+    # Worker method which constructs the properly signed URL, and
+    # performs the Net::HTTP call.
+    # Returns a typical Net::HTTP response with a Hash body.
+    #
+    # +method+: The HTTP method used for the request.
+    # +params+: A Hash containing the
+
+    def raw method, params
+      response      = @connection.send method, @path, :query => @aws.signed_params(method, params)
+      response.body = Hashify.convert response.body.root
+
+      response
+    end
+
+    ##
+    # Vanity wrapper around #raw.
+    #
+    # +inflict+: A String with the EC2 API action to execute.
+    # +filter+: An optional Hash containing the EC2 API filters.
+
+    def action inflict, filter
+      raw "get", { "Action" => inflict }.merge(filter)
+    end
+
+    ##
+    # Provide a simple interface to the EC2 Compute resources.
+
+    def compute
+      @compute ||= Nephophobia::Compute.new self
+    end
+
+    ##
+    # Provide a simple interface to the EC2 Image resources.
+
+    def image
+      @image ||= Nephophobia::Image.new self
+    end
+  end
+end

data/lib/nephophobia/compute.rb

@@ -0,0 +1,150 @@
+module Nephophobia
+  class ComputeData
+    attr_reader :description, :dns_name, :image_id, :instance_id, :instance_type
+    attr_reader :key_name, :launch_time, :name, :owner_id, :placement
+    attr_reader :private_dns_name, :project_id, :public_dns_name, :state
+
+    def initialize hash
+      @project_id       = hash['ownerId']
+      item              = hash['instancesSet']['item']
+      @description      = item['displayDescription']
+      @name             = item['displayName']
+      @key_name         = item['keyName']
+      @instance_id      = item['instanceId']
+      @state            = item['instanceState']['name']
+      @public_dns_name  = item['publicDnsName']
+      @private_dns_name = item['privateDnsName']
+      @image_id         = item['imageId']
+      @dns_name         = item['dnsName']
+      @launch_time      = Time.new(item['launchTime']).utc
+      @placement        = item['placement']['availabilityZone']
+      @instance_type    = item['instanceType']
+    end
+  end
+
+  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
+
+      Nephophobia.coerce(response.body['DescribeInstancesResponse']['reservationSet']['item']).collect do |data|
+        ComputeData.new data
+      end
+    end
+
+    ##
+    # Create the compute instance identified by +instance_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 = {}
+      filter = {
+        "ImageId" => image_id
+      }.merge params
+
+      response = @client.action "RunInstances", filter
+
+      ComputeData.new response.body['RunInstancesResponse']
+    end
+
+    ##
+    # Shuts down the given 'instance_id'. This operation is idempotent; if
+    # you terminate an instance more than once, each call will succeed.
+    # Returns instances response to a state change.
+    #
+    # +instance_id+: A String representing the ID of the instance.
+
+    def destroy instance_id
+      filter = {
+        "InstanceId.1" => instance_id
+      }
+
+      response = @client.action "TerminateInstances", filter
+
+      ResponseData.new response.body['TerminateInstancesResponse']
+    end
+
+    ##
+    # Returns information about the given 'instance_id' +@client+ owns.
+    #
+    # +instance_id+: A String representing the ID of the instance.
+
+    def find instance_id
+      filter = {
+        "InstanceId.1" => instance_id
+      }
+
+      response = @client.action "DescribeInstances", filter
+
+      ComputeData.new response.body['DescribeInstancesResponse']['reservationSet']['item']
+    end
+
+    ##
+    # Reboot the compute instance identified by +instance_id+.
+    # Returns instances response to a state change.
+    #
+    # +instance_id+: A String representing the ID of the instance.
+
+    def reboot instance_id
+      filter = {
+        "InstanceId.1" => instance_id
+      }
+
+      response = @client.action "RebootInstances", filter
+
+      ResponseData.new response.body['RebootInstancesResponse']
+    end
+
+    ##
+    # Starts the compute instance identified by +instance_id+.
+    # Returns instances current and previous state.
+    #
+    # +instance_id+: A String representing the ID of the instance.
+
+    def start instance_id
+      filter = {
+        "InstanceId.1" => instance_id
+      }
+
+      response = @client.action "StopInstances", filter
+
+      ResponseData.new response.body
+    end
+
+    ##
+    # Stops the compute instance identified by +instance_id+.
+    # Returns instances current and previous state.
+    #
+    # +instance_id+: A String representing the ID of the instance.
+
+    def stop instance_id
+      filter = {
+        "InstanceId.1" => instance_id
+      }
+
+      response = @client.action "StartInstances", filter
+
+      ResponseData.new response.body
+    end
+  end
+end