vedeu 0.8.23 → 0.8.24

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 23c1d81d7fc643062c5bfe739de370ff0e5dc948
-  data.tar.gz: 4083354c5c95d5828d7108d1f1870ddbf934f38c
+  metadata.gz: bba38d1b7b8c6befc6f778050e727f1afa5ec5aa
+  data.tar.gz: 2f92824ce2e8faafd9cad5ccd7b69dcb528d2b42
 SHA512:
-  metadata.gz: 31993a416e19b815f8d471d0a23364918c07d070ae9823c17316393b1523f6a2a4780eff35ea05bef6c6ab1a82d61f7b2eabadcba074407874102a0dd574f416
-  data.tar.gz: b9b5bed7178bac6915911f7d4c0b19081a1c5c8094622d4d1e25e10dcbeab4c28b129188bed49487e03c20c1b1b108125d3bd2ca415a9e6533774366e94fd858
+  metadata.gz: 8f685282146b350cbdff354b6990054d022812c9cf9dba3b068efc8ed28313d318a3ea23418fb2ed943f593658017f7a6588e3e46fb564b06d2b57f10235defe
+  data.tar.gz: 0253772378f8d3de47153617970963329548b5ed5021326454d4ba21e078fb51a5df3e3f0380a0760b3c12af780cbfd7ff24af04a7afcb1729b68e6d21cad4af

data/integrations/dsl_app_017.rb

@@ -31,6 +31,11 @@ class DSLApp
 
   Vedeu.render do
     view(:test_interface) do
+      foreground '#ffffff'
+      line do
+        left  'v->l->left',   { background: '#aa00ff' }
+        right 'v->l->right',  { background: '#5a5a5a' }
+      end
     end
   end
 

data/integrations/expected/dsl_app_017.out

