elephas 2.2.0 → 3.0.0

data/doc/method_list.html

@@ -55,39 +55,39 @@
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Providers/Hash.html#data-instance_method" title="Elephas::Providers::Hash#data (method)">#data</a></span>
+    <span class='object_link'><a href="Elephas/Cache.html#backend-instance_method" title="Elephas::Cache#backend (method)">#backend</a></span>
     
-      <small>Elephas::Providers::Hash</small>
+      <small>Elephas::Cache</small>
     
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Cache.html#default_prefix-class_method" title="Elephas::Cache.default_prefix (method)">default_prefix</a></span>
+    <span class='object_link'><a href="Elephas/Backends/Hash.html#data-instance_method" title="Elephas::Backends::Hash#data (method)">#data</a></span>
     
-      <small>Elephas::Cache</small>
+      <small>Elephas::Backends::Hash</small>
     
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Providers/Hash.html#delete-instance_method" title="Elephas::Providers::Hash#delete (method)">#delete</a></span>
+    <span class='object_link'><a href="Elephas/Backends/Base.html#delete-instance_method" title="Elephas::Backends::Base#delete (method)">#delete</a></span>
     
-      <small>Elephas::Providers::Hash</small>
+      <small>Elephas::Backends::Base</small>
     
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Providers/RubyOnRails.html#delete-instance_method" title="Elephas::Providers::RubyOnRails#delete (method)">#delete</a></span>
+    <span class='object_link'><a href="Elephas/Backends/RubyOnRails.html#delete-instance_method" title="Elephas::Backends::RubyOnRails#delete (method)">#delete</a></span>
     
-      <small>Elephas::Providers::RubyOnRails</small>
+      <small>Elephas::Backends::RubyOnRails</small>
     
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Cache.html#delete-class_method" title="Elephas::Cache.delete (method)">delete</a></span>
+    <span class='object_link'><a href="Elephas/Cache.html#delete-instance_method" title="Elephas::Cache#delete (method)">#delete</a></span>
     
       <small>Elephas::Cache</small>
     
@@ -95,9 +95,9 @@
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Providers/Base.html#delete-instance_method" title="Elephas::Providers::Base#delete (method)">#delete</a></span>
+    <span class='object_link'><a href="Elephas/Backends/Hash.html#delete-instance_method" title="Elephas::Backends::Hash#delete (method)">#delete</a></span>
     
-      <small>Elephas::Providers::Base</small>
+      <small>Elephas::Backends::Hash</small>
     
   </li>
   
@@ -111,33 +111,33 @@
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Providers/Hash.html#exists%3F-instance_method" title="Elephas::Providers::Hash#exists? (method)">#exists?</a></span>
+    <span class='object_link'><a href="Elephas/Backends/Base.html#exists%3F-instance_method" title="Elephas::Backends::Base#exists? (method)">#exists?</a></span>
     
-      <small>Elephas::Providers::Hash</small>
+      <small>Elephas::Backends::Base</small>
     
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Cache.html#exists%3F-class_method" title="Elephas::Cache.exists? (method)">exists?</a></span>
+    <span class='object_link'><a href="Elephas/Backends/Hash.html#exists%3F-instance_method" title="Elephas::Backends::Hash#exists? (method)">#exists?</a></span>
     
-      <small>Elephas::Cache</small>
+      <small>Elephas::Backends::Hash</small>
     
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Providers/Base.html#exists%3F-instance_method" title="Elephas::Providers::Base#exists? (method)">#exists?</a></span>
+    <span class='object_link'><a href="Elephas/Cache.html#exists%3F-instance_method" title="Elephas::Cache#exists? (method)">#exists?</a></span>
     
-      <small>Elephas::Providers::Base</small>
+      <small>Elephas::Cache</small>
     
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Providers/RubyOnRails.html#exists%3F-instance_method" title="Elephas::Providers::RubyOnRails#exists? (method)">#exists?</a></span>
+    <span class='object_link'><a href="Elephas/Backends/RubyOnRails.html#exists%3F-instance_method" title="Elephas::Backends::RubyOnRails#exists? (method)">#exists?</a></span>
     
