vedeu 0.2.10 → 0.2.11

data/lib/vedeu/output/clear.rb

@@ -1,88 +0,0 @@
-module Vedeu
-
-  # Clears all the character data for the area defined by an interface. This
-  # class is called every time an interface is rendered to prepare the area
-  # for new data.
-  #
-  # @note We don't simply clear the entire terminal as this would remove the
-  #   content of other interfaces which are being displayed.
-  #
-  # @todo What if an interface 'moves' or changes shape due to the terminal
-  #   resizing?
-  #
-  # @api private
-  class Clear
-
-    # Blanks the area defined by the interface.
-    #
-    # @param interface [Interface]
-    # @param options [Hash]
-    # @return [String]
-    # @see #initialize
-    def self.call(interface, options = {})
-      new(interface, options).clear
-    end
-
-    # Returns a new instance of Clear.
-    #
-    # @param interface [Interface]
-    # @param options [Hash]
-    # @option options :direct [Boolean] Send escape sequences to clear an area
-    #   directly to the Terminal.
-    # @return [Clear]
-    def initialize(interface, options = {})
-      @interface = interface
-      @options   = defaults.merge!(options)
-    end
-
-    # Send the cleared area to the terminal.
-    #
-    # @return [Array]
-    def clear
-      return Terminal.output(view) if direct?
-
-      view
-    end
-
-    private
-
-    attr_reader :interface, :options
-
-    # For each visible line of the interface, set the foreground and background
-    # colours to those specified when the interface was defined, then starting
-    # write space characters over the area which the interface occupies.
-    #
-    # @return [String]
-    def view
-      Vedeu.log("Clearing view: '#{interface.name}'")
-
-      rows.inject([colours]) do |line, index|
-        line << interface.origin(index) { ' ' * interface.width }
-      end.join
-    end
-
-    # @return [String]
-    def colours
-      interface.colour.to_s
-    end
-
-    # @return [Enumerator]
-    def rows
-      interface.height.times
-    end
-
-    # @return [Boolean]
-    def direct?
-      options[:direct]
-    end
-
-    # @return [Hash]
-    def defaults
-      {
-        direct: true
-      }
-    end
-
-  end # Clear
-
-end # Vedeu

data/lib/vedeu/output/render.rb

@@ -1,50 +0,0 @@
-module Vedeu
-
-  # Attempts to convert the provided interface object with associated lines,
-  # streams, colours, styles, etc, into a single string containing all content
-  # and escape sequences.
-  #
-  # @api private
-  class Render
-
-    # Create a new instance of Render with the provided {Vedeu::Interface} and
-    # then convert the interface into a single string of content and escape
-    # sequences.
-    #
-    # @param interface [Interface]
-    # @return [String]
-    def self.call(interface)
-      new(interface).render
-    end
-
-    # Return a new instance of Render.
-    #
-    # @param interface [Interface]
-    # @return [Render]
-    def initialize(interface)
-      @interface = interface
-    end
-
-    # Produces a single string which contains all content and escape sequences
-    # required to render this interface to a position in the terminal window.
-    #
-    # @return [String]
-    def render
-      out = [ Clear.call(interface, { direct: false }) ]
-
-      Vedeu.log("Rendering view: '#{interface.name}'")
-
-      interface.viewport.each_with_index do |line, index|
-        out << interface.origin(index)
-        out << line.join
-      end
-      out.join
-    end
-
-    private
-
-    attr_reader :interface
-
-  end # Render
-
-end # Vedeu

data/lib/vedeu/repositories/positional.rb

@@ -1,23 +0,0 @@
-module Vedeu
-
-  # Repository helper module which reduces duplication in Offsets and Cursors.
-  #
-  module Positional
-
-    # Add or update the offset or cursor coordinates.
-    #
-    # @param attributes [Hash]
-    # @return [Offset]
-    def add(attributes)
-      validate_attributes!(attributes)
-
-      Vedeu.log("#{action(__callee__)} positional (#{entity}): " \
-                "'#{attributes[:name]}'")
-
-      storage.store(attributes[:name], entity.new(attributes))
-    end
-    alias_method :update, :add
-
-  end # Positional
-
-end # Vedeu

data/test/lib/vedeu/output/clear_test.rb

@@ -1,56 +0,0 @@
-require 'test_helper'
-
-module Vedeu
-
-  describe Clear do
-
-    before do
-      Interfaces.reset
-      Terminal.console.stubs(:print)
-    end
-
-    describe '#initialize' do
-      it 'returns an instance of itself' do
-        interface = mock('Interface')
-        Clear.new(interface).must_be_instance_of(Clear)
-      end
-    end
-
-    describe '.call' do
-      it 'returns the escape sequence to clear the whole interface' do
-        interface = Interface.new({
-          name:   'Clear.call',
-          geometry: {
-            width:  5,
-            height: 2
-          }
-        })
-        Clear.call(interface).must_equal([
-          "\e[1;1H     \e[1;1H" \
-          "\e[2;1H     \e[2;1H"
-        ])
-      end
-
-      it 'returns the escape sequence to clear the whole interface with specified colours' do
-        interface = Interface.new({
-          name:   'Clear.call',
-          geometry: {
-            width:  5,
-            height: 2,
-          },
-          colour: {
-            foreground: '#00ff00',
-            background: '#ffff00'
-          }
-        })
-        Clear.call(interface).must_equal([
-          "\e[38;2;0;255;0m\e[48;2;255;255;0m" \
-          "\e[1;1H     \e[1;1H" \
-          "\e[2;1H     \e[2;1H"
-        ])
-      end
-    end
-
-  end # Clear
-
-end # Vedeu

