Contents

module WebConsole
  # A session lets you persist wrap an +Evaluator+ instance in memory
  # associated with multiple bindings.
  #
  # Each newly created session is persisted into memory and you can find it
  # later its +id+.
  #
  # A session may be associated with multiple bindings. This is used by the
  # error pages only, as currently, this is the only client that needs to do
  # that.
  class Session
    INMEMORY_STORAGE = {}

    class << self
      # Finds a persisted session in memory by its id.
      #
      # Returns a persisted session if found in memory.
      # Raises NotFound error unless found in memory.
      def find(id)
        INMEMORY_STORAGE[id]
      end

      # Create a Session from an exception.
      def from_exception(exc)
        new(exc.bindings)
      end

      # Create a Session from a single binding.
      def from_binding(binding)
        new(binding)
      end
    end

    # An unique identifier for every REPL.
    attr_reader :id

    def initialize(bindings)
      @id = SecureRandom.hex(16)
      @bindings = Array(bindings)
      @evaluator = Evaluator.new(@bindings[0])

      store_into_memory
    end

    # Evaluate +input+ on the current Evaluator associated binding.
    #
    # Returns a string of the Evaluator output.
    def eval(input)
      @evaluator.eval(input)
    end

    # Switches the current binding to the one at specified +index+.
    #
    # Returns nothing.
    def switch_binding_to(index)
      @evaluator = Evaluator.new(@bindings[index.to_i])
    end

    private

      def store_into_memory
        INMEMORY_STORAGE[id] = self
      end
  end
end

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
web-console-2.1.3	lib/web_console/session.rb
web-console-2.1.2	lib/web_console/session.rb
web-console-2.1.1	lib/web_console/session.rb
web-console-2.1.0	lib/web_console/session.rb