any_cache 0.2.0 → 0.3.0

data/lib/any_cache/adapters/dalli.rb

@@ -39,9 +39,16 @@ module AnyCache::Adapters
     # @since 0.1.0
     MIN_DECRESEAD_VAL = 0
 
+    # @return [Array]
+    #
+    # @api private
+    # @since 0.3.0
+    READ_MULTI_EMPTY_KEYS_SET = [].freeze
+
     # @since 0.1.0
     def_delegators :driver,
                    :get,
+                   :get_multi,
                    :set,
                    :incr,
                    :decr,
@@ -59,6 +66,25 @@ module AnyCache::Adapters
       get(key)
     end
 
+    # @param keys [Array<String>]
+    # @param options [Hash]
+    # @return [Hash]
+    #
+    # @api private
+    # @since 0.3.0
+    def read_multi(*keys, **options)
+      get_multi(*keys).tap do |res|
+        res.merge!(Hash[(keys - res.keys).zip(READ_MULTI_EMPTY_KEYS_SET)])
+      end
+    end
+
+    # @param key [String]
+    # @param value [Object]
+    # @option expires_in [Integer]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.1.0
     def write(key, value, **options)
       expires_in = options.fetch(:expires_in, NO_EXPIRATION_TTL)
       raw = options.fetch(:raw, true)
@@ -66,6 +92,51 @@ module AnyCache::Adapters
       set(key, value, expires_in, raw: raw)
     end
 
+    # @param entries [Hash]
+    # @param options [Hash]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.3.0
+    def write_multi(entries, **options)
+      raw = options.fetch(:raw, true)
+
+      entries.each_pair { |key, value| write(key, value, raw: raw) }
+    end
+
+    # @param key [String]
+    # @param fallback [Proc]
+    # @option expires_in [Integer]
+    # @option force [Boolean, Proc]
+    # @return [Object]
+    #
+    # @api private
+    # @since 0.2.0
+    def fetch(key, **options, &fallback)
+      force_rewrite = options.fetch(:force, false)
+      force_rewrite = force_rewrite.call(key) if force_rewrite.respond_to?(:call)
+
+      # NOTE: can conflict with :cache_nils Dalli::Client's config
+      read(key).tap { |value| return value if value } unless force_rewrite
+
+      yield(key).tap { |value| write(key, value, **options) } if block_given?
+    end
+
+    # @param keys [Array<String>]
+    # @param fallback [Proc]
+    # @option force [Boolean, Proc]
+    # @option expires_in [Integer]
+    # @return [Hash]
+    #
+    # @api private
+    # @since 0.3.0
+    def fetch_multi(*keys, **options, &fallback)
+      # TODO: think about multi-thread approach
+      keys.each_with_object({}) do |key, dataset|
+        dataset[key] = fetch(key, **options, &fallback)
+      end
+    end
+
     # @param key [String]
     # @param options [Hash]
     # @return [void]
@@ -76,6 +147,16 @@ module AnyCache::Adapters
       driver.delete(key)
     end
 
+    # @param pattern [String, Regexp]
+    # @param options [Hash]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.3.0
+    def delete_matched(pattern, **options)
+      # TODO: make it real >:]
+    end
+
     # @param key [String]
     # @param amount [Integer]
     # @option expires_in [NilClass, Integer]
@@ -147,22 +228,5 @@ module AnyCache::Adapters
     def exist?(key, **options)
       !get(key).nil? # NOTE: can conflict with :cache_nils Dalli::Client's config
     end
-
-    # @param key [String]
-    # @option expires_in [Integer]
-    # @option force [Boolean]
-    # @return [Object]
-    #
-    # @api private
-    # @since 0.2.0
-    def fetch(key, **options)
-      force_rewrite = options.fetch(:force, false)
-      force_rewrite = force_rewrite.call if force_rewrite.respond_to?(:call)
-
-      # NOTE: can conflict with :cache_nils Dalli::Client's config
-      read(key).tap { |value| return value if value } unless force_rewrite
-
-      yield.tap { |value| write(key, value, **options) } if block_given?
-    end
   end
 end

