elephas 2.1.0 → 2.1.1

data/Gemfile

@@ -16,5 +16,5 @@ gem "rake", "~> 10.0.3"
 gem "simplecov", ">= 0.7.1"
 gem "pry", ">= 0"
 gem "yard", ">= 0.8.4"
-gem "redcarpet", ">= 2.2.2"
+gem "kramdown", ">= 0.14.2"
 gem "github-markup", ">= 0.7.5"

data/Rakefile

@@ -8,11 +8,4 @@ require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new("spec")
-
-namespace :spec do
-  desc "Run all specs with coverage"
-  task :coverage do
-    ENV["ELEPHAS_COVERAGE"] = "TRUE"
-    Rake::Task["spec"].invoke
-  end
-end
+RSpec::Core::RakeTask.new("spec:coverage") { |t| t.ruby_opts = "-r./spec/coverage_helper" }

data/doc/Elephas/Cache.html

@@ -672,13 +672,13 @@
 Valid options are:</p>
 
 <ul>
-<li><strong>:ttl</strong>: The TTL (time to live, in milliseconds) of the entry. It means how long will the value stay in cache. Setting it to 0 or less means never cache the entry.</li>
-<li><strong>:force</strong>: Setting it to <code>true</code> will always skip the cache.</li>
-<li><strong>:key</strong>: The key associated to this value. <strong>You should never set this option directly.</strong></li>
-<li><strong>:prefix</strong>: The prefix used in cache. This is used to avoid conflicts with other caching frameworks.</li>
-<li><strong>:complete_key</strong>: The complete key used for computing the hash. By default is concatenation of <code>:key</code> and <code>:prefix</code> options.</li>
-<li><strong>:hash</strong>: The hash used to store the key in the cache. Should be unique</li>
-<li><strong>:as_entry</strong>: In <code>Elephas::Cache.use</code>, setting this to <code>true</code> will return the entire <code>Entry</code> object rather than the value only.</li>
+  <li><strong>:ttl</strong>: The TTL (time to live, in milliseconds) of the entry. It means how long will the value stay in cache. Setting it to 0 or less means never cache the entry.</li>
+  <li><strong>:force</strong>: Setting it to <code>true</code> will always skip the cache.</li>
+  <li><strong>:key</strong>: The key associated to this value. <strong>You should never set this option directly.</strong></li>
+  <li><strong>:prefix</strong>: The prefix used in cache. This is used to avoid conflicts with other caching frameworks.</li>
+  <li><strong>:complete_key</strong>: The complete key used for computing the hash. By default is concatenation of <code>:key</code> and <code>:prefix</code> options.</li>
+  <li><strong>:hash</strong>: The hash used to store the key in the cache. Should be unique</li>
+  <li><strong>:as_entry</strong>: In <code>Elephas::Cache.use</code>, setting this to <code>true</code> will return the entire <code>Entry</code> object rather than the value only.</li>
 </ul>
 
 
@@ -798,22 +798,23 @@ Valid options are:</p>
 
 <p>It tries reading a key from the cache.</p>
 
-<p>If it doesn&#39;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.</p>
+<p>If it doesn&#8217;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.</p>
 
-<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Cache</span><span class='period'>.</span><span class='id identifier rubyid_use'>use</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>KEY</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_options'>options</span><span class='op'>|</span>
-  <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>VALUE</span><span class='tstring_end'>&quot;</span></span>
-<span class='kw'>end</span>
+<p>```ruby
+value = Elephas::Cache.use(&#8220;KEY&#8221;) do |options|
+  &#8220;VALUE&#8221;
+end</p>
 
-<span class='id identifier rubyid_value'>value</span>
-<span class='comment'># =&gt; &quot;VALUE&quot;
-</span>
-<span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Cache</span><span class='period'>.</span><span class='id identifier rubyid_use'>use</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>KEY</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_options'>options</span><span class='op'>|</span>
-  <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>ANOTHER VALUE</span><span class='tstring_end'>&quot;</span></span>
-<span class='kw'>end</span>
+<p>value
+# =&gt; &#8220;VALUE&#8221;</p>
+
+<p>value = Elephas::Cache.use(&#8220;KEY&#8221;) do |options|
+  &#8220;ANOTHER VALUE&#8221;
+end</p>
 
-<span class='id identifier rubyid_value'>value</span>
-<span class='comment'># =&gt; &quot;VALUE&quot;
-</span></code></pre>
+<p>value
+# =&gt; &#8220;VALUE&#8221;
+```</p>
 
 
   </div>
@@ -982,7 +983,7 @@ Valid options are:</p>
       
       
         &mdash;
