Contents

module Howitzer
  ##
  #
  # Data can be stored in memory using this class
  #
  module Cache
    SPECIAL_NS_LIST = [:cloud].freeze #:nodoc:
    @data ||= {}

    class << self
      attr_reader :data

      # Saves data into memory. Marking by a namespace and a key
      #
      # @param ns [String] a namespace
      # @param key [String] a key that should be uniq within the namespace
      # @param value [Object] everything you want to store in Memory
      # @raise [NoDataError] if the namespace missing

      def store(ns, key, value)
        check_ns(ns)
        @data[ns][key] = value
      end

      # Gets data from memory. Can get all namespace or single data value in namespace using key
      #
      # @param ns [String] a namespace
      # @param key [String] key that isn't necessary required
      # @return [Object, Hash] all data from the namespace if the key is ommited, otherwise returs
      #   all data for the namespace
      # @raise [NoDataError] if the namespace missing

      def extract(ns, key = nil)
        check_ns(ns)
        key ? @data[ns][key] : @data[ns]
      end

      # Deletes all data from a namespace
      #
      # @param ns [String] a namespace

      def clear_ns(ns)
        init_ns(ns)
      end

      # Deletes all namespaces with data
      #
      # @param exception_list [Array] a namespace list for excluding

      def clear_all_ns(exception_list = SPECIAL_NS_LIST)
        (@data.keys - exception_list).each { |ns| clear_ns(ns) }
      end

      private

      def check_ns(ns)
        raise Howitzer::NoDataError, 'Data storage namespace can not be empty' unless ns
        init_ns(ns) if ns_absent?(ns)
      end

      def ns_absent?(ns)
        !@data.key?(ns)
      end

      def init_ns(ns)
        @data[ns] = {}
      end
    end
  end
end

Version data entries

5 entries across 5 versions & 1 rubygems

Version	Path
howitzer-2.1.1	lib/howitzer/cache.rb
howitzer-2.1.0	lib/howitzer/cache.rb
howitzer-2.0.3	lib/howitzer/cache.rb
howitzer-2.0.2	lib/howitzer/cache.rb
howitzer-2.0.1	lib/howitzer/cache.rb