fog-rackspace 0.1.0

data/lib/fog/rackspace/models/compute_v2/flavors.rb

@@ -0,0 +1,39 @@
+require 'fog/core/collection'
+require 'fog/rackspace/models/compute_v2/flavor'
+
+module Fog
+  module Compute
+    class RackspaceV2
+      class Flavors < Fog::Collection
+        model Fog::Compute::RackspaceV2::Flavor
+
+        # Retrieves information for all available flavors
+        # @return [Fog::Compute::RackspaceV2::Flavors] list of flavors
+        # @raise [Fog::Compute::RackspaceV2::NotFound] - HTTP 404
+        # @raise [Fog::Compute::RackspaceV2::BadRequest] - HTTP 400
+        # @raise [Fog::Compute::RackspaceV2::InternalServerError] - HTTP 500
+        # @raise [Fog::Compute::RackspaceV2::ServiceError]
+        # @note Fog's currentl implementation only returns 1000 flavors.
+        def all
+          data = service.list_flavors_detail.body['flavors']
+          load(data)
+        end
+
+        # Retrieve image
+        # @param [String] flavor_id id of flavor
+        # @return [Fog::Compute::RackspaceV2::Flavor] flavor
+        # @raise [Fog::Compute::RackspaceV2::NotFound] - HTTP 404
+        # @raise [Fog::Compute::RackspaceV2::BadRequest] - HTTP 400
+        # @raise [Fog::Compute::RackspaceV2::InternalServerError] - HTTP 500
+        # @raise [Fog::Compute::RackspaceV2::ServiceError]
+        # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Get_Flavor_Details-d1e4317.html
+        def get(flavor_id)
+          data = service.get_flavor(flavor_id).body['flavor']
+          new(data)
+        rescue Fog::Compute::RackspaceV2::NotFound
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/models/compute_v2/image.rb

@@ -0,0 +1,117 @@
+require 'fog/core/model'
+
+module Fog
+  module Compute
+    class RackspaceV2
+      class Image < Fog::Model
+        UNKNOWN = 'UNKNOWN'
+        ACTIVE = 'ACTIVE'
+        SAVING = 'SAVING'
+        ERROR = 'ERROR'
+        DELETED = 'DELETED'
+
+        # @!attribute [r] id
+        # @return [String] The server id
+        identity :id
+
+        # @!attribute [r] name
+        # @return [String] The image name.
+        attribute :name
+
+        # @!attribute [r] created
+        # @return [String] The time stamp for the creation date.
+        attribute :created
+
+        # @!attribute [r] updated
+        # @return [String] The time stamp for the last update.
+        attribute :updated
+
+        # @!attribute [r] state
+        # @return [String] image status.
+        attribute :state, :aliases => 'status'
+
+        # @!attribute [r] user_id
+        # @return [String] The user Id.
+        attribute :user_id
+
+        # @!attribute [r] tenant_id
+        # @return [String] The tenant Id.
+        attribute :tenant_id
+
+        # @!attribute [r] progress
+        # @return [Fixnum] The build completion progress, as a percentage. Value is from 0 to 100.
+        attribute :progress
+
+        attribute :minDisk
+        attribute :minRam
+
+        # @!attribute [rw] disk_config
+        # @return [String<AUTO, MANUAL>] The disk configuration value.
+        # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/ch_extensions.html#diskconfig_attribute
+        #
+        # The disk configuration value.
+        #   * AUTO -   The server is built with a single partition the size of the target flavor disk. The file system is automatically adjusted to fit the entire partition.
+        #              This keeps things simple and automated. AUTO is valid only for images and servers with a single partition that use the EXT3 file system.
+        #              This is the default setting for applicable Rackspace base images.
+        #
+        #   * MANUAL - The server is built using whatever partition scheme and file system is in the source image. If the target flavor disk is larger,
+        #              the remaining disk space is left unpartitioned. This enables images to have non-EXT3 file systems, multiple partitions,
+        #              and so on, and enables you to manage the disk configuration.
+        attribute :disk_config, :aliases => 'OS-DCF:diskConfig'
+
+        # @!attribute [r] links
+        # @return [Array] image links.
+        attribute :links
+
+        def initialize(attributes={})
+          @service = attributes[:service]
+          super
+        end
+
+        # Image metadata
+        # @return [Fog::Compute::RackspaceV2::Metadata] Collection of Fog::Compute::RackspaceV2::Metadatum objects containing metadata key value pairs.
+        def metadata
+          @metadata ||= begin
+            Fog::Compute::RackspaceV2::Metadata.new({
+              :service => service,
+              :parent => self
+            })
+          end
+        end
+
+        # Set server metadata
+        # @param [Hash] hash contains key value pairs
+        def metadata=(hash={})
+          metadata.from_hash(hash)
+        end
+
+        # Is image is in ready state
+        # @param [String] ready_state By default state is ACTIVE
+        # @param [Array,String] error_states By default state is ERROR
+        # @return [Boolean] returns true if server is in a ready state
+        # @raise [Fog::Compute::RackspaceV2::NotFound] - HTTP 404
+        # @raise [Fog::Compute::RackspaceV2::BadRequest] - HTTP 400
+        # @raise [Fog::Compute::RackspaceV2::InternalServerError] - HTTP 500
+        # @raise [Fog::Compute::RackspaceV2::ServiceError]
+        # @raise [Fog::Compute::RackspaceV2::InvalidImageStateException] if server state is an error state
+        def ready?(ready_state = ACTIVE, error_states=[ERROR])
+          if error_states
+            error_states = Array(error_states)
+            raise InvalidImageStateException.new(ready_state, state) if error_states.include?(state)
+          end
+          state == ready_state
+        end
+
+        # Destroy image
+        # @raise [Fog::Compute::RackspaceV2::NotFound] - HTTP 404
+        # @raise [Fog::Compute::RackspaceV2::BadRequest] - HTTP 400
+        # @raise [Fog::Compute::RackspaceV2::InternalServerError] - HTTP 500
+        # @raise [Fog::Compute::RackspaceV2::ServiceError]
+        def destroy
+          requires :identity
+          service.delete_image(identity)
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/models/compute_v2/images.rb

