simplydb 0.0.0

data/lib/simplydb/record/base.rb

@@ -0,0 +1,253 @@
+require 'simplydb'
+require 'simplydb/extensions'
+require 'uuidtools'
+
+module SimplyDB
+  module Record
+    class MissingItemName < RuntimeError; end
+    class ItemNotFound < RuntimeError; end
+    
+    class Base
+      include SimplyDB::Extensions
+      
+      class << self
+        include SimplyDB::Extensions
+        
+        # This setups up the parameters for the connection for SimpleDB.
+        #
+        # ==== Parameters
+        # +access_key+: AWS access key.
+        # +secret_key+: AWS secret key.
+        # +force+: Force the creation of the domain. (Not yet implemented)
+        def establish_connection(options = {})
+          @connection = {
+            :access_key => options[:aws_access_key] || options[:access_key] || ENV['AWS_ACCESS_KEY'] || ENV['ACCESS_KEY'],
+            :secret_key => options[:aws_secret_key] || options[:secret_key] || ENV['AWS_SECRET_KEY'] || ENV['SECRET_KEY'],
+            :force => options[:force] == true ? true : false
+          }
+        end
+        
+        # Returns the connection's paramters.
+        attr_accessor :connection
+        
+        # Returns the interface(+SimplyDB::Interface+) the model uses to communicate with SimpleDB.
+        def interface
+          @interface ||= (establish_connection; SimplyDB::Interface.new(@connection))
+        end
+        
+        # Set the name of the domain to associate the record with. This should be set
+        # to the name as it appears on SimpleDB.
+        # ====Paremeters
+        # +name+: The domain name the model will use when saving data to SimpleDB.
+        def set_domain_name(name)
+          @domain_name = name
+          @domain_name ||= domain_name 
+        end
+        alias_method :domain_name=, :set_domain_name
+        
+        # Return the domain name the model has been assigned. Default is the model
+        # name underscored.
+        #
+        #    Person.domain_name == "person"
+        #    MyDomain.domain_name == "my_domain"
+        def domain_name; @domain_name ||= underscore(name); end
+        
+        # Creates the domain associated with the model based on the +domain_name+.
+        def create_domain
+          return interface.create_domain(domain_name)
+        end
+        
+        # Deletes the domain associated with the model based on the +domain_name+.
+        def delete_domain
+          return interface.delete_domain(domain_name)
+        end
+        
+        # Checks to see if the domain associated with the model exists.
+        def domain_exists?
+          interface.domain_metadata(domain_name)
+          return true
+        rescue SimplyDB::Error::NoSuchDomain => e
+          return false
+        end
+        
+        # Creates an object (or multiple objects) and saves it to the database, if validations pass.
+        # The resulting object is returned whether the object was saved successfully to the database or not.
+        #
+        # The +attributes+ parameter can be either be a Hash or an Array of Hashes.  These Hashes describe the
+        # attributes on the objects that are to be created.
+        #
+        # ==== Examples
+        #   # Create a single new object
+        #   User.create(:first_name => 'Jamie')
+        #
+        #   # Create an Array of new objects
+        #   User.create([{ :first_name => 'Jamie' }, { :first_name => 'Jeremy' }])
+        #
+        #   # Create a single object and pass it into a block to set other attributes.
+        #   User.create(:first_name => 'Jamie') do |u|
+        #     u.is_admin = false
+        #   end
+        #
+        #   # Creating an Array of new objects using a block, where the block is executed for each object:
+        #   User.create([{ :first_name => 'Jamie' }, { :first_name => 'Jeremy' }]) do |u|
+        #     u.is_admin = false
+        #   end        
+        def create(attributes = {}, &block)
+          if attributes.is_a?(Array)
+            attributes.collect { |attr| create(attr, &block) }
+          else
+            object = new(attributes)
+            yield(object) if block_given?
+            object.item_name ||= attributes.delete(:item_name) || UUIDTools::UUID.random_create #TODO: not depend on UUID
+            object.save
+            return object
+          end
+        end
+        
+        def find(item_names)
+          if item_names.is_a?(Array)
+            return item_names.collect {|item_name| find(item_name)}
+          else
+            attributes = interface.get_attributes(domain_name, item_names)
+            unless attributes.empty?
+              object = new(attributes)
+              object.item_name = item_names
+              object.instance_variable_set('@new_record', false)
+              return object
+            else
+              raise SimplyDB::Record::ItemNotFound
+            end
+          end
+        end
+        
+        def find_by_select(statement = nil, consistant_read = false)
+          return [] unless statement
+          items = interface.select(statement, consistant_read)
+          objects = items.collect {|item_name, attributes|
+            object = new(attributes)
+            object.item_name = item_name
+            object.instance_variable_set('@new_record', false)
+            object
+          }
+          return objects
+        end
+      end
+      
+      # New objects can be instantiated with attributes pass as a hash with teh key being the
+      # column name and the value being column value.
+      #
+      # ==== Parameters
+      # +attributes+: A hash of the attributes columns and their values.
+      def initialize(attributes = nil)
+        @attributes = {}
+        @new_record = true
+        @destroyed = false
+        self.attributes = attributes unless attributes.nil?
+      end
+      
+      # Returns true if the record has not been created yet.
+      def new_record?
+        return @new_record
+      end
+      
+      # Returns the value of the attribute identified by <tt>attr_name</tt>.
+      # (Alias for the protected read_attribute method).
+      def [](attribute_name)
+        return read_attribute(attribute_name)
+      end
+      
+      # Updates the attribute identified by <tt>attr_name</tt> with the specified +value+.
+      # (Alias for the protected write_attribute method).
+      def []=(attribute_name, value)
+        write_attribute(attribute_name, value)
+      end
+      
+      # Returns a hash of all the attributes with their names as keys and the values of the attributes as values.
+      def attributes
+        attrs = {}
+        attribute_names.each { |name| attrs[name] = read_attribute(name) }
+        return attrs
+      end
+      
+      # Allows you to set all the attributes at once by passing in a hash with keys
+      # matching the attribute names (which again matches the column names).
+      def attributes=(new_attributes)
+        return if new_attributes.nil?
+        new_attributes.each do |name, value|
+          if respond_to?(:"#{name}=")
+            send(:"#{name}=", value)
+          else
+            write_attribute(name, value)
+          end
+        end  
+      end
+      
+      # Checks that an attribute has been assigned a value.
+      def has_attribute?(attribute_name)
+        return @attributes.has_key?(attribute_name)
+      end
+      
+      # Returns an array of names for the attributes available on this object sorted alphabetically.
+      def attribute_names
+        return @attributes.keys.sort
+      end
+      
+      # Save the record to SimpleDB. Requires that an <tt>item_name</tt> has been set for the record.
+      def save(replace = false)
+        raise SimplyDB::Record::MissingItemName if @item_name.nil? || @item_name.empty?
+        if interface.put_attributes(domain_name, item_name, attributes, {}, replace)
+          @new_record = false
+          return true
+        end
+        return false
+      end
+      
+      # Freeze the attributes hash such they are still accessible, even on destroyed records.
+      def freeze
+        @attributes.freeze
+        return self
+      end
+      
+      # Returns +true+ if the attributes hash has been frozen.
+      def frozen?
+        @attributes.frozen?
+      end
+
+      #Deletes the record in the SimpleDB and freezes this instance to reflect that no changes should be made (since they can’t be persisted).
+      def destroy
+        unless new_record?
+          interface.delete_attributes(domain_name, item_name)
+        end
+        
+        @destroyed = true
+        return freeze
+      end
+      
+      def connection; return self.class.connection; end
+      def interface; return self.class.interface; end
+      def domain_name; return self.class.domain_name; end
+      
+      def method_missing(method, *args) #:nodoc:
+        method = method.to_s
+        case method
+          when /=$/
+            return write_attribute(method.sub(/\=$/,''), args[0])
+          else
+            return read_attribute(method) if has_attribute?(method)
+        end
+        raise NoMethodError.new("Could not find method #{method}", method, *args)
+      end
+      
+      attr_accessor :item_name
+      
+      private
+        def read_attribute(name) #:nodoc:
+          return @attributes[name.to_s]
+        end
+        
+        def write_attribute(name, value) #:nodoc:
+          @attributes[name.to_s] = value
+        end
+    end
+  end
+end