-        <div class='inline'><p>The value to write. Setting a value to <code>nil</code> <strong>doesn&#39;t</strong> mean <em>deleting</em> the value.</p>
+        <div class='inline'><p>The value to write. Setting a value to <code>nil</code> <strong>doesn’t</strong> mean <em>deleting</em> the value.</p>
 </div>
       
     </li>
@@ -1057,7 +1058,7 @@ Valid options are:</p>
 </div>
 
     <div id="footer">
-  Generated on Thu Feb  7 08:33:46 2013 by
+  Generated on Thu Feb  7 21:28:09 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4.1 (ruby-1.9.3).
 </div>

data/doc/Elephas/Entry.html

@@ -655,7 +655,18 @@
 93
 94
 95
-96</pre>
+96
+97
+98
+99
+100
+101
+102
+103
+104
+105
+106
+107</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/elephas/entry.rb', line 20</span>
@@ -686,7 +697,7 @@
 </span>  <span class='comment'># @param save [Boolean] If to save the refresh value in the cache.
 </span>  <span class='comment'># @return [Float] The new updated_at value.
 </span>  <span class='kw'>def</span> <span class='id identifier rubyid_refresh'>refresh</span><span class='lparen'>(</span><span class='id identifier rubyid_save'>save</span> <span class='op'>=</span> <span class='kw'>false</span><span class='rparen'>)</span>
-    <span class='ivar'>@updated_at</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_now'>now</span><span class='period'>.</span><span class='id identifier rubyid_to_f'>to_f</span>
+    <span class='ivar'>@updated_at</span> <span class='op'>=</span> <span class='id identifier rubyid_get_new_updated_at'>get_new_updated_at</span><span class='lparen'>(</span><span class='ivar'>@updated_at</span><span class='rparen'>)</span>
     <span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Cache</span><span class='period'>.</span><span class='id identifier rubyid_provider'>provider</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='ivar'>@hash</span><span class='comma'>,</span> <span class='kw'>self</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_save'>save</span>
     <span class='ivar'>@updated_at</span>
   <span class='kw'>end</span>
@@ -736,6 +747,17 @@
 
     <span class='id identifier rubyid_rv'>rv</span>
   <span class='kw'>end</span>
+
+  <span class='id identifier rubyid_private'>private</span>
+    <span class='comment'># Makes sure a new updated at is generated.
+</span>    <span class='comment'>#
+</span>    <span class='comment'># @param initial [Float] Old value.
+</span>    <span class='comment'># @return [Float] New value.
+</span>    <span class='kw'>def</span> <span class='id identifier rubyid_get_new_updated_at'>get_new_updated_at</span><span class='lparen'>(</span><span class='id identifier rubyid_initial'>initial</span><span class='rparen'>)</span>
+      <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_now'>now</span><span class='period'>.</span><span class='id identifier rubyid_to_f'>to_f</span>
+      <span class='id identifier rubyid_rv'>rv</span> <span class='op'>+=</span> <span class='float'>1E6</span> <span class='kw'>if</span> <span class='id identifier rubyid_rv'>rv</span> <span class='op'>==</span> <span class='id identifier rubyid_initial'>initial</span>
+      <span class='id identifier rubyid_rv'>rv</span>
+    <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -862,7 +884,18 @@
 93
 94
 95
-96</pre>
+96
+97
+98
+99
+100
+101
+102
+103
+104
+105
+106
+107</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/elephas/entry.rb', line 20</span>
@@ -893,7 +926,7 @@
 </span>  <span class='comment'># @param save [Boolean] If to save the refresh value in the cache.
 </span>  <span class='comment'># @return [Float] The new updated_at value.
 </span>  <span class='kw'>def</span> <span class='id identifier rubyid_refresh'>refresh</span><span class='lparen'>(</span><span class='id identifier rubyid_save'>save</span> <span class='op'>=</span> <span class='kw'>false</span><span class='rparen'>)</span>
-    <span class='ivar'>@updated_at</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_now'>now</span><span class='period'>.</span><span class='id identifier rubyid_to_f'>to_f</span>
+    <span class='ivar'>@updated_at</span> <span class='op'>=</span> <span class='id identifier rubyid_get_new_updated_at'>get_new_updated_at</span><span class='lparen'>(</span><span class='ivar'>@updated_at</span><span class='rparen'>)</span>
     <span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Cache</span><span class='period'>.</span><span class='id identifier rubyid_provider'>provider</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='ivar'>@hash</span><span class='comma'>,</span> <span class='kw'>self</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_save'>save</span>
     <span class='ivar'>@updated_at</span>
   <span class='kw'>end</span>
@@ -943,6 +976,17 @@
 
     <span class='id identifier rubyid_rv'>rv</span>
   <span class='kw'>end</span>
