RubyGems - dynamoid - Versions diffs - 0.7.1 → 1.0.0 - Mend

dynamoid 0.7.1 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (123) hide show

checksums.yaml +7 -0
data/Gemfile +2 -24
data/README.markdown +89 -73
data/Rakefile +10 -36
data/dynamoid.gemspec +56 -191
data/lib/dynamoid.rb +6 -4
data/lib/dynamoid/adapter.rb +64 -150
data/lib/dynamoid/adapter_plugin/aws_sdk_v2.rb +579 -0
data/lib/dynamoid/components.rb +0 -1
data/lib/dynamoid/config.rb +2 -5
data/lib/dynamoid/criteria.rb +1 -1
data/lib/dynamoid/criteria/chain.rb +27 -140
data/lib/dynamoid/document.rb +2 -2
data/lib/dynamoid/errors.rb +30 -9
data/lib/dynamoid/fields.rb +15 -3
data/lib/dynamoid/finders.rb +7 -6
data/lib/dynamoid/identity_map.rb +1 -5
data/lib/dynamoid/persistence.rb +108 -93
metadata +56 -229
data/.document +0 -5
data/.rspec +0 -1
data/.travis.yml +0 -7
data/Gemfile.lock +0 -81
data/Gemfile_activemodel4 +0 -24
data/Gemfile_activemodel4.lock +0 -88
data/VERSION +0 -1
data/doc/.nojekyll +0 -0
data/doc/Dynamoid.html +0 -328
data/doc/Dynamoid/Adapter.html +0 -1872
data/doc/Dynamoid/Adapter/AwsSdk.html +0 -2101
data/doc/Dynamoid/Adapter/Local.html +0 -1574
data/doc/Dynamoid/Associations.html +0 -138
data/doc/Dynamoid/Associations/Association.html +0 -847
data/doc/Dynamoid/Associations/BelongsTo.html +0 -161
data/doc/Dynamoid/Associations/ClassMethods.html +0 -766
data/doc/Dynamoid/Associations/HasAndBelongsToMany.html +0 -167
data/doc/Dynamoid/Associations/HasMany.html +0 -167
data/doc/Dynamoid/Associations/HasOne.html +0 -161
data/doc/Dynamoid/Associations/ManyAssociation.html +0 -1684
data/doc/Dynamoid/Associations/SingleAssociation.html +0 -627
data/doc/Dynamoid/Components.html +0 -242
data/doc/Dynamoid/Config.html +0 -412
data/doc/Dynamoid/Config/Options.html +0 -638
data/doc/Dynamoid/Criteria.html +0 -138
data/doc/Dynamoid/Criteria/Chain.html +0 -1471
data/doc/Dynamoid/Criteria/ClassMethods.html +0 -105
data/doc/Dynamoid/Dirty.html +0 -424
data/doc/Dynamoid/Dirty/ClassMethods.html +0 -174
data/doc/Dynamoid/Document.html +0 -1033
data/doc/Dynamoid/Document/ClassMethods.html +0 -1116
data/doc/Dynamoid/Errors.html +0 -125
data/doc/Dynamoid/Errors/ConditionalCheckFailedException.html +0 -141
data/doc/Dynamoid/Errors/DocumentNotValid.html +0 -221
data/doc/Dynamoid/Errors/Error.html +0 -137
data/doc/Dynamoid/Errors/InvalidField.html +0 -141
data/doc/Dynamoid/Errors/InvalidQuery.html +0 -131
data/doc/Dynamoid/Errors/MissingRangeKey.html +0 -141
data/doc/Dynamoid/Fields.html +0 -686
data/doc/Dynamoid/Fields/ClassMethods.html +0 -438
data/doc/Dynamoid/Finders.html +0 -135
data/doc/Dynamoid/Finders/ClassMethods.html +0 -943
data/doc/Dynamoid/IdentityMap.html +0 -492
data/doc/Dynamoid/IdentityMap/ClassMethods.html +0 -534
data/doc/Dynamoid/Indexes.html +0 -321
data/doc/Dynamoid/Indexes/ClassMethods.html +0 -369
data/doc/Dynamoid/Indexes/Index.html +0 -1142
data/doc/Dynamoid/Middleware.html +0 -115
data/doc/Dynamoid/Middleware/IdentityMap.html +0 -264
data/doc/Dynamoid/Persistence.html +0 -892
data/doc/Dynamoid/Persistence/ClassMethods.html +0 -836
data/doc/Dynamoid/Validations.html +0 -415
data/doc/_index.html +0 -506
data/doc/class_list.html +0 -53
data/doc/css/common.css +0 -1
data/doc/css/full_list.css +0 -57
data/doc/css/style.css +0 -338
data/doc/file.LICENSE.html +0 -73
data/doc/file.README.html +0 -416
data/doc/file_list.html +0 -58
data/doc/frames.html +0 -28
data/doc/index.html +0 -416
data/doc/js/app.js +0 -214
data/doc/js/full_list.js +0 -178
data/doc/js/jquery.js +0 -4
data/doc/method_list.html +0 -1144
data/doc/top-level-namespace.html +0 -112
data/lib/dynamoid/adapter/aws_sdk.rb +0 -287
data/lib/dynamoid/indexes.rb +0 -69
data/lib/dynamoid/indexes/index.rb +0 -103
data/spec/app/models/address.rb +0 -13
data/spec/app/models/camel_case.rb +0 -34
data/spec/app/models/car.rb +0 -6
data/spec/app/models/magazine.rb +0 -11
data/spec/app/models/message.rb +0 -9
data/spec/app/models/nuclear_submarine.rb +0 -5
data/spec/app/models/sponsor.rb +0 -8
data/spec/app/models/subscription.rb +0 -12
data/spec/app/models/tweet.rb +0 -12
data/spec/app/models/user.rb +0 -26
data/spec/app/models/vehicle.rb +0 -7
data/spec/dynamoid/adapter/aws_sdk_spec.rb +0 -376
data/spec/dynamoid/adapter_spec.rb +0 -155
data/spec/dynamoid/associations/association_spec.rb +0 -194
data/spec/dynamoid/associations/belongs_to_spec.rb +0 -71
data/spec/dynamoid/associations/has_and_belongs_to_many_spec.rb +0 -47
data/spec/dynamoid/associations/has_many_spec.rb +0 -42
data/spec/dynamoid/associations/has_one_spec.rb +0 -45
data/spec/dynamoid/associations_spec.rb +0 -16
data/spec/dynamoid/config_spec.rb +0 -27
data/spec/dynamoid/criteria/chain_spec.rb +0 -210
data/spec/dynamoid/criteria_spec.rb +0 -75
data/spec/dynamoid/dirty_spec.rb +0 -57
data/spec/dynamoid/document_spec.rb +0 -180
data/spec/dynamoid/fields_spec.rb +0 -156
data/spec/dynamoid/finders_spec.rb +0 -147
data/spec/dynamoid/identity_map_spec.rb +0 -45
data/spec/dynamoid/indexes/index_spec.rb +0 -104
data/spec/dynamoid/indexes_spec.rb +0 -25
data/spec/dynamoid/persistence_spec.rb +0 -301
data/spec/dynamoid/validations_spec.rb +0 -36
data/spec/dynamoid_spec.rb +0 -9
data/spec/spec_helper.rb +0 -55
data/spec/support/with_partitioning.rb +0 -15

