canis 0.0.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 816492c76956497f6216f58530ac662a8914f404
+  data.tar.gz: 81030d5970df8c6ada548ad6a5cbe1782d8c2f16
+SHA512:
+  metadata.gz: 6a2294dabd5cd4b38db99ca783c7b3d2005dd9c3b3cb2823c4d284cf60d88f503f870cca06b9596224696a4e70f611417a9e29a341f862921df3e07497face81
+  data.tar.gz: 6510464a766ee936761d32fbbaef6e2d9ed21f3e81d7425956f7d45de5dd2d5b1797cfd71c8799f1499187917f1d8a4c971ab8c0de88d777f134ed00730873f5

data/.gitignore

@@ -0,0 +1,45 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+*.log
+*.sqlite
+*.bak
+todo
+issues
+deprecated
+.srclist
+NOTES
+bug
+examples/common/rmail.rb
+examples/dump.yml
+examples/oldwidgetshortcuts.rb
+examples/test2.rb
+examples/testskel.rb
+examples/teststackflow.rb
+examples/todo.txt
+examples/ugu.rb
+examples/x.tsv
+examples/xxx.rb
+issues.txt
+tags
+test.yml
+todo.0.0.1

data/CHANGES

@@ -0,0 +1,52 @@
+2014-04-22 - 00:13 
+
+Made some changes in getchar to return STRINGS but not implemented. Evaluating benefits
+in moving to chars, and how to go about.
+
+2014-04-23 - 00:23 
+
+removed many dead methods from window and some from widget
+slight changes in button and label : when_form replaced by FORM_ATTACHED
+
+2014-05-05 - 20:12 
+
+- moved to new cleaner method of reading keys from keyboard
+- Added ButtonGroup for RadioButtons.
+- removed Bottomline and enhanced rcommandline instead
+
+2014-05-09 - 22:23 
+
+- introduced layouts. Now a user can hardcode locations of widgets or use a layout
+  to do the same. A layout is able to handle a resize of the screen.
+
+2014-05-25 - 16:03 
+
+- Major rewrite of colorparser. now colors are not hardcoded while parsing. We now store link
+  to parent chunk, so that a change in textpads color can affect the pad without a re-parse.
+  Parent's color's are resolved at render time.
+
+2014-05-31 - 18:20 
+- minor changes that could result in some color related issues with buttons or other widgets
+  - repaint in various widgets no longer sets @bgcolor and @color, it uses the method
+    Same with @attr. messagebox also does not set the color variables but uses the method
+  - clear_pad clear_row uses content_cols i/o width so complete pad is cleared.
+    Also i have put a return in the middle, i think the second part of clear is redundant
+    now, if the first half works properly.
+
+2014-06-06 - 00:05 
+- Released 0.0.1
+
+2014-06-19 - 17:16 
+- Still trying to simplify and refactor TextPad so there are no changes for a fairly long time.
+- Removed content_type complexity into TextDocument so Textpad can be dumb.
+
+Built 0.0.2 but i did not release it.
+
+2014-07-09 - 22:48 
+- for 0.0.3
+  - removed label string from Field and moved to LabeledField
+    This change has an impact in many examples, and combo
+  - some changes in creation of $log so that if none specified then it can go to /dev/null
+    This way an app can have its own logger and not bother about canis' logging.
+    Or it can merge the two.
+  - Moved helpmanager from rwidgets to its own file. Needs to be refactored and cleaned up.

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in canis.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 kepler
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,24 @@
+# Canis
+
+ncurses library for ruby with essential components/controls only
+
+Things are looking better now. Textpad seems to be more or less stable as far 
+as changes are concerned
+
+## Installation
+
+    gem install canis
+
+## Usage
+
+TODO: Write usage instructions here
+
+Textpad is more or less frozen. I have also simplified Field a bit.
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/canis/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/canis.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'canis/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "canis"
+  spec.version       = Canis::VERSION
+  spec.authors       = ["kepler"]
+  spec.email         = ["githubkepler.50s@gishpuppy.com"]
+  spec.summary       = %q{ruby ncurses library for easy application development}
+  spec.description   = %q{ruby ncurses library for easy application development providing most controls, minimal source}
+  spec.homepage      = "https://github.com/mare-imbrium/canis"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", ">= 0.9.6"
+  #spec.add_development_dependency "ffi-ncurses", ">= 0.4.0"
+  spec.add_runtime_dependency "ffi-ncurses", ">= 0.4.0", ">= 0.4.0"
+end