data/lib/any_cache/adapters/delegator.rb

@@ -10,10 +10,15 @@ module AnyCache::Adapters
       #
       # @api private
       # @since 0.1.0
+      # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/AbcSize
       def supported_driver?(driver)
         driver.respond_to?(:read) &&
+        driver.respond_to?(:read_multi) &&
         driver.respond_to?(:write) &&
+        driver.respond_to?(:write_multi) &&
+        driver.respond_to?(:fetch_multi) &&
         driver.respond_to?(:delete) &&
+        driver.respond_to?(:delete_matched) &&
         driver.respond_to?(:increment) &&
         driver.respond_to?(:decrement) &&
         driver.respond_to?(:expire) &&
@@ -22,13 +27,18 @@ module AnyCache::Adapters
         driver.respond_to?(:exist?) &&
         driver.respond_to?(:fetch)
       end
+      # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/AbcSize
     end
 
     # @since 0.1.0
     def_delegators :driver,
                    :read,
+                   :read_multi,
                    :write,
+                   :write_multi,
+                   :fetch_multi,
                    :delete,
+                   :delete_matched,
                    :increment,
                    :decrement,
                    :expire,

data/lib/any_cache/adapters/redis.rb

@@ -33,6 +33,18 @@ module AnyCache::Adapters
     # @since 0.1.0
     DEFAULT_INCR_DECR_AMOUNT = 1
 
+    # @return [String]
+    #
+    # @api private
+    # @since 0.3.0
+    DELETE_MATCHED_CURSOR_START = '0'
+
+    # @return [Integer]
+    #
+    # @api private
+    # @since 0.3.0
+    DELETE_MATCHED_BATCH_SIZE = 10
+
     # @since 0.1.0
     def_delegators :driver,
                    :get,
@@ -43,7 +55,10 @@ module AnyCache::Adapters
                    :decrby,
                    :pipelined,
                    :flushdb,
-                   :exists
+                   :exists,
+                   :mapped_mget,
+                   :mapped_mset,
+                   :scan
 
     # @param key [String]
     # @param options [Hash]
@@ -55,6 +70,16 @@ module AnyCache::Adapters
       get(key)
     end
 
+    # @param keys [Array<String>]
+    # @param options [Hash]
+    # @return [Hash]
+    #
+    # @api private
+    # @since 0.3.0
+    def read_multi(*keys, **options)
+      mapped_mget(*keys)
+    end
+
     # @param key [String]
     # @param value [Object]
     # @option expires_in [NilClass, Integer] Time in seconds
@@ -68,6 +93,47 @@ module AnyCache::Adapters
       expires_in ? setex(key, expires_in, value) : set(key, value)
     end
 
+    # @param entries [Hash]
+    # @param options [Hash]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.3.0
+    def write_multi(entries, **options)
+      mapped_mset(entries)
+    end
+
+    # @param key [String]
+    # @option expires_in [Integer]
+    # @option force [Boolean]
+    # @return [Object]
+    #
+    # @api private
+    # @since 0.2.0
+    def fetch(key, **options, &fallback)
+      force_rewrite = options.fetch(:force, false)
+      force_rewrite = force_rewrite.call(key) if force_rewrite.respond_to?(:call)
+
+      # NOTE: think about #pipelined
+      read(key).tap { |value| return value if value } unless force_rewrite
+
+      yield(key).tap { |value| write(key, value, **options) } if block_given?
+    end
+
+    # @param keys [Array<string>]
+    # @param options [Hash]
+    # @param fallback [Proc]
+    # @return [Hash]
+    #
+    # @api private
+    # @since 0.3.0
+    def fetch_multi(*keys, **options, &fallback)
+      # TODO: think about multi-thread approach
+      keys.each_with_object({}) do |key, dataset|
+        dataset[key] = fetch(key, **options, &fallback)
+      end
+    end
+
     # @param key [String]
     # @param options [Hash]
     # @return [void]
@@ -78,6 +144,31 @@ module AnyCache::Adapters
       del(key)
     end
 