-      <small>Elephas::Providers::RubyOnRails</small>
+      <small>Elephas::Backends::RubyOnRails</small>
     
   </li>
   
@@ -159,23 +159,23 @@
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Entry.html#initialize-instance_method" title="Elephas::Entry#initialize (method)">#initialize</a></span>
+    <span class='object_link'><a href="Elephas/Backends/Hash.html#initialize-instance_method" title="Elephas::Backends::Hash#initialize (method)">#initialize</a></span>
     
-      <small>Elephas::Entry</small>
+      <small>Elephas::Backends::Hash</small>
     
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Providers/Hash.html#initialize-instance_method" title="Elephas::Providers::Hash#initialize (method)">#initialize</a></span>
+    <span class='object_link'><a href="Elephas/Cache.html#initialize-instance_method" title="Elephas::Cache#initialize (method)">#initialize</a></span>
     
-      <small>Elephas::Providers::Hash</small>
+      <small>Elephas::Cache</small>
     
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Entry.html#key-instance_method" title="Elephas::Entry#key (method)">#key</a></span>
+    <span class='object_link'><a href="Elephas/Entry.html#initialize-instance_method" title="Elephas::Entry#initialize (method)">#initialize</a></span>
     
       <small>Elephas::Entry</small>
     
@@ -183,31 +183,31 @@
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Providers/Base.html#now-instance_method" title="Elephas::Providers::Base#now (method)">#now</a></span>
+    <span class='object_link'><a href="Elephas/Entry.html#key-instance_method" title="Elephas::Entry#key (method)">#key</a></span>
     
-      <small>Elephas::Providers::Base</small>
+      <small>Elephas::Entry</small>
     
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Cache.html#provider-class_method" title="Elephas::Cache.provider (method)">provider</a></span>
+    <span class='object_link'><a href="Elephas/Backends/Base.html#now-instance_method" title="Elephas::Backends::Base#now (method)">#now</a></span>
     
-      <small>Elephas::Cache</small>
+      <small>Elephas::Backends::Base</small>
     
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Providers/Base.html#read-instance_method" title="Elephas::Providers::Base#read (method)">#read</a></span>
+    <span class='object_link'><a href="Elephas/Cache.html#prefix-instance_method" title="Elephas::Cache#prefix (method)">#prefix</a></span>
     
-      <small>Elephas::Providers::Base</small>
+      <small>Elephas::Cache</small>
     
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Cache.html#read-class_method" title="Elephas::Cache.read (method)">read</a></span>
+    <span class='object_link'><a href="Elephas/Cache.html#read-instance_method" title="Elephas::Cache#read (method)">#read</a></span>
     
       <small>Elephas::Cache</small>
     
@@ -215,47 +215,47 @@
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Providers/RubyOnRails.html#read-instance_method" title="Elephas::Providers::RubyOnRails#read (method)">#read</a></span>
+    <span class='object_link'><a href="Elephas/Backends/RubyOnRails.html#read-instance_method" title="Elephas::Backends::RubyOnRails#read (method)">#read</a></span>
     
-      <small>Elephas::Providers::RubyOnRails</small>
+      <small>Elephas::Backends::RubyOnRails</small>
     
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Providers/Hash.html#read-instance_method" title="Elephas::Providers::Hash#read (method)">#read</a></span>
+    <span class='object_link'><a href="Elephas/Backends/Hash.html#read-instance_method" title="Elephas::Backends::Hash#read (method)">#read</a></span>
     
-      <small>Elephas::Providers::Hash</small>
+      <small>Elephas::Backends::Hash</small>
     
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Entry.html#refresh-instance_method" title="Elephas::Entry#refresh (method)">#refresh</a></span>
+    <span class='object_link'><a href="Elephas/Backends/Base.html#read-instance_method" title="Elephas::Backends::Base#read (method)">#read</a></span>
     
-      <small>Elephas::Entry</small>
+      <small>Elephas::Backends::Base</small>
     
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Cache.html#setup_options-class_method" title="Elephas::Cache.setup_options (method)">setup_options</a></span>
+    <span class='object_link'><a href="Elephas/Entry.html#refresh-instance_method" title="Elephas::Entry#refresh (method)">#refresh</a></span>
     
-      <small>Elephas::Cache</small>
+      <small>Elephas::Entry</small>
     
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Entry.html#ttl-instance_method" title="Elephas::Entry#ttl (method)">#ttl</a></span>
+    <span class='object_link'><a href="Elephas/Cache.html#setup_options-instance_method" title="Elephas::Cache#setup_options (method)">#setup_options</a></span>
     
-      <small>Elephas::Entry</small>
+      <small>Elephas::Cache</small>
     
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Entry.html#updated_at-instance_method" title="Elephas::Entry#updated_at (method)">#updated_at</a></span>
+    <span class='object_link'><a href="Elephas/Entry.html#ttl-instance_method" title="Elephas::Entry#ttl (method)">#ttl</a></span>
     
       <small>Elephas::Entry</small>
     
@@ -263,23 +263,23 @@
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Cache.html#use-class_method" title="Elephas::Cache.use (method)">use</a></span>
+    <span class='object_link'><a href="Elephas/Entry.html#updated_at-instance_method" title="Elephas::Entry#updated_at (method)">#updated_at</a></span>
     
-      <small>Elephas::Cache</small>
+      <small>Elephas::Entry</small>
     
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Entry.html#valid%3F-instance_method" title="Elephas::Entry#valid? (method)">#valid?</a></span>
+    <span class='object_link'><a href="Elephas/Cache.html#use-instance_method" title="Elephas::Cache#use (method)">#use</a></span>
     
-      <small>Elephas::Entry</small>
+      <small>Elephas::Cache</small>
     
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Entry.html#value-instance_method" title="Elephas::Entry#value (method)">#value</a></span>
+    <span class='object_link'><a href="Elephas/Entry.html#valid%3F-instance_method" title="Elephas::Entry#valid? (method)">#valid?</a></span>
     
       <small>Elephas::Entry</small>
     
@@ -287,37 +287,45 @@
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Providers/Hash.html#write-instance_method" title="Elephas::Providers::Hash#write (method)">#write</a></span>
+    <span class='object_link'><a href="Elephas/Entry.html#value-instance_method" title="Elephas::Entry#value (method)">#value</a></span>
     
-      <small>Elephas::Providers::Hash</small>
+      <small>Elephas::Entry</small>
     
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Providers/RubyOnRails.html#write-instance_method" title="Elephas::Providers::RubyOnRails#write (method)">#write</a></span>
+    <span class='object_link'><a href="Elephas/Backends/Base.html#write-instance_method" title="Elephas::Backends::Base#write (method)">#write</a></span>
     
-      <small>Elephas::Providers::RubyOnRails</small>
+      <small>Elephas::Backends::Base</small>
     
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Elephas/Providers/Base.html#write-instance_method" title="Elephas::Providers::Base#write (method)">#write</a></span>
+    <span class='object_link'><a href="Elephas/Backends/RubyOnRails.html#write-instance_method" title="Elephas::Backends::RubyOnRails#write (method)">#write</a></span>
     
-      <small>Elephas::Providers::Base</small>
+      <small>Elephas::Backends::RubyOnRails</small>
     
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Elephas/Cache.html#write-class_method" title="Elephas::Cache.write (method)">write</a></span>
+    <span class='object_link'><a href="Elephas/Cache.html#write-instance_method" title="Elephas::Cache#write (method)">#write</a></span>
     
       <small>Elephas::Cache</small>
     
   </li>
   
 
+  <li class="r1 ">
+    <span class='object_link'><a href="Elephas/Backends/Hash.html#write-instance_method" title="Elephas::Backends::Hash#write (method)">#write</a></span>
+    
+      <small>Elephas::Backends::Hash</small>
+    
+  </li>
+  
+
       </ul>
     </div>
   </body>

data/doc/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Thu Feb 28 10:48:17 2013 by
+  Generated on Sun Mar 24 12:12:01 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.5.2 (ruby-1.9.3).
 </div>

data/elephas.gemspec

@@ -24,5 +24,5 @@ Gem::Specification.new do |gem|
 
   gem.required_ruby_version = ">= 1.9.3"
 