+
+  <span class='id identifier rubyid_private'>private</span>
+    <span class='comment'># Makes sure a new updated at is generated.
+</span>    <span class='comment'>#
+</span>    <span class='comment'># @param initial [Float] Old value.
+</span>    <span class='comment'># @return [Float] New value.
+</span>    <span class='kw'>def</span> <span class='id identifier rubyid_get_new_updated_at'>get_new_updated_at</span><span class='lparen'>(</span><span class='id identifier rubyid_initial'>initial</span><span class='rparen'>)</span>
+      <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_now'>now</span><span class='period'>.</span><span class='id identifier rubyid_to_f'>to_f</span>
+      <span class='id identifier rubyid_rv'>rv</span> <span class='op'>+=</span> <span class='float'>1E6</span> <span class='kw'>if</span> <span class='id identifier rubyid_rv'>rv</span> <span class='op'>==</span> <span class='id identifier rubyid_initial'>initial</span>
+      <span class='id identifier rubyid_rv'>rv</span>
+    <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1069,7 +1113,18 @@
 93
 94
 95
-96</pre>
+96
+97
+98
+99
+100
+101
+102
+103
+104
+105
+106
+107</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/elephas/entry.rb', line 20</span>
@@ -1100,7 +1155,7 @@
 </span>  <span class='comment'># @param save [Boolean] If to save the refresh value in the cache.
 </span>  <span class='comment'># @return [Float] The new updated_at value.
 </span>  <span class='kw'>def</span> <span class='id identifier rubyid_refresh'>refresh</span><span class='lparen'>(</span><span class='id identifier rubyid_save'>save</span> <span class='op'>=</span> <span class='kw'>false</span><span class='rparen'>)</span>
-    <span class='ivar'>@updated_at</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_now'>now</span><span class='period'>.</span><span class='id identifier rubyid_to_f'>to_f</span>
+    <span class='ivar'>@updated_at</span> <span class='op'>=</span> <span class='id identifier rubyid_get_new_updated_at'>get_new_updated_at</span><span class='lparen'>(</span><span class='ivar'>@updated_at</span><span class='rparen'>)</span>
     <span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Cache</span><span class='period'>.</span><span class='id identifier rubyid_provider'>provider</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='ivar'>@hash</span><span class='comma'>,</span> <span class='kw'>self</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_save'>save</span>
     <span class='ivar'>@updated_at</span>
   <span class='kw'>end</span>
@@ -1150,6 +1205,17 @@
 
     <span class='id identifier rubyid_rv'>rv</span>
   <span class='kw'>end</span>
+
+  <span class='id identifier rubyid_private'>private</span>
+    <span class='comment'># Makes sure a new updated at is generated.
+</span>    <span class='comment'>#
+</span>    <span class='comment'># @param initial [Float] Old value.
+</span>    <span class='comment'># @return [Float] New value.
+</span>    <span class='kw'>def</span> <span class='id identifier rubyid_get_new_updated_at'>get_new_updated_at</span><span class='lparen'>(</span><span class='id identifier rubyid_initial'>initial</span><span class='rparen'>)</span>
+      <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_now'>now</span><span class='period'>.</span><span class='id identifier rubyid_to_f'>to_f</span>
+      <span class='id identifier rubyid_rv'>rv</span> <span class='op'>+=</span> <span class='float'>1E6</span> <span class='kw'>if</span> <span class='id identifier rubyid_rv'>rv</span> <span class='op'>==</span> <span class='id identifier rubyid_initial'>initial</span>
+      <span class='id identifier rubyid_rv'>rv</span>
+    <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1276,7 +1342,18 @@
 93
 94
 95
-96</pre>
+96
+97
+98
+99
+100
+101
+102
+103
+104
+105
+106
+107</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/elephas/entry.rb', line 20</span>
@@ -1307,7 +1384,7 @@
 </span>  <span class='comment'># @param save [Boolean] If to save the refresh value in the cache.
 </span>  <span class='comment'># @return [Float] The new updated_at value.
 </span>  <span class='kw'>def</span> <span class='id identifier rubyid_refresh'>refresh</span><span class='lparen'>(</span><span class='id identifier rubyid_save'>save</span> <span class='op'>=</span> <span class='kw'>false</span><span class='rparen'>)</span>
-    <span class='ivar'>@updated_at</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_now'>now</span><span class='period'>.</span><span class='id identifier rubyid_to_f'>to_f</span>
+    <span class='ivar'>@updated_at</span> <span class='op'>=</span> <span class='id identifier rubyid_get_new_updated_at'>get_new_updated_at</span><span class='lparen'>(</span><span class='ivar'>@updated_at</span><span class='rparen'>)</span>
     <span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Cache</span><span class='period'>.</span><span class='id identifier rubyid_provider'>provider</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='ivar'>@hash</span><span class='comma'>,</span> <span class='kw'>self</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_save'>save</span>
     <span class='ivar'>@updated_at</span>
   <span class='kw'>end</span>
