cachetastic 3.0.3 → 3.0.4

data/README

@@ -1,19 +1,16 @@
 =What is Cachetastic?
-Cachetastic is an incredibly easy to use and administer caching framework. Just because it is easy to use, does not mean that
-it is light with features. Cachetastic allows you to create classes that extend <tt>Cachetastic::Cache</tt>, configure them
-each individually, and much more.
 
-Unlike other systems each cache in your system can use different backends via the use of adapters that get assigned to each
-cache, and globally. You can define different expiration times, loggers, marshal methods, and more! And again, you can choose to 
-define these settings globally, or for each cache!
+Cachetastic is an incredibly easy to use and administer caching framework. Just because it is easy to use, does not mean that it is light with features. Cachetastic allows you to create classes that extend <code>Cachetastic::Cache</code>, configure them each individually, and much more.
+
+Unlike other systems each cache in your system can use different backends via the use of adapters that get assigned to each cache, and globally. You can define different expiration times, loggers, marshal methods, and more! And again, you can choose to define these settings globally, or for each cache!
 
 Adapters are easy to write, so if the built in adapters don't float your boat, you can easily knock one off in short order.
 
 ==Configuration:
-Configuration of Cachetastic is done using the Configatron gem. I would recommend reading the documentation on it first, http://configatron.mackframework.com, before continuing.
 
-All configuration settings hang off of the <tt>cachetastic</tt> namespace on <tt>configatron</tt>. The default settings
-all hang off the <tt>defaults</tt> namespace on the <tt>cachetastic</tt> namespace, as shown below:
+Configuration of Cachetastic is done using the Configatron gem. I would recommend reading the documentation on it first, hcodep://configatron.mackframework.com, before continuing.
+
+All configuration settings hang off of the <code>cachetastic</code> namespace on <code>configatron</code>. The default settings all hang off the <code>defaults</code> namespace on the <code>cachetastic</code> namespace, as shown below:
 
   # This will write detailed information to the logger.
   configatron.cachetastic.defaults.debug = false
@@ -34,7 +31,7 @@ all hang off the <tt>defaults</tt> namespace on the <tt>cachetastic</tt> namespa
   # This sets how long objects will live in the cache before they are auto expired.
   configatron.cachetastic.defaults.default_expiry = 86400 # time in seconds (default: 24 hours)
 
-  # When setting objects into the cache the expiry_swing is +/- to the expiry time.
+  # When secodeing objects into the cache the expiry_swing is +/- to the expiry time.
   # Example: if the expiry time is 1 minute, and the swing is 15 seconds,
   # objects will go into the cache with an expiry time sometime between 45 seconds and 75 seconds.
   # The default is 0 seconds.
@@ -47,7 +44,7 @@ all hang off the <tt>defaults</tt> namespace on the <tt>cachetastic</tt> namespa
   log_2 = Logger.new("log/cachetastic.log")
   log_2.level = Logger::ERROR
   configatron.cachetastic.defaults.logger = [log_1, log_2]
-    
+
 Overriding settings per cache is very simple. Let's take the following two caches:
 
   class UserCache < Cachetastic::Cache
@@ -56,14 +53,13 @@ Overriding settings per cache is very simple. Let's take the following two cache
   class Admin::UserCache < Cachetastic::Cache
   end
 
-If we wanted to set the <tt>UserCache</tt> to use the <tt>Cachetastic::Adapters::File</tt> adapter and we wanted to set the adapter for 
-the <tt>Admin::UserCache</tt> to use <tt>Cachetastic::Adapters::Memcached</tt>, we would configure them like such:
+If we wanted to set the <code>UserCache</code> to use the <code>Cachetastic::Adapters::File</code> adapter and we wanted to set the adapter for 
+the <code>Admin::UserCache</code> to use <code>Cachetastic::Adapters::Memcached</code>, we would configure them like such:
 
   configatron.cachetastic.user_cache.adapter = Cachetastic::Adapters::File
   configatron.cachetastic.admin.user_cache.adapter = Cachetastic::Adapters::Memcached
-  
-In this scenario we have changed the adapters for each of the classes. All of the other default settings will remain intact for
-each of those classes. This makes it incredibly easy to just change the one parameter you need, and not have to reset them all.
+
+In this scenario we have changed the adapters for each of the classes. All of the other default settings will remain intact for each of those classes. This makes it incredibly easy to just change the one parameter you need, and not have to reset them all.
     
 ==Examples:
 
@@ -86,4 +82,4 @@ each of those classes. This makes it incredibly easy to just change the one para
   end
   
   MyAwesomeCache.get(1, 2, 4) # => 8
-  MyAwesomeCache.get(1, 4, 4) # => 8
+  MyAwesomeCache.get(1, 4, 4) # => 8

data/lib/cachetastic/cache.rb

@@ -40,8 +40,10 @@ module Cachetastic # :nodoc:
       # results of the block are not automatically cached.
       def get(key, &block)
         do_with_logging(:get, key) do
-          val = self.adapter.get(key)
-          handle_store_object(key, adapter.unmarshal(val), &block)
+          retryable do
+            val = self.adapter.get(key)
+            handle_store_object(key, adapter.unmarshal(val), &block)
+          end
         end
       end # get
       
@@ -55,23 +57,29 @@ module Cachetastic # :nodoc:
       # expiry time.
       def set(key, value, expiry_time = nil)
         do_with_logging(:set, key) do
-          self.adapter.set(key, value, calculate_expiry_time(expiry_time))
+          retryable do
+            self.adapter.set(key, value, calculate_expiry_time(expiry_time))
+          end
         end
       end # set
       
       # Deletes an object from the cache.
       def delete(key)
         do_with_logging(:delete, key) do
-          self.adapter.delete(key)
-          nil
+          retryable do
+            self.adapter.delete(key)
+            nil
+          end
         end
       end # delete
       
       # Expires all objects for this cache.
       def expire_all
         do_with_logging(:expire_all, nil) do
-          self.adapter.expire_all
-          nil
+          retryable do
+            self.adapter.expire_all
+            nil
+          end
         end
       end # expire_all
       
@@ -159,6 +167,28 @@ module Cachetastic # :nodoc:
         end
       end
       
+      def retryable(options = {}, &block)
+        opts = { :tries => 2, :on => Exception }.merge(options)
+
+        retries = opts[:tries]
+        retry_exceptions = [opts[:on]].flatten
+
+        x = %{
+          begin
+            return yield
+          rescue #{retry_exceptions.join(", ")} => e
+            retries -= 1
+            if retries > 0
+              retry
+            else
+              raise e
+            end
+          end        
+        }
+
+        eval(x, &block)
+      end
+      
     end # class << self
     
   end # Cache

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification 
 name: cachetastic
 version: !ruby/object:Gem::Version 
-  version: 3.0.3
+  version: 3.0.4
 platform: ruby
 authors: 
-- Mark Bates
+- markbates
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2009-08-03 00:00:00 -04:00
+date: 2009-08-31 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -43,7 +43,7 @@ dependencies:
         version: 2.3.2
     version: 
 description: A very simple, yet very powerful caching framework for Ruby.
-email: mark@mackframework.com
+email: mark@markbates.com
 executables: []
 
 extensions: []