any_cache 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb955a7841f5f154dd3a18dcc911333edcf3f9ccc7564c84a8165022cb64e201
-  data.tar.gz: 85ff1e78b433f11a8b870c49fd012b984491873923be153abf6117c57b757a49
+  metadata.gz: b4257f6b3fe2d927086723caf69eec54042cca687633f6737ee42f6604f434a8
+  data.tar.gz: dd574909f6c2668f13f19e97cafb948dd1f8c5b4a284705a221b486ccdf29872
 SHA512:
-  metadata.gz: aaf92352c50ff3a15610214136f4c8b586786548ee384ec46c377b8f055318060417b0cf14ce9c4522e551b3891a2fe35546570f7ba7bef050faee921b4acbbe
-  data.tar.gz: 14c37f9ab0c5319408e6366c4bcafacf3eb0f220b621fb7c68325ceac0bed3173953003e1ba052888788e875e98390d21e95588b9d82cddcef361a9b630e51ff
+  metadata.gz: 88934a670129cf8a67177471884cc8aa493868c4a0ebe6e73899939d2ffd86c5877341965aba82860752e22fe72fb04abbc51c3e071d6f90507367581cba830c
+  data.tar.gz: 676ed5568765a5916992333417503942cb545113aa30241c966b0723b7e521334991c56e008284e9f641db33e368509a8aa244a99658c07ca619ff67ce015c91

data/.travis.yml

@@ -70,6 +70,18 @@ matrix:
   - rvm: ruby-head
     gemfile: gemfiles/redis_store.gemfile
     env: TEST_REDIS_STORE_CACHE=true
+  - rvm: 2.3.7
+    gemfile: gemfiles/active_support_with_dalli.gemfile
+    env: TEST_AS_DALLI_STORE=true
+  - rvm: 2.4.4
+    gemfile: gemfiles/active_support_with_dalli.gemfile
+    env: TEST_AS_DALLI_STORE=true
+  - rvm: 2.5.1
+    gemfile: gemfiles/active_support_with_dalli.gemfile
+    env: TEST_AS_DALLI_STORE=true
+  - rvm: ruby-head
+    gemfile: gemfiles/active_support_with_dalli.gemfile
+    env: TEST_AS_DALLI_STORE=true
   - rvm: 2.3.7
     gemfile: gemfiles/redis_store.gemfile
     env: TEST_REDIS_CACHE=true
@@ -94,3 +106,6 @@ matrix:
   - rvm: ruby-head
     gemfile: gemfiles/active_support_with_dalli.gemfile
     env: TEST_AS_MEM_CACHE_STORE_CACHE=true
+notifications:
+  slack:
+    secure: CRYB00OjJTaAYDPM7VgzdU6kBu0WcgwxyzXR6UTrTklrz3jI8ZRKUxrIqNJXvvYbmQPmnRClCeb1/K865RaH+r6Lc+Fob9mBJrjX2eH8CRtBpn542MgKQcJrJR1rrZnxSq7hAfjzYddtbF/vlzkW5yIRLvtihzY9pP+o9XEJF4mhMZWZw8qeqfK16uDzInYpS7ocw7TjDobKPSpG7SXpm+tVMV+0Wmq/58GZDiHq/vEIPiEegnXEEA6lJao/isZtUGn0YFY+ibQA0MrjnBouIdm4MMkK62ybS8dV/EKT6z0ZuG81VhS8Jb6h8H5j9td8xzjYsHpb1FZE0Rwr8ClWmo2vPRekPxpwqJMBM9lBKJ4Ez7lNWsJP0YkleKfmDEN1KIaMMH4g2YXeTfDagVHc803ooNjCbS1EMA1fZgF77gdlG10sdbyexHkxYxw1rozSa1G6OdDBbKehdaCbqbiqx0unI6gQtENa6ouUiIndZjE/ehcHnP4Y8lFTIbwmvGqborkhsI/0/8X0/Xh6GDypOml3mvKT5u7m0UYBy5lSQpTpmZVz9TV3pId12DM1eObIeWxYRkz+L+7stQBfVAVy8mZFLxm2pmey/Vn5pwAnEwgOBZ5qFPrIEHrjgH91rpdvYVPYswYdGm7WrKPpta4pQhSqDMlKhW1zfk+AMmZ4Yz0=

