pogocache-ruby 0.1.1 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b508539b37fe3e137b77098efd4856a7bbe54d6c29b07b185dbd23c51c9c931
-  data.tar.gz: fcab9a6a1327d7670a6b5d2ff79e980ae02b70d19c0b9a19accf7d3db11a3c9e
+  metadata.gz: 2f4f0e5c79ce77f45196a18d56025ec9e0121d813c27522e5d6f01ff8141f1e1
+  data.tar.gz: 5104e3f9f4a9fb635a34b8bfce6d62c1734848e4d30c2149d11270bc784b053f
 SHA512:
-  metadata.gz: 0cb95e1a9e15bcc29a8fdeae551a010d2db62afa691aeb424ade03e309beb6c40a3c5d48c5d82e8278c6593661c289b060de4288108fd8ff5ed087d9cf1179cc
-  data.tar.gz: 6340e198a411104cd0749a33404ae302b0b8b1370db8a41bf2abfaae3c4e97f34474a06476b47e58fbe3fbf75e6ab82a0e763af11ade9e6056359602d571816c
+  metadata.gz: 632148b9538a2e5892b2071e1e920bcdcafe2f58f4efc42fbc10ce478bf676713c0aadd26c91e8176a5b471252280bb5e4edbbaf600d7d1923850fa0695bdd35
+  data.tar.gz: e3fade41b2dc20d996c17d0ce0ccdfa15c2fd5a32a6d2068198c500551edccb44a5ecd90b11d4489c5fc4b9cb04effe2f4a1d4f22e4f86e639d63ef2d504e826

data/README.md

