rbcurse 0.1.3 → 1.1.1

data/lib/rbcurse/rmultitextview.rb

@@ -0,0 +1,306 @@
+=begin
+  * Name: MultiTextView 
+  * Description   View text in this widget for multiple files
+  * This differs from multicontainer in that since all components are textviews, so they
+  * are all gauranteed to be non-editable and thus we can map many more keys.
+  * MultiContainer can only map Ctrl and Alt (Meta) keys.
+  * Author: rkumar (arunachalesha)
+  * file created 2010-03-11 08:05 
+  --------
+  * License:
+    Same as Ruby's License (http://www.ruby-lang.org/LICENSE.txt)
+
+=end
+require 'rubygems'
+require 'ncurses'
+require 'logger'
+require 'rbcurse'
+require 'rbcurse/rtextview'
+require 'rbcurse/listscrollable'
+
+include Ncurses
+include RubyCurses
+module RubyCurses
+  extend self
+
+  ##
+  # A viewable read only box. Can scroll. 
+  # Extends TextView with ability to load more than one file or content
+  # and switch between files (buffers).
+  # NOTE: ideally, i should be able to dynamically add this functionality to either Textview
+  # or TextArea or even ListBox or Table someday. Should then be a Module rather than a class.
+  class MultiTextView < TextView
+    include ListScrollable
+
+    def initialize form = nil, config={}, &block
+
+      super
+      @bmanager = BufferManager.new self
+
+    end
+    def init_vars
+      super
+      bind_key(?:, :buffer_menu)
+      bind_key(?e, :file_edit)
+      bind_key([?\C-x, ?f], :file_edit)
+      bind_key([?\C-x, ?k], :buffer_delete)
+      bind_key([?\C-x, ?\C-b], :buffers_list)
+      # easily cycle using p. n is used for next search.
+      bind_key(?p, :buffer_previous)
+    end
+    ## returns current buffer
+    # @return  [RBuffer] current buffer
+    def current_buffer
+      @bmanager.current
+    end
+    ## 
+    # send in a list
+    # e.g.         set_content File.open("README.txt","r").readlines
+    # set wrap at time of passing :WRAP_NONE :WRAP_WORD
+    # @see add (add takes a title too which is required here)
+    def set_content list, wrap = :WRAP_NONE
+      ret = super
+    #  buff = @bmanager.add_content @list
+      return ret
+    end
+    # multi-textview
+    def handle_key ch
+      # put list as current list and buffer too then super
+      #@current_buffer = @bmanager.current
+      #@list = @current_buffer.list
+      @buffer = @list[@current_index]
+      #@buffer = @bmanager.current
+      ret = super
+      # check for any keys not handled and check our own ones
+      return ret # 
+    end
+    ## prompt user for a filename to read in
+    def getfilename prompt="Enter filename: ", maxlen=90
+      tabc = Proc.new {|str| Dir.glob(str +"*") }
+      config={}; config[:tab_completion] = tabc
+      #config[:default] = "defaulT"
+      $log.debug " inside getstr before call #{$error_message_row} +  #{$error_message_col}  "
+      #ret, str = rbgetstr(@form.window, @row+@height-1, @col+1, prompt, maxlen, config)
+      ret, str = rbgetstr(@form.window, $error_message_row, $error_message_col, prompt, maxlen, config)
+      $log.debug " rbgetstr returned #{ret} , #{str} "
+      return "" if ret != 0
+      return str
+    end
+    # this is just a test of the simple "most" menu
+    # can use this for next, prev, first, last, new, delete, overwrite etc
+    def buffer_menu
+      menu = PromptMenu.new self 
+      menu.add(menu.create_mitem( 'e', "edit a file", "opened file ", :file_edit ))
+      menu.add(menu.create_mitem( 'o', "overwrite file", "opened a file ", :file_overwrite ))
+      menu.add(menu.create_mitem( 'l', "list buffers", "list buffers ", :buffers_list ))
+      item = menu.create_mitem( 'b', "Buffer Options", "Buffer Options" )
+      menu1 = PromptMenu.new( self, "Buffer Options")
+      menu1.add(menu1.create_mitem( 'n', "Next", "Switched to next buffer", :buffer_next ))
+      menu1.add(menu1.create_mitem( 'p', "Prev", "Switched to previous buffer", :buffer_previous ))
+      menu1.add(menu1.create_mitem( 'f', "First", "Switched to first buffer", :buffer_first ))
+      menu1.add(menu1.create_mitem( 'l', "Last", "Switched to last buffer", :buffer_last ))
+      menu1.add(menu1.create_mitem( 'd', "Delete", "Deleted buffer", :buffer_delete ))
+      item.action = menu1
+      menu.add(item)
+      # how do i know what's available. the application or window should know where to place
+      menu.display @form.window, $error_message_row, $error_message_col, $datacolor #, menu
+    end
+
+    %w[next previous first last].each do |pos|
+      eval(
+           "def _buffer_#{pos}
+              @current_buffer = @bmanager.#{pos}
+              set_current_buffer
+           end"
+          )
+    end
+
+    def buffer_next
+      perror "No other buffer" and return if @bmanager.size < 2
+
+      @current_buffer = @bmanager.next
+      set_current_buffer
+    end
+    def buffer_previous
+      perror "No other buffer" and return if @bmanager.size < 2
+
+      @current_buffer = @bmanager.previous
+      $log.debug " buffer_prev got #{@current_buffer} "
+      set_current_buffer
+    end
+    def buffer_first
+      @current_buffer = @bmanager.first
+      $log.debug " buffer_first got #{@current_buffer} "
+      set_current_buffer
+    end
+    def buffer_last
+      @current_buffer = @bmanager.last
+      $log.debug " buffer_last got #{@current_buffer} "
+      set_current_buffer
+    end
+    def buffer_delete
+      if @bmanager.size > 1
+        @bmanager.delete_at
+        @current_buffer = @bmanager.previous
+        set_current_buffer
+      else
+        perror "Only one buffer. Cannot delete."
+      end
+    end
+    def buffers_list
+      menu = PromptMenu.new self 
+      @bmanager.each_with_index{ |b, ix|
+        aproc = Proc.new { buffer_at(ix) }
+        name = b.title
+        num = ix + 1
+        menu.add(menu.create_mitem( num.to_s, name, "Switched to buffer #{ix}", aproc ))
+      }
+      menu.display @form.window, $error_message_row, $error_message_col, $datacolor
+    end
+    # prompts user for filename and opens in buffer
+    # Like vim's :e
+    def file_edit
+      file = getfilename()
+      $log.debug " got file_edit: #{file} "
+      return if file == ""
+      add file, file
+    end
+    # load a file into the textview.
+    # This is the preferred method since it lets us add a title too
+    # Shucks, this misses wrap_style which the other one has
+    # @param [String] filename
+    def add file, title
+      begin
+        @current_buffer = @bmanager.add file, title
+        $log.debug " file edit got cb : #{@current_buffer} "
+        set_current_buffer
+      rescue => err
+        $error_message = "Error: #{err} "
+        @form.window.print_error_message
+        Ncurses.beep
+        return -1
+      end
+    end
+    def buffer_at index
+      @current_buffer = @bmanager.element_at index
+      $log.debug " buffer_last got #{@current_buffer} "
+      set_current_buffer
+    end
+    def set_current_buffer
+      @current_index = @current_buffer.current_index
+      @curpos = @current_buffer.curpos
+      @title = @current_buffer.title
+      @list = @current_buffer.list
+    end
+    def perror errmess=$error_message
+      @form.window.print_error_message errmess
+    end
+  end # class multitextview
+  ##
+  # Handles multiple buffers, navigation, maintenance etc
+  # Instantiated at startup of MultiTextView
+  #
+  class BufferManager
+    include Enumerable
+    def initialize source
+      @source = source
+      @buffers = [] # contains RBuffer
+      @counter = 0
+      # for each buffer i need to store data, current_index (row), curpos (col offset) and title (filename).
+    end
+    def element_at index
+      @buffers[index]
+    end
+    def each
+      @buffers.each {|k| yield(k)}
+    end
+    ##
+    # @return [RBuffer] current buffer/file
+    ##
+    def current
+      @buffers[@counter]
+    end
+    ##
+    # Would have liked to just return next buffer and not get lost in details of caller
+    #
+    # @return [RBuffer] next buffer/file
+    ##
+    def next
+      @counter += 1
+      @counter = 0 if @counter >= @buffers.size
+      @buffers[@counter]
+    end
+    ##
+    # @return [RBuffer] previous buffer/file
+    ##
+    def previous
+      $log.debug " previous bs: #{@buffers.size}, #{@counter}  "
+      @counter -= 1
+      return last() if @counter < 0
+      $log.debug " previous ctr  #{@counter} "
+      @buffers[@counter]
+    end
+    def first
+      @counter = 0
+      @buffers[@counter]
+    end
+    def last
+      @counter = @buffers.size - 1
+      @buffers[@counter]
+    end
+    ##
+    def delete_at index=@counter
+      @buffers.delete_at index
+    end
+    def delete_by_name name
+      @buffers.delete_if {|b| b.filename == name }
+    end
+    def insert filename, position, title=nil
+      # read up file
+      list = @source.set_content File.open(filename,"r").readlines
+      # set new RBuffer
+      title = filename unless title
+      raise "invalid value for list, Should be an array #{list.class} " unless list.is_a? Array
+      anew = RBuffer.new(list, 0, 0, filename, title)
+      #@buffers << anew
+      @buffers.insert position, anew
+      @counter = position
+      return anew
+    end
+    def add filename, title=nil
+      insert filename, @buffers.size, title
+    end
+    def insert_content str, position,  title="UNTitled"
+      case str
+      when String
+        # put str into list
+        @source.set_content str
+        list = @list
+      when Array
+        list = str
+      end
+      anew = RBuffer.new(list, 0, 0, "", title)
+      #@buffers << anew
+      @buffers.insert position, anew
+      @counter = position
+      return anew
+    end
+    # add content (array or str) to buffer list as a new buffer
+    def add_content str, title="UNtitled"
+      $log.debug " inside BUFFER MANAGER "
+      insert_content str,  @buffers.size, title
+    end
+    def size
+      @buffers.size
+    end
+    alias :count :size
+    def index buff
+      return @buffers.index
+    end
+  end
+  RBuffer = Struct.new(:list, :current_index, :curpos, :filename, :title) do
+    def xxx
+    end
+  end
+
+end # modul

