my_stuff-cache 0.0.1 → 0.0.2

data/COPYING

@@ -0,0 +1,13 @@
+Copyright (c) 2011-present, Fred Emmott <copyright@fredemmott.co.uk>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/README.rdoc

@@ -0,0 +1,28 @@
+= Overview
+
+A simple caching library, optimised for:
+* ease of use
+* multigets
+* delete/set rather than expire semantics
+
+= Usage
+
+See examples/.
+
+= Getting it
+
+ git clone git://github.com/fredemmott/my_stuff-cache.git
+
+or
+
+ gem install my_stuff-cache
+
+= Backends
+
+* null (no caching)
+* memory (in the MyStuff::Cache object itself)
+* memcached
+
+= Copying
+
+See the COPYING file.

data/lib/my_stuff/cache/base.rb

@@ -1,4 +1,4 @@
-# Copyright 2011-present Fred Emmott. All Rights Reserved.
+# Copyright 2011-present Fred Emmott. See COPYING file.
 
 module MyStuff
   module Cache
@@ -9,6 +9,11 @@ module MyStuff
     # - MyStuff::Cache::MemoryCache
     # - MyStuff::Cache::MemcachedCache
     class Base
+      attr_reader :logger
+      def initialize options = {}
+        @logger = options[:logger] || create_logger
+      end
+
       # Try to get ids from cache, falling back to the given block.
       #
       # See #get_with_multi_fallback for documentation.
@@ -49,10 +54,12 @@ module MyStuff
           data = Hash[ids.zip(get(ids.map{|x| key_pattern % x}))]
         end
         misses = data.select{|k,v| !v}.keys
-        from_fallback = fallback.call(misses)
-        Hash[misses.zip(from_fallback)].each do |k,v|
-          to_cache[key_pattern % k] = v
-          data[k] = v;
+        unless misses.empty?
+          from_fallback = fallback.call(misses)
+          Hash[misses.zip(from_fallback)].each do |k,v|
+            to_cache[key_pattern % k] = v
+            data[k] = v;
+          end
         end
         set(to_cache) unless to_cache.empty? || !options[:update_cache]
         ids.map{|k| data[k]}
@@ -80,6 +87,19 @@ module MyStuff
       def set values, options = {}
         raise NotImplementedError.new
       end
+
+      private
+
+      def create_logger
+        # Use MyStuff::Logger if it's already loaded; fall back to standard
+        # Logger
+        if (MyStuff.const_get(:Logger) rescue nil)
+          MyStuff::Logger.new
+        else
+          require 'logger'
+          Logger.new(STDOUT)
+        end
+      end
     end
   end
 end

data/lib/my_stuff/cache/memcached_cache.rb

@@ -1,4 +1,4 @@
-# Copyright 2011-present Fred Emmott. All Rights Reserved.
+# Copyright 2011-present Fred Emmott. See COPYING file.
 
 autoload :Memcached, 'memcached'
 
@@ -11,8 +11,9 @@ module MyStuff
       # Create an instance of this cache.
       #
       # +memcached+ is a Memcached object, provided by the memcached gem.
-      def initialize memcached
+      def initialize memcached, options = {}
         @mc = memcached
+        super options
       end
 
       def get keys, options = {}
@@ -20,7 +21,7 @@ module MyStuff
           results = @mc.get(keys) unless keys.empty?
           keys.map{|k| results[k]}
         rescue Memcached::Error => e
-          LOG :warning, e
+          logger.warn e.inspect
           [nil] * keys.size
         end
       end
@@ -32,7 +33,7 @@ module MyStuff
             @mc.set(k, v, options[:ttl])
           end
         rescue Memcached::Error => e
-          LOG :warning, e
+          logger.warn e
         end
       end
     end

data/lib/my_stuff/cache/memory_cache.rb

@@ -1,4 +1,4 @@
-# Copyright 2011-present Fred Emmott. All Rights Reserved.
+# Copyright 2011-present Fred Emmott. See COPYING file.
 
 module MyStuff
   module Cache
@@ -8,8 +8,9 @@ module MyStuff
     # this means that it won't be shared between all requests in a
     # Passenger or pool-based setup.
     class MemoryCache < MyStuff::Cache::Base
-      def initialize
+      def initialize options = {}
         @cache = Hash.new
+        super options
       end
 
       def get keys, options = {}

data/lib/my_stuff/cache/null_cache.rb

@@ -1,4 +1,4 @@
-# Copyright 2011-present Fred Emmott. All Rights Reserved.
+# Copyright 2011-present Fred Emmott. See COPYING file.
 
 module MyStuff
   module Cache

data/lib/my_stuff/cache.rb

@@ -1,8 +1,7 @@
-# Copyright 2011-present Fred Emmott. All Rights Reserved.
+# Copyright 2011-present Fred Emmott. See COPYING file.
 
 require 'my_stuff/cache/base'
 
-# Code for MyStuff.ws
 module MyStuff
   # Simplistic caching module.
   #

metadata

@@ -1,59 +1,53 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: my_stuff-cache
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 0.0.2
   prerelease: 
-  version: 0.0.1
 platform: ruby
-authors: 
+authors:
 - Fred Emmott
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-08-15 00:00:00 Z
+date: 2011-09-04 00:00:00.000000000Z
 dependencies: []
-
 description: A thin, multi-backend caching library
-email: 
+email:
 - mail@fredemmott.co.uk
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
-- lib/my_stuff/cache/memory_cache.rb
+files:
+- COPYING
+- README.rdoc
 - lib/my_stuff/cache/base.rb
 - lib/my_stuff/cache/memcached_cache.rb
+- lib/my_stuff/cache/memory_cache.rb
 - lib/my_stuff/cache/null_cache.rb
 - lib/my_stuff/cache.rb
 homepage: https://github.com/fredemmott/my_stuff-cache
-licenses: []
-
+licenses:
+- ISC
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
 rubygems_version: 1.8.6
 signing_key: 
 specification_version: 3
 summary: MyStuff.ws's caching library
 test_files: []
-