@@ -2,8 +2,8 @@
 
 Use [pogocache](https://github.com/tidwall/pogocache) as an in-memory store in Ruby.
 This gem embeds pogocache as a C extension and provides the class `Pogocache::Cache`to interact with it.
-The goal is to provide a faster, more lightweight alternative to `ActiveSupport::Cache::MemoryStore.
-The state of this project is pretty much pre alfa but functional.
+The goal is to provide a faster, more lightweight alternative to `ActiveSupport::Cache::MemoryStore`.
+The state of this project is pre release but functional. Feedback is welcome.
 
 ## Features
 
@@ -19,103 +19,53 @@ It does not free the lock before any operation.
 
 ## Usage
 
-```
+```sh
 bundle add pogocache-ruby
 ```
+```ruby
+require 'pogocache-ruby'
 
-## Todos
+cache = Pogocache::Cache.new
 
-- [ ] add interface to be used as a rails cache
-- [ ] improve interface
+cache.set("value1", "string 1")
+cache[:value2] = { hash_key: "value" }
 
-## Benchmark
+cache.fetch(:value2)
+# => {hash_key: "value"}
+cache["value1"]
+# => "string 1"
+```
 
-```ruby
-require 'pogocache-ruby'
-require 'active_support'
-require 'active_support/cache'
-require 'benchmark'
-require 'benchmark/memory'
-
-memory_store = ActiveSupport::Cache::MemoryStore.new
-pogocache_store = Pogocache::Cache.new(usecas: true, nosixpack: true)
-pogocache_batch_store = Pogocache::Cache.new
-
-N = 100_000
-
-puts "Benchmarking WRITE performance (#{N} keys)..."
-Benchmark.bm(20) do |x|
-  x.report("MemoryStore write:") do
-    N.times { |i| memory_store.write("key#{i}", { number: i, value: nil}) }
-  end
-
-  x.report("Pogocache write:") do
-    N.times { |i| pogocache_store.set("key#{i}", { number: i, value: nil}) }
-  end
-end
-
-puts "\nBenchmarking READ performance (#{N} keys)..."
-Benchmark.bm(20) do |x|
-  x.report("MemoryStore read:") do
-    N.times { |i| memory_store.read("key#{i}") }
-  end
-
-  x.report("Pogocache read:") do
-    N.times { |i| pogocache_store.get("key#{i}") }
-  end
-end
-
-puts "Benchmarking WRITE performance (#{N} keys)..."
-Benchmark.memory do |x|
-  x.report("MemoryStore write:") do
-    N.times { |i| memory_store.write("key#{i}", { number: i, value: nil}) }
-  end
-
-  x.report("Pogocache write:") do
-    N.times { |i| pogocache_store.set("key#{i}", { number: i, value: nil}) }
-  end
-end
-
-puts "\nBenchmarking READ performance (#{N} keys)..."
-Benchmark.memory do |x|
-  x.report("MemoryStore read:") do
-    N.times { |i| memory_store.read("key#{i}") }
-  end
-
-  x.report("Pogocache read:") do
-    N.times { |i| pogocache_store.get("key#{i}") }
-  end
-end
+See [pogocache_spec.rb](spec/pogocache_spec.rb) and [pogocache.h](ext/pogocache_ruby/pogocache.h) for details.
 
-```
+## Benchmark
+
+[benchmark.rb](benchmark.rb)
 
 ```
 Benchmarking WRITE performance (100000 keys)...
                            user     system      total        real
-MemoryStore write:     0.663600   0.015039   0.678639 (  0.678977)
-Pogocache write:       0.193228   0.012096   0.205324 (  0.205405)
+MemoryStore write:     0.526285   0.020191   0.546476 (  0.546561)
+Pogocache write:       0.087404   0.003957   0.091361 (  0.091385)
 
 Benchmarking READ performance (100000 keys)...
                            user     system      total        real
-MemoryStore read:      0.456161   0.003899   0.460060 (  0.460138)
-Pogocache read:        0.205501   0.000000   0.205501 (  0.205520)
+MemoryStore read:      0.302697   0.004301   0.306998 (  0.307099)
+Pogocache read:        0.104694   0.000000   0.104694 (  0.104700)
 
-Benchmarking WRITE performance (100000 keys)...
+Benchmarking memory performance (100000 keys)...
 Calculating -------------------------------------
-  MemoryStore write:   239.200M memsize (    15.200M retained)
-                         2.000M objects (   200.000k retained)
-                        50.000  strings (    50.000  retained)
-    Pogocache write:    54.396M memsize (     0.000  retained)
-                       599.990k objects (     0.000  retained)
+        MemoryStore:   232.000M memsize (     8.000M retained)
+                         2.200M objects (   100.000k retained)
                         50.000  strings (     0.000  retained)
-
-Benchmarking READ performance (100000 keys)...
-Calculating -------------------------------------
-   MemoryStore read:   116.000M memsize (     0.000  retained)
-                         1.200M objects (     0.000  retained)
-                        50.000  strings (     0.000  retained)
-     Pogocache read:    71.192M memsize (     0.000  retained)
-                       899.990k objects (     0.000  retained)
+          Pogocache:    52.000M memsize (     0.000  retained)
+                       700.000k objects (     0.000  retained)
                         50.000  strings (     0.000  retained)
 
 ```
+
+## License
+
+This gem uses [Pogocache](https://pogocache.com). Pogocache is free & open source software released under the terms of the AGPL license. The Pogocache source code was written and copyrighted by [Polypoint Labs, LLC](https://polypointlabs.com/). 
+
+For alternative licensing options, please contact them at licensing@polypointlabs.com.

data/benchmark.rb

@@ -0,0 +1,45 @@
+require "pogocache-ruby"
+require "active_support"
+require "active_support/cache"
+require "benchmark"
+require "benchmark/memory"
+
+memory_store = ActiveSupport::Cache::MemoryStore.new
+pogocache_store = Pogocache::Cache.new
+
+N = 100_000
+
+puts "Benchmarking WRITE performance (#{N} keys)..."
+Benchmark.bm(20) do |x|
+  x.report("MemoryStore write:") do
+    N.times { |i| memory_store.write(i, i) }
+  end
+
+  x.report("Pogocache write:") do
+    N.times { |i| pogocache_store.set(i, i) }
+  end
+end
+
+puts "\nBenchmarking READ performance (#{N} keys)..."
+Benchmark.bm(20) do |x|
+  x.report("MemoryStore read:") do
+    N.times { |i| memory_store.read(i) }
+  end
+
+  x.report("Pogocache read:") do
+    N.times { |i| pogocache_store.get(i) }
+  end
+end
+
+puts "\nBenchmarking memory performance (#{N} keys)..."
+Benchmark.memory do |x|
+  x.report("MemoryStore:") do
+    N.times { |i| memory_store.write(i, i) }
+    N.times { |i| memory_store.read(i) }
+  end
+
+  x.report("Pogocache:") do
+    N.times { |i| pogocache_store.set(i, i) }
+    N.times { |i| pogocache_store.get(i) }
+  end
+end

data/lib/pogocache-ruby/cache.rb

@@ -18,9 +18,7 @@ class Pogocache::Cache
     end
   end
 
-  def delete(key)
-    @extension.delete(encode(key))
-  end
+  def delete(key) = @extension.delete(encode(key))
 
   def [](key)
     get(key)
@@ -37,22 +35,37 @@ class Pogocache::Cache
     block&.call
   end
 
-  def count
-    @extension.count
+  def increment(key)
+    value = get(key)&.to_i
+    if value
+      set(key, value + 1)
+      value + 1
+    else
+      set(key, 1)
+      1
+    end
   end
-  alias_method(:size, :count)
 
-  def bytesize
-    @extension.size
+  def decrement(key)
+    value = get(key)&.to_i
+    if value
+      set(key, value - 1)
+      value - 1
+    else
+      set(key, 1)
+      1
+    end
   end
 
-  def clear
-    @extension.clear
-  end
+  def count = @extension.count
 
-  def sweep
-    @extension.sweep
-  end
+  def size = count
+
+  def bytesize = @extension.size
+
+  def clear = @extension.clear
+
+  def sweep = @extension.sweep
 
   def each(opts = {}, &block)
     if block_given?
@@ -70,12 +83,32 @@ class Pogocache::Cache
 
   def nshards = @extension.nshards
 
-  private
+  def cleanup(options = {}) = @extension.sweep
 
-  def encode(obj)
-    Marshal.dump(obj)
+  def prune(options = {})
   end
 
+  def pruning?
+    false
+  end
+
+  def delete_matched(matcher, options = {})
+    @extension.each do |e|
+      if decode(e[:key]).to_s.match(matcher)
+        Pogocache::ITER_DELETE # standard:disable Lint/Void
+      else
+        Pogocache::ITER_CONTINUE # standard:disable Lint/Void
+      end
+    end
+  end
+
+  def synchronize
+  end
+
+  private
+
+  def encode(obj) = Marshal.dump(obj)
+
   def decode(str)
     return nil if str.nil? || str.empty?
 

data/lib/pogocache-ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pogocache
-  VERSION = "0.1.1"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pogocache-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.1
 platform: ruby
 authors:
 - heming
@@ -91,6 +91,7 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- benchmark.rb
 - ext/pogocache_ruby/extconf.rb
 - ext/pogocache_ruby/pogocache.c
 - ext/pogocache_ruby/pogocache.h