vedeu 0.6.13 → 0.6.14

data/lib/vedeu/models/views/view.rb

@@ -2,6 +2,13 @@ module Vedeu
 
   module Views
 
+    # A collection of {Vedeu::Views::View} instances.
+    #
+    # @api private
+    class ViewCollection < Vedeu::Repositories::Collection
+
+    end # ViewCollection
+
     # Represents a container for {Vedeu::Views::Line} and {Vedeu::Views::Stream}
     # objects.
     #

data/lib/vedeu/null/all.rb

@@ -1,12 +1,15 @@
 module Vedeu
 
+  # A group of objects that serve to intercept messages destined for
+  # their real counterpart. In most cases the call is muted or returns
+  # a generic value that does not halt processing.
+  #
   module Null
 
   end # Null
 
 end # Vedeu
 
-require 'vedeu/null/null'
 require 'vedeu/null/generic'
 require 'vedeu/null/interface'
 require 'vedeu/null/view'

data/lib/vedeu/null/interface.rb

@@ -1,5 +1,3 @@
-require 'vedeu/output/presentation/presentation'
-
 module Vedeu
 
   module Null

data/lib/vedeu/null/view.rb

@@ -1,5 +1,3 @@
-require 'vedeu/output/presentation/presentation'
-
 module Vedeu
 
   module Null

data/lib/vedeu/output/output.rb

@@ -25,10 +25,16 @@ module Vedeu
         @output = output
       end
 
-      # Send the view to the renderers.
+      # Send the view to the renderers. If the output is a
+      # {Vedeu::Models::Escape} object (typical when showing or
+      # hiding the cursor) then we bypass the
+      # {Vedeu::Terminal::Buffer} and write directly to the terminal
+      # because escape sequences only make sense to the terminal and
+      # not other renderers.
       #
-      # @return [Array]
+      # @return [Array|NilClass]
       def render