@@ -0,0 +1,73 @@
+require 'fog/core/collection'
+require 'fog/rackspace/models/compute_v2/image'
+
+module Fog
+  module Compute
+    class RackspaceV2
+      class Images < Fog::Collection
+        # @!attribute [rw] name
+        # @return [String] Given a string value x, filters the list of images by image name.
+        attribute :name
+
+        # @!attribute [rw] status
+        # @return [String] Given a string value x, filters the list of images by status.
+        # @note Possible values are ACTIVE, DELETED, ERROR, SAVING, and UNKNOWN.
+        attribute :status
+
+        # @!attribute [rw] marker
+        # @return [String] Given a string value x, return object names greater in value than the specified marker.
+        # @see http://docs.rackspace.com/files/api/v1/cf-devguide/content/List_Large_Number_of_Objects-d1e1521.html
+        attribute :marker
+
+        # @!attribute [rw] limit
+        # @return [Integer] For an integer value n, limits the number of results to at most n values.
+        # @see http://docs.rackspace.com/files/api/v1/cf-devguide/content/List_Large_Number_of_Objects-d1e1521.html
+        attribute :limit
+
+        # @!attribute [rw] type
+        # @return [String] Given a string value x, filters the list of images by type.
+        # @note Valid values are BASE and SNAPSHOT
+        attribute :type
+
+        model Fog::Compute::RackspaceV2::Image
+
+        # Returns list of images
+        # @return [Fog::Compute::RackspaceV2::Images] Retrieves a list images.
+        # @raise [Fog::Compute::RackspaceV2::NotFound] - HTTP 404
+        # @raise [Fog::Compute::RackspaceV2::BadRequest] - HTTP 400
+        # @raise [Fog::Compute::RackspaceV2::InternalServerError] - HTTP 500
+        # @raise [Fog::Compute::RackspaceV2::ServiceError]
+        # @note Fog's current implementation only returns 1000 images.
+        # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/List_Images-d1e4435.html
+        def all(options = {})
+          options = {
+            'name'          => name,
+            'status'        => status,
+            'marker'        => marker,
+            'limit'         => limit,
+            'type'          => type
+          }.merge!(options)
+          merge_attributes(options)
+
+          data = service.list_images_detail(options).body['images']
+          load(data)
+        end
+
+        # Retrieve image
+        # @param [String] image_id id of image
+        # @return [Fog::Compute::RackspaceV2:Image] image
+        # @raise [Fog::Compute::RackspaceV2::NotFound] - HTTP 404
+        # @raise [Fog::Compute::RackspaceV2::BadRequest] - HTTP 400
+        # @raise [Fog::Compute::RackspaceV2::InternalServerError] - HTTP 500
+        # @raise [Fog::Compute::RackspaceV2::ServiceError]
+        # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Get_Image_Details-d1e4848.html
+        def get(image_id)
+          data = service.get_image(image_id).body['image']
+          new(data)
+        rescue Fog::Compute::RackspaceV2::NotFound
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/models/compute_v2/key_pair.rb