-  gem.add_dependency("lazier", "~> 2.7.0")
+  gem.add_dependency("lazier", "~> 2.8.0")
 end

data/lib/elephas/{provider.rb → backends/base.rb}

@@ -6,11 +6,9 @@
 
 module Elephas
   # This module hosts all the storage system for the caches.
-  module Providers
-
-    # The base provider, with all methods a valid provider should override.
-    module Base
-      extend ActiveSupport::Concern
+  module Backends
+    # The a base backend. All data-related methods must be overriden.
+    class Base
       include Lazier::I18n
 
       # Reads a value from the cache.
@@ -58,7 +56,7 @@ module Elephas
       private
         # Marks a method as unimplemented.
         def unimplemented
-          self.i18n_setup(:elephas, ::File.absolute_path(::Pathname.new(::File.dirname(__FILE__)).to_s + "/../../locales/")) if !@i18n
+          self.i18n_setup(:elephas, ::File.absolute_path(::Pathname.new(::File.dirname(__FILE__)).to_s + "/../../../locales/")) if !@i18n
           raise ArgumentError.new(self.i18n.unimplemented)
         end
     end

data/lib/elephas/{providers → backends}/hash.rb

@@ -5,16 +5,16 @@
 #
 
 module Elephas
-  module Providers
-    # This is a simple providers, which uses an hash for storing the values.
+  module Backends
+    # This is a simple backend, which uses an hash for storing the values.
     #
     # @attribute data
-    #   @return [Hash] The internal hash used by the provider.
-    class Hash
-      include Elephas::Providers::Base
+    #   @return [Hash] The internal hash used by the backend.
+    class Hash < Base
       attr_accessor :data
 
-      # Initialize the provider
+      # Initialize the backend.
+      #
       # @param data [Hash] The initial data stored.
       def initialize(data = nil)
         @data = data && data.is_a?(::Hash) ? data : {}
@@ -59,7 +59,7 @@ module Elephas
       # @return [Boolean] `true` if the key is in the cache, `false` otherwise.
       def exists?(key)
         key = key.ensure_string
-        @data.has_key?(key) && @data[key].valid?
+        @data.has_key?(key) && @data[key].valid?(self)
       end
     end
   end

data/lib/elephas/{providers → backends}/ruby_on_rails.rb

@@ -5,11 +5,9 @@
 #
 
 module Elephas
-  module Providers
-    # This is a Ruby on Rails providers, which uses Rails.cache.
-    class RubyOnRails
-      include Elephas::Providers::Base
-
+  module Backends
+    # This is a Ruby on Rails backend, which uses Rails.cache.
+    class RubyOnRails < Base
       # Reads a value from the cache.
       #
       # @param key [String] The key to lookup.
@@ -49,7 +47,7 @@ module Elephas
       # @return [Boolean] `true` if the key is in the cache, `false` otherwise.
       def exists?(key)
         key = key.ensure_string
-        Rails.cache.exist?(key) && Rails.cache.read(key).valid?
+        Rails.cache.exist?(key) && Rails.cache.read(key).valid?(self)
       end
     end
   end

data/lib/elephas/cache.rb

@@ -6,11 +6,21 @@
 
 module Elephas
   # This is the main class of the framework. Use only this class to access the cache.
+  #
+  # @attribute backend
+  #   @return [Backend] The backend used for the caching.
+  # @attribute prefix
+  #   @return [String] The default prefix for cache entries.
   class Cache
-    # @attribute provider
-    #   @return [Provider] The provider used for the caching.
-    class << self
-      attr_accessor :provider
+    attr_accessor :backend
+    attr_accessor :prefix
+
+    # Initialize the cache.
+    #
+    # @param backend [Backends::Base] The backend to use. By default uses an Hash backend.
+    def initialize(backend = nil)
+      @backend = backend || Elephas::Backends::Hash.new
+      @prefix = "elephas-#{::Elephas::Version::STRING}-cache"
     end
 
     # This is the main method of the framework.
@@ -20,14 +30,16 @@ module Elephas
     # If it doesn't find it, it uses the provided block (which receives options as argument) to compute its value and then store it into the cache for later usages.
     #
     # ```ruby