data/lib/simplydb.rb

@@ -0,0 +1,5 @@
+require 'rubygems'
+require 'simplydb/extensions'
+require 'simplydb/error'
+require 'simplydb/client'
+require 'simplydb/interface'

data/simplydb.gemspec

@@ -0,0 +1,82 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{simplydb}
+  s.version = "0.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["JT Archie"]
+  s.date = %q{2010-06-25}
+  s.description = %q{A minimal interface to Amazon SimpleDB that has separation of interfaces. From the low level HTTP request access to high level Ruby abstraction ORM.}
+  s.email = %q{jtarchie@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "examples/interface.rb",
+     "examples/record.rb",
+     "lib/simplydb.rb",
+     "lib/simplydb/client.rb",
+     "lib/simplydb/clients/typhoeus.rb",
+     "lib/simplydb/error.rb",
+     "lib/simplydb/extensions.rb",
+     "lib/simplydb/interface.rb",
+     "lib/simplydb/record/base.rb",
+     "simplydb.gemspec",
+     "spec/client_spec.rb",
+     "spec/error_spec.rb",
+     "spec/extensions_spec.rb",
+     "spec/interface_spec.rb",
+     "spec/record/base_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/jtarchie/simplydb}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{A minimal interface to Amazon SimpleDB.}
+  s.test_files = [
+    "spec/client_spec.rb",
+     "spec/error_spec.rb",
+     "spec/extensions_spec.rb",
+     "spec/interface_spec.rb",
+     "spec/record/base_spec.rb",
+     "spec/spec_helper.rb",
+     "examples/interface.rb",
+     "examples/record.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_runtime_dependency(%q<typhoeus>, [">= 0.1.27"])
+      s.add_runtime_dependency(%q<nokogiri>, [">= 1.4.2"])
+      s.add_runtime_dependency(%q<uuidtools>, [">= 2.1.1"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<typhoeus>, [">= 0.1.27"])
+      s.add_dependency(%q<nokogiri>, [">= 1.4.2"])
+      s.add_dependency(%q<uuidtools>, [">= 2.1.1"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<typhoeus>, [">= 0.1.27"])
+    s.add_dependency(%q<nokogiri>, [">= 1.4.2"])
+    s.add_dependency(%q<uuidtools>, [">= 2.1.1"])
+  end
+end
+

data/spec/client_spec.rb

@@ -0,0 +1,55 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe SimplyDB::Client do
+  before do
+    @client = SimplyDB::Client.new(
+      :access_key => access_key,
+      :secret_key => secret_key
+    )
+    @params = {
+      'Action' => 'PutAttributes',
+      'DomainName' => 'MyDomain',
+      'ItemName' => 'Item123',
+      'Attribute.1.Name' => 'Color',
+      'Attribute.1.Value' => 'Blue',
+      'Attribute.2.Name' => 'Size',
+      'Attribute.2.Value' => 'Med',
+      'Attribute.3.Name' => 'Price',
+      'Attribute.3.Value' => '0014.99',
+      'Version' => '2009-04-15',
+      'Timestamp' => "2010-01-25T15:01:28-07:00",
+      'SignatureVersion' => 2,
+      'SignatureMethod' => 'HmacSHA256',
+      'AWSAccessKeyId' => access_key
+    }
+    @query_string = "AWSAccessKeyId=#{access_key}&Action=PutAttributes&Attribute.1.Name=Color&Attribute.1.Value=Blue&Attribute.2.Name=Size&Attribute.2.Value=Med&Attribute.3.Name=Price&Attribute.3.Value=0014.99&DomainName=MyDomain&ItemName=Item123&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2010-01-25T15%3A01%3A28-07%3A00&Version=2009-04-15"
+    @string_to_sign = "GET\nsdb.amazonaws.com\n/\n#{@query_string}"
+    @post_body = '<PutAttributesResponse><ResponseMetadata><StatusCode>Success</StatusCode><RequestId>f6820318-9658-4a9d-89f8-b067c90904fc</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></PutAttributesResponse>'
+  end
+  
+  it "should generate full URL" do
+    @client.base_url.should == "https://sdb.amazonaws.com:443/"
+  end
+  
+  it "should create the signed string for a POST" do
+    #ie: http://docs.amazonwebservices.com/AmazonSimpleDB/latest/DeveloperGuide/REST_RESTAuth.html
+    @client.string_to_sign(:get, @params).should == @string_to_sign
+  end
+  
+  it "should generate a correct signature" do
+    @client.generate_signature(:get, @params).should == Base64.encode64(
+      OpenSSL::HMAC.digest(
+        OpenSSL::Digest::Digest.new('sha256'),
+        secret_key,
+        @string_to_sign
+      )
+    ).chomp
+  end
+  
+  it "should be able to make an HTTP request" do
+    @client.http_client.hydra.stub(:post, /http/).and_return(Typhoeus::Response.new(:body=>'This is a test.'))
+    @client.call(:post, {:url=>'http://www.example.com'}) do |body|
+      body.should == 'This is a test.'
+    end
+  end
+end

data/spec/error_spec.rb

@@ -0,0 +1,9 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe SimplyDB::Error do
+  it "should contain SignatureDoesNotMatch" do
+    lambda {
+      raise SimplyDB::Error::SignatureDoesNotMatch
+    }.should raise_exception(SimplyDB::Error::SignatureDoesNotMatch)
+  end
+end

data/spec/extensions_spec.rb

@@ -0,0 +1,15 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+require 'simplydb/extensions'
+
+describe SimplyDB::Extensions do
+  include SimplyDB::Extensions
+  
+  it "should underscore a string" do
+    underscore("MyDomain").should == 'my_domain'
+  end
+  
+  it "should correctly escape a string for URI encoding" do
+    escape_value("select color from MyDomain where color = 'blue'").should == 'select%20color%20from%20MyDomain%20where%20color%20%3D%20%27blue%27'
+  end
+end

data/spec/interface_spec.rb

@@ -0,0 +1,223 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+require 'typhoeus'
+
+describe SimplyDB::Interface do
+  before do
+    @interface = SimplyDB::Interface.new(
+      :access_key => access_key,
+      :secret_key => secret_key
+    )
+  end
+  
+  def set_response_body(body)
+    @interface.client.http_client.hydra.stub(:post, /http/).and_return(Typhoeus::Response.new(:body=>body))
+  end
+  
+  describe "#define_attributes" do
+    it "should define attributes" do
+      @interface.send(:define_attributes, {'color'=>'red','size'=>'medium'}).should == {
+        'Attribute.0.Name' => 'color',
+        'Attribute.0.Value' => 'red',
+        'Attribute.1.Name' => 'size',
+        'Attribute.1.Value' => 'medium'
+      }
+    end
+    
+    it "should define attributes with arrays" do
+      @interface.send(:define_attributes, {'color'=>['red','brick','garnet']}).should == {
+        'Attribute.0.Name' => 'color',
+        'Attribute.0.Value' => 'red',
+        'Attribute.1.Name' => 'color',
+        'Attribute.1.Value' => 'brick',
+        'Attribute.2.Name' => 'color',
+        'Attribute.2.Value' => 'garnet'
+      }
+    end
+    
+    it "should define attributes to be replaced" do
+      @interface.send(:define_attributes, {'color'=>'red'}, {}, true).should == {
+        'Attribute.0.Name' => 'color',
+        'Attribute.0.Value' => 'red',
+        'Attribute.0.Replace' => '1',
+      }
+    end
+    
+    it "should define expected states of attributes" do
+      @interface.send(:define_attributes, {}, {'quantity' => '0'}).should == {
+        'Expected.0.Name' => 'quantity',
+        'Expected.0.Value' => '0'
+      }
+    end
+  end
+  
+  describe "successful API calls" do
+    
+    it "should set stats for a request" do
+      set_response_body '<DeleteDomainResponse><ResponseMetadata><RequestId>c522638b-31a2-4d69-b376-8c5428744704</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></DeleteDomainResponse>'
+      @interface.delete_domain('MyDomain')
+      @interface.request_id.should == 'c522638b-31a2-4d69-b376-8c5428744704'
+      @interface.box_usage.should == 0.0000219907
+    end
+    
+    # http://docs.amazonwebservices.com/AmazonSimpleDB/latest/DeveloperGuide/SDB_API_Operations.html
+    describe "for attribute actions" do
+      describe "#get_attributes" do
+        it "should get attributes from an item" do
+          set_response_body '<GetAttributesResponse><GetAttributesResult><Attribute><Name>Color</Name><Value>Blue</Value></Attribute><Attribute><Name>Size</Name><Value>Med</Value></Attribute><Attribute><Name>Price</Name><Value>14</Value></Attribute></GetAttributesResult><ResponseMetadata><RequestId>b1e8f1f7-42e9-494c-ad09-2674e557526d</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></GetAttributesResponse>'
+          @interface.get_attributes('MyDomain', 'Item123') do |attributes|
+            attributes.should == {
+              'Color' => 'Blue',
+              'Size' => 'Med',
+              'Price' => '14'
+            }
+          end
+          @interface.get_attributes('MyDomain', 'Item123').should == {
+            'Color' => 'Blue',
+            'Size' => 'Med',
+            'Price' => '14'
+          }
+        end
+        
+        it "should multiple values for an attribute" do
+          set_response_body '<GetAttributesResponse><GetAttributesResult><Attribute><Name>Color</Name><Value>Blue</Value></Attribute><Attribute><Name>Color</Name><Value>Red</Value></Attribute><Attribute><Name>Size</Name><Value>Med</Value></Attribute><Attribute><Name>Price</Name><Value>14</Value></Attribute></GetAttributesResult><ResponseMetadata><RequestId>b1e8f1f7-42e9-494c-ad09-2674e557526d</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></GetAttributesResponse>'
+          @interface.get_attributes('MyDomain', 'Item123') do |attributes|
+            attributes.should == {
+              'Color' => ['Blue','Red'],
+              'Size' => 'Med',
+              'Price' => '14'
+            }
+          end
+          @interface.get_attributes('MyDomain', 'Item123').should == {
+            'Color' => ['Blue', 'Red'],
+            'Size' => 'Med',
+            'Price' => '14'
+          }
+        end
+        
+        it "should only get specific attributes" do
+          set_response_body '<GetAttributesResponse><GetAttributesResult><Attribute><Name>Color</Name><Value>Blue</Value></Attribute><Attribute><Name>Size</Name><Value>Med</Value></GetAttributesResult><ResponseMetadata><RequestId>b1e8f1f7-42e9-494c-ad09-2674e557526d</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></GetAttributesResponse>'
+          @interface.get_attributes('MyDomain', 'Item123', ['Color','Size']) do |attributes|
+            attributes.should == {
+              'Color' => 'Blue',
+              'Size' => 'Med'
+            }
+          end
+          @interface.get_attributes('MyDomain', 'Item123', ['Color','Size']).should == {
+            'Color' => 'Blue',
+            'Size' => 'Med'
+          }
+        end
+      end
+      
+      it "should set a batch of attributes for items" do |variable|
+        set_response_body '<BatchPutAttributesResponse><ResponseMetadata><RequestId>490206ce-8292-456c-a00f-61b335eb202b</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></BatchPutAttributesResponse>'
+        @interface.batch_put_attributes('MyDomain',{
+          'Shirt1' => {
+            'Color' => 'Blue',
+            'Size' => 'Med',
+            'Price' => '0014.99'
+          },
+          'Shirt2' => {
+            'Color' => 'Red',
+            'Size' => 'Large',
+            'Price' => '0019.99'
+          }
+        }) do |success|
+          success.should == true
+        end
+        @interface.batch_put_attributes('MyDomain',{
+          'Shirt1' => {
+            'Color' => 'Blue',
+            'Size' => 'Med',
+            'Price' => '0014.99'
+          },
+          'Shirt2' => {
+            'Color' => 'Red',
+            'Size' => 'Large',
+            'Price' => '0019.99'
+          }
+        }).should == true
+      end
+      
+      it "should be able to perform a select query" do
+        set_response_body '<SelectResponse><SelectResult><Item><Name>Item_03</Name><Attribute><Name>Category</Name><Value>Clothes</Value></Attribute><Attribute><Name>Subcategory</Name><Value>Pants</Value></Attribute><Attribute><Name>Name</Name><Value>Sweatpants</Value></Attribute><Attribute><Name>Color</Name><Value>Blue</Value></Attribute><Attribute><Name>Color</Name><Value>Yellow</Value></Attribute><Attribute><Name>Color</Name><Value>Pink</Value></Attribute><Attribute><Name>Size</Name><Value>Large</Value></Attribute></Item><Item><Name>Item_06</Name><Attribute><Name>Category</Name><Value>Motorcycle Parts</Value></Attribute><Attribute><Name>Subcategory</Name><Value>Bodywork</Value></Attribute><Attribute><Name>Name</Name><Value>Fender Eliminator</Value></Attribute><Attribute><Name>Color</Name><Value>Blue</Value></Attribute><Attribute><Name>Make</Name><Value>Yamaha</Value></Attribute><Attribute><Name>Model</Name><Value>R1</Value></Attribute></Item></SelectResult><ResponseMetadata><RequestId>b1e8f1f7-42e9-494c-ad09-2674e557526d</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></SelectResponse>'
+        @interface.select("select Color from MyDomain where Color like 'Blue%'") do |items|
+          items.should == {
+            'Item_03' => {
+              'Category' => 'Clothes',
+              'Subcategory' => 'Pants',
+              'Name' => 'Sweatpants',
+              'Color' => ['Blue','Yellow','Pink'],
+              'Size' => 'Large'
+            },
+            'Item_06' => {
+              'Category' => 'Motorcycle Parts',
+              'Subcategory' => 'Bodywork',
+              'Name' => 'Fender Eliminator',
+              'Color' => 'Blue',
+              'Make' => 'Yamaha',
+              'Model' => 'R1'
+            }
+          }
+        end
+      end
+      
+      it "should delete attributes from an item" do
+        set_response_body '<DeleteAttributesResponse><ResponseMetadata><RequestId>05ae667c-cfac-41a8-ab37-a9c897c4c3ca</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></DeleteAttributesResponse>'
+        @interface.delete_attributes('MyDomain', 'JumboFez', {'color'=>['red','brick','garnet']}) do |success|
+          success.should == true
+        end
+        @interface.delete_attributes('MyDomain', 'JumboFez', {'color'=>['red','brick','garnet']}).should == true
+      end
+      
+      it "should be able to put attribues on an item" do
+        set_response_body '<PutAttributesResponse><ResponseMetadata><RequestId>490206ce-8292-456c-a00f-61b335eb202b</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></PutAttributesResponse>'
+        @interface.put_attributes('MyDomain', 'Item123', {'color'=>['red','brick','garnet']}) do |success|
+          success.should == true
+        end
+        @interface.put_attributes('MyDomain', 'Item123', {'color'=>['red','brick','garnet']}).should == true
+      end
+    end
+    describe "for domain actions" do
+      it "should be able to create a domain" do
+        set_response_body '<CreateDomainResponse><ResponseMetadata><RequestId>2a1305a2-ed1c-43fc-b7c4-e6966b5e2727</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></CreateDomainResponse>'
+        @interface.create_domain('MyDomain') do |success|
+          success.should == true
+        end
+        @interface.create_domain('MyDomain').should == true
+      end
+  
+      it "should be able to delete a domain" do
+        set_response_body '<DeleteDomainResponse><ResponseMetadata><RequestId>c522638b-31a2-4d69-b376-8c5428744704</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></DeleteDomainResponse>'
+        @interface.delete_domain('MyDomain') do |success|
+          success.should == true
+        end
+        @interface.delete_domain('MyDomain').should == true
+      end
+  
+      it "should be able to list domains" do
+        set_response_body '<ListDomainsResponse><ListDomainsResult><DomainName>Domain1-200706011651</DomainName><DomainName>Domain2-200706011652</DomainName><NextToken>TWV0ZXJpbmdUZXN0RG9tYWluMS0yMDA3MDYwMTE2NTY=</NextToken></ListDomainsResult><ResponseMetadata><RequestId>eb13162f-1b95-4511-8b12-489b86acfd28</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></ListDomainsResponse>'
+        @interface.list_domains do |domains|
+          domains.should == ['Domain1-200706011651','Domain2-200706011652']
+        end
+        @interface.list_domains.should == ['Domain1-200706011651','Domain2-200706011652']
+      end
+  
+      it "should be able to get the metadeta for a domain" do
+        set_response_body '<DomainMetadataResponse xmlns="http://sdb.amazonaws.com/doc/2009-04-15/"><DomainMetadataResult><ItemCount>195078</ItemCount><ItemNamesSizeBytes>2586634</ItemNamesSizeBytes><AttributeNameCount >12</AttributeNameCount ><AttributeNamesSizeBytes>120</AttributeNamesSizeBytes><AttributeValueCount>3690416</AttributeValueCount><AttributeValuesSizeBytes>50149756</AttributeValuesSizeBytes><Timestamp>1225486466</Timestamp></DomainMetadataResult><ResponseMetadata><RequestId>b1e8f1f7-42e9-494c-ad09-2674e557526d</RequestId><BoxUsage>0.0000219907</BoxUsage></ResponseMetadata></DomainMetadataResponse>'
+        @interface.domain_metadata('Test') do |attributes|
+          attributes.should == {
+            'ItemCount' => '195078',
+            'ItemNamesSizeBytes' => '2586634',
+            'AttributeNameCount' => '12',
+            'AttributeNamesSizeBytes' => '120',
+            'AttributeValueCount' => '3690416',
+            'AttributeValuesSizeBytes' => '50149756',
+            'Timestamp' => '1225486466'
+          }
+        end
+      end
+    end
+  end
+end