data/examples/alpmenu.rb

@@ -0,0 +1,46 @@
+require 'canis/core/util/app'
+
+  App.new do 
+    #title "Demo of Menu - canis"
+    #subtitle "Hit F1 to quit, F2 for menubar toggle"
+    header = app_header "canis #{Canis::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 './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 './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 './tasks.rb'
+      end
+      blank
+      menulink :text => "&Database", :width => w, :description => "Database Demo"  do |s, *stuff|
+        message "Pressed #{s.getvalue} "
+        load './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 'canis/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 #{MyApp::VERSION}", :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/appemail.rb

@@ -0,0 +1,191 @@
+require 'canis/core/util/app'
+require 'fileutils'
+require './common/rmail'
+# You need mailread.rb which is present in 1.8, but missing in 1.9
+# I've loaded it here ... http://gist.github.com/634166 with line encoding
+# You need to fix paths of local mbox files
+
+# this will go into top namespace so will conflict with other apps!
+def testchoose
+  # list filters as you type
+  $log.debug "called CHOOSE " if $log.debug? 
+  filter = "*"
+  filter = ENV['PWD']+"/*"
+  str = choose filter, :title => "Files", :prompt => "Choose a file: "
+  message "We got #{str} " 
+end
+def testnumberedmenu
+  list1 =  %w{ ruby perl python erlang rake java lisp scheme chicken }
+  list1[0] = %w{ ruby ruby1.9 ruby1.8.x jruby rubinius ROR }
+  list1[5] = %w{ java groovy grails }
+  str = numbered_menu list1, { :title => "Languages: ", :prompt => "Select :" }
+  $log.debug "17 We got #{str.class} "
+  message "We got #{str} "
+end
+def testdisplay_list
+  # scrollable list
+  str = display_list Dir.glob("t*.rb"), :title => "Select a file"
+  $log.debug "23 We got #{str} :  #{str.class} , #{str.list[str.current_index]}  "
+  message "We got #{str.list[str.current_index]} "
+end
+def testdisplay_text
+  str = display_text_interactive File.read($0), :title => "#{$0}"
+end
+def testdir
+  # this behaves like vim's file selector, it fills in values
+  str = ask("File?  ", Pathname)  do |q| 
+    q.completion_proc = Proc.new {|str| Dir.glob(str +"*").collect { |f| File.directory?(f) ? f+"/" : f  } }
+    q.helptext = "Enter start of filename and tab to get completion"
+  end
+  message "We got #{str} "
+end
+def test
+end
+def saveas1
+  @tv.saveas 
+end
+
+# experimental. 
+# if components have some commands, can we find a way of passing the command to them
+# method_missing gave a stack overflow.
+def execute_this(meth, *args)
+  $log.debug "app email got #{meth}  " if $log.debug? 
+  cc = @vim.current_component
+  [cc, @lb2, @tv].each do |c|  
+    if c.respond_to?(meth, true)
+      c.send(meth, *args)
+      return true
+    end
+  end
+  false
+end
+
+App.new do 
+  ht = 24
+  @messages = nil
+  $unread_hash = {}
+  @tv = nil
+  borderattrib = :reverse
+  @header = app_header "canis #{Canis::VERSION}", :text_center => "Yet Another Email Client that sucks", :text_right =>"", :color => :black, :bgcolor => :white
+  message "Press F10 to exit ...................................................."
+
+
+  stack :margin_top => 1, :margin => 0, :width => :EXPAND do
+    # NOTE: please fix the next 2 lines based on where your mbox files reside
+    model = ["~/mbox"] 
+    others = "~/mail/"
+    boxes = Dir.new(File.expand_path(others)).entries
+    boxes.delete(".")
+    boxes.delete("..")
+    boxes = boxes.collect do |e| others+e; end
+    model.push *boxes
+
+    #@vim = MasterDetail.new @form, :row => 1, :col => 1, :width => :EXPAND
+    @vim = master_detail :width => :EXPAND
+    @dirs = listbox :list => model, :height => ht, :border_attrib => borderattrib, :suppress_borders => true
+    @dirs.one_key_selection = false
+    
+    # commands that can be mapped to or executed using M-x
+    # however, commands of components aren't yet accessible.
+    def get_commands
+      %w{ testchoose testnumberedmenu testdisplay_list testdisplay_text testdir saveas1 }
+    end
+    # we override/open instance so as to only print basename. Also, print unread count 
+    def @dirs.convert_value_to_text(text, crow)
+      str = File.basename(text)
+      if $unread_hash.has_key?(str)
+        str << " (#{$unread_hash[str]})"
+      else
+        str 
+      end
+    end
+    def test1XX
+      $log.debug "called test1 " if $log.debug? 
+      str = choose "*.rb", :title => "Files", :prompt => "Choose a file: "
+    end
+    def help_text
+      <<-eos
+               APPEMAIL HELP 
+
+      This is some help text for appemail.
+      We are testing out this feature.
+
+      Alt-x    -   Command mode (<tab> to see commands and select)
+      :        -   Command mode
+      <Enter>  -   Display mail headers for mailbox
+                   Display body for selected header
+      F3       -   Enable sidebars in order to change size of windows (toggle)
+      F10      -   Quit application
+
+      Some commands for using bottom of screen as vim and emacs do.
+
+      testchoose       - filter directory list as you type
+      testdir          - vim style, tabbing completes matching files
+      testnumberedmenu - use menu indexes to select options
+      testdisplaylist  - display a list at bottom of screen
+      testdisplaytext  - display text at bottom
+
+      -----------------------------------------------------------------------
+      Hope you enjoyed this help.
+      eos
+    end
+    @vim.set_left_component @dirs
+
+    
+    @mails = []
+    headings = %w{ Stat #  Date From Subject }
+    @lb2 = tabular_widget :suppress_borders => true
+    @lb2.columns = headings
+    @lb2.column_align 1, :right
+    @lb2.column_align 0, :right
+    @lb2.header_fgcolor :white
+    @lb2.header_bgcolor :cyan
+    @vim.set_right_top_component @lb2
+    @dirs.bind :PRESS do |e|
+      @lines = []
+      mx = Mbox.new File.expand_path(e.text)
+      mx.array_each do |text|
+        @lines << text
+      end
+      message_immediate " #{e.text} has #{@lines.size} messages"
+      $unread_hash[File.basename(e.text)] = mx.unread_count
+      @lb2.set_content @lines
+      @lb2.estimate_column_widths=true
+      @messages = mx.mails()
+    end
+    @lb2.bind :PRESS do |e|
+      case @lb2
+      when Canis::TabularWidget
+        if e.action_command == :header
+          # now does sorting on multiple keys
+        else
+          index = e.source.current_index - 1 # this should check what first data index is
+          if index >= 0
+            @tv.set_content(@messages[index].body, :WRAP_WORD)
+          end
+        end
+      else
+        @tv.set_content(@messages[e.source.current_index].body, :WRAP_WORD)
+      end
+    end
+    @lb2.bind :ENTER_ROW do |e|
+      @header.text_right "Row #{e.current_index} of #{@messages.size} "
+      message "Row #{e.current_index} of #{@messages.size} "
+      raw_message "Row #{e.current_index} of #{@messages.size} " # 2011-10-17 14:08:27
+      x = e.current_index
+      y = @messages.size
+      #raw_progress((x*1.0)/y)
+      #raw_progress([x,y])
+    end
+
+    @tv = @vim.set_right_bottom_component "Email body comes here. "
+    @tv.suppress_borders true
+    @tv.border_attrib = borderattrib
+  end # stack
+  @statusline = status_line :row => Ncurses.LINES-1
+  #@statusline.command { }
+  @form.bind_key(?\M-v) { test11() }
+  @form.bind_key(?\M-V) { testme() }
+  @form.bind_key(?\M-c) { test1() }
+  @form.bind_key(?\M-C) { test2() }
+end # app