atomic_cache 0.1.0.rc1

data/lib/atomic_cache/storage/memory.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require_relative 'store'
+
+module AtomicCache
+  module Storage
+
+    # An abstract storage adapter which keeps all values in memory
+    class Memory < Store
+
+      # @abstract implement returning a Hash of the in-memory representation
+      def store; raise NotImplementedError end
+
+      # @abstract implement performing an operation on the store
+      def store_op(key, user_options=nil); raise NotImplementedError end
+
+      def add(raw_key, new_value, ttl, user_options=nil)
+        store_op(raw_key, user_options) do |key, options|
+          return false if store.has_key?(key)
+          write(key, new_value, ttl)
+        end
+      end
+
+      def read(raw_key, user_options=nil)
+        store_op(raw_key, user_options) do |key, options|
+          entry = store[key]
+          return nil unless entry.present?
+
+          return entry[:value] if entry[:ttl].nil? or entry[:ttl] == false
+
+          life = Time.now - entry[:written_at]
+          if (life >= entry[:ttl])
+            store.delete(key)
+            nil
+          else
+            entry[:value]
+          end
+        end
+      end
+
+      def set(raw_key, new_value, user_options=nil)
+        store_op(raw_key, user_options) do |key, options|
+          write(key, new_value, options[:expires_in])
+        end
+      end
+
+      def delete(raw_key)
+        store_op(raw_key) do |key, options|
+          store.delete(key)
+          true
+        end
+      end
+
+      def write(key, value, ttl=nil)
+        stored_value = value.to_s
+        stored_value = nil if value.nil?
+
+        store[key] = {
+          value: stored_value,
+          ttl: ttl || false,
+          written_at: Time.now
+        }
+        true
+      end
+    end
+  end
+end

data/lib/atomic_cache/storage/shared_memory.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative 'memory'
+
+module AtomicCache
+  module Storage
+
+    # A storage adapter which keeps all values in memory, global to all threads
+    class SharedMemory < Memory
+      STORE = {}
+      SEMAPHORE = Mutex.new
+
+      def self.reset
+        STORE.clear
+      end
+
+      def self.store
+        STORE
+      end
+
+      def reset
+        self.class.reset
+      end
+
+      def store
+        STORE
+      end
+
+      def store_op(key, user_options=nil)
+        normalized_key = key.to_sym
+        user_options ||= {}
+
+        SEMAPHORE.synchronize do
+          yield(normalized_key, user_options)
+        end
+      end
+
+    end
+  end
+end

data/lib/atomic_cache/storage/store.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative 'memory'
+
+module AtomicCache
+  module Storage
+
+    class Store
+
+      # @abstract (String, Object, Integer, Hash) -> Boolean
+      # ttl is in millis
+      # operation must be atomic
+      # returns true when the key doesn't exist and was written successfully
+      # returns false in all other cases
+      def add(key, new_value, ttl, user_options); raise NotImplementedError end
+
+      # @abstract (String, Hash) -> String
+      # return the `value` at `key`
+      def read(key, user_options); raise NotImplementedError end
+
+      # @abstract (String, Object) -> Boolean
+      # returns true if it succeeds; false otherwise
+      def set(key, new_value, user_options); raise NotImplementedError end
+
+      # @abstract (String) -> Boolean
+      # returns true if it succeeds; false otherwise
+      def delete(key, user_options); raise NotImplementedError end
+
+    end
+  end
+end

data/lib/atomic_cache/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module AtomicCache
+  VERSION = "0.1.0.rc1"
+end

metadata

@@ -0,0 +1,185 @@
+--- !ruby/object:Gem::Specification
+name: atomic_cache
+version: !ruby/object:Gem::Version
+  version: 0.1.0.rc1
+platform: ruby
+authors:
+- Ibotta Developers
+- Titus Stone
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-02-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: gems
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: murmurhash3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+description: desc
+email: osscompliance@ibotta.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".ruby_version"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- atomic_cache.gemspec
+- bin/console
+- bin/setup
+- docs/ARCH.md
+- docs/INTERFACES.md
+- docs/MODEL_SETUP.md
+- docs/PROJECT_SETUP.md
+- docs/USAGE.md
+- docs/img/quick_retry_graph.png
+- lib/atomic_cache.rb
+- lib/atomic_cache/atomic_cache_client.rb
+- lib/atomic_cache/concerns/global_lmt_cache_concern.rb
+- lib/atomic_cache/default_config.rb
+- lib/atomic_cache/key/keyspace.rb
+- lib/atomic_cache/key/last_mod_time_key_manager.rb
+- lib/atomic_cache/storage/dalli.rb
+- lib/atomic_cache/storage/instance_memory.rb
+- lib/atomic_cache/storage/memory.rb
+- lib/atomic_cache/storage/shared_memory.rb
+- lib/atomic_cache/storage/store.rb
+- lib/atomic_cache/version.rb
+homepage: https://github.com/ibotta/atomic_cache
+licenses:
+- apache 2.0
+metadata: {}
+post_install_message: 
+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: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.11
+signing_key: 
+specification_version: 4
+summary: summary
+test_files: []