moneta 0.7.6 → 0.7.8

data/CHANGES

@@ -1,3 +1,18 @@
+0.7.8
+
+* Adapters::Memcached: switched to Dalli by default
+* Adapters::Daybreak: add option :sync to load and store
+* Adapters::LRUHash: add option :max_count
+* Adapters::Mongo: add options :user and :password
+* Adapters::Mongo: Correctly close connection
+* Adapters::Redis: Correctly close connection
+* Transformer: add inspect key transformer
+* Added #create method to atomically create entries
+* Added WeakCreate and WeakIncrement proxies
+* Added Mutex and Semaphore synchronization primitives for
+  shared/distributed database locks
+* Rename unix socket options from :file to :socket
+
 0.7.6
 
 * Adapters::Daybreak: api changed

data/README.md

@@ -4,15 +4,18 @@
 
 Moneta provides a standard interface for interacting with various kinds of key/value stores. A short overview of the features:
 
-* Supports a lot of backends (See below)
+* Supports a lot of backends with consistent behaviour (See below)
 * Allows a full configuration of the serialization -> compression -> adapter stack using proxies (Similar to [Rack middlewares](http://rack.github.com/))
     * Configurable serialization via `Moneta::Transformer` proxy (Marshal/JSON/YAML and many more)
     * Configurable value compression via `Moneta::Transformer` proxy (Zlib, Snappy, LZMA, ...)
     * Configurable key transformation via `Moneta::Transformer` proxy
 * Expiration for all stores (Added via proxy `Moneta::Expires` if not supported natively)
-* Atomic incrementation and decrementation for most stores (Method `#increment` and `#decrement`)
-* Includes a very simple key/value server (`Moneta::Server`) and client (`Moneta::Adapters::Client`)
-* Integration with [Rails](http://rubyonrails.org/), [Rack](http://rack.github.com/), [Sinatra](http://sinatrarb.com/) and [Rack-Cache](https://github.com/rtomayko/rack-cache)
+* Atomic operations
+    * Atomic incrementation and decrementation for most stores (Method `#increment` and `#decrement`)
+    * Atomic creation of entries (Method `#create`)
+    * Shared/distributed database-wide synchronization primitives `Moneta::Mutex` and `Moneta::Semaphore`
+* Includes a simple pure-ruby key/value server (`Moneta::Server`) and client (`Moneta::Adapters::Client`)
+* Integration with [Rails](http://rubyonrails.org/), [Rack](http://rack.github.com/)/[Rack-Cache](https://github.com/rtomayko/rack-cache), [Sinatra](http://sinatrarb.com/) and [Ramaze](http://ramaze.net/).
 
 If you are not yet convinced, you might ask why? What are the goals of the project?
 
@@ -21,11 +24,43 @@ same for template languages.
 * Make it easy to compare different key/value stores and benchmark them
 * To hide a lot of different and maybe complex APIs behind one well-designed and simple Moneta API
 * Give people a starting point or example code to start working with their favourite key/value store. Feel free to copy code, please mention Moneta then :)
-* Create a reusable piece of code, since similar things are solved over and over again ([Rails](http://rubyonrails.org/ brings its own cache stores, and many frameworks do the same...)
+* Create a reusable piece of code, since similar things are solved over and over again ([Rails](http://rubyonrails.org/) brings its own cache stores, and many frameworks do the same...)
 * See also http://yehudakatz.com/2009/02/12/whats-the-point/
 
 Moneta is tested thoroughly using [Travis-CI](http://travis-ci.org/minad/moneta).
 
+## Getting started
+
+Install Moneta via Rubygems
+
+~~~
+$ gem install moneta
+~~~
+
+or add it to your Gemfile
+
+~~~ ruby
+gem 'moneta'
+~~~
+
+Now you are ready to go:
+
+~~~ ruby
+require 'moneta'
+
+# Create a simple file store
+store = Moneta.new(:File, :dir => 'moneta')
+
+# Store some entries
+store['key'] = 'value'
+
+# Read entry
+store.key?('key') # returns true
+store['key'] # returns 'value'
+
+store.close
+~~~
+
 ## Links
 
 * Source: <http://github.com/minad/moneta>
@@ -36,7 +71,7 @@ Moneta is tested thoroughly using [Travis-CI](http://travis-ci.org/minad/moneta)
 
 ## Supported backends
 
-Out of the box, it supports the following backends:
+Out of the box, it supports the following backends. Use the backend name symbol in the Moneta constructor (e.g. `Moneta.new(:Memory)`).
 
 * Memory:
     * In-memory store (`:Memory`)
@@ -83,49 +118,51 @@ to upgrade to a real key/value store.
 ### Backend feature matrix
 
 <table>
-<thead style="font-weight:bold"><tr><th>Adapter</th><th>Required gems</th><th>Multi-thread safe<sup>[1]</sup></th><th>Multi-process safe<sup>[2]</sup></th><th>Atomic increment</th><th>Native expires<sup>[3]</sup></th><th>Persistent</th><th>Description</th></tr></thead>
+<thead style="font-weight:bold"><tr><th>Adapter</th><th>Required gems</th><th>Multi-thread safe<sup>[1]</sup></th><th>Multi-process safe<sup>[2]</sup></th><th>Atomic increment<sup>[8]</sup></th><th>Atomic create<sup>[9]</sup></th><th>Native expires<sup>[3]</sup></th><th>Persistent</th><th>Description</th></tr></thead>
 <tbody>
-<tr><td>ActiveRecord</td><td>activerecord</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="https://rubygems.org/gems/activerecord">ActiveRecord</a> ORM</td></tr>
-<tr><td>Cassandra</td><td>cassandra</td><td style="color:blue">?</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:green">✓</td><td><a href="http://cassandra.apache.org/">Cassandra</a> distributed database</td></tr>
-<tr><td>Client</td><td>-</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:blue">?<sup>[5]</sup></td><td style="color:blue">?<sup>[5]</sup></td><td style="color:blue">?<sup>[5]</sup></td><td>Moneta client adapter</td></tr>
-<tr><td>Cookie</td><td>-</td><td style="color:red">✗</td><td style="color:blue">(✓)<sup>[6]</sup></td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗</td><td>Cookie in memory store</td></tr>
-<tr><td>Couch</td><td>couchrest</td><td style="color:blue">?</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://couchdb.apache.org/">CouchDB</a> database</td></tr>
-<tr><td>DataMapper</td><td>dm-core, dm-migrations</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://datamapper.org/">DataMapper</a> ORM</td></tr>
-<tr><td>Daybreak</td><td>daybreak</td><td style="color:red">✗</td><td style="color:blue">(✓)<sup>[7]</sup></td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td>Incredibly fast pure-ruby key/value store <a href="http://propublica.github.com/daybreak/">Daybreak</a></td></tr>
-<tr><td>DBM</td><td>-</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://www.ruby-doc.org/stdlib/libdoc/dbm/rdoc/DBM.html">Berkeley DB</a></td></tr>
-<tr><td>File</td><td>-</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td>File store</td></tr>
-<tr><td>Fog</td><td>fog</td><td style="color:blue">?</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://fog.io/">Fog</a> cloud store</td></tr>
-<tr><td>GDBM</td><td>-</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://www.ruby-doc.org/stdlib/libdoc/gdbm/rdoc/GDBM.html">GDBM</a> database</td></tr>
-<tr><td>HBase</td><td>hbase</td><td style="color:blue">?</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://hbase.apache.org/">HBase</a> database</td></tr>
-<tr><td>LevelDB</td><td>leveldb</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://code.google.com/p/leveldb/">LevelDB</a> database</td></tr>
-<tr><td>LocalMemCache</td><td>localmemcache</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://localmemcache.rubyforge.org/">LocalMemCache</a> database</td></tr>
-<tr><td>LRUHash</td><td>-</td><td style="color:red">✗</td><td style="color:blue">(✓)<sup>[6]</sup></td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:red">✗</td><td>LRU memory store</td></tr>
-<tr><td>Memcached</td><td>dalli or memcached</td><td style="color:blue">?</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗<sup>[4]</sup></td><td><a href="http://memcached.org/">Memcached</a> database</td></tr>
-<tr><td>MemcachedDalli</td><td>dalli</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗<sup>[4]</sup></td><td><a href="http://memcached.org/">Memcached</a> database with Dalli library</td></tr>
-<tr><td>MemcachedNative</td><td>memcached</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗<sup>[4]</sup></td><td>Memcached database with native library</td></tr>
-<tr><td>Memory</td><td>-</td><td style="color:red">✗</td><td style="color:blue">(✓)<sup>[6]</sup></td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:red">✗</td><td>Memory store</td></tr>
-<tr><td>Mongo</td><td>mongo</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td><a href="http://www.mongodb.org/">MongoDB</a> database</td></tr>
-<tr><td>Null</td><td>-</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:red">✗</td><td>No database</td></tr>
-<tr><td>PStore</td><td>-</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://ruby-doc.org/stdlib/libdoc/pstore/rdoc/PStore.html">PStore</a> store</td></tr>
-<tr><td>Redis</td><td>redis</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td><a href="http://redis.io/">Redis</a> database</td></tr>
-<tr><td>RestClient</td><td>-</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:blue">?<sup>[5]</sup></td><td>Moneta REST client adapter</td></tr>
-<tr><td>Riak</td><td>riak-client</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://docs.basho.com/">Riak</a> database</td></tr>
-<tr><td>SDBM</td><td>-</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://www.ruby-doc.org/stdlib/libdoc/sdbm/rdoc/SDBM.html">SDBM</a> database</td></tr>
-<tr><td>Sequel</td><td>sequel</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://sequel.rubyforge.org/">Sequel</a> ORM</td></tr>
-<tr><td>Sqlite</td><td>sqlite3</td><td style="color:blue">?</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://sqlite.org/">Sqlite3</a> database</td></tr>
-<tr><td>TDB</td><td>tdb</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://tdb.samba.org/">TDB</a> database</td></tr>
-<tr><td>TokyoCabinet</td><td>tokoycabinet</td><td style="color:red">✗</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://fallabs.com/tokyocabinet/">TokyoCabinet</a> database</td></tr>
-<tr><td>YAML</td><td>-</td><td style="color:red">✗</td><td style="color:green">✓</td><td style="color:green">✓</td><td style="color:red">✗</td><td style="color:green">✓</td><td><a href="http://www.ruby-doc.org/stdlib/libdoc/yaml/rdoc/YAML/Store.html">YAML</a> store</td></tr>
+<tr><td>ActiveRecord</td><td>activerecord</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="https://rubygems.org/gems/activerecord">ActiveRecord</a> ORM</td></tr>
+<tr><td>Cassandra</td><td>cassandra</td><td style="text-align:center;color:blue">?</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td><a href="http://cassandra.apache.org/">Cassandra</a> distributed database</td></tr>
+<tr><td>Client</td><td>-</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:blue">?<sup>[5]</sup></td><td style="text-align:center;color:blue">?<sup>[5]</sup></td><td style="text-align:center;color:blue">?<sup>[5]</sup></td><td style="text-align:center;color:blue">?<sup>[5]</sup></td><td>Moneta client adapter</td></tr>
+<tr><td>Cookie</td><td>-</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:blue">(✓)<sup>[6]</sup></td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td>Cookie in memory store</td></tr>
+<tr><td>Couch</td><td>couchrest</td><td style="text-align:center;color:blue">?</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://couchdb.apache.org/">CouchDB</a> database</td></tr>
+<tr><td>DataMapper</td><td>dm-core, dm-migrations</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://datamapper.org/">DataMapper</a> ORM</td></tr>
+<tr><td>Daybreak</td><td>daybreak</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:blue">(✓)<sup>[7]</sup></td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td>Incredibly fast pure-ruby key/value store <a href="http://propublica.github.com/daybreak/">Daybreak</a></td></tr>
+<tr><td>DBM</td><td>-</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://www.ruby-doc.org/stdlib/libdoc/dbm/rdoc/DBM.html">Berkeley DB</a></td></tr>
+<tr><td>File</td><td>-</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td>File store</td></tr>
+<tr><td>Fog</td><td>fog</td><td style="text-align:center;color:blue">?</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://fog.io/">Fog</a> cloud store</td></tr>
+<tr><td>GDBM</td><td>-</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://www.ruby-doc.org/stdlib/libdoc/gdbm/rdoc/GDBM.html">GDBM</a> database</td></tr>
+<tr><td>HBase</td><td>hbase</td><td style="text-align:center;color:blue">?</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://hbase.apache.org/">HBase</a> database</td></tr>
+<tr><td>LevelDB</td><td>leveldb</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://code.google.com/p/leveldb/">LevelDB</a> database</td></tr>
+<tr><td>LocalMemCache</td><td>localmemcache</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://localmemcache.rubyforge.org/">LocalMemCache</a> database</td></tr>
+<tr><td>LRUHash</td><td>-</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:blue">(✓)<sup>[6]</sup></td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td>LRU memory store</td></tr>
+<tr><td>Memcached</td><td>dalli or memcached</td><td style="text-align:center;color:blue">?</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗<sup>[4]</sup></td><td><a href="http://memcached.org/">Memcached</a> database</td></tr>
+<tr><td>MemcachedDalli</td><td>dalli</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗<sup>[4]</sup></td><td><a href="http://memcached.org/">Memcached</a> database with Dalli library</td></tr>
+<tr><td>MemcachedNative</td><td>memcached</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗<sup>[4]</sup></td><td>Memcached database with native library</td></tr>
+<tr><td>Memory</td><td>-</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:blue">(✓)<sup>[6]</sup></td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td>Memory store</td></tr>
+<tr><td>Mongo</td><td>mongo</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td><a href="http://www.mongodb.org/">MongoDB</a> database</td></tr>
+<tr><td>Null</td><td>-</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td>No database</td></tr>
+<tr><td>PStore</td><td>-</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://ruby-doc.org/stdlib/libdoc/pstore/rdoc/PStore.html">PStore</a> store</td></tr>
+<tr><td>Redis</td><td>redis</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td><a href="http://redis.io/">Redis</a> database</td></tr>
+<tr><td>RestClient</td><td>-</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:blue">?<sup>[5]</sup></td><td>Moneta REST client adapter</td></tr>
+<tr><td>Riak</td><td>riak-client</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://docs.basho.com/">Riak</a> database</td></tr>
+<tr><td>SDBM</td><td>-</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://www.ruby-doc.org/stdlib/libdoc/sdbm/rdoc/SDBM.html">SDBM</a> database</td></tr>
+<tr><td>Sequel</td><td>sequel</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://sequel.rubyforge.org/">Sequel</a> ORM</td></tr>
+<tr><td>Sqlite</td><td>sqlite3</td><td style="text-align:center;color:blue">?</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://sqlite.org/">Sqlite3</a> database</td></tr>
+<tr><td>TDB</td><td>tdb</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://tdb.samba.org/">TDB</a> database</td></tr>
+<tr><td>TokyoCabinet</td><td>tokoycabinet</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://fallabs.com/tokyocabinet/">TokyoCabinet</a> database</td></tr>
+<tr><td>YAML</td><td>-</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:green">✓</td><td style="text-align:center;color:red">✗</td><td style="text-align:center;color:green">✓</td><td><a href="http://www.ruby-doc.org/stdlib/libdoc/yaml/rdoc/YAML/Store.html">YAML</a> store</td></tr>
 </tbody>
 </table>
 
 * [1]: Make adapters thread-safe by using `Moneta::Lock` or by passing the option `:threadsafe => true` to `Moneta#new`. There is also `Moneta::Pool` which can be used to share a store between multiple threads if the store is multi-process safe. I recommend to add the option `:threadsafe` to ensure thread-safety since for example under JRuby and Rubinius even the basic datastructures are not thread safe due to the lack of a global interpreter lock (GIL). This differs from MRI where some adapters might appear thread safe already but only due to the GIL.
 * [2]: Share a Moneta store between multiple processes using `Moneta::Shared` (See below).
 * [3]: Add expiration support by using `Moneta::Expires` or by passing the option `:expires => true` to `Moneta#new`.
-* [4]: There are some servers which use the memcached protocol but which are persistent (e.g. MemcacheDB, Kai, IronCache, ...)
+* [4]: There are some servers which use the memcached protocol but which are persistent (e.g. [MemcacheDB](http://memcachedb.org/), [Kai](http://sourceforge.net/apps/mediawiki/kai), [IronCache](http://dev.iron.io/cache/reference/memcache/))
 * [5]: Depends on server
 * [6]: Store is multi-process safe because it is an in-memory store, values are not shared between multiple processes
 * [7]: Store is multi-process safe, but not synchronized automatically between multiple processes
+* [8]: If a store provides atomic increment it can be used with `Moneta::Semaphore`. You can add weak `#increment` using the `Moneta::WeakIncrement` proxy.
+* [8]: If a store provides atomic creation it can be used with `Moneta::Mutex`. You can add weak `#create` using the `Moneta::WeakCreate` proxy.
 
 ## Proxies
 
@@ -141,6 +178,7 @@ add additional features to storage backends:
 * `Moneta::Pool` to create a pool of stores as a means of making the store thread safe. Add it in the builder using `use(:Pool) {}`.
 * `Moneta::Logger` to log database accesses. Add it in the builder using `use :Logger`.
 * `Moneta::Shared` to share a store between multiple processes. Add it in the builder using `use(:Shared) {}`.
+* `Moneta::WeakIncrement` and `Moneta::WeakCreate` to add `#create` and `#increment` support without atomicity (weak) to stores which don't support it.
 
 ### Serializers and compressors (`Moneta::Transformer`)
 
@@ -173,7 +211,7 @@ Special transformers:
 ## Moneta API
 
 The Moneta API is purposely extremely similar to the Hash API with a few minor additions.
-There are the additional methods `#load`, `#increment`, `#decrement` and `#close`. Every method takes also a optional
+There are the additional methods `#load`, `#increment`, `#decrement`, `#create` and `#close`. Every method takes also a optional
 option hash. In order so support an identical API across stores, Moneta does not support iteration or partial matches.
 
 ~~~
@@ -197,13 +235,16 @@ option hash. In order so support an identical API across stores, Moneta does not
 
 #key?(key, options = {})                  true if the key exists, false if it does not.
 
-#increment(key, amount = 1, options = {}) increment numeric value. This is a atomic operation
+#increment(key, amount = 1, options = {}) increment numeric value. This is an atomic operation
                                           which is not supported by all stores. Returns current value.
 
-#decrement(key, amount = 1, options = {}) increment numeric value. This is a atomic operation
+#decrement(key, amount = 1, options = {}) increment numeric value. This is an atomic operation
                                           which is not supported by all stores. Returns current value.
                                           This is just syntactic sugar for incrementing with a negative value.
 
+#create(key, value, options = {})         create entry. This is an atomic operation which is not supported by all stores.
+                                          Returns true if the value was created.
+
 #clear(options = {})                      clear all keys in this store.
 
 #close                                    close database connection.
@@ -275,7 +316,9 @@ cache = Moneta.build do
 end
 ~~~
 
-### Incrementation and raw access
+### Atomic operations
+
+#### Atomic incrementation and raw access
 
 The stores support the `#increment` which allows atomic increments of unsigned integer values. If you increment
 a non existing value, it will be created. If you increment a non integer value an exception will be raised.
@@ -326,6 +369,69 @@ counters['counter'] = '10'
 counters.increment('counter') # returns 11
 ~~~
 
+#### Atomic create
+
+The stores support the `#create` which allows atomic creation of entries. `#create` returns true
+if the value was created.
+
+~~~ ruby
+store.create('key', 'value') # returns true
+store.create('key', 'other value') # returns false
+~~~
+
+#### Shared/distributed synchronization primitives
+
+Moneta provides shared/distributed synchronization primitives which are shared database-wide between
+all clients.
+
+* `Moneta::Mutex`
+
+~~~ ruby
+mutex = Moneta::Mutex.new(store, 'mutex_key')
+
+mutex.synchronize do
+   mutex.locked? # returns true
+
+   # Synchronized access to counter
+   store['counter'] += 1
+end
+
+begin
+  mutex.lock
+  mutex.locked? # returns true
+  ...
+ensure
+  mutex.unlock
+end
+~~~
+
+* `Moneta::Semaphore`
+
+~~~ ruby
+semaphore = Moneta::Semaphore.new(store, 'semaphore_counter', max_concurrent)
+
+semaphore.synchronize do
+   semaphore.locked? # returns true
+   ...
+end
+
+begin
+  semaphore.enter
+  semaphore.locked? # returns true
+  ...
+ensure
+  semaphore.leave
+end
+~~~
+
+#### Weak atomic operations
+
+If an underlying adapter doesn't provide atomic `#create` or `#increment` and `#decrement` you can
+use the proxies `Moneta::WeakIncrement` and `Moneta::WeakCreate` to add support without atomicity.
+
+But then you have to ensure that the store is not shared by multiple processes and thread-safety is
+provided by `Moneta::Lock`.
+
 ### Syntactic sugar and option merger
 
 For raw data access as described before the class `Moneta::OptionMerger` is used. It works like this:
@@ -367,7 +473,7 @@ compressed_store['key'] = 'value will be compressed'
 
 ## Framework Integration
 
-Inspired by [redis-store](https://github.com/jodosha/redis-store) there exist integration classes for [Rails](http://rubyonrails.org/), [Rack](http://rack.github.com/) and [Rack-Cache](https://github.com/rtomayko/rack-cache). You can also use all the Rack middlewares together with Rails and the [Sinatra](http://sinatrarb.com/) framework. There exist the following integration classes:
+Inspired by [redis-store](https://github.com/jodosha/redis-store) there exist integration classes for [Rails](http://rubyonrails.org/) and [Rack](http://rack.github.com/)/[Rack-Cache](https://github.com/rtomayko/rack-cache). You can also use all the Rack middlewares together with Rails and the [Sinatra](http://sinatrarb.com/) framework. There exist the following integration classes:
 
 * Rack, Rails and Sinatra
     * `Rack::Session::Moneta` is a Rack middleware to use Moneta for storing sessions
@@ -378,6 +484,9 @@ Inspired by [redis-store](https://github.com/jodosha/redis-store) there exist in
 * Rails
     * `ActionDispatch::Session::MonetaStore` is a Rails middleware to use Moneta for storing sessions
     * `ActiveSupport::Cache::MonetaStore` is a Rails cache implementation which uses a Moneta store as backend
+* Ramaze
+    * `Ramaze::Cache::Moneta` is integrated into the [Ramaze](http://ramaze.net/) project and allows Ramaze to use
+      Moneta as caching store
 
 ### Rack
 
@@ -410,9 +519,9 @@ caching if you add the option `:cache => true`. Use it in your `config.ru` like
 # Add Rack::MonetaStore somewhere in your rack stack
 use Rack::MonetaStore, :Memory, :cache => true
 
-run lambda do |env|
+run lambda { |env|
   env['rack.moneta_store'] # is a Moneta store with per-request caching
-end
+}
 
 # Pass it a block like the one passed to Moneta.build
 use Rack::MonetaStore do
@@ -420,9 +529,9 @@ use Rack::MonetaStore do
   adapter :Cookie
 end
 
-run lambda do |env|
+run lambda { |env|
   env['rack.moneta_store'] # is a Moneta store without caching
-end
+}
 ~~~
 
 #### REST server
@@ -474,7 +583,7 @@ to use all the transformers on the cookies (e.g. `:prefix`, `:marshal` and `:hma
 require 'rack/moneta_cookies'
 
 use Rack::MonetaCookies, :domain => 'example.com', :path => '/path'
-run lambda do |env|
+run lambda { |env|
   req = Rack::Request.new(env)
   req.cookies #=> is now a Moneta store!
   env['rack.request.cookie_hash'] #=> is now a Moneta store!
@@ -482,7 +591,7 @@ run lambda do |env|
   req.cookies['key'] = 'value' #=> sets 'key'
   req.cookies.delete('key') #=> removes 'key'
   [200, {}, []]
-end
+}
 ~~~
 
 ### Rails
@@ -588,6 +697,7 @@ on top of the different stores.
 
 * [Horcrux](https://github.com/technoweenie/horcrux): Used at github, supports batch operations but only Memcached backend
 * [ActiveSupport::Cache::Store](http://api.rubyonrails.org/classes/ActiveSupport/Cache/Store.html): The Rails cache store abstraction
+* [Padrino::Cache::Store](http://www.padrinorb.com/api/Padrino/Cache/Store.html): The Padrino cache store abstraction
 * [ToyStore](https://github.com/jnunemaker/toystore): ORM mapper for key/value stores
 * [ToyStore Adapter](https://github.com/jnunemaker/adapter): Adapter to key/value stores used by ToyStore, Moneta can be used directly with the ToyStore Memory adapter
 

data/Rakefile

@@ -24,9 +24,18 @@ task :test do
   #   QuickLZ is also not maintained on Github, but on Bitbucket
   #   and I don't know where the issue tracker is.
   #
-  # * Cassandra and Mongo show spurious failures
+  # * Cassandra show spurious failures
+  #
+  # * action_dispatch cannot be required for an unknown reason
   if ENV['TEST_GROUP']
-    unstable = specs.select {|s| s =~ /quicklz|cassandra|mongo/ }
+    # Shuffle specs to ensure equal distribution over the test groups
+    # We have to shuffle with the same seed every time because rake is started
+    # multiple times!
+    old_seed = srand(42)
+    specs.shuffle!
+    srand(old_seed)
+
+    unstable = specs.select {|s| s =~ /quicklz|cassandra|action_dispatch/ }
     specs -= unstable
   end
 

data/SPEC.md

@@ -43,12 +43,17 @@ Behaves the same as <code>[]=</code>, but allows the client to send additional o
 ### <code>increment(key[Object], amount[Integer] = 1, options[Hash] => {}) => Integer(value)</code>
 
 Increments a value atomically. This method is not supported by all stores and might raise a <code>NotImplementedError</code>.
-This method MUST accept negative values, but the result MUST be unsigned.
+This method MUST accept negative amounts, but the result MUST be unsigned.
 
 ### <code>decrement(key[Object], amount[Integer] = 1, options[Hash] => {}) => Integer(value)</code>
 
 Decrements a value atomically. This method is not supported by all stores and might raise a <code>NotImplementedError</code>.
-This method MUST accept negative values, but the result MUST be unsigned.
+This method MUST accept negative amounts, but the result MUST be unsigned.
+
+### <code>create(key[Object], value[Object], options[Hash] => {}) => [TrueClass, FalseClass]</code>
+
+Creates a value atomically. This method is not supported by all stores and might raise a <code>NotImplementedError</code>.
+It MUST return true if the value was created.
 
 ### <code>clear(options[Hash] => {})</code>
 

data/lib/moneta.rb

@@ -1,6 +1,7 @@
 module Moneta
   autoload :Builder,           'moneta/builder'
   autoload :Cache,             'moneta/cache'
+  autoload :CreateSupport,     'moneta/mixins'
   autoload :Defaults,          'moneta/mixins'
   autoload :ExpiresSupport,    'moneta/mixins'
   autoload :Expires,           'moneta/expires'
@@ -8,15 +9,20 @@ module Moneta
   autoload :IncrementSupport,  'moneta/mixins'
   autoload :Lock,              'moneta/lock'
   autoload :Logger,            'moneta/logger'
+  autoload :Mutex,             'moneta/synchronize'
   autoload :Net,               'moneta/mixins'
   autoload :OptionMerger,      'moneta/optionmerger'
   autoload :OptionSupport,     'moneta/mixins'
   autoload :Pool,              'moneta/pool'
   autoload :Proxy,             'moneta/proxy'
+  autoload :Semaphore,         'moneta/synchronize'
   autoload :Server,            'moneta/server'
   autoload :Shared,            'moneta/shared'
   autoload :Stack,             'moneta/stack'
   autoload :Transformer,       'moneta/transformer'
+  autoload :Utils,             'moneta/utils'
+  autoload :WeakCreate,        'moneta/weak'
+  autoload :WeakIncrement,     'moneta/weak'
   autoload :Wrapper,           'moneta/wrapper'
 
   module Adapters
@@ -63,7 +69,7 @@ module Moneta
   # @param [Hash] options
   # @return [Moneta store] newly created Moneta store
   # @option options [Boolean/Integer] :expires Ensure that store supports expiration by inserting
-  #                                            `Moneta::Expires` if the underlying adapter doesn't support it natively
+  #                                            {Expires} if the underlying adapter doesn't support it natively
   #                                            and set default expiration time
   # @option options [Boolean] :threadsafe (false) Ensure that the store is thread safe by inserting Moneta::Lock
   # @option options [Boolean/Hash] :logger (false) Add logger to proxy stack (Hash is passed to logger as options)

data/lib/moneta/adapters/activerecord.rb

@@ -6,7 +6,6 @@ module Moneta
     # @api public
     class ActiveRecord
       include Defaults
-      include IncrementSupport
 
       def self.tables
         @tables ||= {}
@@ -26,7 +25,16 @@ module Moneta
             c.primary_key = :k
             c
           end
-        @table.establish_connection(options[:connection]) if options[:connection]
+
+        if options[:connection]
+          begin
+            @table.establish_connection(options[:connection])
+          rescue
+            tries ||= 0
+            (tries += 1) < 3 ? retry : raise
+          end
+        end
+
         unless @table.table_exists?
           @table.connection.create_table(@table.table_name, :id => false) do |t|
             # Do not use binary columns (Issue #17)
@@ -54,6 +62,9 @@ module Moneta
         record.v = value
         record.save
         value
+      rescue
+        tries ||= 0
+        (tries += 1) < 10 ? retry : raise
       end
 
       # (see Proxy#delete)
@@ -67,12 +78,25 @@ module Moneta
       # (see Proxy#increment)
       def increment(key, amount = 1, options = {})
         record = @table.where(:k => key).lock.first_or_initialize
-        value = convert_for_increment(record.v) + amount
+        value = Utils.to_int(record.v) + amount
         record.v = value.to_s
         record.save
         value
       end
 
+      # (see Proxy#create)
+      def create(key, value, options = {})
+        record = @table.new
+        record.k = key
+        record.v = value
+        record.save
+        true
+      rescue
+        # FIXME: This catches too many errors
+        # it should only catch a not-unique-exception
+        false
+      end
+
       # (see Proxy#clear)
       def clear(options = {})
         @table.delete_all