cachext 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3072a5999fa8a90d21259de13caec3f355eebdc4
-  data.tar.gz: 7ef116659a1bfa08174f3c27157752a3bdd13c8d
+  metadata.gz: 1141e77be7834868ab37636024f4eeea8c719581
+  data.tar.gz: aed591612989be4abf58211a409542c9f51c189e
 SHA512:
-  metadata.gz: 1c7308ee711bb3c43522f1801fe51f6de0653057a2e6cccd7e9ae0e27be8d42e7ce5285b3287a371f1fe5b26b6ffee1e789db1a1a793ec26fdc991a7ded85489
-  data.tar.gz: 3cb8a48dcd02fac5070bb695e35064fe5562f8303265c334e8846c44bf0a358e6b011e5a63ce60dfe1ea5d61e096f5f070652668ec2dea0fe929fd29d9cf84fe
+  metadata.gz: 4f0bcdf511a0c61b65ee32a4b7a82c1f14864c08bd9a7c5c609970f6bc8f13cbe3c4c2e183966fb75d16cbeb2ce5a7f5f490c1ab9f02f268df8c1f324248370a
+  data.tar.gz: 7bffc2e75ce62b71a0a3db99c917653304291bb7ad854582a04caf7103bbfc18deb2a9c2e9026959ca51bccf143b9d4d532aa886d5afa312531cdd8ae65a771d

data/lib/cachext.rb

@@ -4,8 +4,10 @@ require "faraday/error"
 module Cachext
   autoload :Client, "cachext/client"
   autoload :Configuration, "cachext/configuration"
-  autoload :Key, "cachext/key"
   autoload :Features, "cachext/features"
+  autoload :Key, "cachext/key"
+  autoload :MissingRecord, "cachext/missing_record"
+  autoload :Multi, "cachext/multi"
   autoload :Options, "cachext/options"
 
   def self.Key raw_key
@@ -36,4 +38,8 @@ module Cachext
     config.cache.clear
     config.redis.del "cachext:*"
   end
+
+  def self.multi klass, ids, options = {}, &block
+    Multi.new(config, klass, options).fetch ids, &block
+  end
 end

data/lib/cachext/missing_record.rb

@@ -0,0 +1,12 @@
+module Cachext
+  MissingRecord = Struct.new(:id)
+  class MissingRecord
+    def missing?
+      true
+    end
+
+    def present?
+      false
+    end
+  end
+end

data/lib/cachext/multi.rb

@@ -0,0 +1,114 @@
+require "active_support/core_ext/module/delegation"
+require "active_support/core_ext/hash/keys"
+require "active_support/core_ext/hash/reverse_merge"
+
+module Cachext
+  class Multi
+    delegate :cache, :default_errors, :error_logger, to: :@config
+
+    def initialize config, key_base, options = {}
+      @config = config
+      @key_base = key_base
+      @options = options
+    end
+
+    def fetch ids, &block
+      records = FindByIds.new(self, ids, block).records
+
+      if @options.fetch(:return_array, false)
+        records.values + missing_records(ids - records.keys)
+      else
+        records
+      end
+    end
+
+    def key id
+      @key_base + [id]
+    end
+
+    def expires_in
+      @options.fetch :expires_in, @config.default_expires_in
+    end
+
+    private
+
+    def missing_records ids
+      ids.map { |id| MissingRecord.new id }
+    end
+
+    class FindByIds
+      attr_reader :multi, :ids
+
+      delegate :cache, to: :multi
+
+      def initialize(multi, ids, lookup)
+        @multi = multi
+        @ids = ids
+        @lookup = lookup
+      end
+
+      def records
+        fresh_cached.merge(direct).reverse_merge(stale)
+      end
+
+      private
+
+      def fresh_cached
+        @fresh_cached ||= cache.read_multi(*ids.map { |id| multi.key(id) }).
+          transform_keys { |key| key.last }
+      end
+
+      def uncached_or_stale_ids
+        ids - fresh_cached.keys
+      end
+
+      def direct
+        @direct ||= if uncached_or_stale_ids.length > 0
+          records = uncached_where uncached_or_stale_ids
+          write_cache records
+          records
+        else
+          {}
+        end
+      end
+
+      def write_cache records
+        records.each do |id, record|
+          key = Key.new(multi.key(id))
+          key.write record, expires_in: multi.expires_in
+          key.write_backup record
+        end
+      end
+
+      def delete_backups ids
+        return if ids.blank?
+
+        ids.each do |id|
+          key = Key.new(multi.key(id))
+          key.delete_backup
+        end
+      end
+
+      def stale
+        cache.read_multi(*(uncached_or_stale_ids - direct.keys).map { |id| [:backup_cache] + multi.key(id) }).
+          transform_keys { |key| key.last }
+      end
+
+      def uncached_where ids
+        records = @lookup.call ids
+
+        if records.is_a?(Array)
+          records = records.each_with_object({}) do |record, acc|
+            acc[record.id] = record
+          end
+        end
+
+        delete_backups ids - records.keys
+        records
+      rescue *multi.default_errors => e
+        multi.error_logger.error e
+        {}
+      end
+    end
+  end
+end

data/lib/cachext/version.rb

@@ -1,3 +1,3 @@
 module Cachext
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cachext
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Donald Plummer
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-12-01 00:00:00.000000000 Z
+date: 2015-12-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -191,6 +191,8 @@ files:
 - lib/cachext/features/default.rb
 - lib/cachext/features/lock.rb
 - lib/cachext/key.rb
+- lib/cachext/missing_record.rb
+- lib/cachext/multi.rb
 - lib/cachext/options.rb
 - lib/cachext/version.rb
 homepage: https://github.com/dplummer/cachext