rbhex-core 1.0.0

data/LICENSE

@@ -0,0 +1,56 @@
+rbhex is a continuation of rbcurse, (c) rkumar, 2008-2013.
+You may redistribute and/or modify this software under either the terms of the
+2-clause BSDL  or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+    modifications to Usenet or an equivalent medium, or by allowing
+    the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) give non-standard binaries non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or binary form,
+     provided that you do at least ONE of the following:
+
+       a) distribute the binaries and library files of the software,
+    together with instructions (in the manual page or equivalent)
+    on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+    the software.
+
+       c) give non-standard binaries non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under these terms.
+
+     For the list of those files and their copying conditions, see the
+     file LEGAL.
+
+  5. The scripts and library files supplied as input to or produced as
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them,
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.

data/README.md

@@ -0,0 +1,44 @@
+# rbhex-core
+
+Contains core widgets and infrastructure of rbhex ncurses toolkit. rbhex helps to easily build
+ncurses applications for text terminals.
+
+rbhex-core contains basic widgets for constructing command line applications with ncurses.  These include:
+
+* field
+
+* buttons - checkbox, radio, toggle
+
+* list
+
+* textview
+
+* dialogs and popup
+
+* table
+
+* menu
+
+* tabbedpane
+
+* tree
+
+* application header
+
+* status line
+
+## Install
+
+`gem install rbhex-core`
+
+## Documentation
+
+In short, there isn't any - nor are there any plans to create any. The `/examples` directory
+contains many examples and should provide a nice start for you. Otherwise, the [tutorial for
+rbcurse](https://github.com/rkumar/rbcurse-tutorial) is still mostly valid for the majority of this
+codebase. 
+
+## rbcurse
+
+This project is a continuation/fork of [rkumar](https://github.com/rkumar)'s [rbcurse](https://github.com/rkumar/rbcurse-core). 
+rbcurse is no longer maintained as of March 2014.

data/examples/abasiclist.rb

@@ -0,0 +1,179 @@
+require 'rbhex/core/util/app'
+require 'rbhex/core/include/appmethods'
+require 'rbhex/core/widgets/rlist'
+
+  def my_help_text
+    <<-eos
+    abasiclist.rb
+    =========================================================================
+    Basic Usage
+
+    This simple example shows 2 lists inside a "flow". Each takes 50 percent
+    of the screen's width.
+
+    If you have brew installed, you can refresh the list to show actual
+    brew packages on your system, using ':r'. Then you can view info, edit,
+    or see the man page for that program.
+
+    In the second list, you can refresh the list with your gems using ":r".
+    Place cursor on any gem, and execute any of the ":" commands to see the
+    output. "edit" shells out to your EDITOR.
+
+    You can try multiple selection using <space> and <ctrl-space> for range
+    select. Check the general help screen for more _list_ commands. The selections
+    are not mapped to any command.
+
+    =========================================================================
+    :n or Alt-n for next buffer. 'q' to quit.
+
+    eos
+  end
+
+
+
+# just a simple test to ensure that rbasiclistbox is running inside a container.
+App.new do
+  def disp_menu
+    # ideally this shuld get action_manager and add_action so these are added to widgets actions
+    f = @form.get_current_field
+
+    if f.name == "lb1"
+      menu = PromptMenu.new self do
+        item :r, :refresh
+        item :i, :info
+        item :m, :brew_man
+        item :e, :edit
+      end
+    else
+      menu = PromptMenu.new self do
+        item :r, :refresh
+        item :e, :edit
+        item :d, :dependency
+        item :s, :specification
+        item :w, :which
+      end
+    end
+    menu.display_new :title => "Menu"
+  end
+  # fill list with actual gems available on your system
+  def refresh
+    f = @form.get_current_field
+    if f.name == "lb2"
+      l = %x[gem list --local].split("\n")
+      w = @form.by_name['lb2']
+      w.list l
+    else
+      l = %x[brew list].split("\n")
+      w = @form.by_name['lb1']
+      w.list l
+    end
+  end
+  def specification
+    w = @form.by_name['lb2']
+    name = w.text.split()[0]
+    textdialog(%x[ gem specification #{name} ].split("\n") , :title => 'Specification')
+  end
+
+  # execute just man for the brew package
+  def brew_man
+    w = @form.by_name['lb1']
+    name = w.text.split()[0]
+    shell_out "man #{name}"
+  end
+
+  # using gem which to get path, and then shelling out to EDITOR
+  def edit
+    f = @form.get_current_field
+    if f.name == "lb2"
+      name = f.text.split()[0]
+      shell_out "gem edit #{name}"
+    else
+      name = f.text.split()[0]
+      shell_out "brew edit #{name}"
+    end
+    return
+
+    # this is our own home-cooked version which opens the actual file in your editor
+    res = %x[ gem which #{name} ].split("\n")
+    res = res[0]
+    if File.exists? res
+      require './common/file.rb'
+      file_edit res
+    end
+  end
+  #
+  # general purpose command to catch miscellaneous actions that can be
+  # executed in the same way. Or even take complex command lines
+  # such as what vim has.
+  def execute_this *cmd
+    f = @form.get_current_field
+    if f.name == "lb2"
+      m = "gem"
+    else
+      m = "brew"
+    end
+    w = f
+    name = w.text.split()[0]
+    cmd = cmd[0].to_s
+    res = %x[ #{m} #{cmd} #{name}].split("\n")
+    res ||= "Error in command [#{cmd}] [#{name}] "
+    textdialog( res, :title => cmd ) if res
+  end
+  # handle resizing, sadly I am not sure flow and stack can do a resize, i am sure the xperimental one can.
+  def resize
+    lb1 = @form.by_name["lb1"]
+    lb2 = @form.by_name["lb2"]
+    maxc = Ncurses.COLS
+    maxr = Ncurses.LINES
+    lb1.height = maxr-2
+    lb2.height = maxr-2
+    lb1.width = ((lb1.width_pc * maxc) / 100).floor
+    lb2.width = ((lb2.width_pc * maxc) / 100).floor
+    lb2.col   = lb1.col + lb1.width
+    lab = @form.by_name["lab"]
+    lab.row = maxr-1
+  end
+
+  colors = Ncurses.COLORS
+  back = :blue
+  back = 234 if colors >= 256
+  header = app_header "rbhex #{Rbhex::Core::VERSION}", :text_center => "Basic List Demo", :text_right =>"New Improved!", :color => :white, :bgcolor => back #, :attr => :bold
+  message "Press F10 to escape from here"
+  #install_help_text my_help_text
+  @form.help_manager.help_text = my_help_text
+
+  @form.define_prefix_command :csmap, :scope => self
+  #@form.define_key(:csmap, "r", 'refresh') { refresh }
+  @form.define_key(:csmap, "r", 'refresh', :refresh )
+  @form.define_key(:csmap, "s", 'specification') { specification }
+  @form.bind_key ?\C-s, :csmap
+  #pm = PrefixCommand.new :csmap, self do |p|
+    #p.key("r", 'refresh', :refresh )
+    #p.key("s", 'specification'){ specification }
+  #end
+  #@form.bind_key(?\C-x){ pm.call }
+
+  alist = File.open(File.expand_path("../data/brew.txt", __FILE__), 'r').readlines
+  list2 = File.open(File.expand_path("../data/gemlist.txt", __FILE__), 'r').readlines
+  lb = nil
+
+  flow :margin_top => 1, :height => FFI::NCurses.LINES-2 do
+    lb = listbox :list => alist, :suppress_borders => false, :title => "[ brew packages ]",
+      :left_margin => 1, :width_pc => 50, :name => 'lb1'
+    lb.show_selector = false
+
+    lb2 = listbox :list => list2, :justify => :left, :title => "[ gems ]", :suppress_borders => false,
+      :left_margin => 1, :width_pc => 50, :name => 'lb2'
+    end
+
+
+  label({:text => "F1 Help, F10 Quit. : for menu. Press F4 and F5 to test popup, space or enter to select", :row => Ncurses.LINES-1, :col => 0, :name => 'lab'})
+
+  @form.bind(:RESIZE) { resize() }
+  @form.bind_key(FFI::NCurses::KEY_F4) { row = lb.current_index+lb.row; col=lb.col+lb.current_value.length+1;  ret = popuplist(%w[ andy berlioz strauss tchaiko matz beethoven], :row => row, :col => col, :title => "Names", :bgcolor => :blue, :color => :white) ; alert "got #{ret} "}
+
+  @form.bind_key(FFI::NCurses::KEY_F5) {  list = %x[ls].split("\n");ret = popuplist(list, :title => "Files"); alert "Got #{ret} #{list[ret]} " }
+
+  @form.bind_key(?:) { disp_menu;
+  }
+end # app

data/examples/alpmenu.rb

@@ -0,0 +1,50 @@
+require 'rbhex/core/util/app'
+
+  def load_relative(path)
+    load File.expand_path("../#{path}", __FILE__)
+  end
+
+  App.new do
+    #title "Demo of Menu - rbhex"
+    #subtitle "Hit F1 to quit, F2 for menubar toggle"
+    header = app_header "rbhex #{Rbhex::Core::VERSION}", :text_center => "Alpine Menu Demo", :text_right =>""
+
+    stack :margin_top => 10, :margin_left => 15 do
+      #w = "Messages".length + 1
+      w = 60
+      menulink :text => "&View Dirs", :width => w, :description => "View Dirs in tree"  do |s, *stuff|
+        message "Pressed #{s.text} "
+        load_relative './dirtree.rb'
+        #require './viewtodo'; todo = ViewTodo::TodoApp.new; todo.run
+      end
+      blank
+      menulink :text => "&Tabular", :width => w, :description => "Tabula Rasa"  do |s, *stuff|
+        message "Pressed #{s.text} "
+        load_relative './tabular.rb'
+        #require './testtodo'; todo = TestTodo::TodoApp.new; todo.run
+      end
+      blank
+      menulink :text => "&Messages", :width => w, :description => "View Tasks"  do |s, *stuff|
+        message "Pressed #{s.text} "
+        load_relative './tasks.rb'
+      end
+      blank
+      menulink :text => "&Database", :width => w, :description => "Database Demo"  do |s, *stuff|
+        message "Pressed #{s.getvalue} "
+        load_relative './dbdemo.rb'
+      end
+      blank
+      # somehow ? in mnemonic won't work
+      menulink :text => "&Setup", :width => w, :description => "Configure Alpine options"  do |s, *stuff|
+        #message "Pressed #{s.text} "
+        alert "Not done!"
+      end
+      blank
+      menulink :text => "&Quit", :width => w, :description => "Quit this application"  do |s, *stuff|
+        quit
+      end
+      @form.bind(:ENTER) do |w|
+        header.text_right = w.text
+      end
+    end # stack
+  end # app

data/examples/app.sample

@@ -0,0 +1,19 @@
+require 'rbhex/core/util/app'
+def help_text
+<<-eos
+Enter as much help text
+here as you want
+eos
+end
+
+App.new do
+    ## application code comes here
+    @form.help_manager.help_text = help_text()
+
+    @header = app_header "My App", :text_center => "Yet Another Email Client that sucks", :text_right =>"Some text", :color => :black, :bgcolor => :white
+
+    @status_line = status_line
+    @status_line.command {
+
+    }
+end # app

data/examples/atree.rb

@@ -0,0 +1,100 @@
+require 'rbhex/core/util/app'
+
+App.new do
+  var = Variable.new
+  header = app_header "rbhex #{Rbhex::Core::VERSION}", :text_center => "Tree Demo", :text_right =>"New Improved!", :color => :black, :bgcolor => :white, :attr => :bold
+  message "Press Enter to expand/collapse"
+
+      @form.bind_key(FFI::NCurses::KEY_F3) {
+        require 'rbhex/core/util/viewer'
+        RubyCurses::Viewer.view("rbc13.log", :close_key => KEY_ENTER, :title => "<Enter> to close")
+      }
+
+      ww = FFI::NCurses.COLS-0
+      flow :width => ww , :margin_top => 1, :height => FFI::NCurses.LINES-2 do
+        stack :margin_top => 0, :width_pc => "30" do
+          tm = nil
+          atree = tree :height => 10, :title => '[ ruby way ]'  do
+            root "root" do
+              branch "hello" do
+                leaf "ruby"
+              end
+              branch "goodbye" do
+                leaf "java"
+                leaf "verbosity"
+              end
+            end
+          end
+          found=atree.get_node_for_path "goodbye"
+          atree.set_expanded_state(atree.root, true)
+          atree.set_expanded_state(found,true)
+
+          # using a Hash
+          model = { :ruby => [ "jruby", {:mri => %W[ 1.8.6 1.8.7]}, {:yarv => %W[1.9.1 1.9.2]}, "rubinius", "macruby" ], :python => %W[ cpython jython laden-swallow ] }
+          tree :data => model, :title => "[ Hash ]"
+
+        end # stack
+        stack :margin_top => 0, :width_pc => "30" do
+
+          # using an Array, these would be expanded on selection, using an event
+          tree :data => Dir.glob("*"), :title=> "[ Array ]" do
+            command do |node|
+              # insert dir entries unless done so already
+              if node.children && !node.children.empty?
+              else
+                f = node.user_object
+                if File.directory? f
+                  l = Dir.glob(f + "/*")
+                  node.add(l) if l
+                end
+              end
+            end
+            bind :ENTER_ROW do |t|
+              var.value = t.text.user_object
+            end
+          end
+
+          # long way ISO 9001 certifed, SEI CMM 5 compliant
+          #
+          root    =  TreeNode.new "ROOT"
+          subroot =  TreeNode.new "subroot"
+          leaf1   =  TreeNode.new "leaf 1"
+          leaf2   =  TreeNode.new "leaf 2"
+          model = DefaultTreeModel.new root
+          #model.insert_node_into(subroot, root,  0)  # BLEAH JAVA !!
+
+          # slightly better, since we return self in ruby
+          root << subroot
+          subroot << leaf1 << leaf2
+          leaf1 << "leaf11"
+          leaf1 << "leaf12"
+
+          # more rubyish way
+          root.add "blocky", true do
+            add "block2"
+            add "block3" do
+              add "block31"
+            end
+          end
+
+          tree :data => model, :title => "[ legacy way ]"
+
+        end
+        #stack :margin_top => 2 do
+        stack :margin_top => 0, :width_pc => "40", :height => :expand do
+          t = textview  :suppress_borders => true, :height_pc => 100
+            var.command do |filename|
+              filename = filename.value
+              if File.directory? filename
+                lines = Dir.entries(filename )
+                t.set_content lines
+              elsif File.exist? filename
+                lines = File.open(filename,'r').readlines
+                t.set_content lines
+              else
+                alert " #{filename} does not appear to be a file "
+              end
+            end
+        end
+      end # flow
+end # app