data/CHANGELOG.md

@@ -1,7 +1,22 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [0.3.0] - 2018-10-06
+### Added
+- support for `ActiveSupport::Cache::DalliStore` client;
+- multi-operations: `#read_multi`, `#write_multi`, `#fetch_multi`, `#delete_matched`;
+- logging:
+  - configuration: `AnyCache.configure { |conf| conf.logger = your_logger_object }`;
+  - disable logging: `AnyCache.configure { |conf| conf.logger = nil }`;
+  - `::Logger.new(STDOUT)` with `::Logger::INFO` level is used by default (an instance of `AnyCache::Logging::Logger`);
+  - log message contains the following information:
+    - standard log data (level and time);
+    - cache class name;
+    - current cache operation (`read`, `write` and etc);
+    - cache operation arguments;
+
 ## [0.2.0] - 2018-09-03
+### Added
 - fetching operation `AnyCache#fetch(key, force:, expires_in:, &block)`
   - fetches data from the cache using the given key;
   - if a block has been passed and data with the given key does not exist -

data/README.md

@@ -1,7 +1,7 @@
-# AnyCache · [![Gem Version](https://badge.fury.io/rb/any_cache.svg)](https://badge.fury.io/rb/any_cache) [![Build Status](https://travis-ci.org/0exp/any_cache.svg?branch=master)](https://travis-ci.org/0exp/any_cache) [![Coverage Status](https://coveralls.io/repos/github/0exp/any_cache/badge.svg)](https://coveralls.io/github/0exp/any_cache)
+# AnyCache · [![Gem Version](https://badge.fury.io/rb/any_cache.svg)](https://badge.fury.io/rb/any_cache) [![Build Status](https://travis-ci.org/0exp/any_cache.svg?branch=master)](https://travis-ci.org/0exp/any_cache) [![Coverage Status](https://coveralls.io/repos/github/0exp/any_cache/badge.svg?branch=master)](https://coveralls.io/github/0exp/any_cache?branch=master)
 
 AnyCache - a simplest cache wrapper that provides a minimalistic generic interface for all well-known cache storages and includes a minimal set of necessary operations:
-`fetch`, `read`, `write`, `delete`, `expire`, `persist`, `exist?`, `clear`, `increment`, `decrement`.
+`fetch`, `read`, `write`, `delete`, `fetch_multi`, `read_multi`, `write_multi`, `delete_matched`, `expire`, `persist`, `exist?`, `clear`, `increment`, `decrement`.
 
 Supported clients:
 