@@ -0,0 +1,54 @@
+require 'fog/core/model'
+
+module Fog
+  module Compute
+    class RackspaceV2
+      class KeyPair < Fog::Model
+        # @!attribute [rw] name
+        # @return [String] the keypair name
+        identity  :name
+
+        # @!attribute [r]  public_key
+        # @return [String] the public key
+        attribute :public_key
+
+        # @!attribute [r]  private_key
+        # @return [String] the private key
+        attribute :private_key
+
+        # @!attribute [r]  user_id
+        # @return [String] the user_id associated to
+        attribute :user_id
+
+        # @!attribute [r]  fingerprint
+        # @return [String] unique fingerprint
+        attribute :fingerprint
+
+        # Creates a keypair
+        # @return [Boolean] true if the keypair is successfully created
+        # @raise  [Fog::Compute::RackspaceV2::NotFound]
+        # @raise  [Fog::Compute::RackspaceV2::BadRequest]
+        # @raise  [Fog::Compute::RackspaceV2::InternalServerError]
+        # @raise  [Fog::Compute::RackspaceV2::ServiceError]
+        def save
+          requires :name
+          data = service.create_keypair(name, attributes)
+          merge_attributes(data.body['keypair'])
+          data.body['keypair']['name'] == name
+        end
+
+        # Destroys a keypair
+        # @return [Boolean] true if the keypair is successfully deleted
+        # @raise  [Fog::Compute::RackspaceV2::NotFound]
+        # @raise  [Fog::Compute::RackspaceV2::BadRequest]
+        # @raise  [Fog::Compute::RackspaceV2::InternalServerError]
+        # @raise  [Fog::Compute::RackspaceV2::ServiceError]
+        def destroy
+            requires :identity
+            service.delete_keypair(identity)
+            true
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/models/compute_v2/key_pairs.rb

@@ -0,0 +1,40 @@
+require 'fog/core/collection'
+require 'fog/rackspace/models/compute_v2/key_pair'
+
+module Fog
+  module Compute
+    class RackspaceV2
+      class KeyPairs < Fog::Collection
+        model Fog::Compute::RackspaceV2::KeyPair
+
+        # Fetch the list of known keypairs
+        # @return [Fog::Compute::RackspaceV2::Keypairs] the retreived keypairs
+        # @raise  [Fog::Compute::RackspaceV2::NotFound]
+        # @raise  [Fog::Compute::RackspaceV2::BadRequest]
+        # @raise  [Fog::Compute::RackspaceV2::InternalServerError]
+        # @raise  [Fog::Compute::RackspaceV2::ServiceError]
+        def all
+          data = []
+          service.list_keypairs.body['keypairs'].each do |kp|
+            data << kp['keypair'] if kp['keypair']
+          end
+          load(data)
+        end
+
+        # Fetch keypair details
+        # @param  [String] key_name name of the key to request
+        # @return [Fog::Compute::RackspaceV2::Keypair] the requested keypair or 'nil' when not found
+        # @raise  [Fog::Compute::RackspaceV2::BadRequest]
+        # @raise  [Fog::Compute::RackspaceV2::InternalServerError]
+        # @raise  [Fog::Compute::RackspaceV2::ServiceError]
+        def get(key_name)
+            begin
+                new(service.get_keypair(key_name).body['keypair'])
+            rescue Fog::Compute::RackspaceV2::NotFound
+                nil
+            end
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/models/compute_v2/meta_parent.rb

@@ -0,0 +1,40 @@
+module Fog
+  module Compute
+    class RackspaceV2
+      module MetaParent
+        # Parent of metadata
+        # @return [#parent] parent of metadata
+        def parent
+          @parent
+        end
+
+        # Sets parent of metadata
+        # @param [#parent] new_parent of metadata
+        def parent=(new_parent)
+          @parent = new_parent
+        end
+
+        # Collection type for parent
+        # @return [String] collection type
+        # @raise [RuntimeError] raises excpetion if collection type for parent is unknown
+        def collection_name
+          if parent.class == Fog::Compute::RackspaceV2::Image
+            return "images"
+          elsif parent.class == Fog::Compute::RackspaceV2::Server
+            return "servers"
+          else
+            raise "Metadata is not supported for this model type."
+          end
+        end
+
+        # Converts metadata to hash
+        # @return [Hash] hash containing key value pairs for metadata
+        def metas_to_hash(metas)
+          hash = {}
+          metas.each { |meta| hash[meta.key] = meta.value }
+          hash
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/models/compute_v2/metadata.rb

