tiny_memcache 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cc5d7597a0b2d914021e48cb32e795e356f368591123806d102b09b02f393549
+  data.tar.gz: ba07daba44061fec4ca3ce9be73eb3c1fe42f2b78eae2b2cefa0abc1b21f98c4
+SHA512:
+  metadata.gz: b9a4f437fa04ee9440bf40473a40411361438bc781579624b05175658d0c6dec4fc3aeb5c870e1dff53abb40d7c9518535ca6963457a2882f1276267a1db4d56
+  data.tar.gz: e47757a016a334341c9f889953e7d588d6f50d8be65b6084b0dd8838d83d6b4bfe0d861a0a222f33cad8050f173b94409c0d44dac3f89389e9a276c56248792d

data/lib/tiny_memcache.rb

@@ -0,0 +1,68 @@
+require 'objspace'
+
+# a small in-memory cache, barely more than a Hash.
+#
+# it supports the following commands from the memcache protocol:
+#
+#   * get <key>
+#   * set <key> <value>
+#   * del <key>
+#
+# the key and value lengths are configurable, but default to 1k and 64k
+# respectively.
+#
+# example:
+#
+#   cache = TinyMemcache.new
+#   cache.set("foo", "bar")
+#   cache.get("foo") #=> "bar"
+#   cache.del("foo")
+#   cache.get("foo") #=> nil
+class TinyMemcache
+  attr_reader :total_keys,
+              :total_key_size,
+              :total_value_size
+
+  # initializes a new tiny_memcache object.
+  #
+  # options:
+  #
+  #   :max_key_length   - the maximum length of a key in bytes (default: 1024)
+  #   :max_value_length - the maximum length of a value in bytes (default: 65536)
+  #
+  def initialize(max_key_size: 1_024, max_value_size: 65_536)
+    @data = {}
+
+    @total_keys = 0
+    @total_key_size = 0
+    @total_value_size = 0
+
+    @max_key_length = max_key_size
+    @max_value_length = max_value_size
+  end
+
+  def get(key)
+    @data[key]
+  end
+
+  def set(key, value)
+    raise KeyTooLongError if ObjectSpace.memsize_of(key) > @max_key_length
+    raise ValueTooLongError if ObjectSpace.memsize_of(value) > @max_value_length
+
+    @total_keys += 1
+    @total_key_size += ObjectSpace.memsize_of(key)
+    @total_value_size += ObjectSpace.memsize_of(value)
+    @data[key] = value
+  end
+
+  def del(key)
+    @total_keys -= 1
+    @total_key_size -= ObjectSpace.memsize_of(key)
+    @total_value_size -= ObjectSpace.memsize_of(get(key))
+
+    @data.delete(key)
+  end
+
+  class KeyTooLongError < StandardError; end
+  class ValueTooLongError < StandardError; end
+end

metadata

@@ -0,0 +1,40 @@
+--- !ruby/object:Gem::Specification
+name: tiny_memcache
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jeff Lunt
+bindir: bin
+cert_chain: []
+date: 2025-12-18 00:00:00.000000000 Z
+dependencies: []
+description: a tiny in-memory cache
+email: jefflunt@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/tiny_memcache.rb
+homepage: https://github.com/jefflunt/tiny_memcache
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.3
+specification_version: 4
+summary: a tiny in-memory cache
+test_files: []