@@ -0,0 +1 @@
+(0l(B(0q(B Test (0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0k(B(0x(Bv->l->left        v->l->right(0x(B(0x(B                             (0x(B(0x(B                             (0x(B(0m(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0q(B(0j(B

data/integrations/test_runner.rb

@@ -3,6 +3,7 @@
 # Provides the result of running an integration test.
 #
 # @api private
+#
 class TestRunner
 
   # @param (see #initialize)

data/integrations/test_runner.sh

@@ -44,3 +44,6 @@ cd "$(dirname "$0")"
 ./dsl_app_border_009.rb # only right
 ./dsl_app_border_010.rb # only bottom
 ./dsl_app_border_011.rb # only left
+
+# Failing
+# ./dsl_app_017.rb

data/lib/vedeu/borders/border.rb

@@ -16,6 +16,8 @@ module Vedeu
     #   More details can be found at:
     #   http://en.wikipedia.org/wiki/Box-drawing_character
     #
+    # @api private
+    #
     class Border
 
       extend Forwardable

data/lib/vedeu/borders/dsl.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Provides a mechanism to help configure borders in Vedeu.
     #
+    # @api public
+    #
     class DSL
 
       include Vedeu::DSL

data/lib/vedeu/borders/repository.rb

@@ -7,6 +7,8 @@ module Vedeu
     # Allows the storing of interface/view borders independent of the
     # interface instance.
     #
+    # @api private
+    #
     class Repository < Vedeu::Repositories::Repository
 
       null Vedeu::Borders::Border, enabled: false

data/lib/vedeu/buffers/buffer.rb

@@ -7,6 +7,8 @@ module Vedeu
     # Used by Vedeu internally to manage the buffers of each interface
     # defined.
     #
+    # @api private
+    #
     class Buffer
 
       include Vedeu::Common

data/lib/vedeu/buffers/empty.rb

@@ -55,8 +55,8 @@ module Vedeu
 
       # @return [Array<Array<Vedeu::Cells::Empty>>]
       def empty
-        Array.new(height) do |h|
-          Array.new(width) do |w|
+        Array.new(height) do
+          Array.new(width) do
             Vedeu::Cells::Empty.new(name: name)
           end
         end

data/lib/vedeu/buffers/refresh.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Refreshes the given named interface.
     #
+    # @api private
+    #
     class Refresh
 
       include Vedeu::Common

data/lib/vedeu/buffers/repository.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Allows the storing of view buffers.
     #
+    # @api private
+    #
     class Repository < Vedeu::Repositories::Repository
 
       null Vedeu::Buffers::Null

data/lib/vedeu/colours/colour.rb

@@ -37,6 +37,8 @@ module Vedeu
     #
     # @todo Fix colours in all terminals. (GL: 2015-04-13)
     #
+    # @api private
+    #
     class Colour
 
       class << self

data/lib/vedeu/colours/repository.rb

@@ -7,6 +7,8 @@ module Vedeu
     # Allows the storing of HTML/CSS colours and their respective
     # escape sequences.
     #
+    # @api private
+    #
     class Repository
 
       # @!attribute [r] storage

data/lib/vedeu/configuration/api.rb

@@ -8,6 +8,8 @@ module Vedeu
     # configuration into options used by Vedeu to affect certain
     # behaviours.
     #
+    # @api public
+    #
     class API
 
       include Vedeu::Common

data/lib/vedeu/configuration/configuration.rb

@@ -54,6 +54,8 @@ module Vedeu
   # overridden by client application settings (via the configuration
   # API).
   #
+  # @api private
+  #
   class Configuration
 
     include Singleton

data/lib/vedeu/cursors/repository.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Allows the storing of each interface's cursor.
     #
+    # @api private
+    #
     class Repository < Vedeu::Repositories::Repository
 
       class << self

data/lib/vedeu/distributed/client.rb

@@ -15,6 +15,9 @@ module Vedeu
     #              connect("druby://localhost:21420")
     #   client.input('a')
     #   client.output # => 'some content...'
+    #
+    # @api private
+    #
     class Client
 
       # @param (see #initialize)

data/lib/vedeu/distributed/server.rb

@@ -9,6 +9,9 @@ module Vedeu
 
     # A class for the server side of the DRb server/client
     # relationship.
+    #
+    # @api private
+    #
     class Server
 
       $SAFE = 1 # disable `eval` and related calls on strings passed

data/lib/vedeu/distributed/subprocess.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Creates a subprocess of the DRb server.
     #
+    # @api private
+    #
     class Subprocess
 
       # @param (see #initialize)

data/lib/vedeu/distributed/uri.rb

@@ -10,6 +10,8 @@ module Vedeu
     # Value class which provides the host and port for the DRb server
     # and client.
     #
+    # @api private
+    #
     class Uri
 
       # @!attribute [r] host

data/lib/vedeu/dsl/view.rb

@@ -40,6 +40,8 @@ module Vedeu
     #   be red.
     # - Styles are named. See the table below for supported styles.
     #
+    # @api public
+    #
     class View
 
       include Vedeu::Common

data/lib/vedeu/dsl/views.rb

@@ -82,6 +82,8 @@ module Vedeu
     #             |- streams/stream
     #                 |- char
     #
+    # @api public
+    #
     class Views
 
       include Vedeu::DSL

data/lib/vedeu/editor/editor.rb

@@ -7,6 +7,8 @@ module Vedeu
     # Handles keypresses for a named document whilst the terminal is
     # in fake mode.
     #
+    # @api private
+    #
     class Editor
 
       extend Forwardable

data/lib/vedeu/editor/repository.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Allows the storing of documents.
     #
+    # @api private
+    #
     class Repository < Vedeu::Repositories::Repository
 
       real Vedeu::Editor::Document

data/lib/vedeu/events/event.rb

@@ -31,6 +31,8 @@ module Vedeu
     #       :do_stuff
     #     end
     #
+    # @api private
+    #
     class Event
 
       include Vedeu::Repositories::Model
@@ -182,19 +184,6 @@ module Vedeu
         @executed_at = @now # set execution time to now
         @now         = 0    # reset now
 
-        message = if args.size > 1
-                    "Triggering: '#{name.inspect}' with #{args.inspect}"
-
-                  elsif args.one?
-                    "Triggering: '#{name.inspect}' for #{args.first.inspect}"
-
-                  else
-                    "Triggering: '#{name.inspect}'"
-
-                  end
-
-        Vedeu.log(type: :event, message: message)
-
         closure.call(*args)
       end
 

data/lib/vedeu/events/trigger.rb

@@ -67,9 +67,29 @@ module Vedeu
 
       private
 
+      # @return [String]
+      def message
+        if args.size > 1
+          "Triggering: '#{name.inspect}' with #{args.inspect}"
+
+        elsif args.one?
+          "Triggering: '#{name.inspect}' for #{args.first.inspect}"
+
+        else
+          "Triggering: '#{name.inspect}'"
+
+        end
+      end
+
+      # Trigger each registered event for this name.
+      #
       # @return [Array<void>|void]
       def results
-        @results ||= registered_events.map { |event| event.trigger(*args) }
+        @results ||= registered_events.map do |event|
+          Vedeu.log(type: :event, message: message)
+
+          event.trigger(*args)
+        end
       end
 
       # Return all of the registered events for this name.

data/lib/vedeu/geometries/dsl/dsl.rb

@@ -73,6 +73,8 @@ module Vedeu
     #     yn +--------------+           # south:  yn + 1
     #             south
     #
+    # @api public
+    #
     class DSL
 
       include Vedeu::Common

data/lib/vedeu/geometries/geometry.rb

@@ -12,6 +12,8 @@ module Vedeu
     # the client's requirements and the terminal's current viewing
     # area.
     #
+    # @api private
+    #
     class Geometry
 
       extend Forwardable

data/lib/vedeu/geometries/move.rb

@@ -62,6 +62,17 @@ module Vedeu
 
       private
 
+      # @return [Hash<Symbol => Symbol>]
+      def cursor_event
+        {
+          down:   :_cursor_down_,
+          left:   :_cursor_left_,
+          origin: :_cursor_origin_,
+          right:  :_cursor_right_,
+          up:     :_cursor_up_,
+        }[direction]
+      end
+
       # @macro defaults_method
       def defaults
         {
@@ -76,52 +87,17 @@ module Vedeu
         direction != :none
       end
 
-      # Moves the geometry in the direction given by the offset also
-      # given.
-      #
       # @return [Hash<Symbol => Hash<Symbol => Fixnum>>]
-      def movement
-        {
-          down: {
-            y: y  + offset,
-            yn: yn + offset,
-          },
-          left: {
-            x: x  - offset,
-            xn: xn - offset,
-          },
-          none: {},
-          origin: {
-            x: 1,
-            xn: (xn - x + 1),
-            y: 1,
-            yn: (yn - y + 1),
-          },
-          right: {
-            x: x  + offset,
-            xn: xn + offset,
-          },
-          up: {
-            y: y  - offset,
-            yn: yn - offset,
-          },
-        }
+      def directional_move
+        movement.fetch(direction, {})
       end
 
-      # @return [Hash<Symbol => Symbol>]
-      def cursor_event
+      # @return [Hash<Symbol => Fixnum>]
+      def down
         {
-          down:   :_cursor_down_,
-          left:   :_cursor_left_,
-          origin: :_cursor_origin_,
-          right:  :_cursor_right_,
-          up:     :_cursor_up_,
-        }[direction]
-      end
-
-      # @return [Hash<Symbol => Hash<Symbol => Fixnum>>]
-      def directional_move
-        movement.fetch(direction, {})
+          y:  y + offset,
+          yn: yn + offset,
+        }
       end
 
       # @macro geometry_by_name
@@ -129,11 +105,52 @@ module Vedeu
         @geometry ||= Vedeu.geometries.by_name(name)
       end
 
+      # @return [Hash<Symbol => Fixnum>]
+      def left
+        {
+          x:  x - offset,
+          xn: xn - offset,
+        }
+      end
+
+      # Moves the geometry in the direction given by the offset also
+      # given.
+      #
+      # @return [Hash<Symbol => Hash<Symbol => Fixnum>>]
+      def movement
+        {
+          down:   down,
+          left:   left,
+          none:   {},
+          origin: origin,
+          right:  right,
+          up:     up,
+        }
+      end
+
       # @return [Hash<Symbol => Boolean|String|Symbol>]
       def new_attributes
         geometry.attributes.merge!(unalign_unmaximise)
       end
 
+      # @return [Hash<Symbol => Fixnum>]
+      def origin
+        {
+          x:  1,
+          xn: (xn - x + 1),
+          y:  1,
+          yn: (yn - y + 1),
+        }
+      end
+
+      # @return [Hash<Symbol => Fixnum>]
+      def right
+        {
+          x:  x + offset,
+          xn: xn + offset,
+        }
+      end
+
       # @return [Hash<Symbol => Boolean|Symbol]
       def unalign_unmaximise
         {
@@ -143,6 +160,14 @@ module Vedeu
         }.merge(directional_move)
       end
 
+      # @return [Hash<Symbol => Fixnum>]
+      def up
+        {
+          y:  y - offset,
+          yn: yn - offset,
+        }
+      end
+
       # Refresh the cursor after moving.
       #
       # @return [void]

data/lib/vedeu/geometries/repository.rb

@@ -7,6 +7,8 @@ module Vedeu
     # Allows the storing of interface/view geometry independent of the
     # interface instance.
     #
+    # @api private
+    #
     class Repository < Vedeu::Repositories::Repository
 
       null Vedeu::Geometries::Geometry

data/lib/vedeu/groups/clear.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Clear the interfaces belonging to the named group.
     #
+    # @api private
+    #
     class Clear
 
       class << self

data/lib/vedeu/groups/dsl.rb

@@ -15,6 +15,8 @@ module Vedeu
     # showing or hiding the group would of course, show or hide the
     # interfaces of that group.
     #
+    # @api public
+    #
     class DSL
 
       include Vedeu::DSL

data/lib/vedeu/groups/group.rb

@@ -7,6 +7,8 @@ module Vedeu
     # Interfaces can be associated with one another by being members
     # of the same Group. A Group is a collection of interface names.
     #
+    # @api private
+    #
     class Group
 
       include Vedeu::Repositories::Model

data/lib/vedeu/groups/refresh.rb

@@ -14,6 +14,8 @@ module Vedeu
     # @example
     #   Vedeu.trigger(:_refresh_group_, group_name)
     #
+    # @api private
+    #
     class Refresh
 
       include Vedeu::Common

data/lib/vedeu/groups/repository.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Allows the storing of view groups.
     #
+    # @api private
+    #
     class Repository < Vedeu::Repositories::Repository
 
       null Vedeu::Groups::Group

data/lib/vedeu/input/capture.rb

@@ -10,6 +10,8 @@ module Vedeu
     # Captures input from the user terminal via 'getch' and
     # translates special characters into symbols.
     #
+    # @api private
+    #
     class Capture
 
       include Vedeu::Common

data/lib/vedeu/input/dsl.rb

@@ -9,6 +9,8 @@ module Vedeu
     # of this definition will affect that interface. This allows you
     # to form context driven behaviour for your application.
     #
+    # @api private
+    #
     class DSL
 
       include Vedeu::Common

data/lib/vedeu/input/key.rb

@@ -7,6 +7,8 @@ module Vedeu
     # A single keypress or combination of keypresses bound to a
     # specific action.
     #
+    # @api private
+    #
     class Key
 
       # @!attribute [r] input

data/lib/vedeu/input/keymap.rb

@@ -7,6 +7,8 @@ module Vedeu
     # A container class for keys associated with a particular
     # interface.
     #
+    # @api private
+    #
     class Keymap
 
       include Vedeu::Repositories::Model

data/lib/vedeu/input/repository.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Allows the storing of keymaps.
     #
+    # @api private
+    #
     class Repository < Vedeu::Repositories::Repository
 
       real Vedeu::Input::Keymap

data/lib/vedeu/input/translator.rb

@@ -7,6 +7,8 @@ module Vedeu
     # Translates escape sequences provided by the terminal into
     # symbols which Vedeu can use for various behaviours.
     #
+    # @api private
+    #
     class Translator
 
       # @param (see #initialize)

data/lib/vedeu/interfaces/clear.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Clear the named interface.
     #
+    # @api private
+    #
     class Clear
 
       include Vedeu::Common

data/lib/vedeu/interfaces/dsl.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # DSL for creating interfaces.
     #
+    # @api private
+    #
     class DSL
 
       include Vedeu::Common

data/lib/vedeu/interfaces/interface.rb

@@ -7,6 +7,8 @@ module Vedeu
     # An Interface represents a portion of the terminal defined by
     # {Vedeu::Geometries::Geometry}.
     #
+    # @api private
+    #
     class Interface
 
       include Vedeu::Repositories::Model

data/lib/vedeu/interfaces/null.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Provides a non-existent model to swallow messages.
     #
+    # @api private
+    #
     class Null < Vedeu::Null::Generic
 
       include Vedeu::Presentation

data/lib/vedeu/interfaces/repository.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Allows the storing of interfaces and views.
     #
+    # @api private
+    #
     class Repository < Vedeu::Repositories::Repository
 
       null Vedeu::Interfaces::Null

data/lib/vedeu/logging/timer.rb

@@ -8,6 +8,8 @@ module Vedeu
     # The configuration option 'debug' must be set to true to enable
     # this functionality.
     #
+    # @api private
+    #
     class Timer
 
       class << self

data/lib/vedeu/menus/dsl.rb

@@ -7,6 +7,8 @@ module Vedeu
     # Provides the mechanism to create menus within client
     # applications and use events to drive them.
     #
+    # @api public
+    #
     class DSL
 
       include Vedeu::DSL

data/lib/vedeu/menus/menu.rb

@@ -7,6 +7,8 @@ module Vedeu
     # Converts the collection passed into a list of menu items which
     # can be navigated using the instance methods or events provided.
     #
+    # @api private
+    #
     class Menu
 
       include Vedeu::Repositories::Model

data/lib/vedeu/menus/repository.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Allows the storing of menus by name.
     #
+    # @api private
+    #
     class Repository < Vedeu::Repositories::Repository
 
       real Vedeu::Menus::Menu

data/lib/vedeu/models/page.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # A Page represents an array of Vedeu::Models::Row objects.
     #
+    # @api private
+    #
     class Page
 
       include Enumerable

data/lib/vedeu/models/row.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # A Row represents an array of Vedeu::Cells::Empty objects.
     #
+    # @api private
+    #
     class Row
 
       include Enumerable

data/lib/vedeu/null/generic.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Provides a non-existent model to swallow messages.
     #
+    # @api private
+    #
     class Generic
 
       # @!attribute [r] attributes

data/lib/vedeu/output/refresh.rb

@@ -5,6 +5,9 @@ module Vedeu
   module Output
 
     # @see Vedeu::Bindings::System#refresh!
+    #
+    # @api private
+    #
     class Refresh
 
       # @return (see #all)

data/lib/vedeu/plugins/plugin.rb

@@ -4,6 +4,8 @@ module Vedeu
 
   # A class responsible for plugin loading.
   #
+  # @api private
+  #
   class Plugin
 
     # @!attribute [r] name

data/lib/vedeu/plugins/plugins.rb

@@ -4,6 +4,8 @@ module Vedeu
 
   # A class responsible for managing plugins installation.
   #
+  # @api private
+  #
   class Plugins
 
     # Returns a new instance of Vedeu::Plugins.

data/lib/vedeu/presentation/style.rb

@@ -15,6 +15,8 @@ module Vedeu
     #
     # @see Vedeu::EscapeSequences::Esc
     #
+    # @api private
+    #
     class Style
 
       class << self

data/lib/vedeu/renderers/escape.rb

@@ -8,6 +8,8 @@ module Vedeu
     # {Vedeu::Cells::Char} objects into a stream of characters without
     # escape sequences.
     #
+    # @api private
+    #
     class Escape < Vedeu::Renderers::File
 
       include Vedeu::Renderers::Options

data/lib/vedeu/renderers/html.rb

@@ -7,6 +7,8 @@ module Vedeu
     # Renders a {Vedeu::Buffers::Terminal} as a HTML snippet; a table
     # by default.
     #
+    # @api private
+    #
     class HTML < Vedeu::Renderers::File
 
       include Vedeu::Renderers::Options

data/lib/vedeu/renderers/json.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Renders a {Vedeu::Buffers::Terminal} as JSON.
     #
+    # @api private
+    #
     class JSON < Vedeu::Renderers::File
 
       include Vedeu::Renderers::Options

data/lib/vedeu/renderers/support/file.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Writes the given output to a file.
     #
+    # @api private
+    #
     class File
 
       include Vedeu::Renderers::Options

data/lib/vedeu/renderers/terminal.rb

@@ -7,6 +7,8 @@ module Vedeu
     # Converts a grid of {Vedeu::Cells::Char} objects into a stream of
     # escape sequences and content suitable for a terminal.
     #
+    # @api private
+    #
     class Terminal
 
       include Vedeu::Renderers::Options

data/lib/vedeu/renderers/text.rb

@@ -8,6 +8,8 @@ module Vedeu
     # {Vedeu::Cells::Char} objects into a stream of characters without
     # escape sequences.
     #
+    # @api private
+    #
     class Text < Vedeu::Renderers::File
 
       include Vedeu::Renderers::Options

data/lib/vedeu/repositories/model.rb

@@ -7,6 +7,8 @@ module Vedeu
     # When included into a class, provides the mechanism to store the
     # class in a repository for later retrieval.
     #
+    # @api private
+    #
     module Model
 
       # @!attribute [rw] repository

data/lib/vedeu/repositories/repository.rb

@@ -12,6 +12,8 @@ module Vedeu
     #
     #   { 'models' => [Model] }
     #
+    # @api private
+    #
     class Repository
 
       include Vedeu::Common

data/lib/vedeu/runtime/bootstrap.rb

@@ -10,6 +10,8 @@ module Vedeu
     # initializes Vedeu with this data, then starts the client
     # application.
     #
+    # @api private
+    #
     class Bootstrap
 
       # @param (see #initialize)

data/lib/vedeu/runtime/launcher.rb

@@ -8,6 +8,8 @@ module Vedeu
   # uncaught exceptions and finally the exiting of the application
   # with the correct exit code.
   #
+  # @api public
+  #
   class Launcher
 
     # @!attribute [r] exit_code

data/lib/vedeu/runtime/main_loop.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Provides the main loop for a Vedeu application.
     #
+    # @api private
+    #
     class MainLoop
 
       trap('SIGTERM') { stop! }

data/lib/vedeu/runtime/traps.rb

@@ -6,23 +6,76 @@ module Vedeu
 
     # Vedeu can respond to various signals which are handled here.
     #
+    # @api private
+    #
     module Traps
 
       # :nocov:
 
-      Signal.trap('INT') do
-        exit(1)
-      end
+      # @param keys [Array<Symbol>]
+      # @macro param_block
+      # @macro raise_requires_block
+      # @return [Array<Symbol>]
+      def self.add_signal_trap(*keys, &block)
+        raise Vedeu::Error::RequiresBlock unless block_given?
+
+        # fail Signal.list.inspect
 
-      Signal.trap('TERM') do
-        exit(1)
+        keys.each do |key|
+          Signal.trap(key.to_s, &block) if Signal.list.key?(key.to_s)
+        end
       end
 
-      Signal.trap('TTIN') {}
-      Signal.trap('USR1') {}
-      Signal.trap('USR2') {}
+      # Resize terminal
+      add_signal_trap(:WINCH) { Vedeu.trigger(:_resize_) }
+
+      # Stop runtime (failure)
+      add_signal_trap(:INT, :TERM) { exit(1) }
+
+      # Read from terminal
+      add_signal_trap(:TTIN) {}
+
+      # User
+      add_signal_trap(:USR1, :USR2) {}
 
-      Signal.trap('SIGWINCH') { Vedeu.trigger(:_resize_) }
+      # Signals from Ubuntu Linux 16.04.
+      #
+      # {
+      #   "EXIT"   => 0,
+      #   "HUP"    => 1,
+      #   "INT"    => 2,
+      #   "QUIT"   => 3,
+      #   "ILL"    => 4,
+      #   "TRAP"   => 5,
+      #   "ABRT"   => 6,
+      #   "IOT"    => 6,
+      #   "BUS"    => 7,
+      #   "FPE"    => 8,
+      #   "KILL"   => 9,
+      #   "USR1"   => 10,
+      #   "SEGV"   => 11,
+      #   "USR2"   => 12,
+      #   "PIPE"   => 13,
+      #   "ALRM"   => 14,
+      #   "TERM"   => 15,
+      #   "CHLD"   => 17,
+      #   "CLD"    => 17,
+      #   "STOP"   => 19,
+      #   "CONT"   => 18,
+      #   "TSTP"   => 20,
+      #   "TTIN"   => 21,
+      #   "TTOU"   => 22,
+      #   "URG"    => 23,
+      #   "XCPU"   => 24,
+      #   "XFSZ"   => 25,
+      #   "VTALRM" => 26,
+      #   "PROF"   => 27,
+      #   "WINCH"  => 28,
+      #   "IO"     => 29,
+      #   "POLL"   => 29,
+      #   "PWR"    => 30,
+      #   "SYS"    => 31,
+      # }
 
       # :nocov:
 

data/lib/vedeu/templating/template.rb

@@ -6,6 +6,8 @@ module Vedeu
 
     # Generic class to loading a template and parsing it via ERb.
     #
+    # @api private
+    #
     class Template
 
       # @param (see #initialize)

data/lib/vedeu/templating/view_template.rb

@@ -7,6 +7,8 @@ module Vedeu
     # Extend Template to provide client application view specific
     # parsing.
     #
+    # @api private
+    #
     class ViewTemplate < Vedeu::Templating::Template
 
       include Vedeu::Common

data/lib/vedeu/version.rb

@@ -3,6 +3,6 @@
 module Vedeu
 
   # The current version of Vedeu.
-  VERSION = '0.8.23'
+  VERSION = '0.8.24'
 
-end
+end # Vedeu

data/lib/vedeu/views/composition.rb

@@ -8,6 +8,8 @@ module Vedeu
 
     # A composition is a collection of interfaces.
     #
+    # @api private
+    #
     class Composition
 
       include Vedeu::Repositories::Model

data/lib/vedeu/views/line.rb

@@ -10,6 +10,8 @@ module Vedeu
     # {Vedeu::Views::Stream} objects. A line's width is determined by
     # the {Vedeu::Geometries::Geometry} it belongs to.
     #
+    # @api private
+    #
     class Line
 
       # Provides DSL methods for Vedeu::Views::Line objects.

data/lib/vedeu/views/stream.rb

@@ -11,6 +11,8 @@ module Vedeu
     # {Vedeu::Views::Line} which you wish to colour and style
     # independently of the other characters in that line.
     #
+    # @api private
+    #
     class Stream
 
       # Provides DSL methods for Vedeu::Views::Stream objects.

data/lib/vedeu/views/view.rb

@@ -9,6 +9,8 @@ module Vedeu
     # Represents a container for {Vedeu::Views::Line} and
     # {Vedeu::Views::Stream} objects.
     #
+    # @api private
+    #
     class View
 
       # Provides DSL methods for Vedeu::Views::View objects.

data/test/lib/vedeu/runtime/traps_test.rb

@@ -8,8 +8,30 @@ module Vedeu
 
     describe Traps do
 
-      # @todo Add more tests.
-      # it { skip }
+      let(:described) { Vedeu::Runtime::Traps }
+      let(:keys) { :SIGWINCH }
+
+      describe '.add_signal_trap' do
+        subject { described.add_signal_trap(keys) { } }
+
+        context 'when the required block was given' do
+          context 'when signals were given' do
+            it { subject.must_equal([:SIGWINCH]) }
+          end
+
+          context 'when no signals were given' do
+            let(:keys) {}
+
+            it { subject.must_equal([nil]) }
+          end
+        end
+
+        context 'when the required block was not given' do
+          subject { described.add_signal_trap(keys) }
+
+          it { proc { subject }.must_raise(Vedeu::Error::RequiresBlock) }
+        end
+      end
 
     end # Traps
 

data/vedeu.gemspec

@@ -33,7 +33,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'yard',               '0.8.7.6'
 
   spec.add_dependency 'bundler',       '~> 1.10'
-  spec.add_dependency 'rake',          '~> 10.4'
+  spec.add_dependency 'rake',          '~> 10.5'
   spec.add_dependency 'thor',          '0.19.1'
-  spec.add_dependency 'vedeu_cli',     '0.0.8'
+  spec.add_dependency 'vedeu_cli',     '0.0.10'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vedeu
 version: !ruby/object:Gem::Version
-  version: 0.8.23
+  version: 0.8.24
 platform: ruby
 authors:
 - Gavin Laking
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-28 00:00:00.000000000 Z
+date: 2016-04-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: guard
@@ -170,14 +170,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.4'
+        version: '10.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.4'
+        version: '10.5'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -198,14 +198,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.0.8
+        version: 0.0.10
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.0.8
+        version: 0.0.10
 description: A framework for building GUI/TUI terminal/console applications.
 email:
 - gavinlaking@gmail.com
@@ -587,6 +587,7 @@ files:
 - integrations/expected/dsl_app_014.out
 - integrations/expected/dsl_app_015.out
 - integrations/expected/dsl_app_016.out
+- integrations/expected/dsl_app_017.out
 - integrations/expected/dsl_app_021.out
 - integrations/expected/dsl_app_022.out
 - integrations/expected/dsl_app_border_001.out