+    # @param pattern [String, Regexp]
+    # @param options [Hash]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.3.0
+    def delete_matched(pattern, **options)
+      cursor = DELETE_MATCHED_CURSOR_START
+
+      case pattern
+      when String
+        loop do
+          cursor, keys = scan(cursor, match: pattern, count: DELETE_MATCHED_BATCH_SIZE)
+          del(keys)
+          break if cursor == DELETE_MATCHED_CURSOR_START
+        end
+      when Regexp
+        loop do
+          cursor, keys = scan(cursor, count: DELETE_MATCHED_BATCH_SIZE)
+          del(keys.grep(pattern))
+          break if cursor == DELETE_MATCHED_CURSOR_START
+        end
+      end
+    end
+
     # @param key [String]
     # @param amount [Integer]
     # @option expires_in [NilClass, Integer] Time in seconds
@@ -156,22 +247,5 @@ module AnyCache::Adapters
     def exist?(key, **options)
       exists(key)
     end
-
-    # @param key [String]
-    # @option expires_in [Integer]
-    # @option force [Boolean]
-    # @return [Object]
-    #
-    # @api private
-    # @since 0.2.0
-    def fetch(key, **options)
-      force_rewrite = options.fetch(:force, false)
-      force_rewrite = force_rewrite.call if force_rewrite.respond_to?(:call)
-
-      # NOTE: think about #pipelined
-      read(key).tap { |value| return value if value } unless force_rewrite
-
-      yield.tap { |value| write(key, value, **options) } if block_given?
-    end
   end
 end

data/lib/any_cache/adapters/redis_store.rb

@@ -15,6 +15,8 @@ module AnyCache::Adapters
       end
     end
 
+    def_delegators :driver, :mset
+
     # @param key [String]
     # @param options [Hash]
     # @return [Object]
@@ -27,6 +29,17 @@ module AnyCache::Adapters
       get(key, raw: raw)
     end
 
+    # @param keys [Array<String>]
+    # @param options [Hash]
+    # @return [Hash]
+    #
+    # @api private
+    # @since 0.3.0
+    def read_multi(*keys, **options)
+      # NOTE: cant use Redis::Store#mget cuz it has some marshalling errors :(
+      Hash[keys.zip(keys.map { |key| read(key, **options) })]
+    end
+
     # @param key [String]
     # @param value [Object]
     # @option expires_in [NilClass, Integer] Time in seconds
@@ -40,5 +53,15 @@ module AnyCache::Adapters
 
       expires_in ? setex(key, expires_in, value, raw: raw) : set(key, value, raw: raw)
     end
+
+    # @param entries [Hash]
+    # @param options [Hash]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.3.0
+    def write_multi(entries, **options)
+      mset(*entries.to_a.flatten!, raw: true)
+    end
   end
 end

data/lib/any_cache/adapters.rb

@@ -13,6 +13,7 @@ module AnyCache::Adapters
   require_relative 'adapters/active_support_redis_cache_store'
   require_relative 'adapters/active_support_memory_store'
   require_relative 'adapters/active_support_mem_cache_store'
+  require_relative 'adapters/active_support_dalli_store'
 
   class << self
     # @param driver [Object]
@@ -22,7 +23,7 @@ module AnyCache::Adapters
     #
     # @api private
     # @since 0.1.0
-    # rubocop:disable Metrics/LineLength
+    # rubocop:disable Metrics/LineLength, Metrics/AbcSize
     def build(driver)
       case
       when RedisStore.supported_driver?(driver)                   then RedisStore.new(driver)
@@ -32,11 +33,12 @@ module AnyCache::Adapters
       when ActiveSupportMemoryStore.supported_driver?(driver)     then ActiveSupportMemoryStore.new(driver)
       when ActiveSupportFileStore.supported_driver?(driver)       then ActiveSupportFileStore.new(driver)
       when ActiveSupportMemCacheStore.supported_driver?(driver)   then ActiveSupportMemCacheStore.new(driver)
+      when ActiveSupportDalliStore.supported_driver?(driver)      then ActiveSupportDalliStore.new(driver)
       when Delegator.supported_driver?(driver)                    then Delegator.new(driver)
       else
         raise AnyCache::UnsupportedDriverError
       end
     end