data/doc/top-level-namespace.html DELETED

@@ -1,112 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<title>
-  Top Level Namespace
-    &mdash; Documentation by YARD 0.8.6.1
-</title>
-  <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
-  <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
-<script type="text/javascript" charset="utf-8">
-  hasFrames = window.top.frames.main ? true : false;
-  relpath = '';
-  framesUrl = "frames.html#!" + escape(window.location.href);
-</script>
-  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
-  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
-  </head>
-  <body>
-    <div id="header">
-      <div id="menu">
-    <a href="_index.html">Index</a> &raquo;
-    <span class="title">Top Level Namespace</span>
-  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
-</div>
-      <div id="search">
-    <a class="full_list_link" id="class_list_link"
-        href="class_list.html">
-      Class List
-    </a>
-    <a class="full_list_link" id="method_list_link"
-        href="method_list.html">
-      Method List
-    </a>
-    <a class="full_list_link" id="file_list_link"
-        href="file_list.html">
-      File List
-    </a>
-</div>
-      <div class="clear"></div>
-    </div>
-    <iframe id="search_frame"></iframe>
-    <div id="content"><h1>Top Level Namespace
-</h1>
-<dl class="box">
-</dl>
-<div class="clear"></div>
-<h2>Defined Under Namespace</h2>
-<p class="children">
-      <strong class="modules">Modules:</strong> <span class='object_link'><a href="Dynamoid.html" title="Dynamoid (module)">Dynamoid</a></span>
-</p>
-</div>
-    <div id="footer">
-  Generated on Thu Jun 27 21:59:09 2013 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.6.1 (ruby-1.9.3).
-</div>
-  </body>
-</html>