-    # value = Elephas::Cache.use("KEY") do |options|
+    # cache = Elephas::Cache.new(Elephas::Backends::Hash.new)
+    #
+    # value = cache.use("KEY") do |options|
     #   "VALUE"
     # end
     #
     # value
     # # => "VALUE"
     #
-    # value = Elephas::Cache.use("KEY") do |options|
+    # value = cache.use("KEY") do |options|
     #   "ANOTHER VALUE"
     # end
     #
@@ -40,14 +52,14 @@ module Elephas
     # @param block [Proc] An optional block to run to compute the value for the key if nothing is found.
     # @return [Object|Entry] The found or newly-set value associated to the key.
     # @see .setup_options
-    def self.use(key, options = {}, &block)
+    def use(key, options = {}, &block)
       rv = nil
 
       # Get options
-      options = ::Elephas::Cache.setup_options(options, key)
+      options = self.setup_options(options, key)
 
       # Check if the storage has the value (if we don't have to skip the cache)
-      rv = @provider.read(options[:hash]) if options[:force] == false && options[:ttl] > 0
+      rv = choose_backend(options).read(options[:hash]) if options[:force] == false && options[:ttl] > 0
       rv = compute_value(options, &block) if rv.nil? && block # Try to compute the value from the block
 
       # Return value
@@ -57,9 +69,10 @@ module Elephas
     # Reads a value from the cache.
     #
     # @param key [String] The key to lookup.
+    # @param backend [Backends::Base|NilClass] The backend to use. Defaults to the current backend.
     # @return [Object|NilClass] The read value or `nil`.
-    def self.read(key)
-      @provider.read(key)
+    def read(key, backend = nil)
+      choose_backend({backend: backend}).read(key)
     end
 
     # Writes a value to the cache.
@@ -69,31 +82,26 @@ module Elephas
     # @param options [Hash] A list of options for writing.
     # @see .setup_options
     # @return [Object] The value itself.
-    def self.write(key, value, options = {})
-      @provider.write(key, value, ::Elephas::Cache.setup_options(options, key))
+    def write(key, value, options = {})
+      choose_backend(options).write(key, value, self.setup_options(options, key))
     end
 
     # Deletes a value from the cache.
     #
     # @param key [String] The key to delete.
+    # @param backend [Backends::Base|NilClass] The backend to use. Defaults to the current backend.
     # @return [Boolean] `true` if the key was in the cache, `false` otherwise.
-    def self.delete(key)
-      @provider.delete(key)
+    def delete(key, backend = nil)
+      choose_backend({backend: backend}).delete(key)
     end
 
     # Checks if a key exists in the cache.
     #
     # @param key [String] The key to lookup.
+    # @param backend [Backends::Base|NilClass] The backend to use. Defaults to the current backend.
     # @return [Boolean] `true` if the key is in the cache, `false` otherwise.
-    def self.exists?(key)
-      @provider.exists?(key)
-    end
-
-    # Returns the default prefix for cache entries.
-    #
-    # @return [String] The default prefix for cache entries.
-    def self.default_prefix
-      "elephas-#{::Elephas::Version::STRING}-cache"
+    def exists?(key, backend = nil)
+      choose_backend({backend: backend}).exists?(key)
     end
 
     # Setups options for use into the framework.
@@ -110,7 +118,7 @@ module Elephas
     # @param options [Object] An initial setup.
     # @param key [String] The key to associate to this options.
     # @return [Hash] An options hash.
-    def self.setup_options(options, key)
+    def setup_options(options, key)
       options = {} if !options.is_a?(::Hash)
       options = {ttl: 1.hour * 1000, force: false, as_entry: false}.merge(options)
 
@@ -128,26 +136,36 @@ module Elephas
 
     private
       # Computes a new value and saves it to the cache.
+      #
       # @param options [Hash] A list of options for managing the value.
       # @param block [Proc] The block to run to compute the value.
       # @return [Object|Entry] The new value.
-      def self.compute_value(options, &block)
+      def compute_value(options, &block)
         rv = block.call(options)
         rv = ::Elephas::Entry.ensure(rv, options[:complete_key], options) # Make sure is an entry