+        return nil if output.nil?
         return render_terminal_buffer unless output.is_a?(Vedeu::Models::Escape)
 
         Vedeu::Output::Direct.write(value: output.value,

data/lib/vedeu/output/renderers/all.rb

@@ -1,7 +1,102 @@
 module Vedeu
 
+  # Provides a single interface to all registered renderers.
+  #
   module Renderers
 
+    extend Enumerable
+    extend self
+
+    # Instructs each renderer registered with Vedeu to clear their
+    # content.
+    #
+    # @example
+    #   Vedeu.renderers.clear
+    #
+    # @return [Array<void>]
+    def clear
+      threads = storage.map do |renderer|
+        Thread.new(renderer) do
+          mutex.synchronize do
+            renderer.clear
+          end
+        end
+      end
+      threads.each(&:join)
+
+      ''
+    end
+
+    # Provides access to the list of renderers.
+    #
+    # @example
+    #   Vedeu.renderers
+    #
+    # @return [Module]
+    def renderers
+      self
+    end
+
+    # Instructs each renderer registered with Vedeu to render the
+    # output as content.
+    #
+    # @example
+    #   Vedeu.renderers.render(output)
+    #
+    # @param output [void]
+    # @return [Array<void>]
+    def render(output)
+      threads = storage.map do |renderer|
+        Thread.new(renderer) do
+          mutex.synchronize do
+            Vedeu.log(type:    :output,
+                      message: "Renderer: '#{renderer.class.name}'")
+
+            renderer.render(output)
+          end
+        end
+      end
+      threads.each(&:join)
+
+      output
+    end
+
+    # Adds the given renderer class(es) to the list of renderers.
+    #
+    # @example
+    #   Vedeu.renderer SomeRenderer
+    #
+    # @note
+    #   A renderer class must respond to the '.render' class method.
+    #
+    # @param renderers [Class]
+    # @return [Set]
+    def renderer(*renderers)
+      renderers.each { |renderer| storage.add(renderer) unless renderer.nil? }
+
+      storage
+    end
+
+    # @example
+    #   Vedeu.renderers.reset
+    #
+    # @return [Set]
+    def reset
+      @storage = Set.new
+    end
+
+    private
+
+    # @return [Set]
+    def storage
+      @storage ||= reset
+    end
+
+    # @return [Mutex]
+    def mutex
+      @mutex ||= Mutex.new
+    end
+
   end # Renderers
 
 end # Vedeu
@@ -14,4 +109,3 @@ require 'vedeu/output/renderers/json'
 require 'vedeu/output/renderers/null'
 require 'vedeu/output/renderers/terminal'
 require 'vedeu/output/renderers/text'
-require 'vedeu/output/renderers'

data/lib/vedeu/runtime/all.rb

@@ -1,5 +1,7 @@
 module Vedeu
 
+  # Provides the classes which control the basic Vedeu runtime.
+  #
   module Runtime
 
   end # Runtime

data/lib/vedeu/runtime/launcher.rb

@@ -112,17 +112,9 @@ module Vedeu
     end
     # :nocov:
 
-    # Use the arguments passed on the command-line along with those
-    # defined by the client application and Vedeu's defaults to
-    # configure the client application.
-    #
     # @return [Vedeu::Configuration]
     def configuration
-      Vedeu::Configuration.configure(argv)
-
-      # Configuration.configure(argv, { stdin:  @stdin,
-      #                                 stdout: @stdout,
-      #                                 stderr: @stderr })
+      Vedeu::Configuration
     end
 
   end # Launcher

data/lib/vedeu/version.rb

@@ -1,6 +1,6 @@
 module Vedeu
 
   # The current version of Vedeu.
-  VERSION = '0.6.13'
+  VERSION = '0.6.14'
 
 end

data/test/lib/vedeu/editor/{documents_test.rb → repository_test.rb}

@@ -4,13 +4,13 @@ module Vedeu
 
   module Editor
 
-    describe Documents do
+    describe Repository do
 
-      let(:described) { Vedeu::Editor::Documents }
+      let(:described) { Vedeu::Editor::Repository }
 
       it { described.must_respond_to(:documents) }
 
-    end # Documents
+    end # Repository
 
   end # Editor
 

data/test/lib/vedeu/models/views/char_test.rb

@@ -4,6 +4,19 @@ module Vedeu
 
   module Views
 
+    describe Chars do
+
+      let(:described) { Vedeu::Views::Chars }
+      let(:instance)  { described.new }
+
+      it { described.superclass.must_equal(Vedeu::Repositories::Collection) }
+
+      describe '#initialize' do
+        it { instance.must_be_instance_of(described) }
+      end
+
+    end # Chars
+
     describe Char do
 
       let(:described)     { Vedeu::Views::Char }

data/test/lib/vedeu/models/views/line_test.rb

@@ -4,6 +4,19 @@ module Vedeu
 
   module Views
 
+    describe Lines do
+
+      let(:described) { Vedeu::Views::Lines }
+      let(:instance)  { described.new }
+
+      it { described.superclass.must_equal(Vedeu::Repositories::Collection) }
+
+      describe '#initialize' do
+        it { instance.must_be_instance_of(described) }
+      end
+
+    end # Lines
+
     describe Line do
 
       let(:described)  { Vedeu::Views::Line }
@@ -109,10 +122,10 @@ module Vedeu
         end
       end
 
-      describe '#streams' do
-        subject { instance.streams }
+      describe '#value' do
+        subject { instance.value }
 
-        it { instance.must_respond_to(:value) }
+        it { instance.must_respond_to(:streams) }
 
         it { subject.must_be_instance_of(Vedeu::Views::Streams) }
       end

data/test/lib/vedeu/models/views/stream_test.rb

@@ -4,6 +4,19 @@ module Vedeu
 
   module Views
 
+    describe Streams do
+
+      let(:described) { Vedeu::Views::Streams }
+      let(:instance)  { described.new }
+
+      it { described.superclass.must_equal(Vedeu::Repositories::Collection) }
+
+      describe '#initialize' do
+        it { instance.must_be_instance_of(described) }
+      end
+
+    end # Streams
+
     describe Stream do
 
       let(:described)  { Vedeu::Views::Stream }

data/test/lib/vedeu/models/views/view_test.rb

@@ -4,6 +4,19 @@ module Vedeu
 
   module Views
 
+    describe ViewCollection do
+
+      let(:described) { Vedeu::Views::ViewCollection }
+      let(:instance)  { described.new }
+
+      it { described.superclass.must_equal(Vedeu::Repositories::Collection) }
+
+      describe '#initialize' do
+        it { instance.must_be_instance_of(described) }
+      end
+
+    end # ViewCollection
+
     describe View do
 
       let(:described)  { Vedeu::Views::View }

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

@@ -17,24 +17,38 @@ module Vedeu
       end
 
       describe '.render' do
-        # let(:buffer) { mock }
-
-        # before do
-        #   Vedeu::Terminal::Buffer.stubs(:write).returns(buffer)
-        #   buffer.stubs(:render)
-        # end
-
-        # subject { described.render(output) }
-
-        # it {
-        #   Vedeu::Terminal::Buffer.expects(:write).with(output)
-        #   subject
-        # }
-
-        # it {
-        #   buffer.expects(:render)
-        #   subject
-        # }
+        subject { described.render(output) }
+
+        context 'when the output is empty' do
+          it { subject.must_be_instance_of(NilClass) }
+        end
+
+        context 'when the output is not empty' do
+          context 'and the output is an escape sequence' do
+            let(:output) {
+              Vedeu::Models::Escape.new(value: "\e[?25h", position: [1, 1])
+            }
+
+            before { Vedeu::Output::Direct.stubs(:write).returns(output.to_s) }
+
+            it { subject.must_equal("\e[1;1H\e[?25h") }
+          end
+
+          context 'and the output is not an escape sequence' do
+            let(:output) { Vedeu::Models::Page.new }
+            let(:buffer) { mock('Vedeu::Terminal::Buffer') }
+
+            before do
+              Vedeu::Terminal::Buffer.stubs(:write)
+              buffer.expects(:render).returns(output)
+            end
+
+            it {
+              Vedeu::Terminal::Buffer.expects(:write).with(output).returns(buffer)
+              subject
+            }
+          end
+        end
       end
 
       describe '#render' do

data/test/lib/vedeu/output/renderers/file_test.rb

@@ -18,6 +18,8 @@ module Vedeu
       let(:filename)  { 'vedeu_renderers_file' }
       let(:timestamp) { false }
 
+      before { ::File.stubs(:write) }
+
       describe '#initialize' do
         it { instance.must_be_instance_of(described) }
         it { instance.instance_variable_get('@options').must_equal(options) }
@@ -33,8 +35,6 @@ module Vedeu
       describe '#render' do
         let(:_time) { Time.new(2015, 4, 12, 20, 05, 00, "+01:00") }
 
-        before { ::File.stubs(:write) }
-
         subject { instance.render(output) }
 
         # it { subject.must_be_instance_of(String) }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vedeu
 version: !ruby/object:Gem::Version
-  version: 0.6.13
+  version: 0.6.14
 platform: ruby
 authors:
 - Gavin Laking
@@ -308,7 +308,6 @@ files:
 - lib/vedeu/colours/translator.rb
 - lib/vedeu/common.rb
 - lib/vedeu/configuration/api.rb
-- lib/vedeu/configuration/cli.rb
 - lib/vedeu/configuration/configuration.rb
 - lib/vedeu/cursors/all.rb
 - lib/vedeu/cursors/cursor.rb
@@ -347,11 +346,11 @@ files:
 - lib/vedeu/editor/cropper.rb
 - lib/vedeu/editor/cursor.rb
 - lib/vedeu/editor/document.rb
-- lib/vedeu/editor/documents.rb
 - lib/vedeu/editor/editor.rb
 - lib/vedeu/editor/insert.rb
 - lib/vedeu/editor/line.rb
 - lib/vedeu/editor/lines.rb
+- lib/vedeu/editor/repository.rb
 - lib/vedeu/error.rb
 - lib/vedeu/esc/actions.rb
 - lib/vedeu/esc/all.rb
@@ -407,10 +406,6 @@ files:
 - lib/vedeu/models/toggleable.rb
 - lib/vedeu/models/views/all.rb
 - lib/vedeu/models/views/char.rb
-- lib/vedeu/models/views/collections/chars.rb
-- lib/vedeu/models/views/collections/lines.rb
-- lib/vedeu/models/views/collections/streams.rb
-- lib/vedeu/models/views/collections/view_collection.rb
 - lib/vedeu/models/views/composition.rb
 - lib/vedeu/models/views/html_char.rb
 - lib/vedeu/models/views/line.rb
@@ -419,7 +414,6 @@ files:
 - lib/vedeu/null/all.rb
 - lib/vedeu/null/generic.rb
 - lib/vedeu/null/interface.rb
-- lib/vedeu/null/null.rb
 - lib/vedeu/null/view.rb
 - lib/vedeu/options.rb
 - lib/vedeu/output/clear/named_group.rb
@@ -433,7 +427,6 @@ files:
 - lib/vedeu/output/presentation/styles.rb
 - lib/vedeu/output/refresh/refresh.rb
 - lib/vedeu/output/refresh/refresh_group.rb
-- lib/vedeu/output/renderers.rb
 - lib/vedeu/output/renderers/all.rb
 - lib/vedeu/output/renderers/escape_sequence.rb
 - lib/vedeu/output/renderers/file.rb
@@ -512,7 +505,6 @@ files:
 - test/lib/vedeu/colours/translator_test.rb
 - test/lib/vedeu/common_test.rb
 - test/lib/vedeu/configuration/api_test.rb
-- test/lib/vedeu/configuration/cli_test.rb
 - test/lib/vedeu/configuration/configuration_test.rb
 - test/lib/vedeu/cursors/cursor_test.rb
 - test/lib/vedeu/cursors/refresh_test.rb
@@ -538,11 +530,11 @@ files:
 - test/lib/vedeu/editor/cropper_test.rb
 - test/lib/vedeu/editor/cursor_test.rb
 - test/lib/vedeu/editor/document_test.rb
-- test/lib/vedeu/editor/documents_test.rb
 - test/lib/vedeu/editor/editor_test.rb
 - test/lib/vedeu/editor/insert_test.rb
 - test/lib/vedeu/editor/line_test.rb
 - test/lib/vedeu/editor/lines_test.rb
+- test/lib/vedeu/editor/repository_test.rb
 - test/lib/vedeu/error_test.rb
 - test/lib/vedeu/esc/actions_test.rb
 - test/lib/vedeu/esc/borders_test.rb
@@ -590,10 +582,6 @@ files:
 - test/lib/vedeu/models/row_test.rb
 - test/lib/vedeu/models/toggleable_test.rb
 - test/lib/vedeu/models/views/char_test.rb
-- test/lib/vedeu/models/views/collections/chars_test.rb
-- test/lib/vedeu/models/views/collections/lines_test.rb
-- test/lib/vedeu/models/views/collections/streams_test.rb
-- test/lib/vedeu/models/views/collections/view_collection_test.rb
 - test/lib/vedeu/models/views/composition_test.rb
 - test/lib/vedeu/models/views/html_char_test.rb
 - test/lib/vedeu/models/views/line_test.rb
@@ -601,7 +589,6 @@ files:
 - test/lib/vedeu/models/views/view_test.rb
 - test/lib/vedeu/null/generic_test.rb
 - test/lib/vedeu/null/interface_test.rb
-- test/lib/vedeu/null/null_test.rb
 - test/lib/vedeu/null/view_test.rb
 - test/lib/vedeu/options_test.rb
 - test/lib/vedeu/output/clear/named_group_test.rb
@@ -615,6 +602,7 @@ files:
 - test/lib/vedeu/output/presentation/styles_test.rb
 - test/lib/vedeu/output/refresh/refresh_group_test.rb
 - test/lib/vedeu/output/refresh/refresh_test.rb
+- test/lib/vedeu/output/renderers/all_test.rb
 - test/lib/vedeu/output/renderers/escape_sequence_test.rb
 - test/lib/vedeu/output/renderers/file_test.rb
 - test/lib/vedeu/output/renderers/html_test.rb
@@ -623,7 +611,6 @@ files:
 - test/lib/vedeu/output/renderers/renderer_options_test.rb
 - test/lib/vedeu/output/renderers/terminal_test.rb
 - test/lib/vedeu/output/renderers/text_test.rb
-- test/lib/vedeu/output/renderers_test.rb
 - test/lib/vedeu/output/text_test.rb
 - test/lib/vedeu/output/viewport_test.rb
 - test/lib/vedeu/output/wordwrap_test.rb
@@ -656,7 +643,6 @@ files:
 - test/support/colour_support.sh
 - test/support/coverage.rb
 - test/support/examples/borders_app.rb
-- test/support/examples/configuration_app.rb
 - test/support/examples/drb_app.rb
 - test/support/examples/editor_app.rb
 - test/support/examples/focus_app.rb
@@ -737,7 +723,6 @@ test_files:
 - test/lib/vedeu/colours/translator_test.rb
 - test/lib/vedeu/common_test.rb
 - test/lib/vedeu/configuration/api_test.rb
-- test/lib/vedeu/configuration/cli_test.rb
 - test/lib/vedeu/configuration/configuration_test.rb
 - test/lib/vedeu/cursors/cursor_test.rb
 - test/lib/vedeu/cursors/refresh_test.rb
@@ -763,11 +748,11 @@ test_files:
 - test/lib/vedeu/editor/cropper_test.rb
 - test/lib/vedeu/editor/cursor_test.rb
 - test/lib/vedeu/editor/document_test.rb
-- test/lib/vedeu/editor/documents_test.rb
 - test/lib/vedeu/editor/editor_test.rb
 - test/lib/vedeu/editor/insert_test.rb
 - test/lib/vedeu/editor/line_test.rb
 - test/lib/vedeu/editor/lines_test.rb
+- test/lib/vedeu/editor/repository_test.rb
 - test/lib/vedeu/error_test.rb
 - test/lib/vedeu/esc/actions_test.rb
 - test/lib/vedeu/esc/borders_test.rb
@@ -815,10 +800,6 @@ test_files:
 - test/lib/vedeu/models/row_test.rb
 - test/lib/vedeu/models/toggleable_test.rb
 - test/lib/vedeu/models/views/char_test.rb
-- test/lib/vedeu/models/views/collections/chars_test.rb
-- test/lib/vedeu/models/views/collections/lines_test.rb
-- test/lib/vedeu/models/views/collections/streams_test.rb
-- test/lib/vedeu/models/views/collections/view_collection_test.rb
 - test/lib/vedeu/models/views/composition_test.rb
 - test/lib/vedeu/models/views/html_char_test.rb
 - test/lib/vedeu/models/views/line_test.rb
@@ -826,7 +807,6 @@ test_files:
 - test/lib/vedeu/models/views/view_test.rb
 - test/lib/vedeu/null/generic_test.rb
 - test/lib/vedeu/null/interface_test.rb
-- test/lib/vedeu/null/null_test.rb
 - test/lib/vedeu/null/view_test.rb
 - test/lib/vedeu/options_test.rb
 - test/lib/vedeu/output/clear/named_group_test.rb
@@ -840,6 +820,7 @@ test_files:
 - test/lib/vedeu/output/presentation/styles_test.rb
 - test/lib/vedeu/output/refresh/refresh_group_test.rb
 - test/lib/vedeu/output/refresh/refresh_test.rb
+- test/lib/vedeu/output/renderers/all_test.rb
 - test/lib/vedeu/output/renderers/escape_sequence_test.rb
 - test/lib/vedeu/output/renderers/file_test.rb
 - test/lib/vedeu/output/renderers/html_test.rb
@@ -848,7 +829,6 @@ test_files:
 - test/lib/vedeu/output/renderers/renderer_options_test.rb
 - test/lib/vedeu/output/renderers/terminal_test.rb
 - test/lib/vedeu/output/renderers/text_test.rb
-- test/lib/vedeu/output/renderers_test.rb
 - test/lib/vedeu/output/text_test.rb
 - test/lib/vedeu/output/viewport_test.rb
 - test/lib/vedeu/output/wordwrap_test.rb
@@ -881,7 +861,6 @@ test_files:
 - test/support/colour_support.sh
 - test/support/coverage.rb
 - test/support/examples/borders_app.rb
-- test/support/examples/configuration_app.rb
 - test/support/examples/drb_app.rb
 - test/support/examples/editor_app.rb
 - test/support/examples/focus_app.rb