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

dynamoid 0.7.1 → 1.0.0

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