aws-sdk 1.8.5 → 1.9.0

data/lib/aws/record/conversion.rb

@@ -31,7 +31,7 @@ module AWS
       def to_param
         persisted? ? to_key.join('-') : nil
       end
-      
+
     end
 
   end

data/lib/aws/record/dirty_tracking.rb

@@ -16,30 +16,32 @@ module AWS
 
     # Provides a way to track changes in your records.
     #
-    #   my_book = Book['bookid']
+    #     my_book = Book['bookid']
     #
-    #   my_book.changed? #=> false
-    #   my_book.title #=> "My Book"
-    #   my_book.title = "My Awesome Book"
-    #   my_book.changed? #=> true
+    #     my_book.changed? #=> false
+    #     my_book.title #=> "My Book"
+    #     my_book.title = "My Awesome Book"
+    #     my_book.changed? #=> true
+    #
+    #     my_book = Book['bookid']
     #
     # You can inspect further and get a list of changed attributes
     #
-    #   my_book.changed #=> ['title']
+    #     my_book.changed #=> ['title']
     #
     # Or you can get a more detailed description of the changes.  {#changes}
-    # returns a hash of changed attributes (keys) with their old and new 
+    # returns a hash of changed attributes (keys) with their old and new
     # values.
-    #   
-    #   my_book.changes
-    #   #=> { 'title' => ['My Book', 'My Awesome Book']
+    #
+    #     my_book.changes
+    #     #=> { 'title' => ['My Book', 'My Awesome Book']
     #
     # For every configured attribute you also get a handful of methods
     # for inspecting changes on that attribute.  Given the following
     # attribute:
     #
-    #   string_attr :title
-    # 
+    #     string_attr :title
+    #
     # You can now call any of the following methods:
     #
     #   * title_changed?
@@ -49,73 +51,73 @@ module AWS
     #   * title_will_change!
     #
     # Given the title change from above:
-    # 
-    #   my_book.title_changed? #=> true
-    #   my_book.title_change #=> ['My Book', 'My Awesome Book']
-    #   my_book.title_was #=> ['My Book']
     #
-    #   my_book.reset_title!
-    #   my_book.title #=> 'My Book'
+    #     my_book.title_changed? #=> true
+    #     my_book.title_change #=> ['My Book', 'My Awesome Book']
+    #     my_book.title_was #=> ['My Book']
     #
-    # == In-Place Editing
+    #     my_book.reset_title!
+    #     my_book.title #=> 'My Book'
     #
-    # Dirty tracking works by comparing incoming attribute values upon 
+    # ## In-Place Editing
+    #
+    # Dirty tracking works by comparing incoming attribute values upon
     # assignment against the value that was there previously.  If you
     # use functions against the value that modify it (like gsub!)
     # you must notify your record about the coming change.
     #
-    #   my_book.title #=> 'My Book'
-    #   my_book.title_will_change!
-    #   my_book.title.gsub!(/My/, 'Your')
-    #   my_book.title_change #=> ['My Book', 'Your Book']
+    #     my_book.title #=> 'My Book'
+    #     my_book.title_will_change!
+    #     my_book.title.gsub!(/My/, 'Your')
+    #     my_book.title_change #=> ['My Book', 'Your Book']
     #
-    # == Partial Updates
+    # ## Partial Updates
     #
     # Dirty tracking makes it possible to only persist those attributes
-    # that have changed since they were loaded.  This speeds up requests 
+    # that have changed since they were loaded.  This speeds up requests
     # against AWS when saving data.
     #
     module DirtyTracking
-  
+
       # Returns true if this model has unsaved changes.
       #
-      #   b = Book.new(:title => 'My Book')
-      #   b.changed?
-      #   #=> true
+      #     b = Book.new(:title => 'My Book')
+      #     b.changed?
+      #     #=> true
       #
       # New objects and objects freshly loaded should not have any changes:
       #
-      #   b = Book.new
-      #   b.changed?      #=> false
+      #     b = Book.new
+      #     b.changed?      #=> false
       #