@@ -1357,6 +1434,17 @@
 
     <span class='id identifier rubyid_rv'>rv</span>
   <span class='kw'>end</span>
+
+  <span class='id identifier rubyid_private'>private</span>
+    <span class='comment'># Makes sure a new updated at is generated.
+</span>    <span class='comment'>#
+</span>    <span class='comment'># @param initial [Float] Old value.
+</span>    <span class='comment'># @return [Float] New value.
+</span>    <span class='kw'>def</span> <span class='id identifier rubyid_get_new_updated_at'>get_new_updated_at</span><span class='lparen'>(</span><span class='id identifier rubyid_initial'>initial</span><span class='rparen'>)</span>
+      <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_now'>now</span><span class='period'>.</span><span class='id identifier rubyid_to_f'>to_f</span>
+      <span class='id identifier rubyid_rv'>rv</span> <span class='op'>+=</span> <span class='float'>1E6</span> <span class='kw'>if</span> <span class='id identifier rubyid_rv'>rv</span> <span class='op'>==</span> <span class='id identifier rubyid_initial'>initial</span>
+      <span class='id identifier rubyid_rv'>rv</span>
+    <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1483,7 +1571,18 @@
 93
 94
 95
-96</pre>
+96
+97
+98
+99
+100
+101
+102
+103
+104
+105
+106
+107</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/elephas/entry.rb', line 20</span>
@@ -1514,7 +1613,7 @@
 </span>  <span class='comment'># @param save [Boolean] If to save the refresh value in the cache.
 </span>  <span class='comment'># @return [Float] The new updated_at value.
 </span>  <span class='kw'>def</span> <span class='id identifier rubyid_refresh'>refresh</span><span class='lparen'>(</span><span class='id identifier rubyid_save'>save</span> <span class='op'>=</span> <span class='kw'>false</span><span class='rparen'>)</span>
-    <span class='ivar'>@updated_at</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_now'>now</span><span class='period'>.</span><span class='id identifier rubyid_to_f'>to_f</span>
+    <span class='ivar'>@updated_at</span> <span class='op'>=</span> <span class='id identifier rubyid_get_new_updated_at'>get_new_updated_at</span><span class='lparen'>(</span><span class='ivar'>@updated_at</span><span class='rparen'>)</span>
     <span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Cache</span><span class='period'>.</span><span class='id identifier rubyid_provider'>provider</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='ivar'>@hash</span><span class='comma'>,</span> <span class='kw'>self</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_save'>save</span>
     <span class='ivar'>@updated_at</span>
   <span class='kw'>end</span>
@@ -1564,6 +1663,17 @@
 
     <span class='id identifier rubyid_rv'>rv</span>
   <span class='kw'>end</span>
+
+  <span class='id identifier rubyid_private'>private</span>
+    <span class='comment'># Makes sure a new updated at is generated.
+</span>    <span class='comment'>#
+</span>    <span class='comment'># @param initial [Float] Old value.
+</span>    <span class='comment'># @return [Float] New value.
+</span>    <span class='kw'>def</span> <span class='id identifier rubyid_get_new_updated_at'>get_new_updated_at</span><span class='lparen'>(</span><span class='id identifier rubyid_initial'>initial</span><span class='rparen'>)</span>
+      <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_now'>now</span><span class='period'>.</span><span class='id identifier rubyid_to_f'>to_f</span>
+      <span class='id identifier rubyid_rv'>rv</span> <span class='op'>+=</span> <span class='float'>1E6</span> <span class='kw'>if</span> <span class='id identifier rubyid_rv'>rv</span> <span class='op'>==</span> <span class='id identifier rubyid_initial'>initial</span>
+      <span class='id identifier rubyid_rv'>rv</span>
+    <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1938,7 +2048,7 @@
       <pre class="code"><span class="info file"># File 'lib/elephas/entry.rb', line 45</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_refresh'>refresh</span><span class='lparen'>(</span><span class='id identifier rubyid_save'>save</span> <span class='op'>=</span> <span class='kw'>false</span><span class='rparen'>)</span>
-  <span class='ivar'>@updated_at</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_now'>now</span><span class='period'>.</span><span class='id identifier rubyid_to_f'>to_f</span>
+  <span class='ivar'>@updated_at</span> <span class='op'>=</span> <span class='id identifier rubyid_get_new_updated_at'>get_new_updated_at</span><span class='lparen'>(</span><span class='ivar'>@updated_at</span><span class='rparen'>)</span>
   <span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Cache</span><span class='period'>.</span><span class='id identifier rubyid_provider'>provider</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='ivar'>@hash</span><span class='comma'>,</span> <span class='kw'>self</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_save'>save</span>
   <span class='ivar'>@updated_at</span>
 <span class='kw'>end</span></pre>
