vedeu 0.6.3 → 0.6.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 13eafb5c54e1925996315cb27013efe95164525c
-  data.tar.gz: 8c428666c70339168afde09da41801203f505c12
+  metadata.gz: db7557217b4f94e3fcfea2f541421306550f35a4
+  data.tar.gz: 2a8dbc1907f3c2b48b9f24ee342d974686949ef3
 SHA512:
-  metadata.gz: ade908fc69f911bccd2d8403ebd6a25066ef04e6d416e9db4e67e2154d85c81a6c6a14cd441d133c36d418e205d0e4e709c71e18f07325582e8445703d86fee5
-  data.tar.gz: c732a46881adfb49a33c294c2c690db0edefa4263070cecb063a2cdb686c96ab17a2b931f34b1cfac7c2235104ad2f18b2b3849ef03eb05d9dd8c4c000fef904
+  metadata.gz: be86100e63189b39cbdb342ab8799e67f03a58b0b62f92fd165d4a70dcc3306da0639536cbc7cf8985dd63b699082a52d4f2021a13fa41f54658c0c1f9086b37
+  data.tar.gz: 3b7f9ea1aec43791928f0afbd3fac58f91f7cd2d269dca02f3d5e2f7b80bda87de406090d2a8c90c71513aa2957da88a9ab99be33e71ad8efe5fd8330dadedb9

data/lib/vedeu/all.rb

@@ -44,6 +44,7 @@ require 'vedeu/null/menu'
 require 'vedeu/null/view'
 
 require 'vedeu/geometry/area'
+require 'vedeu/geometry/generic_coordinate'
 require 'vedeu/geometry/coordinate'
 require 'vedeu/geometry/dimension'
 require 'vedeu/geometry/geometry'

data/lib/vedeu/geometry/coordinate.rb

@@ -46,173 +46,4 @@ module Vedeu
 
   end # Coordinate
 
-  # Crudely corrects out of range values.
-  #
-  class GenericCoordinate
-
-    # Return a new instance of Vedeu::GenericCoordinate.
-    #
-    # @param attributes [Hash]
-    # @option attributes name [String]
-    # @option attributes type [Symbol]
-    # @option attributes offset [Fixnum]
-    # @return [Vedeu::GenericCoordinate]
-    def initialize(attributes = {})
-      @attributes = defaults.merge!(attributes)
-
-      @attributes.each { |key, value| instance_variable_set("@#{key}", value) }
-    end
-
-    # Returns the maximum coordinate for an area.
-    #
-    # @example
-    #   # d = 2
-    #   # d_dn = 4
-    #   dn # => 6
-    #
-    # @return [Fixnum]
-    def dn
-      if d_dn <= 0
-        0
-
-      else
-        d + d_dn
-
-      end
-    end
-    alias_method :xn, :dn
-    alias_method :yn, :dn
-
-    # Returns the coordinate for a given index.
-    #
-    # @example
-    #   # d_range = [4, 5, 6, 7, 8, 9, 10, 11, 12, 13]
-    #   position     # => 4
-    #   position(-2) # => 4
-    #   position(2)  # => 6
-    #   position(15) # => 13
-    #
-    # @return [Fixnum]
-    def position
-      pos = case
-            when offset <= 0       then d
-            when offset > dn_index then dn
-            else
-              d_range[offset]
-            end
-
-      pos = pos < bd ? bd : pos
-      pos = pos > bdn ? bdn : pos
-      pos
-    end
-    alias_method :x_position, :position
-    alias_method :y_position, :position
-
-    protected
-
-    # @!attribute [r] name
-    # @return [String]
-    attr_reader :name
-
-    # @!attribute [r] offset
-    # @return [Fixnum]
-    attr_reader :offset
-
-    # @!attribute [r] type
-    # @return [Symbol]
-    attr_reader :type
-
-    private
-
-    # @see Vedeu::Borders#by_name
-    def border
-      @border ||= Vedeu.borders.by_name(name)
-    end
-
-    # Return the :x or :y value from the border.
-    #
-    # @return [Fixnum]
-    def d
-      border.send(coordinate_type[0])
-    end
-
-    # Return the :bx or :by value from the border.
-    #
-    # @return [Fixnum]
-    def bd
-      border.send(coordinate_type[1])
-    end
-
-    # Return the :bxn or :byn value from the border.
-    #
-    # @return [Fixnum]
-    def bdn
-      border.send(coordinate_type[2])
-    end
-
-    # Return the :width or :height value from the border.
-    #
-    # @return [Fixnum]
-    def d_dn
-      border.send(coordinate_type[3])
-    end
-
-    # Ascertain the correct methods to use for determining the coordinates.
-    #
-    # @raise [Vedeu::Error::InvalidSyntax] When the coordinate type is not
-    #   given.
-    # @return [Fixnum]
-    def coordinate_type
-      @_type ||= case type
-                 when :x then [:x, :bx, :bxn, :width]
-                 when :y then [:y, :by, :byn, :height]
-                 else
-                   fail Vedeu::Error::InvalidSyntax,
-                        'Coordinate type not given, cannot continue.'
-                 end
-    end
-
-    # Returns the maximum index for an area.
-    #
-    # @example
-    #   # d_dn = 3
-    #   dn_index # => 2
-    #
-    # @return [Fixnum]
-    def dn_index
-      if d_dn < 1
-        0
-
-      else
-        d_dn - 1
-
-      end
-    end
-
-    # Returns an array with all coordinates from d to dn.
-    #
-    # @example
-    #   # d_dn = 10
-    #   # d = 4
-    #   # dn = 14
-    #   d_range # => [4, 5, 6, 7, 8, 9, 10, 11, 12, 13]
-    #
-    # @return [Array]
-    def d_range
-      (d...dn).to_a
-    end
-
-    # The default values for a new instance of this class.
-    #
-    # @return [Hash]
-    def defaults
-      {
-        name:   '',
-        offset: nil,
-        type:   :x,
-      }
-    end
-
-  end # GenericCoordinate
-
 end # Vedeu