data/lib/rbcurse/rscrollform.rb

@@ -0,0 +1,369 @@
+=begin
+  * Name: ScrollForm - a form that can take more than the screen and focus only on what's visible
+  *  This class originated in TabbedPane for the top button form which only scrolls
+  *  horizontally and uses objects that have a ht of 1. Here we have to deal with
+  * large objects and vertical scrolling.
+  * Description: 
+  * Author: rkumar
+  
+  --------
+  * Date: 2010-03-16 11:32 
+  * License:
+    Same as Ruby's License (http://www.ruby-lang.org/LICENSE.txt)
+
+
+NOTE: 
+    There are going to be tricky cases we have to deal with such as objects that start in the viewable
+area but finish outside, or vice versa.
+
+    What if we wish some static text to be displayed at top or bottom of ScrollForm
+=end
+require 'rubygems'
+require 'ncurses'
+require 'logger'
+require 'rbcurse'
+
+include Ncurses
+include RubyCurses
+module RubyCurses
+  extend self
+  class ScrollForm < RubyCurses::Form
+    # the pad prints from this col to window
+    attr_accessor :pmincol # advance / scroll columns
+    # the pad prints from this row to window, usually 0
+    attr_accessor :pminrow # advance / scroll rows (vertically)
+    attr_accessor :display_w # width of screen display
+    attr_accessor :display_h # ht of screen display
+    attr_accessor :row_offset, :col_offset
+    attr_accessor :scroll_unit # by how much should be scroll
+    attr_reader :orig_top, :orig_left
+    attr_reader :window
+    attr_accessor :name
+    attr_reader :cols_panned, :rows_panned
+    def initialize win, &block
+      @target_window = win
+      super
+      @pminrow = @pmincol = 0
+      @row_offset = @col_offset = 0
+      @scroll_unit = 3
+      @cols_panned = @rows_panned = 0
+      @repaint_all = true
+
+      # take display dimensions from window. It is safe to override immediately after form creation
+      @display_h = win.height
+      @display_w = win.width
+      @display_h = (Ncurses.LINES - win.top - 2) if @display_h == 0
+      @display_w = (Ncurses.COLS - win.left - 2) if @display_w == 0
+      
+      init_vars
+    end
+    def init_vars
+      bind_key(?\M-h, :scroll_left)
+      bind_key(?\M-l, :scroll_right)
+      bind_key(?\M-n, :scroll_down)
+      bind_key(?\M-p, :scroll_up)
+    end
+    def should_print_border flag=true
+      @print_border_flag = flag
+      @row_offset = @col_offset = 1
+    end
+    # This is how we set size of pad and where it prints on screen
+    # This is all that's needed after constructor.
+    # @param [Fixnum] t top (row on screen to print pad on)
+    # @param [Fixnum] l left (col on screen to print)
+    # @param [Fixnum] h height (how many lines in Pad, usually more that screens actual height)
+    # @param [Fixnum] w width (how many cols in Pad, often more than screens width)
+    #
+    def set_pad_dimensions(t, l, h, w )
+      @pad_h = h
+      @pad_w = w
+      @top = @orig_top = t
+      @left = @orig_left = l
+      create_pad
+    end
+    ## 
+    # create a pad to work on. 
+    # XXX We reuse window, which is already the main window
+    # So if we try creating pad later, then old external window is used.
+    # However, many methods in superclass operate on window so we needed to overwrite. What do i do ?
+    private
+    def create_pad
+      raise "Pad already created" if @pad
+      r = @top
+      c = @left
+      layout = { :height => @pad_h, :width => @pad_w, :top => r, :left => c } 
+      @window = VER::Pad.create_with_layout(layout)
+  
+      @window.name = "Pad::ScrollPad" # 2010-02-02 20:01 
+      @name = "Form::ScrollForm"
+      @pad = @window
+      return @window
+    end
+    public
+    def scroll_right
+      s = @scroll_unit + $multiplier
+      $log.debug " scroll_right #{s} m: #{$multiplier} "
+      $multiplier = 0
+      return false if !validate_scroll_col(@pmincol + s)
+      @pmincol += s # some check is required or we'll crash
+      @cols_panned -= s
+      $log.debug " handled ch M-l in ScrollForm"
+      @window.modified = true
+      return 0
+    end
+    ## 
+    # validate fails once unit + mult > 1. Then it won't go further
+    # unit should be one by default.
+    def scroll_left
+      s = @scroll_unit + $multiplier
+      $log.debug " scroll_left #{s} m: #{$multiplier} "
+      $multiplier = 0
+      #return false if !validate_scroll_col(@pmincol - s)
+      if !validate_scroll_col(@pmincol - s)
+        @pmincol = 0
+        @cols_panned  = 0 
+      else
+        @pmincol -= s # some check is required or we'll crash
+        @cols_panned += s
+      end
+      @window.modified = true
+      return 0
+    end
+    def scroll_down
+      s = @scroll_unit + $multiplier; $multiplier = 0
+      return false if !validate_scroll_row(@pminrow + s)
+      @pminrow += s # some check is required or we'll crash
+      @rows_panned -= s
+      @window.modified = true
+      #@repaint_all = true
+      return 0
+    end
+    def scroll_up
+      s = @scroll_unit + $multiplier; $multiplier = 0
+      $log.debug " scroll_up #{s} "
+      #return false if !validate_scroll_row(@pminrow - s)
+      if !validate_scroll_row(@pminrow - s)
+        @pminrow = 0
+        @rows_panned = 0
+        $log.debug " !valid #{@pminrow} "
+      else
+        @pminrow -= s # some check is required or we'll crash
+        @rows_panned += s
+        $log.debug " valid #{@pminrow} "
+      end
+      @window.modified = true
+      #@repaint_all = true
+      return 0
+    end
+    # print a border on the main window, just for kicks
+    def print_border
+      $log.debug " SCROLL print_border ..."
+      #@window.print_border_only(@top-@rows_panned, @left+@cols_panned, @display_h, @display_w, $datacolor)
+      @target_window.print_border_only(@top, @left, @display_h, @display_w+1, $datacolor)
+    end
+    def print_footer
+      footer = "Lines %d-%d (%d)  Cols %d-%d (%d) " % [ @pminrow, @pminrow + @display_h, @orig_top + @pad_h, @pmincol, @pmincol + @display_w, @orig_left + @pad_w ] 
+      @target_window.printstring(@top +@display_h, @left + 3, footer, $datacolor)
+    end
+    # XXX what if we want a static area at bottom ?
+    # maybe we should rename targetwindow to window
+    #  and window to pad
+    #  super may need target window
+    def repaint
+      print_border if @repaint_all and @print_border_flag
+      print_footer
+      $log.debug " scrollForm repaint calling parent #{@row} #{@col}+ #{@cols_panned} #{@col_offset} "
+      super
+      prefresh
+      _print_more_data_marker true
+      _print_more_columns_marker true
+      #$log.debug " @target_window.wmove #{@row+@rows_panned+@row_offset}, #{@col+@cols_panned+@col_offset}  "
+      @target_window.wmove @row+@rows_panned+@row_offset, @col+@cols_panned+@col_offset
+      @window.modified = false
+      @repaint_all = false
+    end
+    ## refresh pad onto window
+    # I am now copying onto main window, else prefresh has funny effects
+    def prefresh
+      ## reduce so we don't go off in top+h and top+w
+      $log.debug "  start ret = @buttonpad.prefresh( #{@pminrow} , #{@pmincol} , #{@top} , #{@left} , top + #{@display_h} left + #{@display_w} ) "
+      if @pminrow + @display_h > @orig_top + @pad_h
+        $log.debug " if #{@pminrow} + #{@display_h} > #{@orig_top} +#{@pad_h} "
+        $log.debug " ERROR 1 "
+        #return -1
+      end
+      if @pmincol + @display_w > @orig_left + @pad_w
+      $log.debug " if #{@pmincol} + #{@display_w} > #{@orig_left} +#{@pad_w} "
+        $log.debug " ERROR 2 "
+        return -1
+      end
+      # actually if there is a change in the screen, we may still need to allow update
+      # but ensure that size does not exceed
+      if @top + @display_h > @orig_top + @pad_h
+      $log.debug " if #{@top} + #{@display_h} > #{@orig_top} +#{@pad_h} "
+        $log.debug " ERROR 3 "
+        return -1
+      end
+      if @left + @display_w > @orig_left + @pad_w
+      $log.debug " if #{@left} + #{@display_w} > #{@orig_left} +#{@pad_w} "
+        $log.debug " ERROR 4 "
+        return -1
+      end
+      # maybe we should use copywin to copy onto @target_window
+      $log.debug "   ret = @window.prefresh( #{@pminrow} , #{@pmincol} , #{@top} , #{@left} , #{@top} + #{@display_h}, #{@left} + #{@display_w} ) "
+      omit = 0
+      # this works but if want to avoid copying border
+      #ret = @window.prefresh(@pminrow, @pmincol, @top+@row_offset, @left+@col_offset, @top + @display_h - @row_offset , @left + @display_w - @col_offset)
+      #
+      ## Haha , we are back to the old notorious copywin which has given mankind
+      # so much grief that it should be removed in the next round of creation.
+      ret = @window.copywin(@target_window.get_window, @pminrow, @pmincol, @top+@row_offset, @left+@col_offset, 
+            @top + @display_h - @row_offset , @left + @display_w - @col_offset,  0)
+
+      $log.debug " copywin ret = #{ret} "
+    end
+    private
+    def validate_scroll_row minrow
+       return false if minrow < 0
+      if minrow + @display_h > @orig_top + @pad_h
+        $log.debug " if #{minrow} + #{@display_h} > #{@orig_top} +#{@pad_h} "
+        $log.debug " ERROR 1 "
+        return false
+      end
+      return true
+    end
+    def validate_scroll_col mincol
+      return false if mincol < 0
+      if mincol + @display_w > @orig_left + @pad_w
+      $log.debug " if #{mincol} + #{@display_w} > #{@orig_left} +#{@pad_w} "
+        $log.debug " ERROR 2 "
+        return false
+      end
+      return true
+    end
+    # when tabbing through buttons, we need to account for all that panning/scrolling goin' on
+    # this is typically called by putchar or putc in editable components like field.
+    # XXX DELETE THIS IS SUPPOSE
+    def OLDsetrowcol r, c
+      $log.debug " SCROLL setrowcol #{r},  #{c} + #{@cols_panned}"
+      # aha ! here's where i can check whether the cursor is falling off the viewable area
+      cc = nil
+      rr = nil
+      if c
+        cc = c #+ @cols_panned
+        if c+@cols_panned < @orig_left
+          # this essentially means this widget (button) is not in view, its off to the left
+          $log.debug " setrowcol OVERRIDE #{c} #{@cols_panned} < #{@orig_left} "
+          $log.debug " aborting settrow col for now"
+          return
+        end
+        if c+@cols_panned > @orig_left + @display_w
+          # this essentially means this button is not in view, its off to the right
+          $log.debug " setrowcol OVERRIDE #{c} #{@cols_panned} > #{@orig_left} + #{@display_w} "
+          $log.debug " aborting settrow col for now"
+          return
+        end
+      end
+      if r
+        rr = r+@rows_panned
+      end
+      super rr, cc
+    end
+    public
+    def add_widget w
+      super
+      $log.debug " inside add_widget #{w.name}  pad w #{@pad_w} #{w.col}, #{@pad_h}  "
+      if w.col >= @pad_w
+        @pad_w += 10 # XXX currently just a guess value, we need length and maybe some extra
+        @window.wresize(@pad_h, @pad_w) if @pad
+      end
+      if w.row >= @pad_h
+        @pad_h += 10 # XXX currently just a guess value, we need length and maybe some extra
+        $log.debug " SCROLL add_widget ..."
+        @window.wresize(@pad_h, @pad_w) if @pad
+      end
+    end
+    ## Is a component visible, typically used to prevent traversal into the field
+    # @returns [true, false] false if components has scrolled off
+    def visible? component
+      r, c = component.rowcol
+      return false if c+@cols_panned < @orig_left
+      return false if c+@cols_panned > @orig_left + @display_w
+      # XXX TODO for rows UNTESTED for rows
+      return false if r + @rows_panned < @orig_top
+      return false if r + @rows_panned > @orig_top + @display_h
+
+      return true
+    end
+    # returns index of first visible component. Currently using column index
+    # I am doing this for horizontal scrolling presently
+    # @return [index, -1] -1 if none visible, else index/offset
+    def first_visible_component_index
+      @widgets.each_with_index do |w, ix|
+        return ix if visible?(w) and focusable?(w)
+      end
+      return -1
+    end
+    def last_visible_component_index
+      ret = -1
+      @widgets.each_with_index do |w, ix|
+        ret = ix if visible?(w) and focusable?(w)
+      end
+      return ret
+    end
+    def req_first_field
+      index = first_visible_component_index
+      ret = select_field(index)
+      return ret
+    end
+    def req_last_field
+      select_field(last_visible_component_index)
+    end
+    def focusable?(w)
+      w.focusable and visible?(w)
+    end
+
+    # XXX needs to be called from repaint and print_border
+    # @param [boolean] should marker be printed or not
+    def _print_more_data_marker tf
+      tf = false
+      # the bottom marker meaning there's more data below
+      if @pminrow + @display_h < @pad_h
+        tf = true
+      end
+      marker = tf ?  Ncurses::ACS_CKBOARD : Ncurses::ACS_VLINE
+      h = @display_h; w = @display_w
+      r = @orig_top
+      c = @orig_left
+      $log.debug " more data #{r+h-1}, #{c+w-1} : row #{r} h #{h} w #{w} col #{c} "
+      @target_window.mvwaddch r+h-1, c+w-0, marker
+      # the top marker to show that there is data above
+      marker = @pminrow > 0 ?  Ncurses::ACS_CKBOARD : Ncurses::ACS_VLINE
+      @target_window.mvwaddch r+1, c+w-0, marker
+    end
+
+    # XXX needs to be called from repaint and print_border
+    # @param [boolean] should marker be printed or not
+    def _print_more_columns_marker tf
+      tf = false
+      if @pmincol + @display_w < @pad_w
+        tf = true
+      end
+      marker = tf ?  Ncurses::ACS_CKBOARD : Ncurses::ACS_HLINE
+      h = @display_h; w = @display_w
+      r = @orig_top
+      c = @orig_left
+      @target_window.mvwaddch r+h, c+w-2, marker
+      #
+      # show if columns to left or not
+      marker = @pmincol > 0 ?  Ncurses::ACS_CKBOARD : Ncurses::ACS_HLINE
+      @target_window.mvwaddch r+h, c+1, marker
+    end                                                                                                            
+  end # class ScrollF
+
+  # the return of the prodigals
+  # The Expanding Heart
+  # The coming together of all those who were
+
+
+end # module