Sha256: a338d90fa4be88ec817ff85fb6a1bc95590ebb736794ad17a917bfa7ec5cc821

Contents?: true

Size: 1.71 KB

Versions: 42

Compression:

Stored size: 1.71 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::Char} objects. Using
  # {Vedeu::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::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::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::Char>>|NilClass]
    def retrieve
      Vedeu.log(type: :drb, message: 'Retrieving output')

      storage.pop
    end

    # Store a new virtual buffer.
    #
    # @return [Array<Array<Vedeu::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

42 entries across 42 versions & 1 rubygems

Version Path
vedeu-0.4.50 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.49 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.48 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.47 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.46 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.45 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.44 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.43 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.42 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.41 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.40 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.39 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.38 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.37 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.36 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.35 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.34 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.33 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.32 lib/vedeu/output/virtual_buffer.rb
vedeu-0.4.31 lib/vedeu/output/virtual_buffer.rb