data/lib/vedeu/geometry/generic_coordinate.rb

@@ -0,0 +1,172 @@
+module Vedeu
+
+  # Crudely corrects out of range values.
+  #
+  class GenericCoordinate
+
+    # Return a new instance of Vedeu::GenericCoordinate.
+    #
+    # @param attributes [Hash]
+    # @option attributes name [String]
+    # @option attributes type [Symbol]
+    # @option attributes offset [Fixnum]
+    # @return [Vedeu::GenericCoordinate]
+    def initialize(attributes = {})
+      @attributes = defaults.merge!(attributes)
+
+      @attributes.each { |key, value| instance_variable_set("@#{key}", value) }
+    end
+
+    # Returns the maximum coordinate for an area.
+    #
+    # @example
+    #   # d = 2
+    #   # d_dn = 4
+    #   dn # => 6
+    #
+    # @return [Fixnum]
+    def dn
+      if d_dn <= 0
+        0
+
+      else
+        d + d_dn
+
+      end
+    end
+    alias_method :xn, :dn
+    alias_method :yn, :dn
+
+    # Returns the coordinate for a given index.
+    #
+    # @example
+    #   # d_range = [4, 5, 6, 7, 8, 9, 10, 11, 12, 13]
+    #   position     # => 4
+    #   position(-2) # => 4
+    #   position(2)  # => 6
+    #   position(15) # => 13
+    #
+    # @return [Fixnum]
+    def position
+      pos = case
+            when offset <= 0       then d
+            when offset > dn_index then dn
+            else
+              d_range[offset]
+            end
+
+      pos = pos < bd ? bd : pos
+      pos = pos > bdn ? bdn : pos
+      pos
+    end
+    alias_method :x_position, :position
+    alias_method :y_position, :position
+
+    protected
+
+    # @!attribute [r] name
+    # @return [String]
+    attr_reader :name
+
+    # @!attribute [r] offset
+    # @return [Fixnum]
+    attr_reader :offset
+
+    # @!attribute [r] type
+    # @return [Symbol]
+    attr_reader :type
+
+    private
+
+    # @see Vedeu::Borders#by_name
+    def border
+      @border ||= Vedeu.borders.by_name(name)
+    end
+
+    # Return the :x or :y value from the border.
+    #
+    # @return [Fixnum]
+    def d
+      border.send(coordinate_type[0])
+    end
+
+    # Return the :bx or :by value from the border.
+    #
+    # @return [Fixnum]
+    def bd
+      border.send(coordinate_type[1])
+    end
+
+    # Return the :bxn or :byn value from the border.
+    #
+    # @return [Fixnum]
+    def bdn
+      border.send(coordinate_type[2])
+    end
+
+    # Return the :width or :height value from the border.
+    #
+    # @return [Fixnum]
+    def d_dn
+      border.send(coordinate_type[3])
+    end
+
+    # Ascertain the correct methods to use for determining the coordinates.
+    #
+    # @raise [Vedeu::Error::InvalidSyntax] When the coordinate type is not
+    #   given.
+    # @return [Fixnum]
+    def coordinate_type
+      @_type ||= case type
+                 when :x then [:x, :bx, :bxn, :width]
+                 when :y then [:y, :by, :byn, :height]
+                 else
+                   fail Vedeu::Error::InvalidSyntax,
+                        'Coordinate type not given, cannot continue.'
+                 end
+    end
+
+    # Returns the maximum index for an area.
+    #
+    # @example
+    #   # d_dn = 3
+    #   dn_index # => 2
+    #
+    # @return [Fixnum]
+    def dn_index
+      if d_dn < 1
+        0
+
+      else
+        d_dn - 1
+
+      end
+    end
+
+    # Returns an array with all coordinates from d to dn.
+    #
+    # @example
+    #   # d_dn = 10
+    #   # d = 4
+    #   # dn = 14
+    #   d_range # => [4, 5, 6, 7, 8, 9, 10, 11, 12, 13]
+    #
+    # @return [Array]
+    def d_range
+      (d...dn).to_a
+    end
+
+    # The default values for a new instance of this class.
+    #
+    # @return [Hash]
+    def defaults
+      {
+        name:   '',
+        offset: nil,
+        type:   :x,
+      }
+    end
+
+  end # GenericCoordinate
+
+end # Vedeu

