rbcurse 1.3.0 → 1.4.0

data/lib/rbcurse/rtable.rb

@@ -18,6 +18,7 @@
    currently it moves to next row. (examples/sqlc.rb) - DONE
   
   * 2010-01-18 19:54 - BUFFERING related changes.
+  * 2011-09-30       - removed all buffer related stuff
   --------
   * Date:   2008-12-27 21:33 
   * License:
@@ -91,7 +92,6 @@ module RubyCurses
       init_vars
       install_list_keys
       install_keys_bindings
-      ## create_buffer needs to move to repaint. widget needs values to use when i creates buffer in repaint.
       if _data && _columns
         set_data _data, _columns
       end
@@ -145,7 +145,8 @@ module RubyCurses
     def focussed_row
       #raise "No data in table" if row_count < 1
       return nil if row_count < 1
-      @current_index
+      return @current_index if @current_index < row_count
+      @current_index = row_count-1
     end
     def focussed_col
       return nil if row_count < 1
@@ -251,7 +252,7 @@ module RubyCurses
     end
     # @deprecated, avoid usage
     def get_table_column_model
-      $log.debug " DEPRECATED. Pls use table_column_model()"
+      $log.warn " DEPRECATED. Pls use table_column_model()"
       @table_column_model 
     end
     # 
@@ -338,6 +339,7 @@ module RubyCurses
     #--- row and column methods of Table ---#
     # must not give wrong results when columns switched!
     def get_value_at row, col
+      return nil if row.nil? || col.nil? # 2011-09-29 
       model_index = @table_column_model.column(col).model_index
       @table_model.get_value_at row, model_index
     end
@@ -487,10 +489,6 @@ module RubyCurses
       @repaint_required = true
       # copied from rlistbox, so that editors write on parent's graphic, otherwise
       # their screen updates get overwritten by parent. 2010-01-19 20:17 
-      if @should_create_buffer
-        $log.debug "LB #{@name} overriding editors comp with GRAPHIC #{@graphic} "
-        editor.component.override_graphic(@graphic) #  2010-01-05 00:36 TRYING OUT BUFFERED
-      end
       set_form_col 
     end
     ## Its too late to call components on_leave here
@@ -881,7 +879,6 @@ module RubyCurses
 
 
     def repaint
-      safe_create_buffer # moved here 2010-02-19 09:53 RFED16
       return unless @repaint_required
       my_win = @form ? @form.window : @target_window
       @graphic = my_win unless @graphic
@@ -980,8 +977,7 @@ module RubyCurses
       $log.debug " _print_more_data_marker(#{rc} >= #{tr} + #{h})"
       @table_changed = false
       @repaint_required = false
-      @buffer_modified = true
-      buffer_to_window # RFED16 2010-02-19 09:55 
+      #@buffer_modified = true # 2011-09-30 CLEANUP
     end
     # NEW to correct overflow
     #  2009-10-05 21:34 

data/lib/rbcurse/rtextarea.rb

@@ -37,14 +37,15 @@ module RubyCurses
   #   work correctly.
   class TextArea < Widget
     include ListScrollable
+    # NOTE: common editing functions moved to listeditable 
     include ListEditable
     dsl_accessor :title
     dsl_accessor :title_attrib   # bold, reverse, normal
-    dsl_accessor :footer_attrib   # bold, reverse, normal added 2009-12-26 18:25 was this missing or delib
-    dsl_accessor :list    # the array of data to be sent by user
-    dsl_accessor :maxlen    # max display length of a row/line 
+    dsl_accessor :footer_attrib  # bold, reverse, normal added 2009-12-26 18:25 was this missing or delib
+    dsl_accessor :list           # the array of data to be sent by user
+    dsl_accessor :maxlen         # max display length of a row/line 
     attr_reader :toprow
-    dsl_accessor :auto_scroll # boolean, keeps view at end as data is inserted.
+    dsl_accessor :auto_scroll    # boolean, keeps view at end as data is inserted.
     dsl_accessor :print_footer
     dsl_accessor :editable          # allow editing
     dsl_accessor :suppress_borders # added 2010-02-12 12:21 values true or false
@@ -59,6 +60,8 @@ module RubyCurses
       @list = []
       @suppress_borders = false
       @row_offset = @col_offset = 1 # for cursor display on first entry, so not positioned on border
+      @_events ||= [] 
+      @_events.push :CHANGE
       super
       @orig_col = @col
       # this does result in a blank line if we insert after creating. That's required at 
@@ -69,7 +72,6 @@ module RubyCurses
       @content_rows = @list.length
       @win = @graphic # 2009-12-26 14:54 BUFFERED  replace form.window with graphic
       # 2010-01-10 19:35 compute locally if not set
-      @_events.push :CHANGE
       install_keys
       init_vars
     end
@@ -176,12 +178,15 @@ module RubyCurses
     # private
     def print_borders
       window = @graphic # 2009-12-26 14:54 BUFFERED
-      color = $datacolor
+      @color_pair = get_color($datacolor) # 2011-09-28 V1.3.1 
+      bordercolor = @border_color || @color_pair
+      borderatt = @border_attrib || Ncurses::A_NORMAL
+      #color = $datacolor
       #window.print_border @row, @col, @height, @width, color
       ## NOTE: If it bombs in next line, either no form passed
       ##+ or you using this embedded and need to set should_create_buffer true when
       ##+ creating. See examples/testscrollta.rb.
-      window.print_border @row, @col, @height-1, @width, color
+      window.print_border @row, @col, @height-1, @width, bordercolor, borderatt
       print_title
 =begin
       hline = "+%s+" % [ "-"*(width-((1)*2)) ]
@@ -199,11 +204,12 @@ module RubyCurses
     def print_title
       # truncate title if longer than width
       return unless @title
+      @color_pair ||= get_color($datacolor)
       _title = @title
       if @title.length > @width - 2
         _title = @title[0..@width-2]
       end
-      @graphic.printstring( @row, @col+(@width-_title.length)/2, _title, $datacolor, @title_attrib) unless @title.nil?
+      @graphic.printstring( @row, @col+(@width-_title.length)/2, _title, @color_pair, @title_attrib) unless @title.nil?
     end
     # text_area print footer
     def print_foot
@@ -212,28 +218,44 @@ module RubyCurses
       #$log.debug " print_foot calling printstring with #{@row} + #{@height} -1, #{@col}+2"
       # changed 2010-01-02 19:31 BUFFERED we were exceeding 1
       #@graphic.printstring( @row + @height, @col+2, footer, $datacolor, @footer_attrib) 
-      @graphic.printstring( @row + @height-1, @col+2, footer, $datacolor, @footer_attrib) 
+      @graphic.printstring( @row + @height-1, @col+2, footer, @color_pair || $datacolor, @footer_attrib) 
       @repaint_footer_required = false
     end
     ### FOR scrollable ###
     def get_content
       @list
     end
+    #
+    # sets content of textarea. I don't know why this was not existing all this while
+    # Name to be consistent with textview. Okay, this does not wrap the words, we assume
+    # its short enough. FIXME. Avoid using currently till i firm this.
+    # NOTE: does not wrap, and does not trigger events
+    # Added on 2011-10-10 
+    # @since 1.4.0
+    # @param [String, Array] String is an existing filename, Array is content to be replaced
+    def set_content lines
+      case lines
+      when String
+        if File.exists? lines
+          lines = File.open(lines,"r").readlines
+        else
+          raise "set_content String param should be a filename"
+        end
+      when Array
+      else
+        raise "Don't know how to handle data in set_content: #{lines.class} "
+      end
+      @list.replace lines
+      @repaint_required = true
+    end
     def get_window
       @graphic
     end
     ### FOR scrollable ###
     def repaint # textarea
-      if @screen_buffer.nil? and @should_create_buffer
-        safe_create_buffer
-        @screen_buffer.name = "Pad::TXTA_PAD_#{@name}"
-        $log.debug " textarea creates pad #{@screen_buffer} #{@name}"
-      end
-      
       #return unless @repaint_required # 2010-02-12 19:08  TRYING - won't let footer print if only col move
       paint if @repaint_required
       print_foot if @print_footer && !@suppress_borders && (@repaint_footer_required || @repaint_required)
-      buffer_to_window # 2010-02-12 14:54 RFED16
     end
     def getvalue
       @list
@@ -243,8 +265,10 @@ module RubyCurses
       return if @keys_mapped
       bind_key(Ncurses::KEY_LEFT){ cursor_backward }
       bind_key(Ncurses::KEY_RIGHT){ cursor_forward }
-      bind_key(Ncurses::KEY_UP){ up }
-      bind_key(Ncurses::KEY_DOWN){ down }
+      bind_key(Ncurses::KEY_UP){ ret = up;  get_window.ungetch(KEY_BTAB) if ret == :NO_PREVIOUS_ROW }
+      # the next was irritating if user wanted to add a row ! 2011-10-10 
+      #bind_key(Ncurses::KEY_DOWN){ ret = down ; get_window.ungetch(KEY_TAB) if ret == :NO_NEXT_ROW }
+      bind_key(Ncurses::KEY_DOWN){ ret = down ; }
       bind_key(?\C-a){ cursor_bol }
       bind_key(?\C-e){ cursor_eol }
       bind_key(?\C-n) { scroll_forward }
@@ -293,10 +317,6 @@ module RubyCurses
       case ch
       when KEY_ENTER, 10, KEY_RETURN
         insert_break
-      #when KEY_LEFT
-        #cursor_backward
-      #when KEY_RIGHT
-        #cursor_forward
       when Ncurses.KEY_BACKSPACE, Ncurses.KEY_BSPACE
         if @editable   # checking here means that i can programmatically bypass!!
           delete_prev_char 
@@ -322,19 +342,9 @@ module RubyCurses
         #@multiplier = (@multiplier == 0 ? 4 : @multiplier *= 4)
         #return 0
       when ?\C-_.getbyte(0) # changed from C-u so i can use C-u for multipliers
-        if @undo_handler
-          @undo_handler.undo
-        else
-          undo_delete
-        end
+        undo
       when ?\C-r.getbyte(0) # redo if UndoHandler installed
-        return unless @undo_handler
-        @undo_handler.redo
-      #when ?\C-a.getbyte(0)
-        #cursor_bol
-      #when ?\C-e.getbyte(0)
-        #cursor_eol
-        
+        text_redo # won't accept name redo
       #when @KEY_ASK_FIND_FORWARD
       #  ask_search_forward
       #when @KEY_ASK_FIND_BACKWARD
@@ -793,7 +803,7 @@ module RubyCurses
     def cursor_eol
        _maxlen = @maxlen || @width - @internal_width
       $log.error "ERROR !!! bufferlen gt _maxlen #{@buffer.length}, #{_maxlen}" if @buffer.length > _maxlen
-      set_form_col current_line().chomp().length()-1
+      set_form_col current_line().chomp().length() #-1 needs to be one ahead 2011-10-10 TRYING OUT XXX
     end
     def cursor_bol
       set_form_col 0
@@ -838,6 +848,7 @@ module RubyCurses
       $log.debug " #{@name} textarea repaint width is #{@width}, height is #{@height} , maxlen #{_maxlen}/ #{@maxlen}, #{@graphic.name} "
       tm = get_content
       tr = @toprow
+      raise "textarea height not specified" unless @height
       acolor = get_color $datacolor
       h = scrollatrow()
       r,c = rowcol
@@ -881,7 +892,6 @@ module RubyCurses
       @table_changed = false
       @repaint_required = false
       @repaint_footer_required = true # 2010-01-23 22:41 
-      @buffer_modified = true # required by form to call buffer_to_screen
       @repaint_all = false # added 2010-01-14 for redrawing everything
     end
     def ask_search_forward
@@ -894,6 +904,17 @@ module RubyCurses
           set_form_col @find_offset
         end
     end
+    def undo
+      if @undo_handler
+        @undo_handler.undo
+      else
+        undo_delete
+      end
+    end
+    def text_redo
+      return unless @undo_handler
+      @undo_handler.redo
+    end
   end # class textarea
   ##
 end # modul

data/lib/rbcurse/rtextview.rb

@@ -180,7 +180,9 @@ module RubyCurses
 
       $log.debug " #{@name} print_borders,  #{@graphic.name} "
       
-      bordercolor = @border_color || $datacolor
+      @color_pair = get_color($datacolor) # added 2011-09-28 as in rlistbox
+#      bordercolor = @border_color || $datacolor # changed 2011 dts  
+      bordercolor = @border_color || @color_pair # 2011-09-28 V1.3.1 
       borderatt = @border_attrib || Ncurses::A_NORMAL
       @graphic.print_border @row, @col, @height-1, @width, bordercolor, borderatt
       print_title
@@ -188,20 +190,21 @@ module RubyCurses
     def print_title #:nodoc:
       return unless @title
       raise "textview needs width" unless @width
-      @color_pair ||= get_color($datacolor) # should we not use this ??? XXX
+      @color_pair ||= get_color($datacolor) # should we not use this ??? XXX 
       #$log.debug " print_title #{@row}, #{@col}, #{@width}  "
       # check title.length and truncate if exceeds width
       _title = @title
       if @title.length > @width - 2
         _title = @title[0..@width-2]
       end
-      @graphic.printstring( @row, @col+(@width-_title.length)/2, _title, $datacolor, @title_attrib) unless @title.nil?
+#      @graphic.printstring( @row, @col+(@width-_title.length)/2, _title, $datacolor, @title_attrib) unless @title.nil? # changed 2011 dts  
+      @graphic.printstring( @row, @col+(@width-_title.length)/2, _title, @color_pair, @title_attrib) unless @title.nil?
     end
     def print_foot #:nodoc:
       @footer_attrib ||= Ncurses::A_REVERSE
       footer = "R: #{@current_index+1}, C: #{@curpos+@pcol}, #{@list.length} lines  "
       #$log.debug " print_foot calling printstring with #{@row} + #{@height} -1, #{@col}+2"
-      @graphic.printstring( @row + @height -1 , @col+2, footer, $datacolor, @footer_attrib) 
+      @graphic.printstring( @row + @height -1 , @col+2, footer, @color_pair || $datacolor, @footer_attrib) 
       @repaint_footer_required = false # 2010-01-23 22:55 
     end
     ### FOR scrollable ###
@@ -213,17 +216,12 @@ module RubyCurses
     end
 
     def repaint # textview :nodoc:
-      if @screen_buffer.nil?
-        safe_create_buffer
-        @screen_buffer.name = "Pad::TV_PAD_#{@name}" unless @screen_buffer.nil?
-        $log.debug " textview creates pad #{@screen_buffer} #{@name}"
-      end
+      $log.debug "TEXTVIEW repaint r c #{@row}, #{@col} "  
 
       #return unless @repaint_required # 2010-02-12 19:08  TRYING - won't let footer print for col move
       paint if @repaint_required
     #  raise "TV 175 graphic nil " unless @graphic
       print_foot if @print_footer && !@suppress_borders && @repaint_footer_required
-      buffer_to_window
     end
     def getvalue
       @list
@@ -259,10 +257,12 @@ module RubyCurses
       when KEY_UP, ?k.getbyte(0)
         #select_prev_row
         ret = up
+        get_window.ungetch(KEY_BTAB) if ret == :NO_PREVIOUS_ROW
         check_curpos
         
       when KEY_DOWN, ?j.getbyte(0)
         ret = down
+        get_window.ungetch(KEY_TAB) if ret == :NO_NEXT_ROW
         check_curpos
       when KEY_LEFT, ?h.getbyte(0)
         cursor_backward
@@ -320,10 +320,9 @@ module RubyCurses
         begin
           ret = process_key ch, self
         rescue => err
-          $error_message = err
-          @form.window.print_error_message
           $log.error " TEXTVIEW ERROR #{err} "
           $log.debug(err.backtrace.join("\n"))
+          alert err.to_s
         end
         return :UNHANDLED if ret == :UNHANDLED
       end
@@ -487,10 +486,8 @@ module RubyCurses
       #@table_changed = false
       @repaint_required = false
       @repaint_footer_required = true
-      @buffer_modified = true # required by form to call buffer_to_screen
       @repaint_all = false 
 
-      # 2010-02-10 22:08 RFED16
     end
     # takes a block, this way anyone extending this class can just pass a block to do his job
     # This modifies the string
@@ -499,7 +496,7 @@ module RubyCurses
         content.chomp!
         # trying out since gsub giving #<ArgumentError: invalid byte sequence in UTF-8> 2011-09-11 
         content = content.encode("ASCII-8BIT", :invalid => :replace, :undef => :replace, :replace => "?")
-        content.gsub!(/\t/, '  ') # don't display tab
+        content.gsub!(/[\t\n\r]/, '  ') # don't display tab
         content.gsub!(/[^[:print:]]/, '')  # don't display non print characters
       else
         content

data/lib/rbcurse/rtree.rb

@@ -49,12 +49,14 @@ module RubyCurses
     dsl_property :row_selected_symbol # 2009-01-12 12:01 changed from selector to selected
     dsl_property :row_unselected_symbol # added 2009-01-12 12:00 
     dsl_property :left_margin
+    dsl_accessor :sanitization_required # 2011-10-6 
     #dsl_accessor :valign  # popup related
     #
     # will pressing a single key move to first matching row. setting it to false lets us use vim keys
     attr_accessor :one_key_selection # will pressing a single key move to first matching row
     # index of row selected, relates to internal representation, not tree. @see selected_row
     attr_reader :selected_index   # index of row that is selected. this relates to representation
