vedeu 0.8.9 → 0.8.10

data/lib/vedeu/renderers/options.rb

@@ -84,9 +84,7 @@ module Vedeu
         fail Vedeu::Error::NotImplemented, 'Including classes implement this.'
       end
 
-      # The default values for a new instance of this class.
-      #
-      # @return [Hash<Symbol => void>]
+      # @macro defaults_method
       def defaults
         {
           compression:   Vedeu.config.compression?,

data/lib/vedeu/repositories/defaults.rb

@@ -32,7 +32,7 @@ module Vedeu
 
       private
 
-      # @return [Hash<void>]
+      # @macro defaults_method
       def defaults
         {}
       end

data/lib/vedeu/repositories/model.rb

@@ -16,9 +16,8 @@ module Vedeu
       # @return [Vedeu::Repositories::Repository]
       attr_accessor :repository
 
-      # Provide additional behaviour as class methods.
-      #
-      module ClassMethods
+      # @macro module_singleton_methods
+      module SingletonMethods
 
         # @!attribute [r] repository
         # @return [Vedeu::Repositories::Repository]
@@ -64,11 +63,11 @@ module Vedeu
           new(attributes).store(&block)
         end
 
-      end # ClassMethods
+      end # SingletonMethods
 
-      # @macro included_module
+      # @macro module_included
       def self.included(klass)
-        klass.extend(Vedeu::Repositories::Model::ClassMethods)
+        klass.extend(Vedeu::Repositories::Model::SingletonMethods)
       end
 
       # @note If a block is given, store the model, return the model

data/lib/vedeu/repositories/registerable.rb

@@ -9,9 +9,8 @@ module Vedeu
     #
     module Registerable
 
-      # Provide additional behaviour as class methods.
-      #
-      module ClassMethods
+      # @macro module_singleton_methods
+      module SingletonMethods
 
         # The null model is used when the repository cannot be found.
         #
@@ -63,10 +62,9 @@ module Vedeu
         end
         alias reset reset!
 
-      end # ClassMethods
+      end # SingletonMethods
 
-      # Provide additional behaviour as instance methods.
-      #
+      # @macro module_instance_methods
       module InstanceMethods
 
         # @return [Boolean]
@@ -76,9 +74,9 @@ module Vedeu
 
       end # InstanceMethods
 
-      # @macro included_module
+      # @macro module_included
       def self.included(klass)
-        klass.extend(Vedeu::Repositories::Registerable::ClassMethods)
+        klass.extend(Vedeu::Repositories::Registerable::SingletonMethods)
         klass.include(Vedeu::Repositories::Registerable::InstanceMethods)
       end
 

data/lib/vedeu/runtime/flags.rb

@@ -6,7 +6,7 @@ module Vedeu
 
     # Home of various runtime flags which Vedeu uses.
     #
-    # @api public
+    # @api private
     #
     class Flags
 
@@ -55,7 +55,7 @@ module Vedeu
 
       private
 
-      # @return [Hash]
+      # @macro defaults_method
       def defaults
         {
           ready: false,

data/lib/vedeu/support/y_coordinate.rb

@@ -9,7 +9,7 @@ module Vedeu
   class YCoordinate
 
     # @param geometry [Vedeu::Geometries::Geometry]
-    # @return [Vedeu::XCoordinate]
+    # @return [Vedeu::YCoordinate]
     def initialize(geometry)
       @geometry = geometry
     end

data/lib/vedeu/version.rb

@@ -3,6 +3,6 @@
 module Vedeu
 
   # The current version of Vedeu.
-  VERSION = '0.8.9'.freeze
+  VERSION = '0.8.10'.freeze
 
 end

data/lib/vedeu/views/composition.rb

@@ -66,9 +66,7 @@ module Vedeu
 
       private
 
-      # The default values for a new instance of this class.
-      #
-      # @return [Hash]
+      # @macro defaults_method
       def defaults
         {
           client: nil,

data/lib/vedeu/views/default_attributes.rb

@@ -52,9 +52,7 @@ module Vedeu
 
       private
 
-      # The default values for a new instance of this class.
-      #
-      # @return [Hash<Symbol => Array<void>|NilClass>]
+      # @macro defaults_method
       def defaults
         {
           align:    nil,
@@ -67,7 +65,7 @@ module Vedeu
           truncate: false,
           value:    '',
           width:    nil,
-          wordwrap: false,
+          wordwrap: true,
         }
       end
 

data/lib/vedeu/views/value.rb

@@ -10,9 +10,8 @@ module Vedeu
     #
     module Value
 
-      # Provide additional behaviour as class methods.
-      #
-      module ClassMethods
+      # @macro module_singleton_methods
+      module SingletonMethods
 
         # @!attribute [w] collection_klass
         # @return [void]
@@ -54,10 +53,9 @@ module Vedeu
           @parent_klass = model
         end
 
-      end # ClassMethods
+      end # SingletonMethods
 
-      # Provide additional behaviour as instance methods.
-      #
+      # @macro module_instance_methods
       module InstanceMethods
 
         include Vedeu::Common
@@ -124,9 +122,9 @@ module Vedeu
 
       end # InstanceMethods
 
-      # @macro included_module
+      # @macro module_included
       def self.included(klass)
-        klass.extend(Vedeu::Views::Value::ClassMethods)
+        klass.extend(Vedeu::Views::Value::SingletonMethods)
         klass.include(Vedeu::Views::Value::InstanceMethods)
       end
 

data/lib/vedeu/views/view.rb

@@ -50,6 +50,11 @@ module Vedeu
       # @return [String|Symbol]
       attr_accessor :name
 
+      # @!attribute [rw] wordwrap
+      # @return [Boolean]
+      attr_accessor :wordwrap
+      alias_method :wordwrap?, :wordwrap
+
       # @!attribute [rw] zindex
       # @return [Fixnum]
       attr_accessor :zindex
@@ -64,6 +69,7 @@ module Vedeu
       # @option attributes name [String|Symbol]
       # @option attributes parent [Vedeu::Views::Composition]
       # @option attributes style [Vedeu::Presentation::Style]
+      # @option attributes wordwrap [Boolean]
       # @option attributes zindex [Fixnum]
       # @return [Vedeu::Views::View]
       def initialize(attributes = {})
@@ -89,6 +95,7 @@ module Vedeu
           parent:         parent,
           style:          style,
           value:          value,
+          wordwrap:       wordwrap,
           zindex:         zindex,
         }
       end
@@ -142,9 +149,7 @@ module Vedeu
         Vedeu.buffers.by_name(name)
       end
 
-      # The default values for a new instance of this class.
-      #
-      # @return [Hash]
+      # @macro defaults_method
       def defaults
         {
           client:         nil,
@@ -154,6 +159,7 @@ module Vedeu
           parent:         nil,
           style:          :normal,
           value:          [],
+          wordwrap:       true,
           zindex:         0,
         }
       end

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

@@ -12,8 +12,9 @@ module Vedeu
 
   describe ApplicationHelper do
 
-    let(:described) { Vedeu::ApplicationHelper }
-    let(:instance)  { Vedeu::ApplicationHelperTestClass.new }
+    let(:described)          { Vedeu::ApplicationHelper }
+    let(:included_described) { Vedeu::ApplicationHelperTestClass }
+    let(:included_instance)  { included_described.new }
 
     # @todo Add more tests.
 

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

@@ -4,7 +4,7 @@ require 'test_helper'
 
 module Vedeu
 
-  class ControllerTestKlass
+  class ControllerTestClass
 
     include Vedeu::Controller
 
@@ -15,21 +15,20 @@ module Vedeu
 
   describe Controller do
 
-    let(:described) { Vedeu::Controller }
-    let(:described_model) { Vedeu::ControllerTestKlass }
-    let(:instance_model)  { described.new }
+    let(:described)          { Vedeu::Controller }
+    let(:included_described) { Vedeu::ControllerTestClass }
 
-    it { described_model.must_respond_to(:controller_name) }
-    it { described_model.must_respond_to(:action_name) }
-    it { described_model.must_respond_to(:controller) }
-    it { described_model.must_respond_to(:action) }
+    it { included_described.must_respond_to(:controller_name) }
+    it { included_described.must_respond_to(:action_name) }
+    it { included_described.must_respond_to(:controller) }
+    it { included_described.must_respond_to(:action) }
 
     describe '.controller' do
-      subject { described_model.controller(:some_controller) }
+      subject { included_described.controller(:some_controller) }
 
       it do
         Vedeu::Runtime::Router.expects(:add_controller).
-          with(:some_controller, 'Vedeu::ControllerTestKlass')
+          with(:some_controller, 'Vedeu::ControllerTestClass')
         subject
       end
 
@@ -37,7 +36,7 @@ module Vedeu
     end
 
     describe '.action' do
-      subject { described_model.action(:some_action, :other_action) }
+      subject { included_described.action(:some_action, :other_action) }
 
       it do
         Vedeu::Runtime::Router.expects(:add_action).

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

@@ -12,8 +12,9 @@ module Vedeu
 
   describe Helper do
 
-    let(:described) { Vedeu::HelperTestClass }
-    let(:instance)  { described.new }
+    let(:described)          { Vedeu::Helper }
+    let(:included_described) { Vedeu::HelperTestClass }
+    let(:included_instance)  { included_described.new }
 
     # @todo Add more tests.
 

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

@@ -12,15 +12,16 @@ module Vedeu
 
   describe View do
 
-    let(:described) { Vedeu::ViewTestClass }
-    let(:instance)  { described.new }
+    let(:described)          { Vedeu::View }
+    let(:included_described) { Vedeu::ViewTestClass }
+    let(:included_instance)  { included_described.new }
 
     describe '#time_now' do
       let(:_time) { Time.new(2015, 6, 23, 22, 25, 17) }
 
       before { Time.stubs(:now).returns(_time) }
 
-      subject { instance.time_now }
+      subject { included_instance.time_now }
 
       it 'returns a formatted time' do
         subject.must_equal('Tue 23 Jun 22:25')

data/test/lib/vedeu/coercers/editor_line_test.rb

@@ -31,6 +31,27 @@ module Vedeu
           it { subject.must_be_instance_of(klass) }
           it { subject.must_equal(_value) }
         end
+
+        context 'when the value is a String' do
+          context 'when the value is empty' do
+            let(:_value) { '' }
+
+            it { subject.must_be_instance_of(klass) }
+            it { subject.collection.must_equal('') }
+          end
+
+          context 'when the value is an String' do
+            let(:_value) { 'some value...' }
+
+            it { subject.must_be_instance_of(klass) }
+            it { subject.collection.must_equal(_value) }
+          end
+        end
+
+        context 'when the value is not already the target class or ' \
+                'a string' do
+          it { subject.must_be_instance_of(klass) }
+        end
       end
 
     end # EditorLine

data/test/lib/vedeu/coercers/editor_lines_test.rb

@@ -31,6 +31,47 @@ module Vedeu
           it { subject.must_be_instance_of(klass) }
           it { subject.must_equal(_value) }
         end
+
+        context 'when the value is an Array' do
+          context 'when the value is empty' do
+            let(:_value) { [] }
+
+            it { subject.collection.must_equal([]) }
+          end
+
+          context 'when the value is not empty' do
+            let(:_value) {
+              [
+                Vedeu::Editor::Line.new('Some text...'),
+                :more_text,
+                'Other text...',
+              ]
+            }
+            let(:expected) {
+              [
+                Vedeu::Editor::Line.new('Some text...'),
+                Vedeu::Editor::Line.new(''),
+                Vedeu::Editor::Line.new('Other text...'),
+              ]
+            }
+
+            it { subject.collection.must_equal(expected) }
+          end
+        end
+
+        context 'when the value is a String' do
+          let(:_value) { "Some text...\nMore text..." }
+
+          context 'but it is empty' do
+            let(:_value) { '' }
+
+            it { subject.must_equal(Vedeu::Editor::Lines.new) }
+          end
+
+          context 'but it has no line breaks' do
+            # @todo Add more tests.
+          end
+        end
       end
 
     end # EditorLines

data/test/lib/vedeu/coercers/page_test.rb

@@ -38,7 +38,7 @@ module Vedeu
 
         subject { described.coerce(_value) }
 
-        it { proc { subject }.must_raise(Vedeu::Error::InvalidSyntax) }
+        it { proc { subject }.must_raise(Vedeu::Error::Fatal) }
 
         context 'when the value is a Vedeu::Models::Row' do
           let(:_value)   { Vedeu::Models::Row.new }

data/test/lib/vedeu/cursors/dsl_test.rb

@@ -24,27 +24,28 @@ module Vedeu
 
     describe DSL do
 
-      let(:described) { Vedeu::Cursors::DSL }
-      let(:instance)  { Vedeu::Cursors::DSLTestClass.new }
+      let(:described)          { Vedeu::Cursors::DSL }
+      let(:included_described) { Vedeu::Cursors::DSLTestClass }
+      let(:included_instance)  { included_described.new }
 
       describe '#cursor' do
-        it { instance.must_respond_to(:cursor) }
+        it { included_instance.must_respond_to(:cursor) }
       end
 
       describe '#cursor!' do
-        it { instance.must_respond_to(:cursor!) }
+        it { included_instance.must_respond_to(:cursor!) }
       end
 
       describe '#show_cursor!' do
-        it { instance.must_respond_to(:show_cursor!) }
+        it { included_instance.must_respond_to(:show_cursor!) }
       end
 
       describe '#no_cursor!' do
-        it { instance.must_respond_to(:no_cursor!) }
+        it { included_instance.must_respond_to(:no_cursor!) }
       end
 
       describe '#hide_cursor!' do
-        it { instance.must_respond_to(:hide_cursor!) }
+        it { included_instance.must_respond_to(:hide_cursor!) }
       end
 
       # describe '#cursor' do
@@ -56,7 +57,7 @@ module Vedeu
       #     Vedeu.cursors.stubs(:by_name).returns(cursor)
       #   end
 
-      #   subject { instance.cursor(_value) }
+      #   subject { included_instance.cursor(_value) }
 
       #   it do
       #     subject
@@ -110,7 +111,7 @@ module Vedeu
       # end
 
       describe '#cursor!' do
-        subject { instance.cursor! }
+        subject { included_instance.cursor! }
 
         it do
           subject
@@ -119,7 +120,7 @@ module Vedeu
       end
 
       describe '#no_cursor!' do
-        subject { instance.no_cursor! }
+        subject { included_instance.no_cursor! }
 
         it do
           subject