data/lib/vedeu/geometry/geometry.rb

@@ -137,7 +137,12 @@ module Vedeu
 
     # @return [Vedeu::Area]
     def area
-      @area = Vedeu::Area.from_attributes(
+      @area = Vedeu::Area.from_attributes(area_attributes)
+    end
+
+    # @return [Hash<Symbol => Fixnum, Boolean>]
+    def area_attributes
+      {
         y:         _y,
         yn:        _yn,
         y_yn:      _height,
@@ -148,7 +153,7 @@ module Vedeu
         x_default: Vedeu.width,
         centred:   centred,
         maximised: maximised,
-      )
+      }
     end
 
     # Returns the row/line start position for the interface.

data/lib/vedeu/input/editor/document.rb

@@ -154,13 +154,7 @@ module Vedeu
       #
       # @return [Array<String|void>]
       def lines
-        @lines ||= if present?(data)
-                     Vedeu::Editor::Lines.coerce(data)
-
-                   else
-                     defaults[:data]
-
-                   end
+        @lines ||= Vedeu::Editor::Lines.coerce(data)
       end
 
       # Render the document content in the terminal.

data/lib/vedeu/models/escape.rb

@@ -15,9 +15,9 @@ module Vedeu
     # @option attributes value [String]
     # @return [Vedeu::Escape]
     def initialize(attributes = {})
-      @attributes = defaults.merge!(attributes)
-
-      @attributes.each { |key, value| instance_variable_set("@#{key}", value) }
+      defaults.merge!(attributes).each do |key, value|
+        instance_variable_set("@#{key}", value)
+      end
     end
 
     # @return [NilClass]

data/lib/vedeu/output/direct.rb

@@ -12,9 +12,12 @@ module Vedeu
       new(value: value, x: x, y: y).write
     end
 
+    # Returns a new instance of Vedeu::Direct.
+    #
     # @param value [String]
     # @param x [Fixnum]
     # @param y [Fixnum]
+    # @return [Vedeu::Direct]
     def initialize(value:, x:, y:)
       @value = value || ''
       @x     = x     || 1

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

@@ -11,6 +11,7 @@ module Vedeu
       # Returns a new instance of Vedeu::Renderers::EscapeSequence.
       #
       # @param options [Hash]
+      # @return [Vedeu::Renderers::EscapeSequence]
       def initialize(options = {})
         @options = options || {}
       end

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

@@ -24,18 +24,15 @@ module Vedeu
       def render(output)
         @options[:content] = output
 