data/lib/dynamoid/adapter/aws_sdk.rb DELETED

@@ -1,287 +0,0 @@
-# encoding: utf-8
-require 'aws'
-module Dynamoid
-  module Adapter
-    # The AwsSdk adapter provides support for the AWS-SDK for Ruby gem.
-    # More information is available at that Gem's Github page:
-    # https://github.com/amazonwebservices/aws-sdk-for-ruby
-    #
-    module AwsSdk
-      extend self
-      @@connection = nil
-      # Establish the connection to DynamoDB.
-      #
-      # @return [AWS::DynamoDB::Connection] the raw DynamoDB connection
-      # Call DynamoDB new, with no parameters.
-      # Make sure the aws.yml file or aws.rb file, refer the link for more details.
-      #https://github.com/amazonwebservices/aws-sdk-for-ruby
-      # 1. Create config/aws.yml as follows:
-      # Fill in your AWS Access Key ID and Secret Access Key
-      # http://aws.amazon.com/security-credentials
-      #access_key_id: REPLACE_WITH_ACCESS_KEY_ID
-      #secret_access_key: REPLACE_WITH_SECRET_ACCESS_KEY
-      #(or)
-      #2, Create config/initializers/aws.rb as follows:
-      # load the libraries
-      #require 'aws'
-      # log requests using the default rails logger
-      #AWS.config(:logger => Rails.logger)
-      # load credentials from a file
-      #config_path = File.expand_path(File.dirname(__FILE__)+"/../aws.yml")
-      #AWS.config(YAML.load(File.read(config_path)))
-      #Additionally include any of the dynamodb paramters as needed
-      #(eg: if you would like to change the dynamodb endpoint, then add the parameter in
-      # the following paramter in the file  aws.yml or aws.rb
-      # dynamo_db_endpoint : dynamodb.ap-southeast-1.amazonaws.com)
-      # @since 0.2.0
-      def connect!
-      @@connection = AWS::DynamoDB.new
-      end
-      # Return the established connection.
-      #
-      # @return [AWS::DynamoDB::Connection] the raw DynamoDB connection
-      #
-      # @since 0.2.0
-      def connection
-        @@connection
-      end
-      # Get many items at once from DynamoDB. More efficient than getting each item individually.
-      #
-      # @example Retrieve IDs 1 and 2 from the table testtable
-      #   Dynamoid::Adapter::AwsSdk.batch_get_item({'table1' => ['1', '2']}, :consistent_read => true)
-      #
-      # @param [Hash] table_ids the hash of tables and IDs to retrieve
-      # @param [Hash] options to be passed to underlying BatchGet call
-      #
-      # @return [Hash] a hash where keys are the table names and the values are the retrieved items
-      #
-      # @since 0.2.0
-      def batch_get_item(table_ids, options = {})
-        hash = Hash.new{|h, k| h[k] = []}
-        return hash if table_ids.all?{|k, v| v.empty?}
-        table_ids.each do |t, ids|
-          Array(ids).in_groups_of(100, false) do |group|
-            batch = AWS::DynamoDB::BatchGet.new(:config => @@connection.config)
-            batch.table(t, :all, Array(group), options) unless group.nil? || group.empty?
-            batch.each do |table_name, attributes|
-              hash[table_name] << attributes.symbolize_keys!
-            end
-          end
-        end
-        hash
-      end
-      # Delete many items at once from DynamoDB. More efficient than delete each item individually.
-      #
-      # @example Delete IDs 1 and 2 from the table testtable
-      #   Dynamoid::Adapter::AwsSdk.batch_delete_item('table1' => ['1', '2'])
-      #or
-      #   Dynamoid::Adapter::AwsSdk.batch_delete_item('table1' => [['hk1', 'rk2'], ['hk1', 'rk2']]]))
-      #
-      # @param [Hash] options the hash of tables and IDs to delete
-      #
-      # @return nil
-      #
-      def batch_delete_item(options)
-        return nil if options.all?{|k, v| v.empty?}
-        options.each do |t, ids|
-          Array(ids).in_groups_of(25, false) do |group|
-            batch = AWS::DynamoDB::BatchWrite.new(:config => @@connection.config)
-            batch.delete(t,group)
-            batch.process!
-          end
-        end
-        nil
-      end
-      # Create a table on DynamoDB. This usually takes a long time to complete.
-      #
-      # @param [String] table_name the name of the table to create
-      # @param [Symbol] key the table's primary key (defaults to :id)
-      # @param [Hash] options provide a range_key here if you want one for the table
-      #
-      # @since 0.2.0
-      def create_table(table_name, key = :id, options = {})
-        Dynamoid.logger.info "Creating #{table_name} table. This could take a while."
-        options[:hash_key] ||= {key.to_sym => :string}
-        read_capacity = options[:read_capacity] || Dynamoid::Config.read_capacity
-        write_capacity = options[:write_capacity] || Dynamoid::Config.write_capacity
-        table = @@connection.tables.create(table_name, read_capacity, write_capacity, options)
-        sleep 0.5 while table.status == :creating
-        return table
-      end
-      # Removes an item from DynamoDB.
-      #
-      # @param [String] table_name the name of the table
-      # @param [String] key the hash key of the item to delete
-      # @param [Number] range_key the range key of the item to delete, required if the table has a composite key
-      #
-      # @since 0.2.0
-      def delete_item(table_name, key, options = {})
-        range_key = options.delete(:range_key)
-        table = get_table(table_name)
-        result = table.items.at(key, range_key)
-        result.delete unless result.attributes.to_h.empty?
-        true
-      end
-      # Deletes an entire table from DynamoDB. Only 10 tables can be in the deleting state at once,
-      # so if you have more this method may raise an exception.
-      #
-      # @param [String] table_name the name of the table to destroy
-      #
-      # @since 0.2.0
-      def delete_table(table_name)
-        Dynamoid.logger.info "Deleting #{table_name} table. This could take a while."
-        table = @@connection.tables[table_name]
-        table.delete
-        sleep 0.5 while table.exists? == true
-      end
-      # @todo Add a DescribeTable method.
-      # Fetches an item from DynamoDB.
-      #
-      # @param [String] table_name the name of the table
-      # @param [String] key the hash key of the item to find
-      # @param [Number] range_key the range key of the item to find, required if the table has a composite key
-      #
-      # @return [Hash] a hash representing the raw item in DynamoDB
-      #
-      # @since 0.2.0
-      def get_item(table_name, key, options = {})
-        range_key = options.delete(:range_key)
-        table = get_table(table_name)
-        result = table.items.at(key, range_key).attributes.to_h(options)
-        if result.empty?
-          nil
-        else
-          result.symbolize_keys!
-        end
-      end
-      def update_item(table_name, key, options = {}, &block)
-        range_key = options.delete(:range_key)
-        conditions = options.delete(:conditions) || {}
-        table = get_table(table_name)
-        item = table.items.at(key, range_key)
-        item.attributes.update(conditions.merge(:return => :all_new), &block)
-      rescue AWS::DynamoDB::Errors::ConditionalCheckFailedException
-        raise Dynamoid::Errors::ConditionalCheckFailedException
-      end
-      # List all tables on DynamoDB.
-      #
-      # @since 0.2.0
-      def list_tables
-        @@connection.tables.collect(&:name)
-      end
-      # Persists an item on DynamoDB.
-      #
-      # @param [String] table_name the name of the table
-      # @param [Object] object a hash or Dynamoid object to persist
-      #
-      # @since 0.2.0
-      def put_item(table_name, object, options = nil)
-        table = get_table(table_name)
-        table.items.create(
-          object.delete_if{|k, v| v.nil? || (v.respond_to?(:empty?) && v.empty?)},
-          options || {}
-        )
-      rescue AWS::DynamoDB::Errors::ConditionalCheckFailedException => e
-        raise Dynamoid::Errors::ConditionalCheckFailedException
-      end
-      # Query the DynamoDB table. This employs DynamoDB's indexes so is generally faster than scanning, but is
-      # only really useful for range queries, since it can only find by one hash key at once. Only provide
-      # one range key to the hash.
-      #
-      # @param [String] table_name the name of the table
-      # @param [Hash] opts the options to query the table with
-      # @option opts [String] :hash_value the value of the hash key to find
-      # @option opts [Range] :range_value find the range key within this range
-      # @option opts [Number] :range_greater_than find range keys greater than this
-      # @option opts [Number] :range_less_than find range keys less than this
-      # @option opts [Number] :range_gte find range keys greater than or equal to this
-      # @option opts [Number] :range_lte find range keys less than or equal to this
-      #
-      # @return [Enumerator] an iterator of all matching items
-      #
-      # @since 0.2.0
-      def query(table_name, opts = {})
-        table = get_table(table_name)
-        Enumerator.new do |yielder|
-          consistent_opts = { :consistent_read => opts[:consistent_read] || false }
-          if table.composite_key?
-            table.items.query(opts).each do |data|
-              if opts.has_key? :select
-                yielder.yield data.attributes.symbolize_keys!
-              else
-                yielder.yield data.attributes.to_h(consistent_opts).symbolize_keys!
-              end
-            end
-          else
-            yielder.yield get_item(table_name, opts[:hash_value])
-          end
-        end
-      end
-      # Scan the DynamoDB table. This is usually a very slow operation as it naively filters all data on
-      # the DynamoDB servers.
-      #
-      # @param [String] table_name the name of the table
-      # @param [Hash] scan_hash a hash of attributes: matching records will be returned by the scan
-      #
-      # @return [Enumerator] an iterator of all matching items
-      #
-      # @since 0.2.0
-      def scan(table_name, scan_hash, select_opts)
-        table = get_table(table_name)
-        Enumerator.new do |yielder|
-          table.items.where(scan_hash).select(select_opts).each do |data|
-            yielder.yield data.attributes.symbolize_keys!
-          end
-        end
-      end
-      # @todo Add an UpdateItem method.
-      # @todo Add an UpdateTable method.
-      def get_table(table_name)
-        unless table = table_cache[table_name]
-          table = @@connection.tables[table_name]
-          table.load_schema
-          table_cache[table_name] = table
-        end
-        table
-      end
-      def table_cache
-        @table_cache ||= {}
-      end
-      # Number of items from a table
-      #
-      # @param [String] table_name the name of the table
-      #
-      # @return [Integer] the number of items from a table
-      #
-      # @since 0.6.1
-      def count(table_name)
-        table = get_table(table_name)
-        table.items.count
-      end
-    end
-  end
-end