+    attr_reader :treemodel        # returns treemodel for further actions 2011-10-2 
 
     def initialize form, config={}, &block
       @focusable = true
@@ -75,12 +77,16 @@ module RubyCurses
       super
       #@selection_mode ||= :single # default is multiple, anything else given becomes single
       @win = @graphic    # 2010-01-04 12:36 BUFFERED  replace form.window with graphic
+      @sanitization_required = true
+      @longest_line = 0
       
      
       @win_left = 0
       @win_top = 0
       @_events.push(*[:ENTER_ROW, :LEAVE_ROW, :TREE_COLLAPSED_EVENT, :TREE_EXPANDED_EVENT, :TREE_SELECTION_EVENT, :TREE_WILL_COLLAPSE_EVENT, :TREE_WILL_EXPAND_EVENT])
 
+      
+      bind(:PROPERTY_CHANGE){|e| @cell_renderer = nil } # will be recreated if anything changes 2011-09-28 V1.3.1  
       init_vars
 
       #if !@list.selected_index.nil? 
@@ -114,11 +120,15 @@ module RubyCurses
       bind_key(KEY_RETURN) { toggle_expanded_state() }
       bind_key(?o) { toggle_expanded_state() }
       bind_key(?f){ ask_selection_for_char() }
-      bind_key(?\M-v){ @one_key_selection = true }
+      bind_key(?\M-v){ @one_key_selection = !@one_key_selection }
       bind_key(KEY_DOWN){ next_row() }
       bind_key(KEY_UP){ previous_row() }
       bind_key(?O){ expand_children() }
       bind_key(?X){ collapse_children() }
+      bind_key(?>, :scroll_right)
+      bind_key(?<, :scroll_left)
+      bind_key(?\M-l, :scroll_right)
+      bind_key(?\M-h, :scroll_left)
       # TODO
       bind_key(?x){ collapse_parent() }
       bind_key(?p){ goto_parent() }
@@ -156,15 +166,28 @@ module RubyCurses
         return @height - 3
       end
     end
-    # this allows a user to use this 2 times !! XXX
-    def root node, asks_allow_children=false, &block
+    #
+    # Sets the given node as root and returns treemodel.
+    # Returns root if no argument given.
+    # Now we return root if already set
+    # Made node nillable so we can return root. 
+    #
+    # @raise ArgumentError if setting a root after its set
+    #   or passing nil if its not been set.
+    def root node=nil, asks_allow_children=false, &block
+      if @treemodel
+        return @treemodel.root unless node
+        raise ArgumentError, "Root already set"
+      end
+
       raise ArgumentError, "root: node cannot be nil" unless node
       @treemodel = RubyCurses::DefaultTreeModel.new(node, asks_allow_children, &block)
     end
+
     # pass data to create this tree model
     # used to be list
     def data alist=nil
-      #return @treemodel if alist.nil?
+
       # if nothing passed, print an empty root, rather than crashing
       alist = [] if alist.nil?
       @data = alist # data given by user
@@ -253,7 +276,9 @@ module RubyCurses
       window = @graphic  # 2010-01-04 12:37 BUFFERED
       startcol = @col 
       startrow = @row 
-      bordercolor = @border_color || $datacolor
+      @color_pair = get_color($datacolor)
+#      bordercolor = @border_color || $datacolor # changed 2011 dts  
+      bordercolor = @border_color || @color_pair # 2011-09-28 V1.3.1 
       borderatt = @border_attrib || Ncurses::A_NORMAL
                            
       window.print_border startrow, startcol, height, width, bordercolor, borderatt
@@ -265,7 +290,7 @@ module RubyCurses
       if @title.length > @width - 2
         _title = @title[0..@width-2]
       end
-      @color_pair = get_color($datacolor)
+      @color_pair ||= get_color($datacolor)
       @graphic.printstring( @row, @col+(@width-_title.length)/2, _title, @color_pair, @title_attrib) unless @title.nil?
     end
     ### START FOR scrollable ###
@@ -417,12 +442,11 @@ module RubyCurses
     # a section of it.
     # FIXME: tree may not be clearing till end see appdirtree after divider movement
     def repaint
-      safe_create_buffer # 2010-01-04 12:36 BUFFERED moved here 2010-01-05 18:07 
       return unless @repaint_required