-        Elephas::Cache.write(rv.hash, rv, options) if !rv.value.nil? && options[:ttl] > 0 # We have a value and we have to store it
+        self.write(rv.hash, rv, options) if !rv.value.nil? && options[:ttl] > 0 # We have a value and we have to store it
         rv
       end
 
       # Sanitizes options for safe usage.
+      #
       # @param options [Object] An initial setup.
       # @param key [String] The key to associate to this options.
       # @return [Hash] An options hash.
-      def self.sanitize_options(options, key)
+      def sanitize_options(options, key)
         options[:key] ||= key.ensure_string
         options[:ttl] == options[:ttl].blank? ? 1.hour * 1000 : [options[:ttl].to_integer, 0].max
         options[:force] = options[:force].to_boolean
-        options[:prefix] = options[:prefix].present? ? options[:prefix] : "elephas-#{::Elephas::Version::STRING}-cache"
+        options[:prefix] = options[:prefix].present? ? options[:prefix] : self.prefix
         options
       end
+
+      # Choose a backend to use.
+      #
+      # @param options [Backends::Base|Hash] The backend to use. Defaults to the current backend.
+      def choose_backend(options)
+        backend = (options.is_a?(Hash) ? options.symbolize_keys[:backend] : options)
+        backend.is_a?(Elephas::Backends::Base) ? backend : self.backend
+      end
   end
 end

data/lib/elephas/entry.rb

@@ -41,20 +41,20 @@ module Elephas
     # Refreshes the entry.
     #
     # @param save [Boolean] If to save the refresh value in the cache.
+    # @param cache [Cache] The cache where to save the entry.
     # @return [Float] The new updated_at value.
-    def refresh(save = false)
+    def refresh(save = false, cache = nil)
       @updated_at = get_new_updated_at(@updated_at)
-      Elephas::Cache.provider.write(@hash, self) if save
+      cache.write(@hash, self) if save && cache
       @updated_at
     end
 
     # Checks if the entry is still valid.
     #
-    # @param provider [Provider::Base] The provider to use for the check.
+    # @param backend [Backends::Base] The backend to use for the check.
     # @return [Boolean] `true` if the entry is still valid, `false` otherwise.
-    def valid?(provider = nil)
-      provider ||= ::Elephas::Cache.provider
-      provider.now - self.updated_at < self.ttl / 1000
+    def valid?(backend)
+      backend.now - self.updated_at < self.ttl / 1000
     end
 
     # Compares to another Entry.

data/lib/elephas/version.rb

@@ -11,10 +11,10 @@ module Elephas
   # @see http://semver.org
   module Version
     # The major version.
-    MAJOR = 2
+    MAJOR = 3
 
     # The minor version.
-    MINOR = 2
+    MINOR = 0
 
     # The patch version.
     PATCH = 0

data/lib/elephas.rb

@@ -9,10 +9,8 @@ require "digest/sha2"
 Lazier.load!("boolean", "math", "object")
 
 require "elephas/version" if !defined?(Elephas::Version)
+require "elephas/backends/base"
+require "elephas/backends/hash"
+require "elephas/backends/ruby_on_rails"
 require "elephas/entry"
-require "elephas/provider"
-require "elephas/providers/hash"
-require "elephas/providers/ruby_on_rails"
-require "elephas/cache"
-
-Elephas::Cache.provider = defined?(Rails) ? Elephas::Providers::RubyOnRails.new : Elephas::Providers::Hash.new
+require "elephas/cache"

data/locales/en.yml

@@ -6,4 +6,4 @@
 
 ---
   elephas:
-    unimplemented: "A Elephas::Providers subclass must override this method."
+    unimplemented: "A Elephas::Backends::Base subclass must override this method."

data/locales/it.yml

@@ -6,4 +6,4 @@
 
 ---
   elephas:
-    unimplemented: "Una sottoclasse di Elephas::Providers deve effettuare l'override di questo metodo."
+    unimplemented: "Una sottoclasse di Elephas::Backends::Base deve effettuare l'override di questo metodo."