-      #   b = Book.first
-      #   b.changed?      #=> false
+      #     b = Book.first
+      #     b.changed?      #=> false
       #
       # @return [Boolean] Returns true if any of the attributes have
       #   unsaved changes.
       def changed?
         !orig_values.empty?
       end
-  
-      # Returns an array of attribute names that have changes. 
+
+      # Returns an array of attribute names that have changes.
       #
-      #   book.changed #=> []
-      #   person.title = 'New Title'
-      #   book.changed #=> ['title']
+      #     book.changed #=> []
+      #     person.title = 'New Title'
+      #     book.changed #=> ['title']
       #
-      # @return [Array] Returns an array of attribute names that have 
+      # @return [Array] Returns an array of attribute names that have
       #   unsaved changes.
       def changed
         orig_values.keys
       end
-  
+
       # Returns the changed attributes in a hash.  Keys are attribute names,
       # values are two value arrays.  The first value is the previous
       # attribute value, the second is the current attribute value.
       #
-      #   book.title = 'New Title'
-      #   book.changes
-      #   #=> { 'title' => ['Old Title', 'New Title'] }
+      #     book.title = 'New Title'
+      #     book.changes
+      #     #=> { 'title' => ['Old Title', 'New Title'] }
       #
       # @return [Hash] Returns a hash of attribute changes.
       def changes
@@ -124,16 +126,16 @@ module AWS
           changes
         end
       end
-  
+
       # Returns true if the named attribute has unsaved changes.
       #
-      # This is an attribute method.  The following two expressions 
+      # This is an attribute method.  The following two expressions
       # are equivilent:
       #
-      #   book.title_changed?
-      #   book.attribute_changed?(:title)
+      #     book.title_changed?
+      #     book.attribute_changed?(:title)
       #
-      # @param [String] attribute_name Name of the attribute to check 
+      # @param [String] attribute_name Name of the attribute to check
       #   for changes.
       #
       # @return [Boolean] Returns true if the named attribute
@@ -143,15 +145,15 @@ module AWS
       def attribute_changed? attribute_name
         orig_values.keys.include?(attribute_name)
       end
-  
-      # Returns an array of the old value and the new value for 
+
+      # Returns an array of the old value and the new value for
       # attributes that have unsaved changes, returns nil otherwise.
       #
-      # This is an attribute method.  The following two expressions 
+      # This is an attribute method.  The following two expressions
       # are equivilent:
       #
-      #   book.title_change
-      #   book.attribute_change(:title)
+      #     book.title_change
+      #     book.attribute_change(:title)
       #
       # @example Asking for changes on an unchanged attribute
       #
@@ -168,7 +170,7 @@ module AWS
       #   book = Book.first
       #   book.title = 'New Title'
       #   book.title_change #=> ['Old Title', 'New Title']
-      # 
+      #
       # @param [String] attribute_name Name of the attribute to fetch
       #   a change for.
       # @return [Boolean] Returns true if the named attribute
@@ -184,15 +186,15 @@ module AWS
           end
         end
       end
-  
+
       # Returns the previous value for changed attributes, or the current
       # value for unchanged attributes.
       #
-      # This is an attribute method.  The following two expressions 
+      # This is an attribute method.  The following two expressions
       # are equivilent:
       #
-      #   book.title_was
-      #   book.attribute_was(:title)
+      #      book.title_was
+      #      book.attribute_was(:title)
       #
       # @example Returns the previous value for changed attributes:
       #
@@ -215,7 +217,7 @@ module AWS
           orig_values.has_key?(name) ? orig_values[name] : __send__(name)
         end
       end
-  
+
       # Reverts any changes to the attribute, restoring its original value.
       # @param [String] attribute_name Name of the attribute to reset.
       # @return [nil]
@@ -225,7 +227,7 @@ module AWS
         __send__("#{attribute_name}=", attribute_was(attribute_name))
         nil
       end
-  
+
       # Indicate to the record that you are about to edit an attribute
       # in place.
       # @param [String] attribute_name Name of the attribute that will