@@ -9,6 +9,7 @@ Supported clients:
 - `Redis::Store` ([gem redis-store](https://github.com/redis-store/redis-store)) ([redis storage](https://redis.io/))
 - `Dalli::Client` ([gem dalli](https://github.com/petergoldstein/dalli)) ([memcached storage](https://memcached.org/))
 - `ActiveSupport::Cache::RedisCacheStore` ([gem activesupport](https://github.com/rails/rails/blob/master/activesupport/lib/active_support/cache/redis_cache_store.rb)) ([redis cache storage](https://api.rubyonrails.org/classes/ActiveSupport/Cache/RedisCacheStore.html))
+- `ActiveSupport::Cache::DalliStore` ([gem dalli](https://github.com/petergoldstein/dalli)) ([dalli store](https://github.com/petergoldstein/dalli/blob/master/lib/active_support/cache/dalli_store.rb))
 - `ActiveSupport::Cache::MemCacheStore` ([gem activesupport](https://github.com/rails/rails/blob/master/activesupport/lib/active_support/cache/mem_cache_store.rb)) ([memcache storage](https://api.rubyonrails.org/classes/ActiveSupport/Cache/MemCacheStore.html))
 - `ActiveSupport::Cache::FileStore` ([gem activesupport](https://github.com/rails/rails/blob/master/activesupport/lib/active_support/cache/file_store.rb)) ([file storage](https://api.rubyonrails.org/classes/ActiveSupport/Cache/FileStore.html))
 - `ActiveSupport::Cache::MemoryStore` ([gem activesupport](https://github.com/rails/rails/blob/master/activesupport/lib/active_support/cache/memory_store.rb)) ([in memory storage](https://api.rubyonrails.org/classes/ActiveSupport/Cache/MemoryStore.html))
@@ -42,18 +43,19 @@ require 'any_cache'
         - [AnyCache with Redis::Store](#anycache-with-redisstore)
         - [AnyCache with Dalli::Client](#anycache-with-dalliclient)
         - [AnyCache with ActiveSupport::Cache::RedisCacheStore](#anycache-with-activesupportcacherediscachestore)
+        - [AnyCache with ActiveSupport::Cache::DalliStore](#anycache-with-activesupportcachedallistore)
         - [AnyCache with ActiveSupport::Cache::MemCacheStore](#anycache-with-activesupportcachememcachestore)
         - [AnyCache with ActiveSupport::Cache::FileStore](#anycache-with-activesupportcachefilestore)
         - [AnyCache with ActiveSupport::Cache::MemoryStore](#anycache-with-activesupportcachememorystore)
     - [Many cache storages](#many-cache-storages)
     - [Custom cache clients](#custom-cache-clients)
+- [Logging](#logging)
 - [Operations](#operations)
-    - [Fetch](#fetch)
-    - [Read](#read)
-    - [Write](#write)
-    - [Delete](#delete)
-    - [Increment](#increment)
-    - [Decrement](#decrement)
+    - [Fetch](#fetch) / [Fetch Multi](#fetch-multi)
+    - [Read](#read) / [Read Multi](#read-multi)
+    - [Write](#write) / [Write Multi](#write-multi)
+    - [Delete](#delete) / [Delete Matched](#delete-matched)
+    - [Increment](#increment) / [Decrement](#decrement)
     - [Expire](#expire)
     - [Persist](#persist)
     - [Existence](#existence)
@@ -72,6 +74,7 @@ Supported clients:
 - `Redis::Store`
 - `Dalli::Client`
 - `ActiveSupport::Cache::RedisCacheStore`
+- `ActiveSupport::Cache::DalliStore`
 - `ActiveSupport::Cache::MemCacheStore`
 - `ActiveSupport::Cache::FileStore`
 - `ActiveSupport::Cache::MemoryStore`
@@ -94,7 +97,9 @@ client = Redis::Store.new(...)
 client = Dalli::Client.new(...)
 # -- or --
 client = ActiveSupport::Cache::RedisCacheStore.new(...)
-# --- or ---
+# -- or --
+client = ActiveSupport::Cache::DalliStore.new(...)
+# -- or --
 client = ActiveSupport::Cache::MemCacheStore.new(...)
 # -- or --
 client = ActiveSupport::Cache::FileStore.new(...)
@@ -102,7 +107,7 @@ client = ActiveSupport::Cache::FileStore.new(...)
 client = ActiveSupport::Cache::MemoryStore.new(...)
 
 # 2) build AnyCache instance
-any_cache = AnyCache.build(client) # => <AnyCache:0x00007f990527f268 ...>
+cache_store = AnyCache.build(client) # => <AnyCache:0x00007f990527f268 ...>
 ```
 
 #### Config-based creation
@@ -117,9 +122,10 @@ storage instantiation works via `.build` method without explicit attributes.
 Supported drivers:
 
 - `:redis` - [Redis](#anycache-with-redis);
-- `:redis_tore` - [Redis::Client](#anycache-with-redisstore);
+- `:redis_store` - [Redis::Client](#anycache-with-redisstore);
 - `:dalli` - [Dalli::Client](#anycache-with-dalliclient);
 - `:as_redis_cache_store` - [ActiveSupport::Cache::RedisCacheStore](#anycache-with-activesupportcacherediscachestore);
+- `:as_dalli_store` - [ActiveSupport::Cache::DalliStore](#anycache-with-activesupportcachedallistore);
 - `:as_mem_cache_store` - [ActiveSupport::Cache::MemCacheStore](#anycache-with-activesupportcachememcachestore);
 - `:as_file_store` - [ActiveSupport::Cache::FileStore](#anycache-with-activesupportcachefilestore);
 - `:as_memory_store` - [ActiveSupport::Cache::MemoryStore](#anycache-with-activesupportcachememorystore);
@@ -135,7 +141,7 @@ AnyCache.configure do |conf|
   conf.redis.options = { ... } # Redis-related options
 end
 
-AnyCache.build
+cache_store = AnyCache.build
 ```
 
 ##### `AnyCache` with `Redis::Store`:
@@ -149,7 +155,7 @@ AnyCache.configure do |conf|
   conf.redis_store.options = { ... } # Redis::Store-related options
 end
 
-AnyCache.build
+cache_store = AnyCache.build
 ```
 
 ##### `AnyCache` with `Dalli::Client`:
@@ -164,12 +170,13 @@ AnyCache.configure do |conf|
   conf.dalli.options = { ... } # Dalli::Client-related options
 end
 
-AnyCache.build
+cache_store = AnyCache.build
 ```
 
 ##### `AnyCache` with `ActiveSupport::Cache::RedisCacheStore`:
 
 ```ruby
+require 'redis'
 require 'active_support'
 require 'any_cache'
 
@@ -178,7 +185,23 @@ AnyCache.configure do |conf|
   conf.as_redis_cache_store.options = { ... } # ActiveSupport::Cache::RedisCacheStore-related options
 end
 
-AnyCache.build
+cache_store = AnyCache.build
+```
+
+##### `AnyCache` with `ActiveSupport::Cache::DalliStore`:
+
+```ruby
+require 'dalli'
+require 'active_support'
+require 'any_cache'
+
+AnyCache.configure do |conf|
+  conf.driver = :as_dalli_store
+  conf.as_dalli_store.servers = ... # string or array of strings
+  conf.as_dalli_store.options = { ... } # ActiveSupport::Cache::DalliStore-related options
+end
+
+cache_store = AnyCache.build
 ```
 
 ##### `AnyCache` with `ActiveSupport::Cache::MemCacheStore`:
@@ -189,11 +212,11 @@ require 'any_cache'
 
 AnyCache.configure do |conf|
   conf.driver = :as_mem_cache_store
-  conf.as_memory_store.servers = ... # string or array of strings
-  conf.as_memory_store.options = { ... } # ActiveSupport::Cache::MemCacheStore-related options
+  conf.as_mem_cache_store.servers = ... # string or array of strings
+  conf.as_mem_cache_store.options = { ... } # ActiveSupport::Cache::MemCacheStore-related options
 end
 
-AnyCache.build
+cache_store = AnyCache.build
 ```
 
 ##### `AnyCache` with `ActiveSupport::Cache::FileStore`:
@@ -208,7 +231,7 @@ AnyCache.configure do |conf|
   conf.as_file_store.options = { ... } # ActiveSupport::Cache::FileStore-related options
 end
 
-AnyCache.build
+cache_store = AnyCache.build
 ```
 
 ##### `AnyCache` with `ActiveSupport::Cache::MemoryStore`:
@@ -222,7 +245,7 @@ AnyCache.configure do |conf|
   conf.as_memory_store.options = { ... } # ActiveSupport::Cache::MemoryStore-related options
 end
 
-AnyCache.build
+cache_store = AnyCache.build
 ```
 
 #### Many cache storages
@@ -250,10 +273,14 @@ dalli_cache = DalliCache.build
 
 If you want to use your own cache client implementation, you should provide an object that responds to:
 
-- `#fetch(*key, [**options])` ([doc](#fetch))
+- `#fetch(key, [**options])` ([doc](#fetch))
+- `#fetch_multi(*keys, [**options])` ([doc](#fetch-multi))
 - `#read(key, [**options])` ([doc](#read))
+- `#read_multi(*keys, [**options])` ([doc](#read-multi))
 - `#write(key, value, [**options])` ([doc](#write))
+- `#write_multi(entries, [**options])` ([doc](#write-multi))
 - `#delete(key, [**options])` ([doc](#delete))
+- `#delete_matched(pattern, [**options])` ([doc](#delete-matched))
 - `#increment(key, amount, [**options])` ([doc](#increment))
 - `#decrement(key, amount, [**options])` ([doc](#decrement))
 - `#expire(key, [**options])` ([doc](#expire))
@@ -279,16 +306,63 @@ end
 AnyCache.build(MyCacheClient.new)
 ```
 
+---
+
+### Logging
+
+AnyCache logs all its operations. By default, `AnyCache` uses a simple `STDOUT` logger with `Logger::INFO` level.
+Logging is performed with level configured in logger object.
+
+Logger configuration:
+
+```ruby
+# --- use your own logger ---
+AnyCache.configure do |conf|
+  conf.logger = MyLoggerObject.new
+end
+
+# --- disable logging ---
+AnyCache.configure do |conf|
+  conf.logger = nil
+end
+
+# --- (used by default) ---
+AnyCache.configure do |conf|
+  conf.logger = AnyCache::Logging::Logger.new(STDOUT)
+end
+```
+
+Log message format:
+
+```shell
+[AnyCache<CACHER_NAME>/Activity<OPERATION_NAME>]: performed <OPERATION_NAME> operation with
+params: INSPECTED_ARGUMENTS and options: INSPECTED_OPTIONS
+```
+
+- progname
+  - `CACHER_NAME` - class name of your cache class;
+  - `OPERATION_NAME` - performed operation (`read`, `write`, `fetch` and etc);
+- message
+  - `INSPECTED_ARGUMENTS` - a set of operation arguments;
+  - `INSPECTED_OPTIONS` - a set of operation options;
+
+```ruby
+any_cache.write("data", 123, expires_in: 60)
+# I, [2018-09-07T10:04:56.649960 #15761]  INFO -- [AnyCache<AnyCache>/Activity<write>]: performed <write> operation with params: ["data", 123] and options: {:expires_in=>60}.
+
+any_cache.clear
+# I, [2018-09-07T10:05:26.999847 #15761]  INFO -- [AnyCache<AnyCache>/Activity<clear>]: performed <clear> operation with params: [] and options: {}.
+```
+
 ## Operations
 
 `AnyCache` provides a following operation set:
 
-- [fetch](#fetch)
-- [read](#read)
-- [write](#write)
-- [delete](#delete)
-- [increment](#increment)
-- [decrement](#decrement)
+- [fetch](#fetch) / [fetch_multi](#fetch-multi)
+- [read](#read) / [read_multi](#read-multi)
+- [write](#write) / [write_multi](#write-multi)
+- [delete](#delete) / [delete_matched](#delete-matched)
+- [increment](#increment) / [decrement](#decrement)
 - [expire](#expire)
 - [persist](#persist)
 - [clear](#clear)
@@ -298,37 +372,73 @@ AnyCache.build(MyCacheClient.new)
 
 ### Fetch
 
-- `AnyCache#fetch(key, [force:], [expires_in:], [&block])`
+- `AnyCache#fetch(key, [force:], [expires_in:], [&fallback])`
     - works in `ActiveSupport::Cache::Store#fetch`-manner;
-    - fetches data from the cache, using the given key;
-    - if there is data in the cache with the given key, then that data is returned;
-    - if there is no such data in the cache (a cache miss), then nil will be returned:
-        - if a block has been passed, that block will be passed the key and executed in the event of a cache miss;
-        - the return value of the block will be written to the cache under the given cache key, and that return value will be returned;
+    - fetches data from the cache using the given key;
+    - if a `fallback` block has been passed and data with the given key does not exist - that block
+      will be called with the given key and the return value will be written to the cache;
 
 ```ruby
 # --- entry exists ---
-any_cache.fetch("data") # => "some_data"
-any_cache.fetch("data") { "new_data" } # => "some_data"
+cache_store.fetch("data") # => "some_data"
+cache_store.fetch("data") { "new_data" } # => "some_data"
 
 # --- entry does not exist ---
-any_cache.fetch("data") # => nil
-any_cache.fetch("data") { "new_data" } # => "new_data"
-any_cache.fetch("data") # => "new_data"
+cache_store.fetch("data") # => nil
+cache_store.fetch("data") { |key| "new_data" } # => "new_data"
+cache_store.fetch("data") # => "new_data"
 
 # --- new entry with expiration time ---
-any_cache.fetch("data") # => nil
-any_cache.fetch("data", expires_in: 8) { "new_data" } # => "new_data"
-any_cache.fetch("data") # => "new_data"
+cache_store.fetch("data") # => nil
+cache_store.fetch("data", expires_in: 8) { |key| "new_#{key}" } # => "new_data"
+cache_store.fetch("data") # => "new_data"
 # ...sleep 8 seconds...
-any_cache.fetch("data") # => nil
+cache_store.fetch("data") # => nil
 
 # --- force update/rewrite ---
-any_cache.fetch("data") # => "some_data"
-any_cache.fetch("data", expires_in: 8, force: true) { "new_data" } # => "new_data"
-any_cache.fetch("data") # => "new_data"
+cache_store.fetch("data") # => "some_data"
+cache_store.fetch("data", expires_in: 8, force: true) { |key| "new_#{key}" } # => "new_data"
+cache_store.fetch("data") # => "new_data"
 # ...sleep 8 seconds...
-any_cache.fetch("data") # => nil
+cache_store.fetch("data") # => nil
+```
+
+---
+
+### Fetch Multi
+
+- `AnyCache#fetch_multi(*keys, [force:], [expires_in:], [&fallback])`
+    - get a set of entries in hash form from the cache storage using given keys;
+    - works in `#fetch` manner but with a series of entries;
+    - nonexistent entries will be fetched with `nil` values;
+
+```ruby
+# --- fetch entries ---
+cache_store.fetch_multi("data", "second_data", "last_data")
+# => returns:
+{
+  "data" => "data", # existing entry
+  "second_data" => nil, # nonexistent entry
+  "last_data" => nil # nonexistent entry
+}
+
+# --- fetch etnries and define non-existent entries ---
+cache_store.fetch_multi("data", "second_data", "last_data") { |key| "new_#{key}" }
+# => returns:
+{
+  "data" => "data", # entry with OLD value
+  "second_data" => "new_second_data", # entry with NEW DEFINED value
+  "last_data" => "new_last_data" # entry with NEW DEFINED value
+}
+
+# --- force rewrite all entries ---
+cache_store.fetch_multi("data", "second_data", "last_data", force: true) { |key| "force_#{key}" }
+# => returns
+{
+  "data" => "force_data", # entry with REDEFINED value
+  "second_data" => "force_second_data", # entry with REDEFINED value
+  "last_data" => "force_last_data" # entry with REDEFINED value
+}
 ```
 
 ---
@@ -339,10 +449,29 @@ any_cache.fetch("data") # => nil
 
 ```ruby
 # --- entry exists ---
-any_cache.read("data") # => "some_data"
+cache_store.read("data") # => "some_data"
 
 # --- entry doesnt exist ---
-any_cache.read("data") # => nil
+cache_store.read("data") # => nil
+```
+
+---
+
+### Read Multi
+
+- `AnyCache#read_multi(*keys)`
+    - get entries from the cache storage in hash form;
+    - nonexistent entries will be fetched with `nil` values;
+
+```ruby
+cache_store.read_multi("data", "another_data", "last_data", "super_data")
+# => returns
+{
+  "data" => "test", # existing entry
+  "another_data" => nil, # nonexistent entry
+  "last_data" => "some_data", # exisitng enry
+  "super_data" => nil # existing entry
+}
 ```
 
 ---
@@ -353,10 +482,20 @@ any_cache.read("data") # => nil
 
 ```ruby
 # --- permanent entry ---
-any_cache.write("data", 123)
+cache_store.write("data", 123)
 
 # --- temporal entry (expires in 60 seconds) ---
-any_cache.write("data", 123, expires_in: 60)
+cache_store.write("data", 123, expires_in: 60)
+```
+
+---
+
+### Write Multi
+
+- `AnyCache#write_multi(**entries)` - write a set of permanent entries to the cache storage
+
+```ruby
+cache_store.write_multi("data" => "test", "another_data" => 123)
 ```
 
 ---
@@ -366,7 +505,23 @@ any_cache.write("data", 123, expires_in: 60)
 - `AnyCache#delete(key)` - remove entry from the cache storage
 
 ```ruby
-any_cache.delete("data")
+cache_store.delete("data")
+```
+
+---
+
+### Delete Matched
+
+- `AnyCache#delete_matched(pattern)`
+    - removes all entries with keys matching the pattern;
+    - currently unsupported: `:dalli`, `:as_mem_cache_store`, `:as_dalli_Store`;
+
+```ruby
+# --- using a regepx ---
+cache_store.delete_matched(/\A*test*\z/i)
+
+# --- using a string ---
+cache_store.delete_matched("data")
 ```
 
 ---
@@ -378,19 +533,19 @@ any_cache.delete("data")
 
 ```ruby
 # --- increment existing entry ---
-any_cache.write("data", 1)
+cache_store.write("data", 1)
 
 # --- increment by default value (1) ---
-any_cache.increment("data") # => 2
+cache_store.increment("data") # => 2
 
 # --- increment by custom value ---
-any_cache.increment("data", 12) # => 14
+cache_store.increment("data", 12) # => 14
 
 # --- increment and expire after 31 seconds
-any_cache.incrmeent("data", expires_in: 31) # => 15
+cache_store.incrmeent("data", expires_in: 31) # => 15
 
 # --- increment nonexistent entry (create new entry) ---
-any_cache.increment("another_data", 5, expires_in: 5) # => 5
+cache_store.increment("another_data", 5, expires_in: 5) # => 5
 ```
 
 ---
@@ -402,19 +557,19 @@ any_cache.increment("another_data", 5, expires_in: 5) # => 5
 
 ```ruby
 # --- decrement existing entry ---
-any_cache.write("data", 15)
+cache_store.write("data", 15)
 
 # --- decrement by default value (1) ---
-any_cache.decrement("data") # => 14
+cache_store.decrement("data") # => 14
 
 # --- decrement by custom value ---
-any_cache.decrement("data", 10) # => 4
+cache_store.decrement("data", 10) # => 4
 
 # --- decrement and expire after 5 seconds
-any_cache.decrememnt("data", expirs_in: 5) # => 3
+cache_store.decrememnt("data", expirs_in: 5) # => 3
 
 # --- decrement nonexistent entry (create new entry) ---
-any_cache.decrememnt("another_data", 2, expires_in: 10) # => -2 (or 0 for Dalli::Client)
+cache_store.decrememnt("another_data", 2, expires_in: 10) # => -2 (or 0 for Dalli::Client)
 ```
 
 ---
@@ -425,10 +580,10 @@ any_cache.decrememnt("another_data", 2, expires_in: 10) # => -2 (or 0 for Dalli:
 
 ```ruby
 # --- expire immediately ---
-any_cache.expire("data")
+cache_store.expire("data")
 
 # --- set new expiration time (in seconds) --
-any_cache.expire("data", expires_in: 36)
+cache_store.expire("data", expires_in: 36)
 ```
 
 ---
@@ -439,10 +594,10 @@ any_cache.expire("data", expires_in: 36)
 
 ```ruby
 # --- create temporal entry (30 seconds) ---
-any_cache.write("data", { a: 1 }, expires_in: 30)
+cache_store.write("data", { a: 1 }, expires_in: 30)
 
 # --- remove entry expiration (make it permanent) ---
-any_cache.persist("data")
+cache_store.persist("data")
 ```
 
 ---
@@ -453,10 +608,10 @@ any_cache.persist("data")
 
 ```ruby
 # --- entry exists ---
-any_cache.exist?("data") # => true
+cache_store.exist?("data") # => true
 
 # --- entry does not exist ---
-any_cache.exist?("another-data") # => false
+cache_store.exist?("another-data") # => false
 ```
 
 ---
@@ -467,17 +622,17 @@ any_cache.exist?("another-data") # => false
 
 ```ruby
 # --- prepare cache data ---
-any_cache.write("data", { a: 1, b: 2 })
-any_cache.write("another_data", 123_456)
+cache_store.write("data", { a: 1, b: 2 })
+cache_store.write("another_data", 123_456)
 
-any_cache.read("data") # => { a: 1, b: 2 }
-any_cache.read("another_data") # => 123_456
+cache_store.read("data") # => { a: 1, b: 2 }
+cache_store.read("another_data") # => 123_456
 
 # --- clear cache ---
-any_cache.clear
+cache_store.clear
 
-any_cache.read("data") # => nil
-any_cache.read("another_data") # => nil
+cache_store.read("data") # => nil
+cache_store.read("another_data") # => nil
 ```
 
 ---
@@ -490,14 +645,23 @@ any_cache.read("another_data") # => nil
 bin/rspec --test-redis # run specs with Redis
 bin/rspec --test-redis-store # run specs with Redis::Store
 bin/rspec --test-dalli # run specs with Dalli::Client
-bin/rspec --test-as-file-store # run specs with ActiveSupport::Cache::FileStore
-bin/rspec --test-as-memory-store # run specs with ActiveSupport::Cache::MemoryStore
 bin/rspec --test-as-redis-cache-store # run specs with ActiveSupport::Cache::RedisCacheStore
+bin/rspec --test-as-dalli-store # run specs with ActiveSupport::Cache::DalliStore
 bin/rspec --test-as-mem-cache-store # run specs with ActiveSupport::Cache::MemCacheStore
+bin/rspec --test-as-file-store # run specs with ActiveSupport::Cache::FileStore
+bin/rspec --test-as-memory-store # run specs with ActiveSupport::Cache::MemoryStore
 ```
 
 ---
 
+## Roadmap
+
+- instrumentation layer;
+- global and configurable default expiration time;
+- `#delete_matched` for memcached-based cache storages;
+
+---
+
 ## Contributing
 
 - Fork it (https://github.com/0exp/any_cache/fork)

data/any_cache.gemspec

@@ -32,7 +32,7 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency 'coveralls',        '~> 0.8'
   spec.add_development_dependency 'simplecov',        '~> 0.16'
-  spec.add_development_dependency 'armitage-rubocop', '~> 0.7'
+  spec.add_development_dependency 'armitage-rubocop', '~> 0.9'
   spec.add_development_dependency 'rspec',            '~> 3.8'
 
   spec.add_development_dependency 'bundler'

data/bin/rspec

@@ -20,7 +20,7 @@ module AnyCacheSpecRunner
     active_support_with_dalli: expand_gemfile_path('active_support_with_dalli.gemfile')
   }.freeze
 
-  # rubocop:disable Metrics/MethodLength, Metrics/BlockLength
+  # rubocop:disable Metrics/MethodLength, Metrics/BlockLength, Metrics/AbcSize
   def run!
     OptionParser.new do |opts|
       opts.banner = 'Usage: bin/rspec [options]'
@@ -60,13 +60,18 @@ module AnyCacheSpecRunner
         'Run specs with ActiveSupport::Cache::MemCacheStore cache storage'
       ) { run_as_mem_cache_store_cache_specs! }
 
+      opts.on(
+        '--test-as-dalli-store',
+        'Run specs with ActiveSupport::Cache::DalliStore cache storage'
+      ) { run_as_dalli_store_specs! }
+
       opts.on(
         '-h', '--help',
         'Show this message'
       ) { puts opts }
     end.parse!
   end
-  # rubocop:enable Metrics/MethodLength, Metrics/BlockLength
+  # rubocop:enable Metrics/MethodLength, Metrics/BlockLength, Metrics/AbcSize
 
   private
 
@@ -119,6 +124,13 @@ module AnyCacheSpecRunner
     run_tests!
   end
 
+  def run_as_dalli_store_specs!
+    ENV['TEST_AS_DALLI_STORE'] = 'true'
+    ENV['BUNDLE_GEMFILE'] = GEMFILES[:active_support_with_dalli]
+
+    run_tests!
+  end
+
   def run_tests!
     require 'rubygems'
     require 'bundler/setup'