-    # rubocop:enable Metrics/LineLength
+    # rubocop:enable Metrics/LineLength, Metrics/AbcSize
   end
 end

data/lib/any_cache/delegation.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.3.0
+module AnyCache::Delegation
+  class << self
+    # @param base_klass [Class]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.3.0
+    def included(base_klass)
+      base_klass.extend(ClassMethods)
+    end
+  end
+
+  # @api private
+  # @since 0.3.0
+  module ClassMethods
+    # @param receiver [Symbol, String]
+    # @param delegators [Array<Symbol, String>]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.3.0
+    def def_loggable_delegators(receiver, *delegators)
+      delegators.each { |delegat| def_loggable_delegator(receiver, delegat) }
+    end
+
+    # @param receiver [Symbol, String]
+    # @param delegat [Symbol, String]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.3.0
+    def def_loggable_delegator(receiver, delegat)
+      define_method(delegat) do |*args, **opts, &block|
+        send(receiver).send(delegat, *args, **opts, &block).tap do
+          shared_config[:logger].tap do |logger|
+            AnyCache::Logging::Activity.log(
+              self, logger, activity: delegat, message:
+                "performed <#{delegat}> operation with " \
+                "params: #{args.inspect} and options: #{opts.inspect}."
+            ) if logger
+          end
+        end
+      end
+    end
+  end
+end

data/lib/any_cache/drivers/active_support_dalli_store.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module AnyCache::Drivers::ActiveSupportDalliStore
+  class << self
+    # @param driver [::ActiveSupport::Cache::DalliStore]
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.3.0
+    def supported_source?(driver)
+      defined?(::Dalli) &&
+      defined?(::ActiveSupport::Cache::DalliStore) &&
+      driver.is_a?(::ActiveSupport::Cache::DalliStore)
+    end
+
+    # @param settings [Qonfig:Settings]
+    # @return [::ActiveSupport::Cache::DalliStore]
+    #
+    # @api private
+    # @since 0.3.0
+    def build(settings)
+      ::ActiveSupport::Cache::DalliStore.new([Array(settings.servers), settings.options])
+    end
+  end
+end

data/lib/any_cache/drivers.rb

@@ -10,6 +10,7 @@ module AnyCache::Drivers
   require_relative 'drivers/active_support_memory_store'
   require_relative 'drivers/active_support_redis_cache_store'
   require_relative 'drivers/active_support_mem_cache_store'
+  require_relative 'drivers/active_support_dalli_store'
 
   class << self
     # @param config [Qonfig::DataSet]
@@ -19,6 +20,7 @@ module AnyCache::Drivers
     #
     # @api private
     # @since 0.2.0
+    # rubocop:disable Metrics/AbcSize
     def build(config)
       driver = config[:driver]
 
@@ -37,9 +39,12 @@ module AnyCache::Drivers
         ActiveSupportRedisCacheStore.build(config[:as_redis_cache_store])
       when :as_mem_cache_store
         ActiveSupportMemCacheStore.build(config[:as_mem_cache_store])
+      when :as_dalli_store
+        ActiveSupportDalliStore.build(config[:as_dalli_store])
       else
         raise AnyCache::UnsupportedDriverError
       end
     end
+    # rubocop:enable Metrics/AbcSize
   end
 end

data/lib/any_cache/logging/activity.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.3.0
+module AnyCache::Logging::Activity
+  # @return [String]
+  #
+  # @api private
+  # @since 0.3.0
+  ANONYMOUS_CACHER_CLASS_NAME = '<__anonymous_cache__>'
+
+  class << self
+    # @param cacher [AnyCache]
+    # @param logger [::Logger]
+    # @option activity [String, NilClass]
+    # @option message [String, NillClass]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.3.0
+    def log(cacher, logger, activity: nil, message: nil)
+      cacher = cacher.class.name || ANONYMOUS_CACHER_CLASS_NAME
+      progname = "[AnyCache<#{cacher}>/Activity<#{activity}>]"
+      logger.add(logger.level, message, progname)
+    end
+  end
+end

