vedeu 0.6.50 → 0.6.51

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3656fd2ea030549ea6a2a7b436f3d4e0b30b4cae
-  data.tar.gz: 7d1ae15fec3a67bda3e62bd0777c9e38c69dc35f
+  metadata.gz: 08eb61b65bd7020344202d3002defb0dc0d50c13
+  data.tar.gz: 560d43d002cf41c62bcb74b9964534071f33e941
 SHA512:
-  metadata.gz: 828e104fc823104f930edbcea3e8dfff7f66b485fc07abc2124fe543a8ebc4d78ac491b3ba7119322417bb7b44c383e31cbd6a83cd6f96daef055a231a53638f
-  data.tar.gz: 1d8398ed1312cd0da093e3ba370904bf05e34cd6fee2e6d49b633890d4691e6cb73f546458721bd6648ebb829a743aeb14f36be40963bac5d93a57aa79b80ab3
+  metadata.gz: ad2ece537d1197ef06bce653d9a063dae0a43abd7fd42989fe090451b346be4a4a36685c56d4794366b64b474d1dc5fed2be4bb44e15f4cce02b7bbb51051b6c
+  data.tar.gz: 2e660fa55283d844fbe6e5fa9f2a74ae8ba26489059a57ca8975fc1073c3a9afb91aefa6ea3bf8d0b52e7fc168bf23e9897895e876e0a58fe00b0ec976815f7b

data/docs/events/view.md