@@ -0,0 +1,108 @@
+require 'fog/core/collection'
+require 'fog/rackspace/models/compute_v2/meta_parent'
+require 'fog/rackspace/models/compute_v2/metadatum'
+require 'fog/rackspace/models/compute_v2/image'
+require 'fog/rackspace/models/compute_v2/server'
+
+module Fog
+  module Compute
+    class RackspaceV2
+      class Metadata < Fog::Collection
+        model Fog::Compute::RackspaceV2::Metadatum
+
+        include Fog::Compute::RackspaceV2::MetaParent
+
+        # Retrieves all of the metadata from server
+        # @return [Fog::Compute::RackspaceV2::Metadatum] list of metadatum
+        # @raise [Fog::Compute::RackspaceV2::NotFound] - HTTP 404
+        # @raise [Fog::Compute::RackspaceV2::BadRequest] - HTTP 400
+        # @raise [Fog::Compute::RackspaceV2::InternalServerError] - HTTP 500
+        # @raise [Fog::Compute::RackspaceV2::ServiceError]
+        def all
+          requires :parent
+          return unless parent.identity
+          data = service.list_metadata(collection_name, parent.id).body['metadata']
+          from_hash(data)
+        end
+
+        # Retrieves specific metadata from server
+        # @param [String] key for metadatum
+        # @return [Fog::Compute::RackspaceV2::Metadatum] metadatum
+        # @raise [Fog::Compute::RackspaceV2::NotFound] - HTTP 404
+        # @raise [Fog::Compute::RackspaceV2::BadRequest] - HTTP 400
+        # @raise [Fog::Compute::RackspaceV2::InternalServerError] - HTTP 500
+        # @raise [Fog::Compute::RackspaceV2::ServiceError]
+        def get(key)
+          requires :parent
+          data = service.get_metadata_item(collection_name, parent.id, key).body["meta"]
+          datum = data.first
+          new(:key => datum[0], :value => datum[1])
+        rescue Fog::Compute::RackspaceV2::NotFound
+          nil
+        end
+
+        # Retrieve specific value for key from Metadata.
+        # * If key is of type String, this method will return the value of the metadatum
+        # * If key is of type Fixnum, this method will return a Fog::Compute::RackspaceV2::Metadatum object (legacy)
+        # @param [#key] key
+        # @return [#value]
+        def [](key)
+          return super(key) if key.is_a?(Integer)
+          return nil unless key
+          datum = self.find {|datum| datum.key == key || datum.key == key.to_sym }
+          datum ? datum.value : nil
+        end
+
+        # Set value for key.
+        # * If key is of type String, this method will set/add the value to Metadata
+        # * If key is of type Fixnum, this method will set a Fog::Compute::RackspaceV2::Metadatum object (legacy)
+        # @param [#key] key
+        # @return [String]
+        def []=(key, value)
+          return super(key,value) if key.is_a?(Integer)
+          return nil unless key
+          datum = self.find {|datum| datum.key == key || datum.key == key.to_sym }
+          if datum
+            datum.value = value
+          else
+            self << Fog::Compute::RackspaceV2::Metadatum.new(:key => key, :value => value, :service => service, :parent => parent)
+          end
+          value
+        end
+
+        # Saves the current metadata on server
+        # @raise [Fog::Compute::RackspaceV2::NotFound] - HTTP 404
+        # @raise [Fog::Compute::RackspaceV2::BadRequest] - HTTP 400
+        # @raise [Fog::Compute::RackspaceV2::InternalServerError] - HTTP 500
+        # @raise [Fog::Compute::RackspaceV2::ServiceError]
+        def save
+          requires :parent
+          service.set_metadata(collection_name, parent.id, to_hash)
+        end
+
+        # Creates new metadata
+        def new(attributes = {})
+          super({ :parent => parent }.merge!(attributes))
+        end
+
+        # Resets metadata using data from hash
+        # @param hash hash containing key value pairs used to populate metadata.
+        # @note This will remove existing data
+        def from_hash(hash)
+          return unless hash
+          metas = []
+          hash.each_pair {|k,v| metas << {:key => k, :value => v} }
+          load(metas)
+        end
+
+        # Converts metadata object to hash
+        # @return [Hash] hash of metadata key value pairs
+        def to_hash
+          h = {}
+          self.each { |datum| h[datum.key] = datum.value }
+          h
+        end
+      end
+    end
+  end
+end