coin 0.1.2 → 0.1.3

data/README.md

@@ -1,9 +1,9 @@
 # Coin
 
-## Memcached? We don't need no stinking Memcached.
+## Memcached? We don't need no stinking Memcached. <sup><a href="#cultural-references">1</a></sup>
 
-... Well, you might depending upon your specific needs.
-But be sure to have a look at Coin before you reach for the sledgehammer.
+Well... you might depending upon your specific needs.,
+but have a look at Coin before you reach for the sledgehammer.
 
 Coin is an absurdly simple in memory object caching system written in Ruby.
 
@@ -104,6 +104,24 @@ Coin.start_server # => true
 Coin.start_server true # => true
 ```
 
+## Best Practices
+
+All objects stored with Coin must be able to marshal.
+
+Its generally a good idea to store only the most basic objects.
+For example:
+
+* Boolean
+* String
+* Number
+
+Its possible to store more complex objects such as:
+
+* Array
+* Hash
+
+Just be sure to limit the keys & values to basic types.
+
 ## Run the Tests
 
 ```bash
@@ -122,4 +140,7 @@ shared access across all processes on a **single machine**.
 _It should be relatively simple to update Coin to work across multiple machines,
 so keep an eye peeled for this feature in the future._
 
-![Coin Processes](https://www.lucidchart.com/publicSegments/view/50b8299a-7c5c-4175-8121-6b190a7a0a70/image.png)
+
+## Cultural References
+
+1. "Badges? We don't need no stinking badges!" - from Mel Brooks' film [Blazing Saddles](http://en.wikipedia.org/wiki/Stinking_badges)

data/lib/coin/vault.rb

@@ -1,11 +1,13 @@
 require "thread"
 require "singleton"
 require "forwardable"
+require "monitor"
 
 module Coin
   class Vault
     extend Forwardable
     include Singleton
+    include MonitorMixin
     def_delegators :@dict, :length
 
     def read(key)
@@ -17,7 +19,7 @@ module Coin
 
     def read_and_delete(key)
       value = nil
-      @mutex.synchronize do
+      synchronize do
         value = read(key)
         @dict.delete(key)
       end
@@ -25,18 +27,18 @@ module Coin
     end
 
     def write(key, value, lifetime=300)
-      @mutex.synchronize do
+      synchronize do
         @dict[key] = { :value => value, :cached_at => Time.now, :lifetime => lifetime }
       end
       value
     end
 
     def delete(key)
-      @mutex.synchronize { @dict.delete(key) }
+      synchronize { @dict.delete(key) }
     end
 
     def clear
-      @mutex.synchronize { @dict = {} }
+      synchronize { @dict = {} }
     end
 
     def ok?
@@ -46,9 +48,11 @@ module Coin
     protected
 
     def initialize
-      @mutex = Mutex.new
       @dict = {}
       start_sweeper
+      # have to directly call mon_initialize since this is a
+      # singleton class and constructor is protected
+      mon_initialize
     end
 
     def start_sweeper

data/lib/coin/version.rb

@@ -1,3 +1,3 @@
 module Coin
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: coin
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-30 00:00:00.000000000 Z
+date: 2012-12-05 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: