Sha256: 00d01ef036b7eba30ef0c6b314b329d229d72b48d365a1c731a8967c02e66d98

Contents?: true

Size: 1.75 KB

Versions: 6

Compression:

Stored size: 1.75 KB

Contents

module Vedeu

  # Store and retrieve {Vedeu::VirtualTerminal} objects.
  #
  # Each {Vedeu::VirtualTerminal} object is a copy of the current terminal
  # including content but not as String objects but {Vedeu::Views::Char}
  # objects. Using {Vedeu::Views::Char} objects means that we can store the data
  # used to make up the displayed character, complete with its colour, position
  # and style.
  #
  # Once a {Vedeu::Views::Char} has been converted to a String, it is tricky to
  # separate the escape sequences and string data. By deferring this conversion
  # we can display the {Vedeu::Views::Char} in multiple ways (e.g. HTML) or in
  # multiple formats (e.g. JSON), and render/use that in an appropriate way.
  #
  module VirtualBuffer

    extend self

    # Fetch the oldest stored virtual buffer first.
    #
    # @return [Array<Array<Vedeu::Views::Char>>|NilClass]
    def retrieve
      Vedeu.log(type: :drb, message: 'Retrieving output')

      storage.pop
    end

    # Store a new virtual buffer.
    #
    # @return [Array<Array<Vedeu::Views::Char>>]
    def store(data)
      Vedeu.log(type: :drb, message: 'Storing output')

      storage.unshift(data)
    end

    # Return the number of virtual buffers currently stored.
    #
    # @return [Fixnum]
    def size
      storage.size
    end

    # Destroy all virtual buffers currently stored.
    #
    # @return [Array]
    def clear
      @storage = in_memory
    end
    alias_method :reset, :clear

    private

    # Access to the storage for this repository.
    #
    # @return [Array]
    def storage
      @storage ||= in_memory
    end

    # Returns an empty collection ready for the storing of virtual buffers.
    #
    # @return [Array]
    def in_memory
      []
    end

  end # VirtualBuffer

end # Vedeu

Version data entries

6 entries across 6 versions & 1 rubygems

Version Path
vedeu-0.5.10 lib/vedeu/output/virtual_buffer.rb
vedeu-0.5.9 lib/vedeu/output/virtual_buffer.rb
vedeu-0.5.8 lib/vedeu/output/virtual_buffer.rb
vedeu-0.5.7 lib/vedeu/output/virtual_buffer.rb
vedeu-0.5.6 lib/vedeu/output/virtual_buffer.rb
vedeu-0.5.5 lib/vedeu/output/virtual_buffer.rb