@@ -2032,7 +2142,7 @@
 </div>
 
     <div id="footer">
-  Generated on Thu Feb  7 08:33:46 2013 by
+  Generated on Thu Feb  7 21:28:08 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4.1 (ruby-1.9.3).
 </div>

data/doc/Elephas/Providers/Base.html

@@ -577,7 +577,7 @@
       
       
         —
-        <div class='inline'><p>The value to write. Setting a value to <code>nil</code> <strong>doesn&#39;t</strong> mean <em>deleting</em> the value.</p>
+        <div class='inline'><p>The value to write. Setting a value to <code>nil</code> <strong>doesn’t</strong> mean <em>deleting</em> the value.</p>
 </div>
       
     </li>
@@ -652,7 +652,7 @@
 </div>
 
     <div id="footer">
-  Generated on Thu Feb  7 08:33:46 2013 by
+  Generated on Thu Feb  7 21:28:08 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4.1 (ruby-1.9.3).
 </div>

data/doc/Elephas/Providers/Hash.html

@@ -806,7 +806,7 @@
       
       
         —
-        <div class='inline'><p>The value to write. Setting a value to <code>nil</code> <strong>doesn&#39;t</strong> mean <em>deleting</em> the value.</p>
+        <div class='inline'><p>The value to write. Setting a value to <code>nil</code> <strong>doesn’t</strong> mean <em>deleting</em> the value.</p>
 </div>
       
     </li>
@@ -887,7 +887,7 @@
 </div>
 
     <div id="footer">
-  Generated on Thu Feb  7 08:33:46 2013 by
+  Generated on Thu Feb  7 21:28:09 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4.1 (ruby-1.9.3).
 </div>

data/doc/Elephas/Providers/RubyOnRails.html

@@ -523,7 +523,7 @@
       
       
         —
-        <div class='inline'><p>The value to write. <strong>Setting a value to <code>nil</code> **doesn&#39;t</strong> mean <em>deleting</em> the value.</p>
+        <div class='inline'><p>The value to write. <strong>Setting a value to <code>nil</code> **doesn’t</strong> mean <em>deleting</em> the value.</p>
 </div>
       
     </li>
@@ -604,7 +604,7 @@
 </div>
 
     <div id="footer">
-  Generated on Thu Feb  7 08:33:46 2013 by
+  Generated on Thu Feb  7 21:28:09 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4.1 (ruby-1.9.3).
 </div>

data/doc/Elephas/Providers.html

@@ -120,7 +120,7 @@
 </div>
 
     <div id="footer">
-  Generated on Thu Feb  7 08:33:46 2013 by
+  Generated on Thu Feb  7 21:28:08 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4.1 (ruby-1.9.3).
 </div>

data/doc/Elephas/Version.html

@@ -149,7 +149,7 @@
 
 </div>
         </dt>
-        <dd><pre class="code"><span class='int'>0</span></pre></dd>
+        <dd><pre class="code"><span class='int'>1</span></pre></dd>
       
         <dt id="STRING-constant" class="">STRING =
           <div class="docstring">
@@ -180,7 +180,7 @@
 </div>
 
     <div id="footer">
-  Generated on Thu Feb  7 08:33:46 2013 by
+  Generated on Thu Feb  7 21:28:08 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4.1 (ruby-1.9.3).
 </div>

data/doc/Elephas.html

@@ -88,8 +88,8 @@
 
 <h2>Overview</h2><div class="docstring">
   <div class="discussion">
-    <p>This file is part of the elephas gem. Copyright (C) 2013 and above Shogun <shogun_panda@me.com>.
-Licensed under the MIT license, which can be found at <a href="http://www.opensource.org/licenses/mit-license.php">http://www.opensource.org/licenses/mit-license.php</a>.</p>
+    <p>This file is part of the elephas gem. Copyright (C) 2013 and above Shogun &lt;shogun_panda@me.com&gt;.
+Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.</p>
 
 
   </div>
@@ -121,7 +121,7 @@ Licensed under the MIT license, which can be found at <a href="http://www.openso
 </div>
 
     <div id="footer">
-  Generated on Thu Feb  7 08:33:46 2013 by
+  Generated on Thu Feb  7 21:28:08 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4.1 (ruby-1.9.3).
 </div>

data/doc/_index.html

@@ -198,7 +198,7 @@
 </div>
 
     <div id="footer">
-  Generated on Thu Feb  7 08:33:46 2013 by
+  Generated on Thu Feb  7 21:28:08 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4.1 (ruby-1.9.3).
 </div>

data/doc/file.README.html

@@ -61,38 +61,40 @@
 
     <iframe id="search_frame"></iframe>
 
-    <div id="content"><div id='filecontents'><h1>elephas</h1>
+    <div id="content"><div id='filecontents'><h1 id="elephas">elephas</h1>
 
-<p><a href="http://travis-ci.org/ShogunPanda/elephas"><img src="https://secure.travis-ci.org/ShogunPanda/elephas.png?branch=master" alt="Build Status"></a>
-<a href="https://gemnasium.com/ShogunPanda/elephas"><img src="https://gemnasium.com/ShogunPanda/elephas.png?travis" alt="Dependency Status"></a>
-<a href="https://codeclimate.com/github/ShogunPanda/elephas"><img src="https://codeclimate.com/github/ShogunPanda/elephas.png" alt="Code Climate"></a></p>
+<p><a href="http://travis-ci.org/ShogunPanda/elephas"><img src="https://secure.travis-ci.org/ShogunPanda/elephas.png?branch=master" alt="Build Status" /></a>
+<a href="https://gemnasium.com/ShogunPanda/elephas"><img src="https://gemnasium.com/ShogunPanda/elephas.png?travis" alt="Dependency Status" /></a>
+<a href="https://codeclimate.com/github/ShogunPanda/elephas"><img src="https://codeclimate.com/github/ShogunPanda/elephas.png" alt="Code Climate" /></a></p>
 
 <p>A storage agnostic caching framework.</p>
 
-<p><a href="http://sw.cow.tc/elephas">http://sw.cow.tc/elephas</a></p>
+<p>http://sw.cow.tc/elephas</p>
 
-<p><a href="http://rdoc.info/gems/elephas">http://rdoc.info/gems/elephas</a></p>
+<p>http://rdoc.info/gems/elephas</p>
 
-<h2>Usage</h2>
+<h2 id="usage">Usage</h2>
 
 <p>The usage of the framework is really simple.</p>
 
 <p>At first you have to setup a provider (that is, a storage) for the Elephas. By default it uses an internal hash, and also Rails is supported.</p>
 
-<pre class="code ruby"><code class="ruby"><span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Cache</span><span class='period'>.</span><span class='id identifier rubyid_provider'>provider</span> <span class='op'>=</span> <span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Providers</span><span class='op'>::</span><span class='const'>RubyOnRails</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
-</code></pre>
+<p><code>ruby
+Elephas::Cache.provider = Elephas::Providers::RubyOnRails.new
+</code></p>
 
 <p>After that, you can query the framework for a value use the <code>use</code> method.</p>
 
 <p>You should also pass a block to the method, so that the framework use that for computing the value of the cache entry.</p>
 
-<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Cache</span><span class='period'>.</span><span class='id identifier rubyid_use'>use</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>KEY</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_options'>options</span><span class='op'>|</span>
-  <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>VALUE</span><span class='tstring_end'>&quot;</span></span>
-<span class='kw'>end</span>
-<span class='comment'># =&gt; &quot;VALUE&quot;
-</span></code></pre>
+<p><code>ruby
+value = Elephas::Cache.use("KEY") do |options|
+  "VALUE"
+end
+# =&gt; "VALUE"
+</code></p>
 
-<p>The next time you issue this call, the block won&#39;t be called.</p>
+<p>The next time you issue this call, the block won&#8217;t be called.</p>
 
 <p>The block takes an argument, which contains all the options for the entry.</p>
 
@@ -102,29 +104,29 @@
 
 <p>See documentation for more informations.</p>
 
-<p><strong>You&#39;re done!</strong></p>
+<p><strong>You&#8217;re done!</strong></p>
 
-<h2>Contributing to elephas</h2>
+<h2 id="contributing-to-elephas">Contributing to elephas</h2>
 
 <ul>
-<li>Check out the latest master to make sure the feature hasn&#39;t been implemented or the bug hasn&#39;t been fixed yet.</li>
-<li>Check out the issue tracker to make sure someone already hasn&#39;t requested it and/or contributed it.</li>
-<li>Fork the project.</li>
-<li>Start a feature/bugfix branch.</li>
-<li>Commit and push until you are happy with your contribution.</li>
-<li>Make sure to add tests for it. This is important so I don&#39;t break it in a future version unintentionally.</li>
-<li>Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.</li>
+  <li>Check out the latest master to make sure the feature hasn&#8217;t been implemented or the bug hasn&#8217;t been fixed yet.</li>
+  <li>Check out the issue tracker to make sure someone already hasn&#8217;t requested it and/or contributed it.</li>
+  <li>Fork the project.</li>
+  <li>Start a feature/bugfix branch.</li>
+  <li>Commit and push until you are happy with your contribution.</li>
+  <li>Make sure to add tests for it. This is important so I don&#8217;t break it in a future version unintentionally.</li>
+  <li>Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.</li>
 </ul>
 