@@ -240,7 +242,7 @@ module AWS
             was = __send__(name)
             begin
               # booleans, nil, etc all #respond_to?(:clone), but they raise
-              # a TypeError when you attempt to dup them.  
+              # a TypeError when you attempt to dup them.
               orig_values[name] = was.clone
             rescue TypeError
               orig_values[name] = was
@@ -254,12 +256,12 @@ module AWS
       def orig_values
         @_orig_values ||= {}
       end
-  
+
       private
       def clear_change! attribute_name
         orig_values.delete(attribute_name)
       end
-  
+
       private
       def ignore_changes &block
         begin
@@ -269,17 +271,17 @@ module AWS
           @_ignore_changes = false
         end
       end
-  
+
       private
       def if_tracking_changes &block
         yield unless @_ignore_changes
       end
-  
+
       private
       def clear_changes!
         orig_values.clear
       end
-      
+
     end
   end
 end

data/lib/aws/record/errors.rb

@@ -15,20 +15,20 @@ module AWS
   module Record
 
     class Errors < Core::IndifferentHash
-      
+
       include Enumerable
 
       # Returns the errors for the atttibute in an array.
       #
-      #   errors.add(:name, 'may not be blank')
-      #   errors.add(:name, 'must be less than 30 characters')
-      #   errors[:name]
-      #   #=> ['may not be blank', 'must be less than 30 characters']
+      #     errors.add(:name, 'may not be blank')
+      #     errors.add(:name, 'must be less than 30 characters')
+      #     errors[:name]
+      #     #=> ['may not be blank', 'must be less than 30 characters']
       #
       # @param [String,Symbol] attribute_name The name of the attribute to retnr
       #   errors for.  You can pass the string or symbol version.
       # @return [Array<String>] Returns the error messages for the given
-      #   +attribute_name+.  If there are no errors on the attribute then
+      #   `attribute_name`.  If there are no errors on the attribute then
       #   an empty array is returned.
       def [] attribute_name
         super(attribute_name) || []
@@ -37,15 +37,15 @@ module AWS
 
       # Adds an error message to the named attribute.
       #
-      #   errors.add(:name, 'may not be blank')
-      #   errors.on(:name)
-      #   #=> ['may not be blank']
+      #     errors.add(:name, 'may not be blank')
+      #     errors.on(:name)
+      #     #=> ['may not be blank']
       #
-      # If you want to add a general error message, then pass +:base+ 
-      # for +attribute_name+, or call {#add_to_base}.
+      # If you want to add a general error message, then pass `:base`
+      # for `attribute_name`, or call {#add_to_base}.
       # @param [String,Symbol] attribute_name The name of the attribute
       #   that you are adding an error to.
-      # @param [String] message ('is invalid') The error message (should 
+      # @param [String] message ('is invalid') The error message (should
       #   not contain the attribute name).
       # @return [String] Returns the message.
       def []= attribute_name, message = 'is invalid'
@@ -60,7 +60,7 @@ module AWS
 
       # Adds a general error message (not associated with any particular
       # attribute).
-      # @param [String] message ('is invalid') The error message (should 
+      # @param [String] message ('is invalid') The error message (should
       #   not contain the attribute name).
       # @return [String] Returns the message.
       def add_to_base message
@@ -73,9 +73,9 @@ module AWS
       end
       alias_method :size, :count
 
-      # Yields once for each error message added.  
+      # Yields once for each error message added.
       #
-      # An attribute_name may yield more than once if there are more than 
+      # An attribute_name may yield more than once if there are more than
       # one errors associated with that attirbute.
       #
       # @yield [attribute_name, error_message]
@@ -93,9 +93,9 @@ module AWS
       # Returns the errors prefixed by a humanized version of the attribute
       # name.
       #
-      #   errors.add(:name, 'may not be blank')
-      #   errors.full_messages 
-      #   #=> ['Name may not be blank']
+      #     errors.add(:name, 'may not be blank')
+      #     errors.full_messages
+      #     #=> ['Name may not be blank']
       #
       # @return [Array of Strings] Returns an array of error messages.
       def full_messages