data/test/lib/vedeu/output/render_test.rb

@@ -1,100 +0,0 @@
-require 'test_helper'
-
-module Vedeu
-
-  describe Render do
-
-    before do
-      Terminal.console.stubs(:print)
-
-      Buffers.reset
-      Cursors.reset
-      Interfaces.reset
-
-      Vedeu.interface('fluorine') do
-        width  32
-        height 3
-        line 'this is the first'
-        line 'this is the second and it is long'
-        line 'this is the third, it is even longer and still truncated'
-        line 'this should not render'
-      end
-    end
-
-    describe '#initialize' do
-      it 'returns an instance of itself' do
-        interface = Interface.new
-        Render.new(interface).must_be_instance_of(Render)
-      end
-    end
-
-    describe '.call' do
-      let(:interface) { Vedeu.use('fluorine') }
-
-      before { interface.stubs(:in_focus?).returns(true) }
-
-      it 'returns the content for the interface' do
-        Render.call(interface).must_equal(
-          "\e[1;1H                                \e[1;1H" \
-          "\e[2;1H                                \e[2;1H" \
-          "\e[3;1H                                \e[3;1H" \
-          "\e[1;1Hthis is the first" \
-          "\e[2;1Hthis is the second and it is lon" \
-          "\e[3;1Hthis is the third, it is even lo"
-        )
-      end
-
-      it 'returns a blank interface if there are no streams of text' do
-        interface = Interface.new({
-          name:     'fluorine',
-          geometry: {
-            width:  32,
-            height: 3,
-          },
-          lines:    []
-        })
-
-        Render.call(interface).must_equal(
-          "\e[1;1H                                \e[1;1H" \
-          "\e[2;1H                                \e[2;1H" \
-          "\e[3;1H                                \e[3;1H"
-        )
-      end
-
-      it 'skips lines which have streams with no content' do
-        interface = Interface.new({
-          name:     'fluorine',
-          geometry: {
-            width:  32,
-            height: 3,
-          },
-          lines:    [
-            {
-              streams: [{ text: 'this is the first' }]
-            }, {
-              streams: { text: '' }
-            }, {
-              streams: [
-                { text: 'this is the third, ' },
-                { text: 'it is even longer '  },
-                { text: 'and still truncated' }
-              ]
-            }, {
-              streams: [{ text: 'this should not render' }]
-            }
-          ]
-        })
-        Render.call(interface).must_equal(
-          "\e[1;1H                                \e[1;1H" \
-          "\e[2;1H                                \e[2;1H" \
-          "\e[3;1H                                \e[3;1H" \
-          "\e[1;1Hthis is the first" \
-          "\e[2;1H" \
-          "\e[3;1Hthis is the third, it is even lo"
-        )
-      end
-    end
-
-  end # Render
-
-end # Vedeu

data/test/lib/vedeu/repositories/positional_test.rb

@@ -1,50 +0,0 @@
-require 'test_helper'
-
-module Vedeu
-
-  describe Positional do
-
-    before do
-      Offsets.reset
-      Cursors.reset
-      Registrar.record({ name: 'chromium' })
-    end
-
-    describe '#add' do
-      it 'raises an exception if a :name attribute is not provided' do
-        proc { Offsets.add({ no_name: 'no_name' }) }
-          .must_raise(MissingRequired)
-      end
-
-      it 'returns a new instance of Offset once stored' do
-        Offsets.add({ name: 'praseodymium' }).must_be_instance_of(Offset)
-      end
-    end
-
-    describe '#add' do
-      let(:attributes) { { name: 'chromium' } }
-
-      it 'returns a new Cursor after registering' do
-        Cursors.add(attributes).must_be_instance_of(Cursor)
-      end
-
-      it 'returns a new Cursor after updating' do
-        Cursors.update(attributes).must_be_instance_of(Cursor)
-      end
-
-      context 'when the attributes do not have the :name key' do
-        let(:attributes) { { no_name_key: 'some_value' } }
-
-        it 'raises an exception' do
-          proc { Cursors.update(attributes) }.must_raise(MissingRequired)
-        end
-
-        it 'raises an exception' do
-          proc { Cursors.add(attributes) }.must_raise(MissingRequired)
-        end
-      end
-    end
-
-  end # Positional
-
-end # Vedeu