-<h2>Copyright</h2>
+<h2 id="copyright">Copyright</h2>
 
-<p>Copyright (C) 2013 and above Shogun (<a href="mailto:shogun_panda@me.com">shogun_panda@me.com</a>).</p>
+<p>Copyright (C) 2013 and above Shogun (shogun_panda@me.com).</p>
 
-<p>Licensed under the MIT license, which can be found at <a href="http://www.opensource.org/licenses/mit-license.php">http://www.opensource.org/licenses/mit-license.php</a>.</p>
+<p>Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Thu Feb  7 08:33:46 2013 by
+  Generated on Thu Feb  7 21:28:08 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4.1 (ruby-1.9.3).
 </div>

data/doc/index.html

@@ -61,38 +61,40 @@
 
     <iframe id="search_frame"></iframe>
 
-    <div id="content"><div id='filecontents'><h1>elephas</h1>
+    <div id="content"><div id='filecontents'><h1 id="elephas">elephas</h1>
 
-<p><a href="http://travis-ci.org/ShogunPanda/elephas"><img src="https://secure.travis-ci.org/ShogunPanda/elephas.png?branch=master" alt="Build Status"></a>
-<a href="https://gemnasium.com/ShogunPanda/elephas"><img src="https://gemnasium.com/ShogunPanda/elephas.png?travis" alt="Dependency Status"></a>
-<a href="https://codeclimate.com/github/ShogunPanda/elephas"><img src="https://codeclimate.com/github/ShogunPanda/elephas.png" alt="Code Climate"></a></p>
+<p><a href="http://travis-ci.org/ShogunPanda/elephas"><img src="https://secure.travis-ci.org/ShogunPanda/elephas.png?branch=master" alt="Build Status" /></a>
+<a href="https://gemnasium.com/ShogunPanda/elephas"><img src="https://gemnasium.com/ShogunPanda/elephas.png?travis" alt="Dependency Status" /></a>
+<a href="https://codeclimate.com/github/ShogunPanda/elephas"><img src="https://codeclimate.com/github/ShogunPanda/elephas.png" alt="Code Climate" /></a></p>
 
 <p>A storage agnostic caching framework.</p>
 
-<p><a href="http://sw.cow.tc/elephas">http://sw.cow.tc/elephas</a></p>
+<p>http://sw.cow.tc/elephas</p>
 
-<p><a href="http://rdoc.info/gems/elephas">http://rdoc.info/gems/elephas</a></p>
+<p>http://rdoc.info/gems/elephas</p>
 
-<h2>Usage</h2>
+<h2 id="usage">Usage</h2>
 
 <p>The usage of the framework is really simple.</p>
 
 <p>At first you have to setup a provider (that is, a storage) for the Elephas. By default it uses an internal hash, and also Rails is supported.</p>
 
-<pre class="code ruby"><code class="ruby"><span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Cache</span><span class='period'>.</span><span class='id identifier rubyid_provider'>provider</span> <span class='op'>=</span> <span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Providers</span><span class='op'>::</span><span class='const'>RubyOnRails</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
-</code></pre>
+<p><code>ruby
+Elephas::Cache.provider = Elephas::Providers::RubyOnRails.new
+</code></p>
 
 <p>After that, you can query the framework for a value use the <code>use</code> method.</p>
 
 <p>You should also pass a block to the method, so that the framework use that for computing the value of the cache entry.</p>
 
-<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='const'>Elephas</span><span class='op'>::</span><span class='const'>Cache</span><span class='period'>.</span><span class='id identifier rubyid_use'>use</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>KEY</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_options'>options</span><span class='op'>|</span>
-  <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>VALUE</span><span class='tstring_end'>&quot;</span></span>
-<span class='kw'>end</span>
-<span class='comment'># =&gt; &quot;VALUE&quot;
-</span></code></pre>
+<p><code>ruby
+value = Elephas::Cache.use("KEY") do |options|
+  "VALUE"
+end
+# =&gt; "VALUE"
+</code></p>
 
-<p>The next time you issue this call, the block won&#39;t be called.</p>
+<p>The next time you issue this call, the block won&#8217;t be called.</p>
 
 <p>The block takes an argument, which contains all the options for the entry.</p>
 
@@ -102,29 +104,29 @@
 
 <p>See documentation for more informations.</p>
 
-<p><strong>You&#39;re done!</strong></p>
+<p><strong>You&#8217;re done!</strong></p>
 
