palaver 0.2.0

data/.gitignore

@@ -0,0 +1 @@
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012, Peter Allin <peter@peca.dk>
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted
+provided that the following conditions are met:
+
+- Redistributions of source code must retain the above copyright notice, this list of conditions and
+  the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice, this list of conditions
+  and the following disclaimer in the documentation and/or other materials provided with the
+  distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
+THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,16 @@
+# Palaver -- A 'dialog' API for Ruby
+
+Palaver is a ruby library for making text user interfaces based on the program "dialog"
+(http://invisible-island.net/dialog/). It aims at making all the features of the "dialog" program
+available for Ruby programs.
+
+The project was started because the RDialog (http://rdialog.rubyforge.org/) project with similar
+aims seemed idle and missed some features that I needed. I also felt that RDialogs API was not a
+very good match for some of the more complex dialogs supported by the "dialog" program.
+
+In order to scratch these itches I have implemented, what I call the "blocks based API", in
+Palaver. This API works by passing a Ruby block to a factory method, the function calls in this
+block then defines the dialog to be created. I believe this kind of API is well suited for things
+like the "menu" and "form" dialogs from the "dialog" program. For the simpler dialogs a more
+conventional API where the factory methods are given hashes containing parameter to value mappings
+is implemented. The examples in the "examples" directory show how both kind of APIs can be used.

data/Rakefile

@@ -0,0 +1,21 @@
+require 'rake'
+require 'rubygems/package_task'
+
+gemspec = eval(File.read("palaver.gemspec"))
+
+desc "Validate the gemspec"
+task :gemspec do
+  gemspec.validate
+end
+
+desc "Build gem locally"
+task :build => :gemspec do
+  system "gem build #{gemspec.name}.gemspec"
+  FileUtils.mkdir "pkg" unless File.exists? "pkg"
+  FileUtils.mv "#{gemspec.name}-#{gemspec.version}.gem", "pkg"
+end
+
+desc "Clean automatically generated files"
+task :clean do
+  FileUtils.rm_rf "pkg"
+end

data/examples/calendar.rb

@@ -0,0 +1,14 @@
+require 'palaver'
+require 'date'
+
+dialog_factory = Palaver::DialogFactory.new
+
+# Using the hash based API with the calendar dialog
+start_date = dialog_factory.calendar(:text => "Choose the start date", :date => Date.new(1939,9,1)).show
+
+# Using the block based API with the calendar dialog. This probably doesn'palaver'
+# simple widget like the calendar.
+end_date = dialog_factory.calendar { text "Choose the end date"; date Date.new(1945,9,2); }.show
+
+puts start_date
+puts end_date

data/examples/checklist.rb

@@ -0,0 +1,28 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+chosen1 = dialog_factory.checklist(:text => "Which do you want, hash style?",
+                                   :options => [
+                                                [ "fisk", "A confusing choice for a metasyntactic variable name", :off ],
+                                                [ "foo", "The classic first metasyntactic variable name", :on ],
+                                                [ "bar", "The classic second metasyntactic variable name", :off ],
+                                                [ "baz", "The classic third metasyntactic variable name", :off ],
+                                                [ "quux", "A quite unusual metasyntactic variable name", :off ]
+                                               ]).show
+
+chosen2 = dialog_factory.checklist {
+  text "Which do you want, block style?"
+  option "fisk", "A confusing choice for a metasyntactic variable name"
+  option "foo", "The classic first metasyntactic variable name", :on
+  option "bar", "The classic second metasyntactic variable name", :on
+  option "baz", "The classic third metasyntactic variable name", :on
+  option "quux", "A quite unusual metasyntactic variable name"
+}.show
+
+puts "Chosen from the dialog created with the hash style:"
+puts chosen1
+puts
+puts "Chosen from the dialog created with the block style"
+puts chosen2
+

data/examples/dselect.rb

@@ -0,0 +1,13 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+# Using the hash based API for requesting the user to choose a directory
+dir_hash = dialog_factory.dselect(:path => "/").show
+
+# Using the block based API for requesting the user to choose a directory
+dir_block = dialog_factory.dselect { path "/" }.show
+
+puts "Dir chosen with hash method #{dir_hash}"
+puts "Dir chosen with block method #{dir_block}"
+

data/examples/form.rb

@@ -0,0 +1,16 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+answers = dialog_factory.form {
+  text "Foos and their texts"
+  height 10
+  form_height 5
+  entry :first, "First foo", 1, 0, "Default text for first foo", 1, 15, 20, 200
+  entry :second, "Second foo", 1, 40, "Default text for second foo", 1, 55, 20, 200
+  entry :third, "Third foo", 3, 0, "Default text for third foo", 3, 15, 20, 200
+}.show
+
+answers.keys.each do |k|
+  puts "#{k}: #{answers[k]}"
+end

data/examples/form_simple.rb

@@ -0,0 +1,18 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+answers = dialog_factory.form {
+  text "Simple-entry foos and their texts"
+  height 10
+  form_height 5
+  simple_display_width 30
+  simple_text_length 200
+  simple_entry :first, "First foo", "Default text for first foo"
+  simple_entry :second, "Second foo", "Default text for second foo"
+  simple_entry :third, "Third foo", "Default text for third foo"
+}.show
+
+answers.keys.each do |k|
+  puts "#{k}: #{answers[k]}"
+end

data/examples/fselect.rb

@@ -0,0 +1,13 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+# Using the hash based API for requesting the user to choose a fileectory
+file_hash = dialog_factory.fselect(:path => "/", :width => 60, :height => 10).show
+
+# Using the block based API for requesting the user to choose a fileectory
+file_block = dialog_factory.fselect { path "/"; width 60; height 10; }.show
+
+puts "File chosen with hash method #{file_hash}"
+puts "File chosen with block method #{file_block}"
+

data/examples/infobox.rb

@@ -0,0 +1,14 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+dialog_factory.infobox(:text => "This is information from the hash based api").show
+sleep 2
+dialog_factory.infobox(:text => "This is wide information from the hash based api", :width => 60, :height => 10).show
+sleep 2
+
+dialog_factory.infobox{ text "This is information from the block based api" }.show
+sleep 2
+dialog_factory.infobox{ text "This is wide information from the block based api"; width 60; height 10 }.show
+sleep 2
+

data/examples/inputbox.rb

@@ -0,0 +1,16 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+# Using the hash based API for asking a question in an input box
+answer_hash = dialog_factory.inputbox(:text => "What do you think about the hash based API?", :initial => "I like it very much" ).show
+
+# Using the block based API for asking a question in an input box
+answer_block = dialog_factory.inputbox{ text "What do you think about the block based API?"; initial "I love it"; }.show
+
+# Using the block based API, with no initial value
+answer_ruby = dialog_factory.inputbox { text "What do you think about Ruby? (be creative)" }.show
+
+puts "Answer to the hash question: #{answer_hash}"
+puts "Answer to the block question: #{answer_block}"
+puts "Answer to the Ruby question: #{answer_ruby}"

data/examples/menu.rb

@@ -0,0 +1,28 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+chosen1 = dialog_factory.menu(:text => "Choose from the menu, hash style",
+                              :options => [
+                                           [ "fisk", "A confusing choice for a metasyntactic variable name", :off ],
+                                           [ "foo", "The classic first metasyntactic variable name", :on ],
+                                           [ "bar", "The classic second metasyntactic variable name", :off ],
+                                           [ "baz", "The classic third metasyntactic variable name", :off ],
+                                           [ "quux", "A quite unusual metasyntactic variable name", :off ]
+                                          ]).show
+
+chosen2 = dialog_factory.menu {
+  text "Choose from the menu, block style"
+  option "fisk", "A confusing choice for a metasyntactic variable name"
+  option "foo", "The classic first metasyntactic variable name", :on
+  option "bar", "The classic second metasyntactic variable name", :on
+  option "baz", "The classic third metasyntactic variable name", :on
+  option "quux", "A quite unusual metasyntactic variable name"
+}.show
+
+puts "Chosen from the dialog created with the hash style:"
+puts chosen1
+puts
+puts "Chosen from the dialog created with the block style"
+puts chosen2
+

data/examples/msgbox.rb

@@ -0,0 +1,9 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+# Using the hash based API for showing a msgbox
+dialog_factory.msgbox(:text => "This is a message from the hash based API").show
+
+# Using the block based API for showing a msgbox
+dialog_factory.msgbox { text "This is a message from the block based API" }.show

data/examples/passwordbox.rb

@@ -0,0 +1,16 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+# Using the hash based API to ask for a password
+hash_pw = dialog_factory.passwordbox(:text => "Please enter password, hash style").show
+hash_pw_insec = dialog_factory.passwordbox(:text => "Please enter password, more usable hash style", :insecure => true).show
+# Using the block based API to ask for a password
+block_pw = dialog_factory.passwordbox{ text "Please enter passwrod, block style" }.show
+block_pw_insec = dialog_factory.passwordbox{ insecure; text "Please enter passwrod, more usable block style" }.show
+
+puts "Hash password: #{hash_pw}"
+puts "Hash password (entered in less secure way): #{hash_pw_insec}"
+puts "Block password: #{block_pw}"
+puts "Block parssword (entered ien less secure way): #{block_pw_insec}"
+

data/examples/pause.rb

@@ -0,0 +1,14 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+accepted_hash_style = dialog_factory.pause(:text => "Pause, hash style", :seconds => 15, :width => 40, :height => 8).show
+accepted_block_style = dialog_factory.pause{ text "Pause, block style";  seconds 20; width 30; height 8; }.show
+
+if accepted_hash_style then
+  puts "You accepted the hash style pause"
+end
+
+if accepted_block_style then
+  puts "You accepted the block style pause"
+end

data/examples/radiolist.rb

@@ -0,0 +1,28 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+chosen1 = dialog_factory.radiolist(:text => "Choose one, hash style",
+                                   :options => [
+                                                [ "fisk", "A confusing choice for a metasyntactic variable name", :off ],
+                                                [ "foo", "The classic first metasyntactic variable name", :on ],
+                                                [ "bar", "The classic second metasyntactic variable name", :off ],
+                                                [ "baz", "The classic third metasyntactic variable name", :off ],
+                                                [ "quux", "A quite unusual metasyntactic variable name", :off ]
+                                               ]).show
+
+chosen2 = dialog_factory.radiolist {
+  text "Choose one, block style"
+  option "fisk", "A confusing choice for a metasyntactic variable name"
+  option "foo", "The classic first metasyntactic variable name", :on
+  option "bar", "The classic second metasyntactic variable name"
+  option "baz", "The classic third metasyntactic variable name"
+  option "quux", "A quite unusual metasyntactic variable name"
+}.show
+
+puts "Chosen from the dialog created with the hash style:"
+puts chosen1
+puts
+puts "Chosen from the dialog created with the block style"
+puts chosen2
+

data/examples/textbox.rb

@@ -0,0 +1,9 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+# How to view a file in a dialog using the hash API
+dialog_factory.textbox(:filename => ARGV[0]).show
+
+# How to view a file in a dialog using the block API, does not make much sense
+dialog_factory.textbox { filename ARGV[1] }.show

data/examples/yesno.rb

@@ -0,0 +1,15 @@
+require 'palaver'
+
+dialog_factory = Palaver::DialogFactory.new
+
+# Using the hash based API, which makes most sense for this kind of dialog
+likes_hash_based_api = dialog_factory.yesno(:text => "Do you like the hash based API?").show
+
+# Using the block based API
+likes_block_based_api = dialog_factory.yesno { text "Do you like the block based API?" }.show
+
+if likes_block_based_api or likes_hash_based_api then
+  puts "Great"
+else
+  puts "What a pity. Try RDialog instead, it's also very nice"
+end

data/lib/palaver/base.rb

@@ -0,0 +1,40 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+module Palaver
+  class Base
+    def initialize(options)
+      @text = nil
+      @width = 0
+      @height = 0
+
+      options.each do |option,value|
+        case option
+        when :width then self.width(value)
+        when :height then self.height(value)
+        when :text then self.text(value)
+        end
+      end
+    end
+
+    def text(str)
+      @text = str
+    end
+    
+    def width(w)
+      @width = w
+    end
+
+    def height(h)
+      @height = h
+    end
+
+    def with_tempfile
+      tf = Tempfile.new "palaver"
+      tfpath = tf.path
+      tf.close
+      yield tfpath
+      File.delete tfpath
+    end
+  end
+end

data/lib/palaver/calendar.rb

@@ -0,0 +1,43 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+require 'tempfile'
+require 'date'
+require 'palaver/base'
+
+module Palaver
+  class Calendar < Palaver::Base
+    def initialize(options={})
+      super(options)
+      @default_date = nil
+
+      options.each do |option,value|
+        case option
+        when :date then self.date(value)
+        end
+      end
+      
+    end
+    
+    def date(d)
+      @default_date = d
+    end
+
+    def show
+      day, month, year =
+        if @default_date then [ @default_date.day, @default_date.month, @default_date.year]
+        else [ 0, 0, 0 ]
+        end
+      chosen_date = nil
+      with_tempfile do |tfpath|
+        cmd = 'dialog --calendar "%s" %d %d %d %d %d 2> %s' % [ @text,
+                                                                @height, @width, 
+                                                                day, month, year,
+                                                                tfpath ]
+        success = system cmd
+        chosen_date = Date.strptime(File.read(tfpath), "%d/%m/%Y") if success
+      end
+      return chosen_date
+    end
+  end
+end

data/lib/palaver/checklist.rb

@@ -0,0 +1,24 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+require 'palaver/list_with_options'
+
+module Palaver
+  class Checklist < Palaver::ListWithOptions
+    def initialize(options)
+      super(options)
+    end
+    
+    def show
+      choices = nil
+      with_tempfile do |fname|
+        cmd = "dialog --checklist '#@text' #@height #@width #@list_height #{options_string_with_status} 2> #{fname}"
+        success = system cmd
+        if success then
+          choices = File.read(fname).split(" ").map { |s| s[1..-2] }
+        end
+      end
+      return choices
+    end
+  end
+end

data/lib/palaver/dialog_factory.rb

@@ -0,0 +1,42 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+module Palaver
+  class DialogFactory
+    @@dialog_types = {
+      :calendar => Calendar,
+      :checklist => Checklist,
+      :radiolist => Radiolist,
+      :menu => Menu,
+      :yesno => YesNo,
+      :textbox => TextBox,
+      :msgbox => MsgBox,
+      :inputbox => InputBox,
+      :infobox => InfoBox,
+      :pause => Pause,
+      :passwordbox => PasswordBox,
+      :dselect => DSelect,
+      :fselect => FSelect,
+      :form => Form
+    }
+
+    private
+
+    def method_missing(methodsym, *args, &block)
+      if @@dialog_types.has_key? methodsym then
+        c = @@dialog_types[methodsym]
+        options = args.size == 1 ? args[0] : {}
+        return make_dialog(c, options, &block)
+      else
+        raise NoMethodError.new("Undefined method: #{methodsym} for #{self}", methodsym)
+      end
+    end
+
+    def make_dialog(cls, options, &spec)
+      d = cls.new(options)
+      d.instance_eval &spec if spec
+      return d
+    end
+    
+  end
+end

data/lib/palaver/dselect.rb

@@ -0,0 +1,18 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+require 'palaver/pathselect'
+
+module Palaver
+  class DSelect < Palaver::PathSelect
+    def initialize(options={})
+      super(options)
+    end
+
+    def dialog_name
+      "dselect"
+    end
+    
+  end
+end
+

data/lib/palaver/form.rb

@@ -0,0 +1,96 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+module Palaver
+
+  class Form < Palaver::Base
+    def initialize(options)
+      super(options)
+      @entries = []
+      @form_height = nil
+      @simple_display_width = nil
+      @simple_text_length = nil
+    end
+
+    def show
+      text_width = @entries.map { |e| e.text_width }.max
+      @entries.each { |e| e.update_value_x text_width }
+      
+      cmd_intro = "dialog --form '#@text' #@height #@width #@form_height "
+      cmd_entries = @entries.map { |e| e.to_cmd_s }.join(' ')
+
+      result = nil
+      with_tempfile do |tfpath|
+        cmd = "#{cmd_intro} #{cmd_entries} 2> #{tfpath}"
+        success = system cmd
+        result = read_dialog_output tfpath
+      end
+      
+      return result
+    end
+
+    private
+
+    class Entry
+      attr_reader :field_id, :text
+      
+      def initialize(id, text, text_y, text_x, default_value, value_y, value_x, field_length, input_length)
+        @field_id = id
+        @text = text
+        @text_y = text_y
+        @text_x = text_x
+        @default_value = default_value
+        @value_y = value_y
+        @value_x = value_x
+        @field_length = field_length
+        @input_length = input_length
+      end
+
+      def text_width
+        @text.length + 2
+      end
+
+      def update_value_x(min)
+        @value_x = [ @value_x ? @value_x : 0, min ].max
+      end
+      
+      def to_cmd_s
+        "'#@text' #@text_y #@text_x '#@default_value' #@value_y #@value_x #@field_length #@input_length"
+      end
+    end
+
+    def read_dialog_output(fname)
+      lines = File.read(fname).split("\n")
+      result = {}
+      lines.each_with_index { |l,i| result[@entries[i].field_id] = l }
+      return result
+    end
+     
+    def form_height(val)
+      @form_height = val
+    end
+
+    def entry(id, title, text_y, text_x, default_value, value_y, value_x, field_length, input_length)
+      newentry = Entry.new(id, title, text_y, text_x, default_value, value_y, value_x, field_length, input_length)
+      @entries.push newentry
+    end
+
+    def simple_display_width(width)
+      @simple_display_width = width
+    end
+
+    def simple_text_length(length)
+      @simple_text_length = length
+    end
+
+    def simple_entry(id, title, default_value)
+      @simple_next_y = 1 if not @simple_next_y
+      newentry = Entry.new(id, title, @simple_next_y, 0, default_value, @simple_next_y, nil, @simple_display_width, @simple_text_length)
+      @entries.push newentry
+      @simple_next_y = @simple_next_y + 1
+    end
+
+  end
+  
+end
+

data/lib/palaver/fselect.rb

@@ -0,0 +1,17 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+require 'palaver/pathselect'
+
+module Palaver
+  class FSelect < Palaver::PathSelect
+    def initialize(options={})
+      super(options)
+    end
+
+    def dialog_name
+      "fselect"
+    end
+  end
+end
+

data/lib/palaver/infobox.rb

@@ -0,0 +1,15 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+module Palaver
+  class InfoBox < Palaver::Base
+    def initialize(options)
+      super(options)
+    end
+
+    def show
+      cmd = "dialog --infobox '#@text' #@height #@width"
+      system cmd
+    end
+  end
+end

data/lib/palaver/inputbox.rb

@@ -0,0 +1,34 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+module Palaver
+  class InputBox < Palaver::Base
+    def initialize(options)
+      super(options)
+      @initial = nil
+
+      options.each do |option,value|
+        case option
+        when :initial then self.initial(value)
+        end
+      end
+
+    end
+
+    def initial(text)
+      @initial = text
+    end
+
+    def show
+      answer = nil
+      with_tempfile do |fname|
+        cmd = "dialog --inputbox '#@text' #@height #@width '#@initial' 2> #{fname}"
+        success = system cmd
+        if success  then
+          answer = File.read(fname)
+        end
+      end
+      return answer
+    end
+  end
+end

data/lib/palaver/list_with_options.rb

@@ -0,0 +1,46 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+module Palaver
+
+  class ListWithOptions < Palaver::Base
+
+    class Option
+      attr_reader :tag, :item, :status
+      def initialize(tag,item,status=nil)
+        @tag = tag
+        @item = item
+        @status = status
+      end
+    end
+
+    def initialize(options)
+      super(options)
+      @dialog_options = []
+      @list_height = 0
+
+      options.each do |option,value|
+        case option
+        when :options then @dialog_options = value.map { |o| Option.new(o[0],o[1],o[2]) }
+        end
+      end
+    end
+  
+    def option(tag, desc, status=nil)
+      @dialog_options.push Option.new(tag,desc,status)
+    end
+
+    def list_height(h)
+      @list_height = h
+    end
+
+    def options_string_with_status
+      @dialog_options.map { |o| "'#{o.tag}' '#{o.item}' '#{o.status == :on ? 'on' : 'off'}'" }.join ' '
+    end
+
+    def options_string_no_status
+      @dialog_options.map { |o| "'#{o.tag}' '#{o.item}'" }.join ' '
+    end
+    
+  end
+end

data/lib/palaver/menu.rb

@@ -0,0 +1,25 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+require 'palaver/list_with_options'
+
+module Palaver
+  class Menu < Palaver::ListWithOptions
+    def initialize(options)
+      super options
+    end
+
+    def show
+      chosen = nil
+      with_tempfile do |fname|
+        cmd = "dialog --menu '#@text' #@height #@width #@list_height #{options_string_no_status} 2> #{fname}"
+        sucess = system cmd
+        if sucess then
+          chosen = File.read(fname)
+        end
+      end
+      return chosen
+    end
+    
+  end
+end

data/lib/palaver/msgbox.rb

@@ -0,0 +1,15 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+module Palaver
+  class MsgBox < Palaver::Base
+    def initialize(options)
+      super options
+    end
+
+    def show
+      cmd = "dialog --msgbox '#@text' #@height #@width"
+      system cmd
+    end    
+  end
+end

data/lib/palaver/passwordbox.rb

@@ -0,0 +1,36 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+module Palaver
+  class PasswordBox < Palaver::Base
+    def initialize(options)
+      super(options)
+      @insecure = false
+
+      options.each do |option,value|
+        case option
+        when :insecure then self.insecure(value)
+        end
+      end
+    end
+
+    def insecure(should_be_insecure=true)
+      @insecure = should_be_insecure
+    end
+
+    
+    def show
+      answer = nil
+      with_tempfile do |fname|
+        insecure = @insecure ? "--insecure" : ""
+        cmd = "dialog #{insecure} --passwordbox '#@text' #@height #@width 2> #{fname}"
+        #puts cmd
+        success = system cmd
+        if success  then
+          answer = File.read(fname)
+        end
+      end
+      return answer      
+    end
+  end
+end

data/lib/palaver/pathselect.rb

@@ -0,0 +1,35 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+module Palaver
+  class PathSelect < Palaver::Base
+    def initialize(options={})
+      super(options)
+      @path = nil
+      
+      options.each do |option,value|
+        case option
+        when :path  then self.path(value)
+        end
+      end
+      
+    end
+
+    def path(str)
+      @path = str
+    end
+
+    def show
+      raise "CAn't open a #{dialog_name} dialog with a path" if not @path
+      chosen_file = nil
+      with_tempfile do |tfpath|
+        cmd = "dialog --#{dialog_name} '#@path' #@height #@width 2> #{tfpath}"
+        puts cmd
+        success = system cmd
+        chosen_file = File.read(tfpath) if success
+      end
+      return chosen_file
+    end
+  end
+end
+

data/lib/palaver/pause.rb

@@ -0,0 +1,26 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+module Palaver
+  class Pause < Palaver::Base
+    def initialize(options)
+      super(options)
+      @seconds = 0
+      options.each do |option,value|
+        case option
+        when :seconds then @seconds = value
+        end
+      end
+    end
+
+    def seconds(val)
+      @seconds = val
+    end
+
+    def show
+      cmd = "dialog --pause '#@text' #@height #@width #@seconds"
+      rc = system cmd
+      return rc
+    end
+  end
+end

data/lib/palaver/radiolist.rb

@@ -0,0 +1,24 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+require 'palaver/list_with_options'
+
+module Palaver
+  class Radiolist < Palaver::ListWithOptions
+    def initialize(options)
+      super(options)
+    end
+    
+    def show
+      chosen = nil
+      with_tempfile do |fname|
+        cmd = "dialog --radiolist '#@text' #@height #@width #@list_height #{options_string_with_status} 2> #{fname}"
+        sucess = system cmd
+        if sucess then
+          chosen = File.read(fname)
+        end
+      end
+      return chosen
+    end
+  end
+end

data/lib/palaver/textbox.rb

@@ -0,0 +1,25 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+module Palaver
+  class TextBox < Base
+    def initialize(options)
+      super options
+      options.each do |option,value|
+        case option
+        when :filename then filename(value)
+        end
+      end
+    end
+    
+    def show
+      cmd = "dialog --textbox '#@filename' #@height #@width"
+      system cmd
+    end
+    
+    def filename(name)
+      @filename = name
+    end
+  end
+end
+

data/lib/palaver/yesno.rb

@@ -0,0 +1,16 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+module Palaver
+  class YesNo < Palaver::Base
+    def initialize(optons)
+      super optons
+    end
+
+    def show
+      cmd = "dialog --yesno '#@text' #@height #@width"
+      rc = system cmd
+      return  rc
+    end
+  end
+end

data/lib/palaver.rb

@@ -0,0 +1,18 @@
+# Copyright (c) 2012, Peter Allin <peter@peca.dk> All rights reserved.
+# See LICENSE file for licensing information.
+
+require 'palaver/calendar.rb'
+require 'palaver/checklist.rb'
+require 'palaver/radiolist.rb'
+require 'palaver/menu.rb'
+require 'palaver/yesno.rb'
+require 'palaver/textbox.rb'
+require 'palaver/msgbox.rb'
+require 'palaver/inputbox.rb'
+require 'palaver/infobox.rb'
+require 'palaver/pause.rb'
+require 'palaver/passwordbox.rb'
+require 'palaver/dselect.rb'
+require 'palaver/fselect.rb'
+require 'palaver/form.rb'
+require 'palaver/dialog_factory.rb'

data/palaver.gemspec

@@ -0,0 +1,14 @@
+Gem::Specification.new do |s|
+  s.name = "palaver"
+  s.version = "0.2.0"
+  s.platform = Gem::Platform::RUBY
+  s.authors = [ "Peter Allin" ]
+  s.email = [ "peter@peca.dk" ]
+  s.summary = "Ruby interface for the 'dialog' progam"
+  s.description = "Uses the 'dialog' program to create Ruby applications with text based user interfaces"
+  s.rubyforge_project = s.name
+  s.required_rubygems_version = ">= 1.3.6"
+  s.files = `git ls-files`.split "\n"
+  s.require_path = "lib"
+  s.homepage = "https://github.com/peterallin/palaver"
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification 
+name: palaver
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.0
+platform: ruby
+authors: 
+- Peter Allin
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-07-10 00:00:00 Z
+dependencies: []
+
+description: Uses the 'dialog' program to create Ruby applications with text based user interfaces
+email: 
+- peter@peca.dk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- LICENSE
+- README.md
+- Rakefile
+- examples/calendar.rb
+- examples/checklist.rb
+- examples/dselect.rb
+- examples/form.rb
+- examples/form_simple.rb
+- examples/fselect.rb
+- examples/infobox.rb
+- examples/inputbox.rb
+- examples/menu.rb
+- examples/msgbox.rb
+- examples/passwordbox.rb
+- examples/pause.rb
+- examples/radiolist.rb
+- examples/textbox.rb
+- examples/yesno.rb
+- lib/palaver.rb
+- lib/palaver/base.rb
+- lib/palaver/calendar.rb
+- lib/palaver/checklist.rb
+- lib/palaver/dialog_factory.rb
+- lib/palaver/dselect.rb
+- lib/palaver/form.rb
+- lib/palaver/fselect.rb
+- lib/palaver/infobox.rb
+- lib/palaver/inputbox.rb
+- lib/palaver/list_with_options.rb
+- lib/palaver/menu.rb
+- lib/palaver/msgbox.rb
+- lib/palaver/passwordbox.rb
+- lib/palaver/pathselect.rb
+- lib/palaver/pause.rb
+- lib/palaver/radiolist.rb
+- lib/palaver/textbox.rb
+- lib/palaver/yesno.rb
+- palaver.gemspec
+homepage: https://github.com/peterallin/palaver
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: palaver
+rubygems_version: 1.8.16
+signing_key: 
+specification_version: 3
+summary: Ruby interface for the 'dialog' progam
+test_files: []
+