-        if write_file?
-          super(Vedeu::Templating::Template.parse(self, template))
-
-        else
-          Vedeu::Templating::Template.parse(self, template)
-
-        end
+        super(Vedeu::Templating::Template.parse(self, template))
       end
 
       # @return [String]
       def html_body
+        return '' if content.is_a?(Vedeu::Escape)
+
         out = ''
+
         Array(content).each do |line|
           out << "#{start_row_tag}\n"
           line.each do |char|

data/lib/vedeu/output/style.rb

@@ -24,10 +24,7 @@ module Vedeu
     # @param value [Object|NilClass]
     # @return [Object]
     def self.coerce(value)
-      if value.nil?
-        new
-
-      elsif value.is_a?(self)
+      if value.is_a?(self)
         value
 
       else

data/lib/vedeu/version.rb

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

data/test/lib/vedeu/application/application_view_test.rb

@@ -50,8 +50,6 @@ module Vedeu
       it { instance.must_respond_to(:render) }
     end
 
-
-
   end # ApplicationView
 
 end # Vedeu

data/test/lib/vedeu/borders/border_test.rb

@@ -396,139 +396,14 @@ module Vedeu
     end
 
     describe '#render' do
-      let(:attributes) {
-        {
-          bottom_left:  'C',
-          bottom_right: 'D',
-          enabled:      enabled,
-          horizontal:   'H',
-          name:         'Border#render',
-          show_top:     top,
-          show_bottom:  bottom,
-          show_left:    left,
-          show_right:   right,
-          top_left:     'A',
-          top_right:    'B',
-          vertical:     'V'
-        }
-      }
-      let(:enabled) { false }
-      let(:top)     { false }
-      let(:bottom)  { false }
-      let(:left)    { false }
-      let(:right)   { false }
-      let(:visibility) { true }
-      let(:geometry) {
-        Vedeu::Geometry.new(name: 'Border#render', x: 1, xn: 4, y: 1, yn: 4)
-      }
-      let(:interface) { Vedeu::Interface.new(visible: visibility) }
-
-      before { Vedeu.interfaces.stubs(:by_name).returns(interface) }
+      before { Vedeu::RenderBorder.stubs(:with) }
 
       subject { instance.render }
 
-      it { subject.must_be_instance_of(Array) }
-
-      context 'when the interface is not visible' do
-        let(:visibility) { false }
-
-        it { subject.must_equal([]) }
-      end
-
-      context 'when the border is not enabled' do
-        it { subject.must_equal([]) }
-      end
-
-      context 'when the border is enabled' do
-        let(:enabled) { true }
-
-        context 'top' do
-          let(:top) { true }
-
-          it { subject.size.must_equal(4) }
-        end
-
-        context 'right' do
-          let(:right) { true }
-
-          it { subject.size.must_equal(4) }
-        end
-
-        context 'bottom' do
-          let(:bottom) { true }
-
-          it { subject.size.must_equal(4) }
-        end
-
-        context 'left' do
-          let(:left) { true }
-
-          it { subject.size.must_equal(4) }
-        end
-
-        context 'top and right' do
-          let(:top)   { true }
-          let(:right) { true }
-
-          it { subject.size.must_equal(7) }
-        end
-
-        context 'top and right and bottom' do
-          let(:top)    { true }
-          let(:right)  { true }
-          let(:bottom) { true }
-
-          it { subject.size.must_equal(10) }
-        end
-
-        context 'top and bottom' do
-          let(:top)    { true }
-          let(:bottom) { true }
-
-          it { subject.size.must_equal(8) }
-        end
-
-        context 'top and left' do
-          let(:top)  { true }
-          let(:left) { true }
-
-          it { subject.size.must_equal(7) }
-        end
-
-        context 'right and bottom' do
-          let(:right)  { true }
-          let(:bottom) { true }
-
-          it { subject.size.must_equal(7) }
-        end
-
-        context 'right and left' do
-          let(:right) { true }
-          let(:left)  { true }
-
-          it { subject.size.must_equal(8) }
-        end
-
-        context 'bottom and left' do
-          let(:bottom) { true }
-          let(:left)   { true }
-
-          it { subject.size.must_equal(7) }
-        end
-
-        context 'all' do
-          let(:top)    { true }
-          let(:right)  { true }
-          let(:bottom) { true }
-          let(:left)   { true }
-
-          it { subject.size.must_equal(12) }
-        end
-
-        context 'none' do
-          it { subject.size.must_equal(0) }
-        end
-      end
+      it {
+        Vedeu::RenderBorder.expects(:with).with(instance)
+        subject
+      }
     end
 
   end # Border

data/test/lib/vedeu/exceptions_test.rb

@@ -2,4 +2,21 @@ require 'test_helper'
 
 module Vedeu
 
-end
+  module Error
+
+    describe OutOfRange do
+
+      let(:described) { Vedeu::Error::OutOfRange }
+      let(:instance)  { described.new }
+
+      describe '#message' do
+        subject { instance.message }
+
+        it { subject.must_be_instance_of(String) }
+      end
+
+    end # OutOfRange
+
+  end # Error
+
+end # Vedeu

data/test/lib/vedeu/geometry/generic_coordinate_test.rb

@@ -0,0 +1,41 @@
+require 'test_helper'
+
+module Vedeu
+
+  describe GenericCoordinate do
+
+    let(:described)  { Vedeu::GenericCoordinate }
+    let(:instance)   { described.new(attributes) }
+    let(:attributes) {
+      {
+        name:   _name,
+        offset: offset,
+        type:   type,
+      }
+    }
+    let(:_name)  {}
+    let(:offset) {}
+    let(:type)   {}
+
+    describe '#initialize' do
+      it { instance.must_be_instance_of(described) }
+      it { instance.instance_variable_get('@name').must_equal(_name) }
+      it { instance.instance_variable_get('@offset').must_equal(offset) }
+      it { instance.instance_variable_get('@type').must_equal(type) }
+    end
+
+    describe '#dn' do
+      subject { instance.dn }
+
+      # it { skip }
+    end
+
+    describe '#position' do
+      subject { instance.position }
+
+      # it { skip }
+    end
+
+  end # GenericCoordinate
+
+end # Vedeu

data/test/lib/vedeu/input/editor/document_test.rb

@@ -152,28 +152,17 @@ module Vedeu
       end
 
       describe '#lines' do
-        subject { instance.lines }
-
-        context 'when the data is empty' do
-          let(:data) {}
-          let(:expected) {
-            Vedeu::Editor::Lines.new([Vedeu::Editor::Line.new])
-          }
-
-          it { subject.must_equal(expected) }
-        end
+        let(:expected) {
+          Vedeu::Editor::Lines.new([
+            Vedeu::Editor::Line.new('Hydrogen'),
+            Vedeu::Editor::Line.new('Helium'),
+            Vedeu::Editor::Line.new('Lithium'),
+          ])
+        }
 
-        context 'when the data is not empty' do
-          let(:expected) {
-            Vedeu::Editor::Lines.new([
-              Vedeu::Editor::Line.new('Hydrogen'),
-              Vedeu::Editor::Line.new('Helium'),
-              Vedeu::Editor::Line.new('Lithium'),
-            ])
-          }
+        subject { instance.lines }
 
-          it { subject.must_equal(expected) }
-        end
+        it { subject.must_equal(expected) }
       end
 
       describe '#render' do

data/test/lib/vedeu/models/toggleable_test.rb

@@ -33,6 +33,10 @@ module Vedeu
         subject
         instance.instance_variable_get('@visible').must_equal(false)
       }
+
+      it { Vedeu::ToggleableTestClass.must_respond_to(:hide_cursor) }
+      it { Vedeu::ToggleableTestClass.must_respond_to(:hide_group) }
+      it { Vedeu::ToggleableTestClass.must_respond_to(:hide_interface) }
     end
 
     describe '#show' do
@@ -42,11 +46,19 @@ module Vedeu
         subject
         instance.instance_variable_get('@visible').must_equal(true)
       }
+
+      it { Vedeu::ToggleableTestClass.must_respond_to(:show_cursor) }
+      it { Vedeu::ToggleableTestClass.must_respond_to(:show_group) }
+      it { Vedeu::ToggleableTestClass.must_respond_to(:show_interface) }
     end
 
     describe '#toggle' do
       subject { instance.toggle }
 
+      it { Vedeu::ToggleableTestClass.must_respond_to(:toggle_cursor) }
+      it { Vedeu::ToggleableTestClass.must_respond_to(:toggle_group) }
+      it { Vedeu::ToggleableTestClass.must_respond_to(:toggle_interface) }
+
       context 'when the model is visible' do
         let(:visible) { true }
 

data/test/lib/vedeu/null/geometry_test.rb

@@ -15,8 +15,6 @@ module Vedeu
       }
       let(:_name)     { 'null_geometry' }
 
-      before { Vedeu::Terminal.stubs(:size).returns([25, 40]) }
-
       describe '#initialize' do
         it { instance.must_be_instance_of(described) }
         it {
@@ -62,26 +60,38 @@ module Vedeu
       end
 
       describe '#height' do
+        before { Vedeu::Terminal.stubs(:size).returns([25, 40]) }
+
         it { instance.height.must_equal(25) }
       end
 
       describe '#width' do
+        before { Vedeu::Terminal.stubs(:size).returns([25, 40]) }
+
         it { instance.width.must_equal(40) }
       end
 
       describe '#x' do
+        before { Vedeu::Terminal.stubs(:size).returns([25, 40]) }
+
         it { instance.x.must_equal(1) }
       end
 
       describe '#xn' do
+        before { Vedeu::Terminal.stubs(:size).returns([25, 40]) }
+
         it { instance.xn.must_equal(40) }
       end
 
       describe '#y' do
+        before { Vedeu::Terminal.stubs(:size).returns([25, 40]) }
+
         it { instance.y.must_equal(1) }
       end
 
       describe '#yn' do
+        before { Vedeu::Terminal.stubs(:size).returns([25, 40]) }
+
         it { instance.yn.must_equal(25) }
       end
 

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

@@ -65,6 +65,10 @@ module Vedeu
       it { instance.instance_variable_get('@options').must_equal(options) }
     end
 
+    describe '#content' do
+      it { instance.must_respond_to(:content) }
+    end
+
     describe '#prune' do
       let(:text) { text_line }
 
@@ -184,8 +188,8 @@ module Vedeu
       end
     end
 
-    describe '#content' do
-      subject { instance.content }
+    describe '.for' do
+      subject { described.for(text, options) }
 
       it { subject.must_be_instance_of(Vedeu::Views::Lines) }
 

data/test/lib/vedeu/terminal/content_test.rb

@@ -53,12 +53,16 @@ module Vedeu
         let(:char) {}
 
         subject { described.store(char) }
+
+        it { subject.must_equal(char) }
       end
 
       describe '#stores' do
         let(:chars) {}
 
         subject { described.stores(chars) }
+
+        it { subject.must_equal([]) }
       end
 
       describe '#write' do
@@ -82,7 +86,11 @@ module Vedeu
       end
 
       describe '#reprocess' do
+        before { Vedeu::Terminal.stubs(:clear) }
+
         subject { described.reprocess }
+
+        it { subject.must_equal(['']) }
       end
 
       describe '#reset' do

data/test/support/average_duration_reporter.rb

@@ -0,0 +1,201 @@
+require 'yaml'
+
+module Minitest
+  module Reporters
+
+    class MeanTimeReporter < DefaultReporter
+
+      # @param options [Hash]
+      # @option previous_runs_filename [String] Contains the times for each test
+      #   by description. Defaults to '/tmp/minitest_reporters_previous_run'.
+      # @option report_filename [String] Contains the parsed results for the
+      #   last test run. Defaults to '/tmp/minitest_reporters_report'.
+      # @return [Minitest::Reporters::MeanTimeReporter]
+      def initialize(options = {})
+        super
+
+        @all_suite_times = []
+      end
+
+      # Copies the suite times from the
+      # {Minitest::Reporters::DefaultReporter#after_suite} method, making them
+      # available to this class.
+      #
+      # @return [Hash<String => Float>]
+      def after_suite(suite)
+        super
+
+        @all_suite_times = @suite_times
+      end
+
+      # Runs the {Minitest::Reporters::DefaultReporter#report} method and then
+      # enhances it by storing the results to the 'previous_runs_filename' and
+      # outputs the parsed results to both the 'report_filename' and the
+      # terminal.
+      #
+      def report
+        super
+
+        create_or_update_previous_runs!
+
+        create_new_report!
+      end
+
+      protected
+
+      attr_accessor :all_suite_times
+
+      private
+
+      # @return [Hash<String => Float>]
+      def current_run
+        Hash[all_suite_times]
+      end
+
+      # @return [Hash] Sets default values for the filenames used by this class.
+      def defaults
+        {
+          previous_runs_filename: '/tmp/minitest_reporters_previous_run',
+          report_filename:        '/tmp/minitest_reporters_report',
+        }
+      end
+
+      # Added to the top of the report file to be helpful.
+      #
+      # @return [String]
+      def report_header
+        "Samples: #{samples}\n\n"
+      end
+
+      # The report itself. Displays statistic about all runs, ideal for use with
+      # the Unix 'head' command. Listed in slowest average descending order.
+      #
+      # @return [String]
+      def report_body
+        previous_run.each_with_object([]) do |(description, timings), obj|
+          size = timings.size
+          sum  = timings.inject { |total, x| total + x }
+          avg  = (sum / size).round(9).to_s.ljust(12)
+          min  = timings.min.to_s.ljust(12)
+          max  = timings.max.to_s.ljust(12)
+
+          obj << "#{avg_label} #{avg} " \
+                 "#{min_label} #{min} " \
+                 "#{max_label} #{max} " \
+                 "#{des_label} #{description}\n"
+        end.sort.reverse.join
+      end
+
+      # @return [Hash]
+      def options
+        defaults.merge!(@options)
+      end
+
+      # @return [Hash<String => Array<Float>]
+      def previous_run
+        @previous_run ||= YAML.load_file(previous_runs_filename)
+      end
+
+      # @return [String] The path to the file which contains all the durations
+      #   for each test run. The previous runs file is in YAML format, using the
+      #   test name for the key and an array containing the time taken to run
+      #   this test for values.
+      #
+      # @return [String]
+      def previous_runs_filename
+        options[:previous_runs_filename]
+      end
+
+      # Returns a boolean indicating whether a previous runs file exists.
+      #
+      # @return [Boolean]
+      def previously_ran?
+        File.exist?(previous_runs_filename)
+      end
+
+      # @return [String] The path to the file which contains the parsed test
+      #   results. The results file contains a line for each test with the
+      #   average time of the test, the minimum time the test took to run,
+      #   the maximum time the test took to run and a description of the test
+      #   (which is the test name as emitted by Minitest).
+      def report_filename
+        options[:report_filename]
+      end
+
+      # A barbaric way to find out how many runs are in the previous runs file;
+      # this method takes the first test listed, and counts its samples
+      # trusting (naively) all runs to be the same number of samples. This will
+      # produce incorrect averages when new tests are added, so it is advised
+      # to restart the statistics by removing the 'previous runs' file.
+      #
+      # @return [Fixnum]
+      def samples
+        return 1 unless previous_run.first[1].is_a?(Array)
+
+        previous_run.first[1].size
+      end
+
+      # Creates a new 'previous runs' file, or updates the existing one with
+      # the latest timings.
+      #
+      # @return [void]
+      def create_or_update_previous_runs!
+        if previously_ran?
+          current_run.each do |description, elapsed|
+          new_times = if previous_run["#{description}"]
+                        Array(previous_run["#{description}"]) << elapsed
+
+                      else
+                        Array(elapsed)
+
+                      end
+
+            previous_run.store("#{description}", new_times)
+          end
+
+          File.write(previous_runs_filename, previous_run.to_yaml)
+
+        else
+
+          File.write(previous_runs_filename, current_run.to_yaml)
+
+        end
+      end
+
+      # Creates a new report file in the 'report_filename'. This file contains
+      # a line for each test of the following example format:
+      #
+      # Avg: 0.0555555 Min: 0.0498765 Max: 0.0612345 Description: The test name
+      #
+      # Note however the timings are to 9 decimal places, and padded to 12
+      # characters and each label is coloured, Avg (yellow), Min (green),
+      # Max (red) and Description (blue). It looks pretty!
+      #
+      # @return [void]
+      def create_new_report!
+        File.write(report_filename, report_header + report_body)
+      end
+
+      # @return [String] A yellow 'Avg:' label.
+      def avg_label
+        "\e[33mAvg:\e[39m"
+      end
+
+      # @return [String] A blue 'Description:' label.
+      def des_label
+        "\e[34mDescription:\e[39m"
+      end
+
+      # @return [String] A red 'Max:' label.
+      def max_label
+        "\e[31mMax:\e[39m"
+      end
+
+      # @return [String] A green 'Min:' label.
+      def min_label
+        "\e[32mMin:\e[39m"
+      end
+
+    end
+  end
+end

data/test/test_helper.rb

@@ -88,11 +88,15 @@ require 'vedeu'
 require 'support/helpers/model_test_class'
 
 # require 'minitest/reporters'
+# require 'support/average_duration_reporter'
 # Minitest::Reporters.use!(
-#  # commented out by default (makes tests slower)
-#  # Minitest::Reporters::DefaultReporter.new({ color: true,
-#  #                                            slow_suite_count: 3 }),
-#  # Minitest::Reporters::SpecReporter.new
+    # commented out by default (makes tests slower)
+    # Minitest::Reporters::MeanTimeReporter.new({
+    #   previous_runs_filename: "/tmp/reports/durations",
+    #   report_filename:        "/tmp/reports/durations_results"})
+    # Minitest::Reporters::DefaultReporter.new({ color: true,
+    #                                            slow_suite_count: 15 }),
+    # Minitest::Reporters::SpecReporter.new
 # )
 
 def test_configuration

data/vedeu.gemspec

@@ -23,7 +23,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'guard',              '2.13.0'
   spec.add_development_dependency 'guard-minitest',     '2.4.4'
   spec.add_development_dependency 'minitest',           '5.8.0'
-  spec.add_development_dependency 'minitest-reporters', '1.0.20'
+  spec.add_development_dependency 'minitest-reporters', '1.1.0'
   spec.add_development_dependency 'mocha',              '1.1.0'
   spec.add_development_dependency 'pry',                '0.10.1'
   spec.add_development_dependency 'rubocop',            '0.34.0'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vedeu
 version: !ruby/object:Gem::Version
-  version: 0.6.3
+  version: 0.6.4
 platform: ruby
 authors:
 - Gavin Laking
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.20
+        version: 1.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.20
+        version: 1.1.0
 - !ruby/object:Gem::Dependency
   name: mocha
   requirement: !ruby/object:Gem::Requirement
@@ -342,6 +342,7 @@ files:
 - lib/vedeu/geometry/area.rb
 - lib/vedeu/geometry/coordinate.rb
 - lib/vedeu/geometry/dimension.rb
+- lib/vedeu/geometry/generic_coordinate.rb
 - lib/vedeu/geometry/geometries.rb
 - lib/vedeu/geometry/geometry.rb
 - lib/vedeu/geometry/grid.rb
@@ -521,6 +522,7 @@ files:
 - test/lib/vedeu/geometry/area_test.rb
 - test/lib/vedeu/geometry/coordinate_test.rb
 - test/lib/vedeu/geometry/dimension_test.rb
+- test/lib/vedeu/geometry/generic_coordinate_test.rb
 - test/lib/vedeu/geometry/geometries_test.rb
 - test/lib/vedeu/geometry/geometry_test.rb
 - test/lib/vedeu/geometry/grid_test.rb
@@ -625,6 +627,7 @@ files:
 - test/lib/vedeu/terminal/terminal_test.rb
 - test/lib/vedeu_test.rb
 - test/support/all_seeds.sh
+- test/support/average_duration_reporter.rb
 - test/support/coverage.rb
 - test/support/helpers/model_test_class.rb
 - test/support/stats.sh
@@ -727,6 +730,7 @@ test_files:
 - test/lib/vedeu/geometry/area_test.rb
 - test/lib/vedeu/geometry/coordinate_test.rb
 - test/lib/vedeu/geometry/dimension_test.rb
+- test/lib/vedeu/geometry/generic_coordinate_test.rb
 - test/lib/vedeu/geometry/geometries_test.rb
 - test/lib/vedeu/geometry/geometry_test.rb
 - test/lib/vedeu/geometry/grid_test.rb
@@ -831,6 +835,7 @@ test_files:
 - test/lib/vedeu/terminal/terminal_test.rb
 - test/lib/vedeu_test.rb
 - test/support/all_seeds.sh
+- test/support/average_duration_reporter.rb
 - test/support/coverage.rb
 - test/support/helpers/model_test_class.rb
 - test/support/stats.sh