-      # not sure where to put this, once for all or repeat 2010-02-17 23:07 RFED16
+    
       my_win = @form ? @form.window : @target_window
       @graphic = my_win unless @graphic
-      #$log.warn "neither form not target window given!!! TV paint 368" unless my_win
+   
       raise " #{@name} neither form, nor target window given TV paint " unless my_win
       raise " #{@name} NO GRAPHIC set as yet                 TV paint " unless @graphic
       @win_left = my_win.left
@@ -431,6 +455,7 @@ module RubyCurses
       $log.debug "rtree repaint  #{@name} graphic #{@graphic}"
       print_borders unless @suppress_borders # do this once only, unless everything changes
       maxlen = @maxlen || @width-@internal_width
+      maxlen -= @left_margin # 2011-10-6 
       tm = _list()
       select_default_values
       rc = row_count
@@ -438,6 +463,7 @@ module RubyCurses
       acolor = get_color $datacolor
       h = scrollatrow()
       r,c = rowcol
+      @longest_line = @width #maxlen
       0.upto(h) do |hh|
         crow = tr+hh
         if crow < rc
@@ -452,24 +478,19 @@ module RubyCurses
               node = content
               object = content
               leaf = node.is_leaf?
+              # content passed is rejected by treecellrenderer 2011-10-6 
               content = node.user_object.to_s # may need to trim or truncate
               expanded = row_expanded? crow  
             elsif content.is_a? String
-              content = content.dup
-              content.chomp!
-              content.gsub!(/\t/, '  ') # don't display tab
-              content.gsub!(/[^[:print:]]/, '')  # don't display non print characters
-              if !content.nil? 
-                if content.length > maxlen # only show maxlen
-                  content = content[@pcol..@pcol+maxlen-1] 
-                else
-                  content = content[@pcol..-1]
-                end
-              end
+              $log.warn "Removed this entire block since i don't think it was used XXX  "
+              # this block does not set object XXX
             else
               raise "repaint what is the class #{content.class} "
               content = content.to_s
             end
+            # this is redundant since data is taken by renderer directly
+            #sanitize content if @sanitization_required
+            #truncate value
             ## set the selector symbol if requested
             selection_symbol = ''
             if @show_selector
@@ -480,10 +501,13 @@ module RubyCurses
               end
               @graphic.printstring r+hh, c, selection_symbol, acolor,@attr
             end
+
             renderer = cell_renderer()
             renderer.display_length(@width-@internal_width-@left_margin) # just in case resizing of listbox
+            renderer.pcol = @pcol
             #renderer.repaint @graphic, r+hh, c+@left_margin, crow, content, _focussed, selected
             renderer.repaint @graphic, r+hh, c+@left_margin, crow, object, content, leaf,  focus_type, selected, expanded
+            @longest_line = renderer.actual_length if renderer.actual_length > @longest_line 
         else
           # clear rows
           @graphic.printstring r+hh, c, " " * (@width-@internal_width), acolor,@attr
@@ -491,9 +515,8 @@ module RubyCurses
       end
       @table_changed = false
       @repaint_required = false
-      @buffer_modified = true # required by form to call buffer_to_screen BUFFERED
-      buffer_to_window # RFED16 2010-02-17 23:16 
     end
+
     def list_data_changed
       if row_count == 0 # added on 2009-02-02 17:13 so cursor not hanging on last row which could be empty
         init_vars
@@ -707,6 +730,39 @@ module RubyCurses
         end
       end
     end
+
+    #
+    # To retrieve the node corresponding to a path specified as an array or string
+    # Do not mention the root.
+    # e.g. "ruby/1.9.2/io/console"
+    # or %w[ ruby 1.9.3 io console ]
+    # @since 1.4.0 2011-10-2 
+    def get_node_for_path(user_path)
+      case user_path
+      when String
+        user_path = user_path.split "/"
+      when Array
+      else
+        raise ArgumentError, "Should be Array or String delimited with /"
+      end
+      $log.debug "TREE #{user_path} " if $log.debug? 
+      root = @treemodel.root
+      found = nil
+      user_path.each { |e| 
+        success = false
+        root.children.each { |c| 
+          if c.user_object == e
+            found = c
+            success = true
+            root = c
+            break
+          end
+        }
+        return false unless success
+
+      }
+      return found
+    end
     private
     # please do not rely on this yet, name could change
     def _structure_changed tf=true
@@ -716,6 +772,7 @@ module RubyCurses
     end
 
 
+
     # ADD HERE
   end # class tree