data/lib/any_cache/logging/logger.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.3.0
+class AnyCache::Logging::Logger < ::Logger
+  # @api public
+  # @since 0.3.0
+  def initialize(*, **)
+    super
+    self.level = ::Logger::INFO
+  end
+end

data/lib/any_cache/logging.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.3.0
+module AnyCache::Logging
+  require_relative 'logging/logger'
+  require_relative 'logging/activity'
+end

data/lib/any_cache/version.rb

@@ -2,5 +2,5 @@
 
 class AnyCache
   # @since 0.1.0
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/lib/any_cache.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'logger'
 require 'qonfig'
 require 'securerandom'
 require 'concurrent/atomic/reentrant_read_write_lock'
@@ -11,17 +12,22 @@ class AnyCache
   require_relative 'any_cache/error'
   require_relative 'any_cache/drivers'
   require_relative 'any_cache/adapters'
-
-  # @since 0.1.0
-  extend Forwardable
+  require_relative 'any_cache/logging'
+  require_relative 'any_cache/delegation'
 
   # @since 0.2.0
   include Qonfig::Configurable
 
+  # @since 0.3.0
+  include Delegation
+
   # @since 0.2.0
+  # rubocop:disable Metrics/BlockLength
   configuration do
     setting :driver
 
+    setting :logger, Logging::Logger.new(STDOUT)
+
     setting :redis do
       setting :options, {}
     end
@@ -52,7 +58,13 @@ class AnyCache
       setting :servers, nil
       setting :options, {}
     end
+
+    setting :as_dalli_store do
+      setting :servers, nil
+      setting :options, {}
+    end
   end
+  # rubocop:enable Metrics/BlockLength
 
   class << self
     # @param driver [Object]
@@ -66,18 +78,22 @@ class AnyCache
   end
 
   # @api public
-  # @since 0.1.0
-  def_delegators :adapter,
-                 :read,
-                 :write,
-                 :delete,
-                 :increment,
-                 :decrement,
-                 :expire,
-                 :persist,
-                 :clear,
-                 :exist?,
-                 :fetch
+  # @since 0.3.0
+  def_loggable_delegators :adapter,
+                          :read,
+                          :read_multi,
+                          :write,
+                          :write_multi,
+                          :fetch,
+                          :fetch_multi,
+                          :delete,
+                          :delete_matched,
+                          :increment,
+                          :decrement,
+                          :expire,
+                          :persist,
+                          :clear,
+                          :exist?
 
   # @return [AnyCache::Adapters::Basic]
   #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: any_cache
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-09-04 00:00:00.000000000 Z
+date: 2018-10-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -167,6 +167,7 @@ files:
 - gemfiles/redis_store.gemfile
 - lib/any_cache.rb
 - lib/any_cache/adapters.rb
+- lib/any_cache/adapters/active_support_dalli_store.rb
 - lib/any_cache/adapters/active_support_file_store.rb
 - lib/any_cache/adapters/active_support_file_store/decrement.rb
 - lib/any_cache/adapters/active_support_file_store/expire.rb
@@ -194,7 +195,9 @@ files:
 - lib/any_cache/adapters/delegator.rb
 - lib/any_cache/adapters/redis.rb
 - lib/any_cache/adapters/redis_store.rb
+- lib/any_cache/delegation.rb
 - lib/any_cache/drivers.rb
+- lib/any_cache/drivers/active_support_dalli_store.rb
 - lib/any_cache/drivers/active_support_file_store.rb
 - lib/any_cache/drivers/active_support_mem_cache_store.rb
 - lib/any_cache/drivers/active_support_memory_store.rb
@@ -203,6 +206,9 @@ files:
 - lib/any_cache/drivers/redis.rb
 - lib/any_cache/drivers/redis_store.rb
 - lib/any_cache/error.rb
+- lib/any_cache/logging.rb
+- lib/any_cache/logging/activity.rb
+- lib/any_cache/logging/logger.rb
 - lib/any_cache/version.rb
 homepage: https://github.com/0exp/any_cache
 licenses: