vedeu 0.6.9 → 0.6.10

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vedeu
 version: !ruby/object:Gem::Version
-  version: 0.6.9
+  version: 0.6.10
 platform: ruby
 authors:
 - Gavin Laking
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-09-16 00:00:00.000000000 Z
+date: 2015-09-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: guard
@@ -252,7 +252,8 @@ files:
 - docs/object_graph.md
 - lib/vedeu.rb
 - lib/vedeu/all.rb
-- lib/vedeu/api.rb
+- lib/vedeu/api/external.rb
+- lib/vedeu/api/internal.rb
 - lib/vedeu/application/application_controller.rb
 - lib/vedeu/application/application_helper.rb
 - lib/vedeu/application/application_view.rb
@@ -280,8 +281,6 @@ files:
 - lib/vedeu/buffers/null.rb
 - lib/vedeu/buffers/refresh.rb
 - lib/vedeu/buffers/repository.rb
-- lib/vedeu/buffers/virtual_buffer.rb
-- lib/vedeu/buffers/virtual_buffers.rb
 - lib/vedeu/colours/all.rb
 - lib/vedeu/colours/background.rb
 - lib/vedeu/colours/backgrounds.rb
@@ -364,7 +363,6 @@ files:
 - lib/vedeu/input/keys.rb
 - lib/vedeu/input/mapper.rb
 - lib/vedeu/input/translator.rb
-- lib/vedeu/internal_api.rb
 - lib/vedeu/logging/all.rb
 - lib/vedeu/logging/debug.rb
 - lib/vedeu/logging/lockless_log_device.rb
@@ -447,11 +445,13 @@ files:
 - lib/vedeu/templating/helpers.rb
 - lib/vedeu/templating/template.rb
 - lib/vedeu/templating/view_template.rb
-- lib/vedeu/terminal/content.rb
+- lib/vedeu/terminal/buffer.rb
 - lib/vedeu/terminal/mode.rb
 - lib/vedeu/terminal/terminal.rb
 - lib/vedeu/version.rb
-- test/lib/vedeu/api_test.rb
+- out_
+- test/lib/vedeu/api/external_test.rb
+- test/lib/vedeu/api/internal_test.rb
 - test/lib/vedeu/application/application_controller_test.rb
 - test/lib/vedeu/application/application_helper_test.rb
 - test/lib/vedeu/application/application_view_test.rb
@@ -477,8 +477,6 @@ files:
 - test/lib/vedeu/buffers/null_test.rb
 - test/lib/vedeu/buffers/refresh_test.rb
 - test/lib/vedeu/buffers/repository_test.rb
-- test/lib/vedeu/buffers/virtual_buffer_test.rb
-- test/lib/vedeu/buffers/virtual_buffers_test.rb
 - test/lib/vedeu/colours/background_test.rb
 - test/lib/vedeu/colours/backgrounds_test.rb
 - test/lib/vedeu/colours/colour_test.rb
@@ -546,7 +544,6 @@ files:
 - test/lib/vedeu/input/keys_test.rb
 - test/lib/vedeu/input/mapper_test.rb
 - test/lib/vedeu/input/translator_test.rb
-- test/lib/vedeu/internal_api_test.rb
 - test/lib/vedeu/logging/debug_test.rb
 - test/lib/vedeu/logging/lockless_log_device_test.rb
 - test/lib/vedeu/logging/log_test.rb
@@ -624,7 +621,7 @@ files:
 - test/lib/vedeu/templating/helpers_test.rb
 - test/lib/vedeu/templating/template_test.rb
 - test/lib/vedeu/templating/view_template_test.rb
-- test/lib/vedeu/terminal/content_test.rb
+- test/lib/vedeu/terminal/buffer_test.rb
 - test/lib/vedeu/terminal/mode_test.rb
 - test/lib/vedeu/terminal/terminal_test.rb
 - test/lib/vedeu_test.rb
@@ -650,6 +647,7 @@ files:
 - test/support/examples/view_templates_app/wrap.erb
 - test/support/helpers/model_test_class.rb
 - test/support/stats.sh
+- test/support/templates/html_renderer.vedeu
 - test/test_helper.rb
 - vedeu.gemspec
 homepage: https://github.com/gavinlaking/vedeu
@@ -677,7 +675,8 @@ signing_key:
 specification_version: 4
 summary: A terminal case of wonderland.
 test_files:
-- test/lib/vedeu/api_test.rb
+- test/lib/vedeu/api/external_test.rb
+- test/lib/vedeu/api/internal_test.rb
 - test/lib/vedeu/application/application_controller_test.rb
 - test/lib/vedeu/application/application_helper_test.rb
 - test/lib/vedeu/application/application_view_test.rb
@@ -703,8 +702,6 @@ test_files:
 - test/lib/vedeu/buffers/null_test.rb
 - test/lib/vedeu/buffers/refresh_test.rb
 - test/lib/vedeu/buffers/repository_test.rb
-- test/lib/vedeu/buffers/virtual_buffer_test.rb
-- test/lib/vedeu/buffers/virtual_buffers_test.rb
 - test/lib/vedeu/colours/background_test.rb
 - test/lib/vedeu/colours/backgrounds_test.rb
 - test/lib/vedeu/colours/colour_test.rb
@@ -772,7 +769,6 @@ test_files:
 - test/lib/vedeu/input/keys_test.rb
 - test/lib/vedeu/input/mapper_test.rb
 - test/lib/vedeu/input/translator_test.rb
-- test/lib/vedeu/internal_api_test.rb
 - test/lib/vedeu/logging/debug_test.rb
 - test/lib/vedeu/logging/lockless_log_device_test.rb
 - test/lib/vedeu/logging/log_test.rb
@@ -850,7 +846,7 @@ test_files:
 - test/lib/vedeu/templating/helpers_test.rb
 - test/lib/vedeu/templating/template_test.rb
 - test/lib/vedeu/templating/view_template_test.rb
-- test/lib/vedeu/terminal/content_test.rb
+- test/lib/vedeu/terminal/buffer_test.rb
 - test/lib/vedeu/terminal/mode_test.rb
 - test/lib/vedeu/terminal/terminal_test.rb
 - test/lib/vedeu_test.rb
@@ -876,5 +872,6 @@ test_files:
 - test/support/examples/view_templates_app/wrap.erb
 - test/support/helpers/model_test_class.rb
 - test/support/stats.sh
+- test/support/templates/html_renderer.vedeu
 - test/test_helper.rb
 has_rdoc: 

data/lib/vedeu/api.rb

@@ -1,190 +0,0 @@
-module Vedeu
-
-  # Provides the API to Vedeu. Methods therein, and classes belonging
-  # to this module expose Vedeu's core functionality.
-  #
-  # These methods are used in a variety of ways, sometimes in
-  # combination:
-  #
-  #   # with parameters
-  #   Vedeu.method_name(*params)
-  #
-  #   # with a block
-  #   Vedeu.method_name(*params) do
-  #     # ...
-  #   end
-  #
-  #   # with other methods
-  #   Vedeu.method_name.other_method
-  #
-  module API
-
-    extend Forwardable
-
-    module_function
-
-    # @!method configure
-    #   @see Vedeu::Configuration.configure
-    # @!method configuration
-    #   @see Vedeu::Configuration.configuration
-    def_delegators Vedeu::Configuration, :configure, :configuration
-
-    # @!method cursor
-    # @return [Vedeu::Cursors::Cursor]
-    def_delegators Vedeu::Cursors::Repository, :cursor
-
-    # @!method drb_restart
-    #   @see Vedeu::Distributed::Server#restart
-    # @!method drb_start
-    #   @see Vedeu::Distributed::Server#start
-    # @!method drb_status
-    #   @see Vedeu::Distributed::Server#status
-    # @!method drb_stop
-    #   @see Vedeu::Distributed::Server#stop
-    def_delegators Vedeu::Distributed::Server, :drb_restart, :drb_start,
-                   :drb_status, :drb_stop
-
-    # @!method border
-    #   @see Vedeu::Borders::DSL.border
-    def_delegators Vedeu::Borders::DSL, :border
-
-    # @!method geometry
-    #   @see Vedeu::Geometry::DSL.geometry
-    def_delegators Vedeu::Geometry::DSL, :geometry
-
-    # @!method group
-    #   @see Vedeu::DSL::Group.group
-    def_delegators Vedeu::DSL::Group, :group
-
-    # @!method keymap
-    #   @see Vedeu::DSL::Keymap.keymap
-    def_delegators Vedeu::DSL::Keymap, :keymap
-
-    # @!method interface
-    #   @see Vedeu::DSL::Interface.interface
-    def_delegators Vedeu::DSL::Interface, :interface
-
-    # @!method render
-    #   @see Vedeu::DSL::View.render
-    # @!method renders
-    #   @see Vedeu::DSL::View.renders
-    # @!method views
-    #   @see Vedeu::DSL::View.views
-    def_delegators Vedeu::DSL::View, :renders, :render, :views
-
-    # @!method bind
-    #   @see Vedeu::Events::Event.bind
-    # @!method bound?
-    #   @see Vedeu::Events::Event.bound?
-    # @!method unbind
-    #   @see Vedeu::Events::Event.unbind
-    def_delegators Vedeu::Events::Event, :bind, :bound?, :unbind
-
-    # @!method bind_alias
-    #   @see Vedeu::Events::Aliases#bind_alias
-    # @!method unbind_alias
-    #   @see Vedeu::Events::Aliases#unbind_alias
-    def_delegators Vedeu::Events::Aliases, :bind_alias, :unbind_alias
-
-    # @!method focus
-    #   @see Vedeu::Models::Focus#focus
-    # @!method focus_by_name
-    #   @see Vedeu::Models::Focus#focus_by_name
-    # @!method focussed?
-    #   @see Vedeu::Models::Focus#focussed?
-    # @!method focus_next
-    #   @see Vedeu::Models::Focus#focus_next
-    # @!method focus_previous
-    #   @see Vedeu::Models::Focus#focus_previous
-    def_delegators Vedeu::Models::Focus, :focus, :focus_by_name, :focussed?,
-                   :focus_next, :focus_previous
-
-    # @!method log
-    #   @see Vedeu::Logging::Log.log
-    # @!method log_stdout
-    #   @see Vedeu::Logging::Log.log_stdout
-    # @!method log_stderr
-    #   @see Vedeu::Logging::Log.log_stderr
-    def_delegators Vedeu::Logging::Log, :log, :log_stdout, :log_stderr
-
-    # @!method keypress
-    #   @see Vedeu::Input::Mapper.keypress
-    def_delegators Vedeu::Input::Mapper, :keypress
-
-    # @!method menu
-    #   @see Vedeu::Menus::Menu.menu
-    def_delegators Vedeu::Menus::Menu, :menu
-
-    # @!method goto
-    #   @see Vedeu::Router#goto
-    def_delegators Vedeu::Router, :goto
-
-    # @!method height
-    #   @see Vedeu::Terminal#height
-    def_delegators Vedeu::Terminal, :height
-
-    # @!method width
-    #   @see Vedeu::Terminal#width
-    def_delegators Vedeu::Terminal, :width
-
-    # @!method trigger
-    #   @see Vedeu::Events::Trigger.trigger
-    def_delegators Vedeu::Events::Trigger, :trigger
-
-    # @!method exit
-    #   @see Vedeu::Runtime::Application.stop
-    def_delegators Vedeu::Runtime::Application, :exit
-
-    # @!method clear
-    #   @see Vedeu::Terminal#clear
-    def_delegators Vedeu::Terminal, :clear
-
-    # @!method clear_by_name
-    #   @see Vedeu::Clear::NamedInterface.render
-    def_delegators Vedeu::Clear::NamedInterface, :clear_by_name
-
-    # @!method clear_by_group
-    #   @see Vedeu::Clear::NamedGroup.render
-    def_delegators Vedeu::Clear::NamedGroup, :clear_by_group
-
-    # @!method hide_cursor
-    #   @see Vedeu::Cursors::Cursor#hide
-    def_delegators Vedeu::Cursors::Cursor, :hide_cursor
-
-    # @!method show_cursor
-    #   @see Vedeu::Cursors::Cursor#show
-    def_delegators Vedeu::Cursors::Cursor, :show_cursor
-
-    # @!method toggle_cursor
-    #   @see Vedeu::Cursors::Cursor#toggle
-    def_delegators Vedeu::Cursors::Cursor, :toggle_cursor
-
-    # @!method hide_group
-    #   @see Vedeu::Models::Group#hide
-    def_delegators Vedeu::Models::Group, :hide_group
-
-    # @!method show_group
-    #   @see Vedeu::Models::Group#show
-    def_delegators Vedeu::Models::Group, :show_group
-
-    # @!method toggle_group
-    #   @see Vedeu::Models::Group#toggle
-    def_delegators Vedeu::Models::Group, :toggle_group
-
-    # @!method hide_interface
-    #   @see Vedeu::Models::Interface#hide
-    def_delegators Vedeu::Models::Interface, :hide_interface
-
-    # @!method show_interface
-    #   @see Vedeu::Models::Interface#show
-    def_delegators Vedeu::Models::Interface, :show_interface
-
-    # @!method toggle_interface
-    #   @see Vedeu::Models::Interface#toggle
-    def_delegators Vedeu::Models::Interface, :toggle_interface
-
-  end # API
-
-  extend API
-
-end # Vedeu

data/lib/vedeu/buffers/virtual_buffer.rb

@@ -1,136 +0,0 @@
-module Vedeu
-
-  module Buffers
-
-    # Represents a {Vedeu::Terminal} view as a grid of
-    # {Vedeu::Models::Cell} objects.
-    #
-    class VirtualBuffer
-
-      # @!attribute [rw] renderer
-      # @return [void]
-      attr_accessor :renderer
-
-      # @!attribute [r] height
-      # @return [Fixnum]
-      attr_reader :height
-
-      # @!attribute [r] width
-      # @return [Fixnum]
-      attr_reader :width
-
-      # @param data [Array<Array<Vedeu::Views::Char>>]
-      # @return [Array<Array<Vedeu::Views::Char>>]
-      # @see Vedeu::Buffers::VirtualBuffer#output
-      def self.output(data)
-        new(Vedeu.height, Vedeu.width, Vedeu::Renderers::HTML.new).output(data)
-      end
-
-      # Returns a new instance of Vedeu::Buffers::VirtualBuffer.
-      #
-      # @param height [Fixnum]
-      # @param width [Fixnum]
-      # @param renderer [Object|Vedeu::Renderers::HTML] An object
-      #   responding to .render.
-      # @return [Vedeu::Buffers::VirtualBuffer]
-      def initialize(height, width, renderer = Vedeu::Renderers::HTML.new)
-        @height   = height
-        @width    = width
-        @renderer = renderer
-      end
-
-      # Return a grid of {Vedeu::Views::Char} objects defined by the
-      # height and width of this virtual terminal.
-      #
-      # @return [Array<Array<Vedeu::Views::Char>>]
-      def cells
-        @cells ||= new_virtual_buffer
-      end
-
-      # Read a single cell from the virtual terminal.
-      #
-      # @note
-      #   Given two actual coordinates (y, x) e.g. (1, 1)
-      #   Convert to coordinate indices (cy, cx) e.g. (0, 0)
-      #   Fetch the row at cy and return the cell from cx
-      #
-      # @param y [Fixnum] The row/line coordinate.
-      # @param x [Fixnum] The column/character coordinate.
-      # @return [Vedeu::Views::Char]
-      def read(y, x)
-        cy, cx = Vedeu::Geometry::Position[y, x].as_indices
-
-        row  = fetch(cells, cy)
-        cell = fetch(row, cx)
-
-        cell
-      end
-
-      # Write a collection of cells to the virtual terminal.
-      #
-      # @param data [Array<Array<Vedeu::Views::Char>>]
-      # @return [Array<Array<Vedeu::Views::Char>>]
-      def output(data)
-        Array(data).flatten.each do |char|
-          write(char.y, char.x, char) if char.is_a?(Vedeu::Views::Char)
-        end
-
-        cells
-      end
-
-      # Send the cells to the renderer and return the rendered result.
-      #
-      # @return [String|void] Most likely to be a String.
-      def render
-        renderer.render(cells)
-      end
-
-      # Removes all content from the virtual terminal; effectively
-      # clearing it.
-      #
-      # @return [Array<Array<Vedeu::Views::Char>>]
-      def reset
-        @cells = new_virtual_buffer
-      end
-      alias_method :clear, :reset
-
-      # Write a single cell to the virtual terminal.
-      #
-      # @note
-      #   If the position (y, x) is nil; we're out of bounds.
-      #   Otherwise, write the data to (cy, cx).
-      #
-      # @param y [Fixnum] The row/line coordinate.
-      # @param x [Fixnum] The column/character coordinate.
-      # @param data [Vedeu::Views::Char]
-      # @return [Vedeu::Views::Char]
-      def write(y, x, data)
-        return false unless read(y, x).is_a?(Vedeu::Models::Cell)
-
-        cy, cx = Vedeu::Geometry::Position[y, x].as_indices
-        cells[cy][cx] = data
-
-        true
-      end
-
-      private
-
-      # @param from [Array] An Array of rows, or an Array of cells.
-      # @param which [Fixnum] A Fixnum representing the index; the row
-      #   number or the cell number for a row.
-      # @return [Array<Vedeu::Views::Char>|Array]
-      def fetch(from, which)
-        from[which] || []
-      end
-
-      # @return [Array<Array<Vedeu::Models::Cell>>]
-      # @see Vedeu::Buffers::VirtualBuffer#cells
-      def new_virtual_buffer
-        Array.new(height) { Array.new(width) { Vedeu::Models::Cell.new } }
-      end
-
-    end # VirtualBuffer
-
-  end # Buffers
-
-end # Vedeu

data/lib/vedeu/buffers/virtual_buffers.rb

@@ -1,77 +0,0 @@
-module Vedeu
-
-  module Buffers
-
-    # Store and retrieve {Vedeu::Buffers::VirtualBuffer} objects.
-    #
-    # Each {Vedeu::Buffers::VirtualBuffer} object is a copy of the
-    # current terminal including content but not as String objects but
-    # {Vedeu::Views::Char} objects. Using {Vedeu::Views::Char} objects
-    # means that we can store the data used to make up the displayed
-    # character, complete with its colour, position and style.
-    #
-    # Once a {Vedeu::Views::Char} has been converted to a String, it
-    # is tricky to separate the escape sequences and string data. By
-    # deferring this conversion we can display the
-    # {Vedeu::Views::Char} in multiple ways (e.g. HTML) or in multiple
-    # formats (e.g. JSON), and render/use that in an appropriate way.
-    #
-    module VirtualBuffers
-
-      extend self
-
-      # Fetch the oldest stored virtual buffer first.
-      #
-      # @return [Array<Array<Vedeu::Views::Char>>|NilClass]
-      def retrieve
-        Vedeu.log(type: :drb, message: 'Retrieving output')
-
-        storage.pop
-      end
-
-      # Store a new virtual buffer.
-      #
-      # @return [Array<Array<Vedeu::Views::Char>>]
-      def store(data)
-        Vedeu.log(type: :drb, message: 'Storing output')
-
-        storage.unshift(data)
-      end
-
-      # Return the number of virtual buffers currently stored.
-      #
-      # @return [Fixnum]
-      def size
-        storage.size
-      end
-
-      # Destroy all virtual buffers currently stored.
-      #
-      # @return [Array]
-      def clear
-        @storage = in_memory
-      end
-      alias_method :reset, :clear
-
-      private
-
-      # Access to the storage for this repository.
-      #
-      # @return [Array]
-      def storage
-        @storage ||= in_memory
-      end
-
-      # Returns an empty collection ready for the storing of virtual
-      # buffers.
-      #
-      # @return [Array]
-      def in_memory
-        []
-      end
-
-    end # VirtualBuffers
-
-  end # Buffers
-
-end # Vedeu

data/lib/vedeu/internal_api.rb