@@ -11,6 +11,26 @@ Maximising an interface.
 
 See {Vedeu::Geometry::Geometry#maximise}
 
+### `:\_movement_refresh\_`
+When triggered, triggers additional events which aid the updating of
+the output. Used when moving an interface/view.
+
+    Vedeu.trigger(:_movement_refresh_, name)
+
+At this time, triggering this event will:
+
+- Clear the entire terminal (assuming at least one renderer is the
+  default (Vedeu::Renderer::Terminal)). This action is performed when
+  moving an interface/view so that there are no 'artefacts' left
+  behind.
+- Refresh the entire terminal (as above). This means all visible
+  interfaces are re-rendered. This action is performed to ensure other
+  views currently visible are rendered in their current position.
+- Clears the named view. This action removes the named view from the
+  terminal (or output).
+- Refreshes the named view. This action adds the named view to the
+  terminal (or output); in the new position.
+
 ### `:\_resize\_`
 When triggered will cause Vedeu to trigger the `:_clear_` and
 `:_refresh_` events. Please see those events for their behaviour.

data/docs/output.md

@@ -1,2 +1,4 @@
 # @title Vedeu Output
 # Vedeu Output
+
+More coming soon.

data/lib/vedeu/borders/null.rb

@@ -5,6 +5,8 @@ module Vedeu
     # Provides a non-existent Vedeu::Borders::Border that acts like
     # the real thing, but does nothing.
     #
+    # @api private
+    #
     class Null
 
       # @!attribute [r] name

data/lib/vedeu/borders/refresh.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Renders and refreshes the named border.
     #
+    # @api private
+    #
     class Refresh
 
       extend Forwardable

data/lib/vedeu/borders/title.rb

@@ -6,6 +6,8 @@ module Vedeu
     # title is longer than the interface is wide, and pad with a space
     # either side.
     #
+    # @api private
+    #
     class Title
 
       # @param value [String|Vedeu::Borders::Title|
@@ -129,6 +131,8 @@ module Vedeu
     # the caption is longer than the interface is wide, and pad with a
     # space either side.
     #
+    # @api private
+    #
     class Caption < Title
 
     end # Caption

data/lib/vedeu/buffers/null.rb

@@ -5,6 +5,8 @@ module Vedeu
     # Provides a non-existent Vedeu::Buffers::Buffer that acts like
     # the real thing, but does nothing.
     #
+    # @api private
+    #
     class Null < Vedeu::Null::Generic
 
     end # Null

data/lib/vedeu/colours/background.rb

@@ -6,6 +6,8 @@ module Vedeu
     # {Vedeu::Colours::Foreground}) of a terminal colour escape
     # sequence.
     #
+    # @api private
+    #
     class Background < Vedeu::Colours::Translator
 
       private

data/lib/vedeu/colours/foreground.rb

@@ -6,6 +6,8 @@ module Vedeu
     # {Vedeu::Colours::Background}) of a terminal colour escape
     # sequence.
     #
+    # @api private
+    #
     class Foreground < Vedeu::Colours::Translator
 
       private

data/lib/vedeu/colours/translator.rb

@@ -26,6 +26,8 @@ module Vedeu
     #
     # @todo More documentation required (create a fancy chart!)
     #
+    # @api private
+    #
     class Translator
 
       # @!attribute [r] colour

data/lib/vedeu/common.rb

@@ -2,6 +2,8 @@ module Vedeu
 
   # A module for common methods used throughout Vedeu.
   #
+  # @api private
+  #
   module Common
 
     # Returns a boolean indicating whether a variable is nil or empty.

data/lib/vedeu/configuration/api.rb

@@ -221,8 +221,11 @@ module Vedeu
       # setting is for debugging to be disabled. Using `debug!` or
       # setting `debug` to true will enable debugging.
       #
-      # At this time, debugging only toggles between viewing a full
-      # backtrace (true) upon exception or only its top line (false).
+      # Enabling debugging will:
+      # - Enable `Vedeu::Logging::Timer` meaning various timing
+      #   information is output to the log file.
+      # - Produce a full a backtrace to STDOUT and the log file upon
+      #   unrecoverable error or unhandled exception.
       #
       #   Vedeu.configure do
       #     debug!
@@ -516,9 +519,9 @@ module Vedeu
       def background(value = nil)
         return options[:background] unless value
 
-        new_background = Vedeu::Colours::Background.coerce(value)
+        bg = Vedeu::Colours::Background.coerce(value)
 
-        options[:background] = colour_attributes(background: new_background)
+        options[:background] = colour_attributes(background: bg)
                                .fetch(:background)
       end
 
@@ -534,9 +537,9 @@ module Vedeu
       def foreground(value = nil)
         return options[:foreground] unless value
 
-        new_foreground = Vedeu::Colours::Foreground.coerce(value)
+        fg = Vedeu::Colours::Foreground.coerce(value)
 
-        options[:foreground] = colour_attributes(foreground: new_foreground)
+        options[:foreground] = colour_attributes(foreground: fg)
                                .fetch(:foreground)
       end
 

data/lib/vedeu/cursors/cursor.rb

@@ -5,6 +5,8 @@ module Vedeu
     # Each interface has its own Cursor which maintains the position
     # and visibility of the cursor within that interface.
     #
+    # @api private
+    #
     class Cursor
 
       include Vedeu::Repositories::Model

data/lib/vedeu/cursors/refresh.rb

@@ -6,6 +6,8 @@ module Vedeu
     # the whole interface; unless the cursor's offset has caused the
     # view to change.
     #
+    # @api private
+    #
     class Refresh
 
       extend Forwardable

data/lib/vedeu/cursors/reposition.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Arbitrarily move the cursor to a given position.
     #
+    # @api private
+    #
     class Reposition
 
       # Returns a new instance of Vedeu::Cursors::Reposition.

data/lib/vedeu/editor/capture.rb

@@ -52,27 +52,20 @@ module Vedeu
           end
         end
 
-        if keys.start_with?("\e[M")
-          button, x, y = keys.chars[3..-1].map { |c| c.ord - 32 }
-
-          Vedeu.log(type:    :input,
-                    message: "Mouse pressed: '#{button}' (x: #{x}, y: #{y})")
-
-          if button == 0 # left mouse button
-            Vedeu.trigger(:_cursor_reposition_, Vedeu.focus, y, x)
-
-          elsif button == 64 # scroll wheel up
-            Vedeu.trigger(:_cursor_up_, Vedeu.focus)
-
-          elsif button == 65 # scroll wheel down
-            Vedeu.trigger(:_cursor_down_, Vedeu.focus)
-
-          end
-        end
+        return Vedeu::Input::Mouse.click(keys) if click?(keys)
 
         keys
       end
 
+      # Returns a boolean indicating whether a mouse click was
+      # received.
+      #
+      # @param keys [String]
+      # @return [Boolean]
+      def click?(keys)
+        keys.start_with?("\e[M")
+      end
+
       # @return [IO]
       def console
         @console || Vedeu::Terminal.console

data/lib/vedeu/editor/cropper.rb

@@ -5,6 +5,8 @@ module Vedeu
     # Crop the lines to the visible area of the document, as defined
     # by the geometry provided.
     #
+    # @api private
+    #
     class Cropper
 
       extend Forwardable

data/lib/vedeu/editor/cursor.rb

@@ -5,6 +5,8 @@ module Vedeu
     # Maintains a cursor position within the {Vedeu::Editor::Document}
     # class.
     #
+    # @api private
+    #
     class Cursor
 
       extend Forwardable

data/lib/vedeu/editor/delete.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Manipulate the lines of an Vedeu::Editor::Document.
     #
+    # @api private
+    #
     class Delete
 
       # @param (see #initialize)

data/lib/vedeu/editor/document.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # A collection of keypresses ordered by input.
     #
+    # @api private
+    #
     class Document
 
       include Vedeu::Repositories::Model
@@ -37,6 +39,11 @@ module Vedeu
 
       # Returns a new instance of Vedeu::Editor::Document.
       #
+      # @note
+      #   If a particular key is missing from the attributes
+      #   parameter, then it is added with the respective value from
+      #   #defaults.
+      #
       # @param attributes [Hash]
       # @option attributes data [String]
       # @option attributes name [String|Symbol]

data/lib/vedeu/editor/insert.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Manipulate the lines of an Vedeu::Editor::Document.
     #
+    # @api private
+    #
     class Insert
 
       # @param (see #initialize)

data/lib/vedeu/editor/item.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Fetches an item from a collection.
     #
+    # @api private
+    #
     class Item
 
       # @param collection [Vedeu::Editor::Line|Vedeu::Editor::Lines]

data/lib/vedeu/editor/line.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Manipulate a single line of an Vedeu::Editor::Document.
     #
+    # @api private
+    #
     class Line
 
       # @!attribute [rw] line

data/lib/vedeu/editor/lines.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Manipulate the lines of an Vedeu::Editor::Document.
     #
+    # @api private
+    #
     class Lines
 
       include Enumerable

data/lib/vedeu/error.rb

@@ -3,6 +3,8 @@ module Vedeu
   # Custom exceptions/errors which Vedeu will raise in certain
   # circumstances.
   #
+  # @api private
+  #
   module Error
 
     # Raised with Vedeu attempts to access a client application

data/lib/vedeu/events/trigger.rb

@@ -38,6 +38,9 @@ module Vedeu
       #
       # @return [Array]
       def trigger
+        Vedeu.log(type:    :event,
+                  message: "No action for: '#{name.inspect}'") if results.empty?
+
         return results[0] if results.one?
 
         results

data/lib/vedeu/geometry/alignment.rb

@@ -10,6 +10,8 @@ module Vedeu
     # @see Vedeu::Geometry::HorizontalAlignment
     # @see Vedeu::Geometry::VerticalAlignment
     #
+    # @api private
+    #
     class Alignment
 
       # @param (see #initialize)

data/lib/vedeu/geometry/area.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Define an area from dimensions or points.
     #
+    # @api private
+    #
     class Area
 
       # @!attribute [r] y

data/lib/vedeu/geometry/coordinate.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Crudely corrects out of range values.
     #
+    # @api private
+    #
     class Coordinate
 
       # Return a new instance of Vedeu::Geometry::Coordinate.

data/lib/vedeu/geometry/dimension.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # A Dimension is either the height or width of an entity.
     #
+    # @api private
+    #
     class Dimension
 
       extend Forwardable

data/lib/vedeu/geometry/grid.rb

@@ -7,6 +7,8 @@ module Vedeu
     # If the terminal height or width is not a multiple of 12, then
     # Grid chooses the maximum value which will fit.
     #
+    # @api private
+    #
     class Grid
 
       # @see #initialize

data/lib/vedeu/geometry/horizontal_alignment.rb

@@ -5,6 +5,8 @@ module Vedeu
     # Provides the mechanism to align an interface/view horizontally
     # within the available terminal space.
     #
+    # @api private
+    #
     class HorizontalAlignment < Vedeu::Geometry::Alignment
 
       # @raise [Vedeu::Error::InvalidSyntax] When the value is not one

data/lib/vedeu/geometry/null.rb

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

data/lib/vedeu/geometry/position.rb

@@ -5,6 +5,8 @@ module Vedeu
     # Change coordinates into an escape sequence to set the cursor
     # position.
     #
+    # @api private
+    #
     class Position
 
       # @!attribute [r] y

data/lib/vedeu/geometry/repository.rb

@@ -33,6 +33,7 @@ module Vedeu
     Vedeu.geometries.by_name(name).maximise
   end
 
+  # See {file:docs/events/view.md#\_movement_refresh_}
   Vedeu.bind(:_movement_refresh_) do |name|
     Vedeu.trigger(:_clear_)
     Vedeu.trigger(:_refresh_)

data/lib/vedeu/geometry/validator.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Validate values given to {Vedeu::Geometry::DSL}.
     #
+    # @api private
+    #
     module Validator
 
       include Vedeu::Common

data/lib/vedeu/geometry/vertical_alignment.rb

@@ -5,6 +5,8 @@ module Vedeu
     # Provides the mechanism to align an interface/view vertically
     # within the available terminal space.
     #
+    # @api private
+    #
     class VerticalAlignment < Vedeu::Geometry::Alignment
 
       # @raise [Vedeu::Error::InvalidSyntax] When the value is not one

data/lib/vedeu/geometry/x_dimension.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # The X Dimension provides the width of an entity.
     #
+    # @api private
+    #
     class XDimension < Vedeu::Geometry::Dimension
 
       private

data/lib/vedeu/geometry/y_dimension.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # The Y Dimension provides the height of an entity.
     #
+    # @api private
+    #
     class YDimension < Vedeu::Geometry::Dimension
 
       private

data/lib/vedeu/input/all.rb

@@ -15,5 +15,6 @@ require 'vedeu/input/key'
 require 'vedeu/input/keymap'
 require 'vedeu/input/keymaps'
 require 'vedeu/input/mapper'
+require 'vedeu/input/mouse'
 require 'vedeu/input/store'
 require 'vedeu/input/translator'

data/lib/vedeu/input/capture.rb

@@ -42,7 +42,10 @@ module Vedeu
       #
       # @return [Array|String|Symbol]
       def read
-        if reader.raw_mode?
+        if click?(keypress)
+          Vedeu.trigger(:_mouse_event_, keypress)
+
+        elsif reader.raw_mode?
           Vedeu.trigger(:_keypress_, keypress)
 
         elsif reader.fake_mode?
@@ -74,13 +77,24 @@ module Vedeu
 
       private
 
+      # Returns a boolean indicating whether a mouse click was
+      # received.
+      #
+      # @param key [String]
+      # @return [Boolean]
+      def click?(key)
+        return false if key.is_a?(Symbol)
+
+        key.is_a?(Vedeu::Cursors::Cursor) || key.start_with?("\e[M")
+      end
+
       # Returns the translated (when possible) keypress(es).
       #
       # @return [String|Symbol]
       def keypress
         key = input
 
-        Vedeu::Input::Translator.translate(key)
+        @keypress ||= Vedeu::Input::Translator.translate(key)
       end
 
       # Returns the input from the terminal.

data/lib/vedeu/input/mouse.rb

@@ -0,0 +1,96 @@
+module Vedeu
+
+  module Input
+
+    # Rudimentary support for mouse interactions.
+    #
+    class Mouse
+
+      # Trigger an event depending on which button was pressed.
+      #
+      # @param input [String]
+      # @return [void]
+      def self.click(input)
+        new(input).click
+      end
+
+      # Return an instance of Vedeu::Input::Mouse.
+      #
+      # @param input [String]
+      # @return [Vedeu::Input::Mouse]
+      def initialize(input)
+        @input = input
+      end
+
+      # Trigger an event depending on which button was pressed.
+      #
+      # @return [void]
+      def click
+        Vedeu.log(type:    :input,
+                  message: "Mouse pressed: '#{button}' (x: #{x}, y: #{y})")
+
+        if left_click?
+          Vedeu.trigger(:_cursor_reposition_, Vedeu.focus, y, x)
+
+        elsif wheel_up?
+          Vedeu.trigger(:_cursor_up_, Vedeu.focus)
+
+        elsif wheel_down?
+          Vedeu.trigger(:_cursor_down_, Vedeu.focus)
+
+        else
+          Vedeu.log(type:    :input,
+                    message: 'Vedeu does not support mouse button ' \
+                             "'#{button}' yet.")
+
+        end
+      end
+
+      protected
+
+      # @!attribute [r] input
+      # @return [String]
+      attr_reader :input
+
+      private
+
+      # @return [Fixnum]
+      def button
+        mouse[0]
+      end
+
+      # @return [Array<Fixnum>]
+      def mouse
+        @_input ||= input.chars[3..-1].map { |character| character.ord - 32 }
+      end
+
+      # @return [Boolean]
+      def left_click?
+        button == 0
+      end
+
+      # @return [Boolean]
+      def wheel_up?
+        button == 64
+      end
+
+      # @return [Boolean]
+      def wheel_down?
+        button == 65
+      end
+
+      # @return [Fixnum]
+      def x
+        mouse[1]
+      end
+
+      # @return [Fixnum]
+      def y
+        mouse[2]
+      end
+
+    end # Mouse
+
+  end # Input
+
+end # Vedeu

data/lib/vedeu/logging/lockless_log_device.rb

@@ -5,6 +5,8 @@ module Vedeu
     # Ensures we can always write to the log file by creating a
     # lock-less log device.
     #
+    # @api private
+    #
     class LocklessLogDevice < ::Logger::LogDevice
 
       # Returns a new instance of Vedeu::Logging::LocklessLogDevice.

data/lib/vedeu/logging/mono_logger.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Allows the creation of a lock-less log device.
     #
+    # @api private
+    #
     class MonoLogger < ::Logger
 
       # Create a trappable Logger instance.

data/lib/vedeu/menus/null.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Provides a non-existent model to swallow messages.
     #
+    # @api private
+    #
     class Null < Vedeu::Null::Generic
 
       # Returns an instance of the Vedeu::Menus::Null class.

data/lib/vedeu/models/cell.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # A Cell represents a single square of the terminal.
     #
+    # @api private
+    #
     class Cell
 
       # @!attribute [r] colour
@@ -20,6 +22,11 @@ module Vedeu
 
       # Returns a new instance of Vedeu::Models::Cell.
       #
+      # @note
+      #   If a particular key is missing from the attributes
+      #   parameter, then it is added with the respective value from
+      #   #defaults.
+      #
       # @param attributes [Hash<Symbol => Array<Symbol|String>,
       #                                   Fixnum, String, Symbol]
       # @option attributes colour [NilClass|String]

data/lib/vedeu/models/escape.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Represents an invisible escape character sequence.
     #
+    # @api private
+    #
     class Escape
 
       # @!attribute [r] value

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

@@ -5,6 +5,7 @@ module Vedeu
     # A collection of {Vedeu::Views::Char} instances.
     #
     # @api private
+    #
     class Chars < Vedeu::Repositories::Collection
 
     end # Chars

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

@@ -5,6 +5,7 @@ module Vedeu
     # A collection of {Vedeu::Views::Line} instances.
     #
     # @api private
+    #
     class Lines < Vedeu::Repositories::Collection
 
     end # Lines

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

@@ -5,6 +5,7 @@ module Vedeu
     # A collection of {Vedeu::Views::Stream} instances.
     #
     # @api private
+    #
     class Streams < Vedeu::Repositories::Collection
 
     end # Streams

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

@@ -5,6 +5,7 @@ module Vedeu
     # A collection of {Vedeu::Views::View} instances.
     #
     # @api private
+    #
     class ViewCollection < Vedeu::Repositories::Collection
 
     end # ViewCollection

data/lib/vedeu/null/all.rb

@@ -4,6 +4,8 @@ module Vedeu
   # their real counterpart. In most cases the call is muted or returns
   # a generic value that does not halt processing.
   #
+  # @api private
+  #
   module Null
 
   end # Null

data/lib/vedeu/output/compressor.rb

@@ -7,6 +7,8 @@ module Vedeu
     # occurences of the same escape sequence, resulting in a smaller
     # payload being sent to the renderer.
     #
+    # @api private
+    #
     class Compressor
 
       include Vedeu::Common

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

@@ -4,9 +4,10 @@ module Vedeu
 
     # Provides shared functionality to Vedeu::Renderer classes.
     #
-    # :nocov:
     module Options
 
+      # :nocov:
+
       # @!attribute [w] options
       # @return [Hash<Symbol => void>]
       attr_writer :options
@@ -32,8 +33,9 @@ module Vedeu
         {}
       end
 
+      # :nocov:
+
     end # Options
-    # :nocov:
 
   end # Renderers
 

data/lib/vedeu/output/viewport.rb

@@ -9,6 +9,8 @@ module Vedeu
     # columns than the defined width of the interface, this class
     # provides 'scrolling' via the cursor's position.
     #
+    # @api private
+    #
     class Viewport
 
       extend Forwardable

data/lib/vedeu/repositories/collection.rb

@@ -5,6 +5,8 @@ module Vedeu
     # Convert an Array into an object which has some meaning in the
     # context it is being used.
     #
+    # @api private
+    #
     class Collection
 
       include Enumerable

data/lib/vedeu/repositories/store.rb

@@ -4,6 +4,8 @@ module Vedeu
 
     # Provides generic repository related behaviour.
     #
+    # @api private
+    #
     module Store
 
       include Enumerable

data/lib/vedeu/templating/decoder.rb

@@ -5,6 +5,8 @@ module Vedeu
     # Converts an encoded string back into an object or collection of
     # objects.
     #
+    # @api private
+    #
     class Decoder
 
       # @param (see #initialize)

data/lib/vedeu/templating/encoder.rb

@@ -5,6 +5,8 @@ module Vedeu
     # Converts an object or collection of objects into an encoded
     # String.
     #
+    # @api private
+    #
     class Encoder
 
       # @param (see #initialize)

data/lib/vedeu/version.rb

@@ -1,6 +1,6 @@
 module Vedeu
 
   # The current version of Vedeu.
-  VERSION = '0.6.50'.freeze
+  VERSION = '0.6.51'.freeze
 
 end

data/test/lib/vedeu/input/mouse_test.rb

@@ -0,0 +1,69 @@
+require 'test_helper'
+
+module Vedeu
+
+  module Input
+
+    describe Mouse do
+
+      let(:described) { Vedeu::Input::Mouse }
+      let(:instance)  { described.new(input) }
+      let(:input)     {}
+
+      describe '#initialize' do
+        it { instance.must_be_instance_of(described) }
+        it { instance.instance_variable_get('@input').must_equal(input) }
+      end
+
+      describe '.click' do
+        before { Vedeu.interface(:mouse_test) {} }
+        after  { Vedeu.interfaces.reset! }
+
+        subject { described.click(input) }
+
+        context 'when the left mouse button was pressed' do
+          let(:input) { "\e[M ,%" }
+
+          it {
+            Vedeu.expects(:trigger).with(:_cursor_reposition_, Vedeu.focus, 5, 12)
+            subject
+          }
+        end
+
+        context 'when the mouse scroll wheel was moved upwards' do
+          let(:input) { "\e[M`6E" }
+
+          it {
+            Vedeu.expects(:trigger).with(:_cursor_up_, Vedeu.focus)
+            subject
+          }
+        end
+
+        context 'when the mouse scroll wheel was moved downwards' do
+          let(:input) { "\e[MaN5" }
+
+          it {
+            Vedeu.expects(:trigger).with(:_cursor_down_, Vedeu.focus)
+            subject
+          }
+        end
+
+        context 'when the mouse input was not recognised' do
+          let(:input) { "\e[Mb0(" }
+
+          it {
+            subject.must_equal("\e[93m[input]  \e[39m\e[33mVedeu does not " \
+                               "support mouse button '66' yet.\e[39m")
+          }
+        end
+      end
+
+      describe '#click' do
+        it { instance.must_respond_to(:click) }
+      end
+
+    end # Mouse
+
+  end # Input
+
+end # Vedeu

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vedeu
 version: !ruby/object:Gem::Version
-  version: 0.6.50
+  version: 0.6.51
 platform: ruby
 authors:
 - Gavin Laking
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-11-08 00:00:00.000000000 Z
+date: 2015-11-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: guard
@@ -436,6 +436,7 @@ files:
 - lib/vedeu/input/keymap.rb
 - lib/vedeu/input/keymaps.rb
 - lib/vedeu/input/mapper.rb
+- lib/vedeu/input/mouse.rb
 - lib/vedeu/input/store.rb
 - lib/vedeu/input/translator.rb
 - lib/vedeu/interfaces/all.rb
@@ -613,6 +614,7 @@ files:
 - test/lib/vedeu/input/keymap_test.rb
 - test/lib/vedeu/input/keymaps_test.rb
 - test/lib/vedeu/input/mapper_test.rb
+- test/lib/vedeu/input/mouse_test.rb
 - test/lib/vedeu/input/store_test.rb
 - test/lib/vedeu/input/translator_test.rb
 - test/lib/vedeu/interfaces/clear_test.rb
@@ -820,6 +822,7 @@ test_files:
 - test/lib/vedeu/input/keymap_test.rb
 - test/lib/vedeu/input/keymaps_test.rb
 - test/lib/vedeu/input/mapper_test.rb
+- test/lib/vedeu/input/mouse_test.rb
 - test/lib/vedeu/input/store_test.rb
 - test/lib/vedeu/input/translator_test.rb
 - test/lib/vedeu/interfaces/clear_test.rb