@@ -113,9 +113,9 @@ module AWS
       # Returns a hash of of errors messages.  Keys are attribute names
       # and values are arrays of error messages.
       #
-      #   errors.add(:name, 'may not be blank')
-      #   errors.to_hash
-      #   #=> { 'name' => ['may not be blank'] }
+      #     errors.add(:name, 'may not be blank')
+      #     errors.to_hash
+      #     #=> { 'name' => ['may not be blank'] }
       #
       # Please note that the hash values are always arrays, even if there
       # is only one error message for the attribute.

data/lib/aws/record/exceptions.rb

@@ -13,7 +13,7 @@
 
 module AWS
   module Record
-  
+
     # Raised when trying to access an attribute that does not exist.
     # @private
     class UndefinedAttributeError < StandardError
@@ -21,7 +21,7 @@ module AWS
         super("undefined attribute `#{attribute_name}`")
       end
     end
-  
+
     # Raised when calling #save!, #create! or #update_attributes! on a record that
     # has validation errors.
     # @private

data/lib/aws/record/hash_model.rb

@@ -11,45 +11,44 @@
 # ANY KIND, either express or implied. See the License for the specific
 # language governing permissions and limitations under the License.
 
-require 'aws/record/abstract_base'
-require 'aws/record/hash_model/scope'
-require 'aws/record/hash_model/attributes'
-require 'aws/record/hash_model/finder_methods'
-
 module AWS
   module Record
     class HashModel
 
+      require 'aws/record/hash_model/attributes'
+      require 'aws/record/hash_model/finder_methods'
+      require 'aws/record/hash_model/scope'
+
       extend AbstractBase
 
       class << self
 
         # Creates the DynamoDB table that is configured for this class.
         #
-        #   class Product < AWS::Record::HashModel
-        #   end
+        #     class Product < AWS::Record::HashModel
+        #     end
         #
-        #   # create the table 'Product' with 10 read/write capacity units
-        #   Product.create_table 10, 10
+        #     # create the table 'Product' with 10 read/write capacity units
+        #     Product.create_table 10, 10
         #
         # If you shard you data across multiple tables, you can specify the
         # shard name:
         #
-        #   # create two tables, with the given names
-        #   Product.create_table 500, 10, :shard_name => 'products-1'
-        #   Product.create_table 500, 10, :shard_name => 'products-2'
+        #     # create two tables, with the given names
+        #     Product.create_table 500, 10, :shard_name => 'products-1'
+        #     Product.create_table 500, 10, :shard_name => 'products-2'
         #
         # If you share a single AWS account with multiple applications, you
         # can provide a table prefix to group tables and to avoid name
         # collisions:
         #
-        #   AWS::Record.table_prefix = 'myapp-'
+        #     AWS::Record.table_prefix = 'myapp-'
         #
-        #   # creates the table 'myapp-Product'
-        #   Product.create_table 250, 50
+        #     # creates the table 'myapp-Product'
+        #     Product.create_table 250, 50
         #
-        #   # creates the table 'myapp-products-1'
-        #   Product.create_table 250, 50, :shard_name => 'products-1'
+        #     # creates the table 'myapp-products-1'
+        #     Product.create_table 250, 50, :shard_name => 'products-1'
         #
         # @param [Integer] read_capacity_units
         #   See {DynamoDB::TableCollection#create} for more information.
@@ -73,9 +72,9 @@ module AWS
           create_opts[:hash_key] = { :id => :string }
 
           dynamo_db.tables.create(
-            table_name, 
-            read_capacity_units, 
-            write_capacity_units, 
+            table_name,
+            read_capacity_units,
+            write_capacity_units,
             create_opts)
 
         end
@@ -100,7 +99,7 @@ module AWS
 
       end
 
-      # @return [DynamoDB::Item] Returns a reference to the item as stored in 
+      # @return [DynamoDB::Item] Returns a reference to the item as stored in
       #   simple db.
       # @private
       private