data/lib/dynamoid/indexes.rb DELETED

@@ -1,69 +0,0 @@
-# encoding: utf-8
-require 'dynamoid/indexes/index'
-module Dynamoid #:nodoc:
-  # Indexes are quick ways of performing queries by anything other than id in DynamoDB. They are denormalized tables;
-  # that is, data is duplicated in the initial table (where the object is saved) and the index table (where
-  # we perform indexing).
-  module Indexes
-    extend ActiveSupport::Concern
-    # Make some helpful attributes to persist indexes.
-    included do
-      class_attribute :indexes
-      self.indexes = {}
-    end
-    module ClassMethods
-      # The call to create an index. Generates a new index with the specified options -- for more information, see Dynamoid::Indexes::Index.
-      # This function also attempts to immediately create the indexing table if it does not exist already.
-      #
-      # @since 0.2.0
-      def index(name, options = {})
-        index = Dynamoid::Indexes::Index.new(self, name, options)
-        self.indexes[index.name] = index
-        create_indexes
-      end
-      # Helper function to find indexes.
-      #
-      # @since 0.2.0
-      def find_index(index)
-        self.indexes[Array(index).collect(&:to_s).sort.collect(&:to_sym)]
-      end
-      # Helper function to create indexes (if they don't exist already).
-      #
-      # @since 0.2.0
-      def create_indexes
-        self.indexes.each do |name, index|
-          opts = {:table_name => index.table_name, :id => :id}
-          opts[:range_key] = { :range => :number } if index.range_key?
-          self.create_table(opts)
-        end
-      end
-    end
-    # Callback for an object to save itself to each of a class' indexes.
-    #
-    # @since 0.2.0
-    def save_indexes
-      self.class.indexes.each do |name, index|
-        index.save(self)
-      end
-    end
-    # Callback for an object to delete itself from each of a class' indexes.
-    #
-    # @since 0.2.0
-    def delete_indexes
-      self.class.indexes.each do |name, index|
-        index.delete(self)
-      end
-    end
-  end
-end