-<h2>Contributing to elephas</h2>
+<h2 id="contributing-to-elephas">Contributing to elephas</h2>
 
 <ul>
-<li>Check out the latest master to make sure the feature hasn&#39;t been implemented or the bug hasn&#39;t been fixed yet.</li>
-<li>Check out the issue tracker to make sure someone already hasn&#39;t requested it and/or contributed it.</li>
-<li>Fork the project.</li>
-<li>Start a feature/bugfix branch.</li>
-<li>Commit and push until you are happy with your contribution.</li>
-<li>Make sure to add tests for it. This is important so I don&#39;t break it in a future version unintentionally.</li>
-<li>Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.</li>
+  <li>Check out the latest master to make sure the feature hasn&#8217;t been implemented or the bug hasn&#8217;t been fixed yet.</li>
+  <li>Check out the issue tracker to make sure someone already hasn&#8217;t requested it and/or contributed it.</li>
+  <li>Fork the project.</li>
+  <li>Start a feature/bugfix branch.</li>
+  <li>Commit and push until you are happy with your contribution.</li>
+  <li>Make sure to add tests for it. This is important so I don&#8217;t break it in a future version unintentionally.</li>
+  <li>Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.</li>
 </ul>
 
-<h2>Copyright</h2>
+<h2 id="copyright">Copyright</h2>
 
-<p>Copyright (C) 2013 and above Shogun (<a href="mailto:shogun_panda@me.com">shogun_panda@me.com</a>).</p>
+<p>Copyright (C) 2013 and above Shogun (shogun_panda@me.com).</p>
 
-<p>Licensed under the MIT license, which can be found at <a href="http://www.opensource.org/licenses/mit-license.php">http://www.opensource.org/licenses/mit-license.php</a>.</p>
+<p>Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Thu Feb  7 08:33:46 2013 by
+  Generated on Thu Feb  7 21:28:08 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4.1 (ruby-1.9.3).
 </div>

data/doc/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Thu Feb  7 08:33:46 2013 by
+  Generated on Thu Feb  7 21:28:08 2013 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.4.1 (ruby-1.9.3).
 </div>

data/lib/elephas/entry.rb

@@ -43,7 +43,7 @@ module Elephas
     # @param save [Boolean] If to save the refresh value in the cache.
     # @return [Float] The new updated_at value.
     def refresh(save = false)
-      @updated_at = Time.now.to_f
+      @updated_at = get_new_updated_at(@updated_at)
       Elephas::Cache.provider.write(@hash, self) if save
       @updated_at
     end
@@ -93,5 +93,16 @@ module Elephas
 
       rv
     end
+
+    private
+      # Makes sure a new updated at is generated.
+      #
+      # @param initial [Float] Old value.
+      # @return [Float] New value.
+      def get_new_updated_at(initial)
+        rv = Time.now.to_f
+        rv += 1E6 if rv == initial
+        rv
+      end
   end
 end

data/lib/elephas/version.rb

@@ -17,7 +17,7 @@ module Elephas
     MINOR = 1
 
     # The patch version.
-    PATCH = 0
+    PATCH = 1
 
     # The current version of elephas.
     STRING = [MAJOR, MINOR, PATCH].compact.join(".")

data/spec/coverage_helper.rb

@@ -5,16 +5,13 @@
 #
 
 require "pathname"
+require "simplecov"
 
-if ENV["ELEPHAS_COVERAGE"] == "TRUE" && RUBY_VERSION >= "1.9" then
-  require "simplecov"
-
+SimpleCov.start do
   root = Pathname.new(File.dirname(__FILE__)) + ".."
 
-  SimpleCov.start do
-    add_filter do |src_file|
-      path = Pathname.new(src_file.filename).relative_path_from(root).to_s
-      path !~ /^lib/
-    end
+  add_filter do |src_file|
+    path = Pathname.new(src_file.filename).relative_path_from(root).to_s
+    path !~ /^lib/
   end
 end

data/spec/elephas/providers/ruby_on_rails_spec.rb

@@ -13,6 +13,7 @@ describe Elephas::Providers::RubyOnRails do
     end
 
     def write(key, value, options = {})
+      self.delete(key)
       self[key] = value
     end
 

data/spec/spec_helper.rb

@@ -5,7 +5,6 @@
 #
 
 require "rubygems"
-require "coverage_helper"
 require "bundler/setup"
 require "elephas"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: elephas
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.1.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-07 00:00:00.000000000 Z
+date: 2013-02-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lazier
@@ -100,7 +100,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2315547574760873877
+      hash: 1754632980539960747
 requirements: []
 rubyforge_project: elephas
 rubygems_version: 1.8.25