@@ -1,173 +0,0 @@
-module Vedeu
-
-  # Vedeu's internal API methods provide convenient ways to access
-  # Vedeu's internals. They are not supposed to be used by client
-  # applications as they have limited value there.
-  #
-  module InternalAPI
-
-    extend Forwardable
-
-    module_function
-
-    # Manipulate the repository of background colours.
-    #
-    # @example
-    #   Vedeu.background_colours
-    #
-    # @!method background_colours
-    # @return [Vedeu::Colours::Backgrounds]
-    def_delegators Vedeu::Colours::Backgrounds, :background_colours
-
-    # Manipulate the repository of borders.
-    #
-    # @example
-    #   Vedeu.borders
-    #
-    # @!method borders
-    # @return [Vedeu::Borders::Repository]
-    def_delegators Vedeu::Borders::Repository, :borders
-
-    # Manipulate the repository of buffers.
-    #
-    # @example
-    #   Vedeu.buffers
-    #
-    # @!method buffers
-    # @return [Vedeu::Buffers::Repository]
-    def_delegators Vedeu::Buffers::Repository, :buffers
-
-    # Manipulate the repository of cursors.
-    #
-    # @example
-    #   Vedeu.cursors
-    #
-    # @!method cursors
-    # @return [Vedeu::Cursors::Repository]
-    def_delegators Vedeu::Cursors::Repository, :cursors
-
-    # Allow debugging via the creation of stack traces courtesy of
-    # ruby-prof.
-    #
-    # @example
-    #   Vedeu.debug
-    #
-    # @!method debug
-    # @return [Vedeu::Logging::Debug]
-    def_delegators Vedeu::Logging::Debug, :debug
-
-    # Manipulate the repository of documents.
-    #
-    # @example
-    #   Vedeu.documents
-    #
-    # @!method documents
-    # @return [Vedeu::Editor::Documents]
-    def_delegators Vedeu::Editor::Documents, :documents
-
-    # Manipulate the repository of events.
-    #
-    # @example
-    #   Vedeu.events
-    #
-    # @!method events
-    # @return [Vedeu::Events::Repository]
-    def_delegators Vedeu::Events::Repository, :events
-
-    # Manipulate the repository of foreground colours.
-    #
-    # @example
-    #   Vedeu.foreground_colours
-    #
-    # @!method foreground_colours
-    # @return [Vedeu::Colours::Foregrounds]
-    def_delegators Vedeu::Colours::Foregrounds, :foreground_colours
-
-    # Manipulate the repository of geometries.
-    #
-    # @example
-    #   Vedeu.geometries
-    #
-    # @!method geometries
-    # @return [Vedeu::Geometry::Repository]
-    def_delegators Vedeu::Geometry::Repository, :geometries
-
-    # Manipulate the repository of groups.
-    #
-    # @example
-    #   Vedeu.groups
-    #
-    # @!method groups
-    # @return [Vedeu::Models::Groups]
-    def_delegators Vedeu::Models::Groups, :groups
-
-    # Manipulate the repository of interfaces.
-    #
-    # @example
-    #   Vedeu.interfaces
-    #
-    # @!method interfaces
-    # @return [Vedeu::Models::Interfaces]
-    def_delegators Vedeu::Models::Interfaces, :interfaces
-
-    # Manipulate the repository of keymaps.
-    #
-    # @example
-    #   Vedeu.keymaps
-    #
-    # @!method keymaps
-    # @return [Vedeu::Input::Keymaps]
-    def_delegators Vedeu::Input::Keymaps, :keymaps
-
-    # Manipulate the repository of menus.
-    #
-    # @example
-    #   Vedeu.menus
-    #
-    # @!method menus
-    # @return [Vedeu::Menus::Repository]
-    def_delegators Vedeu::Menus::Repository, :menus
-
-    # Manipulate the internal flags.
-    #
-    # @!method ready?
-    # @!method ready!
-    # @return [Boolean]
-    def_delegators Vedeu::Runtime::Flags, :ready?, :ready!
-
-    # @example
-    #   Vedeu.renderer
-    #   Vedeu.renderers
-    #
-    # @!method renderer
-    #   @see Vedeu::Renderers#renderer
-    # @!method renderers
-    #   @see Vedeu::Renderers#renderers
-    def_delegators Vedeu::Renderers, :renderer, :renderers
-
-    # Instruct the terminal to resize. This will happen automatically
-    # as the terminal recieves SIGWINCH signals.
-    #
-    # @example
-    #   Vedeu.resize
-    #
-    # @!method resize
-    #   @see Vedeu::Terminal#resize
-    def_delegators Vedeu::Terminal, :resize
-
-    # Measure the execution time of the code in the given block.
-    #
-    # @example
-    #   Vedeu.timer do
-    #     # ... some code here ...
-    #   end
-    #
-    # @!method timer
-    #   @see Vedeu::Logging::Timer.timer
-    def_delegators Vedeu::Logging::Timer, :timer
-
-  end # InternalAPI
-
-  extend InternalAPI
-
-end # Vedeu