typr 1.1.2 → 1.2.0

data/lib/line.rb

@@ -7,36 +7,36 @@ module Typr
 # == Example
 #
 #   line = Line.new( top: 5, left: 10, width: 40 )
-#   line.draw "Hello world"
+#   line.show "Hello world"
 #   line.append " more"
-#   line.ask([ ["Name?", :string], ["Age?", :integer] ])
+#   line.ask([ ["Name?", :line], ["Age?", :line] ])
 
 class Line < Space
-  attr_accessor :default, :prompt, :bindings, :data
+  attr_accessor :default, :prompt, :bindings, :data, :align, :trim
 
   # Render +msg+ (String, Proc, or Space) on this line.
   #
-  #   line.draw "status: ok"
-  #   line.draw Proc.new { show_time }
+  #   line.show "status: ok"
+  #   line.show Proc.new { show_time }
 
-  def draw msg=@data
+  def show msg=@data, align=@align
     @data = msg
     move left, top
     color @colors[:default]
     case msg
       when Proc; msg.call
-      when Space; msg.draw
-      when String; show( prepare msg, width )
+      when Space; msg.show
+      when String; draw( prepare msg, width, align, @trim )
     end
   end
 
   # Append +str+ to the current content and redraw.
   #
-  #   line.draw "hello"
+  #   line.show "hello"
   #   line.append " world"   #=> "hello world"
   #   line << "!"            #=> "hello world!"
 
-  def append(str); draw @data+str end
+  def append(str); show @data+str end
   alias :<< :append
 
   # Display keybinding help in a floating grid.
@@ -56,38 +56,68 @@ class Line < Space
   #
   #   line.reset
 
-  def reset; draw( @default || ( @bindings || [@prompt] ).join(' ') ) end
+  def reset; show( @default || ( @bindings || [@prompt] ).join(' ') ) end
 
   # Prompt the user with a sequence of questions.
-  # +sentence+ is an array of [question, type] pairs.
-  # Returns a single answer or an array when multiple questions.
+  # +sentence+ is an array of [question, type] pairs (or a hash of them).
+  # Returns a single answer, or an array when there are multiple questions.
   #
-  #   line.ask([ ["Name?", :string] ])             #=> "Alice"
-  #   line.ask([ ["Name?", :string], ["Ok?", ["y","n"]] ])  #=> ["Alice", "y"]
+  # The +type+ selects how the answer is collected:
+  #   Array - interactive pick via <widget>.pick(<type>); an optional third
+  #           element renders the chosen row's field into the line
+  #   :key  - a single keypress via Typr.read_key
+  #   :line - interactive line editor via Typr.read_line at the cursor
+  #
+  # Pressing the exit key (@keymap[:exit], Escape by default) aborts the
+  # remaining questions and returns nil.
+  #
+  #   line.ask(name: :line)                  #=> "Alice"
+  #   line.ask(keys: :key)                   #=> "a"
+  #   line.ask(open: [grid, :row, :name])    #=> 2   (picked row id)
+  #   line.ask([ ["Name?", :line], ["Ok?", :key] ])  #=> ["Alice", "a"]
 
   def ask sentence
     answer = []
     move left, top
     Typr.clear :line
-    draw @prompt
-    for question, object in sentence
-      color( @colors[:question] )
-      append " " + question.to_s + " "
-      column = Typr.column
-      color( @colors[:answer] )
-      case object
-        when Array then answer << object.first.pick( object.last )
-        else answer << Typr.read( object, @data )
+    saved = @trim
+    @trim = :left
+    begin
+      @data = @prompt.to_s
+      colored = color_code( @colors[:default] ).to_s + @data
+      move left, top
+      draw prepare( colored, width, @align, @trim )
+      for question, object in sentence
+        text = " " + question.to_s + " "
+        @data += text
+        colored += color_code( @colors[:question] ).to_s + text
+        move left, top
+        draw prepare( colored, width, @align, @trim )
+        color( @colors[:answer] )
+        case object
+          when Array then answer << object.first.pick( object[1] )
+          when :key then answer << Typr.read_key
+          when :line then answer << Typr.read_line( colored + color_code( @colors[:answer] ),
+            left: left, top: top )
+        end
+        return if !answer.last or answer.last == @keymap[:exit]
+        text = ( object.is_a?(Array) and object[2] ) ?
+          object.first.data[answer.last][object[2]].to_s : answer.last.to_s
+        @data += text
+        colored += color_code( @colors[:answer] ).to_s + text
+        move left, top
+        draw prepare( colored, width, @align, @trim )
       end
-      return if !answer.last or answer.last == @keymap[:exit]
-      move column, top
-      append answer.last.to_s
+    ensure
+      @trim = saved
     end
     return ( answer.one? ? answer.first : answer )
   end
 
   def initialize args
     @right= -1
+    @align = :left
+    @trim = :right
     @prompt = ?>
     super
     @bottom = @top

data/lib/space.rb

@@ -10,7 +10,7 @@ module Typr
 #
 # @example
 #   box = Space.new(left: 0, top: 2, right: 0.5, bottom: -4, border: :round)
-#   box.draw
+#   box.show
 
 class Space
 include Typr
@@ -29,21 +29,29 @@ include Typr
 STR
 eval( method % ([name]*11) ) }
 
+  def symbolize obj
+    case obj
+    when Hash
+      obj.each_with_object({}) { |(k, v), h|
+        h[k.is_a?(String) ? k.to_sym : k] = symbolize(v) }
+    else obj end
+  end
+
   attr_writer :left, :top, :right, :bottom
   attr_accessor :margin, :colors, :interval, :borders
 
   def width; right - left + 1 end
   def height; bottom - top + 1 end
 
-  def start; @updater = Thread.new{ loop{draw; sleep @interval }} end
+  def start; @updater = Thread.new{ loop{show; sleep @interval }} end
   def stop; @updater.terminate end
 
   def draw_border x,y,char
-    show move_code(x, y) + char unless not char or
+    draw move_code(x, y) + char unless not char or
       x < 0 or x > Typr.width or y < 0 or y > Typr.height
   end
 
-  def draw
+  def show
     return if @borders.empty?
     color @colors[:border]
     draw_border(left - 1, top - 1, @borders[:top_left])
@@ -71,10 +79,11 @@ eval( method % ([name]*11) ) }
   end
 
   def initialize args={}
-    @max, @keymap, @colors, @margin = 0, {}, {}, ' '
+    @max, @keymap, @colors, @margin = 0, {}, {}, '  '
     @left, @top, @interval, @borders = 0, 0, 1, {}
   	args.each{ |name, value|
       instance_variable_set ?@ + name.to_s, value }
+    @colors = symbolize( @colors ) if @colors.is_a? Hash
     @keymap = { exit: KEY_ESCAPE }.merge @keymap
     @colors = { default: [:white, :black], border: [:white, :black] }.merge(@colors)
     borders = @borders.dup

data/lib/stack.rb

@@ -1,7 +1,3 @@
-#!/usr/bin/env ruby
-# coding: utf-8
-# frozen_string_literal: true
-
 module Typr
 
   ##
@@ -54,7 +50,7 @@ module Typr
     #
     #   stack.print 42   # renders a blank row
 
-    def print id; show " " * (width-@margin.size) end
+    def print id; draw " " * (width-@margin.size) end
 
     ##
     # Resets widget state by one or more categories.
@@ -84,12 +80,16 @@ module Typr
       if type.to_s[ /column/ ]
         positions( row_id )[ @hints_start..-1 ].each_with_index{ |pos, idx|
           move( left + pos, top + row_id )
-          show @hints[idx] }
-      else @hints.chars.each_with_index{ |char, idx|
-        pos = idx + @hints_start + headspace
-        break if pos > [height, rows-1+headspace].min
-        move( left, top + pos )
-        show char }
+          draw @hints[idx] }
+      else
+        bottom = top + headspace + [height, rows].min - 1
+        (top + headspace..bottom).each{ |pos|
+          move( left, pos ); draw ' ' }
+        @hints.chars.each_with_index{ |char, idx|
+          pos = idx + @hints_start + headspace
+          break if top + pos > bottom
+          move( left, top + pos )
+          draw char }
       end
     end
 
@@ -100,11 +100,11 @@ module Typr
     # This method is called by your application's main loop each frame; it does not handle
     # events itself (see {#send}).
 
-    def draw
+    def show
       if @header
         color @colors[ :header ]
         move left,top
-        show @margin
+        draw @margin
         print :header
       end
       list = page.to_a
@@ -116,7 +116,7 @@ module Typr
         dark=!dark if @alternate
         background ( select ? @colors[:selected] :
           (@alternate and dark) ? @colors[:alternate] : @colors[:default][1] )
-        show @margin
+        draw @margin
         print id
         background if select
       end
@@ -195,7 +195,6 @@ module Typr
     #   stack.pick "rows"         # multi-select rows
 
     def pick type = :row, row=0 #, key=nil
-      @hints_start = 0
       type = type.to_s
       multiple = type[-1] == ?s
       loop do
@@ -204,10 +203,10 @@ module Typr
           column = pick( :column, page.to_a.index( row  + headspace)) or return
           value = [ row , column ]
         else
-          draw
+          show
           draw_hints type, row unless type['none']
           limit = type['row'] ? height : positions(row).count
-          key = Typr.read :key
+          key = Typr.read_key
           if key.is_a?(String) and value =
             @hints[0..limit-@hints_start-1].index(key)
             value += @hints_start
@@ -262,9 +261,9 @@ module Typr
 
     def initialize args={}
       @keymap, @separator, @selected = {}, " ", {}
-      @start, @hints_start, @highlight = 0, 0, 0#A_STANDOUT
+      @start, @hints_start = 0, 0
       @alternate = true
-      super #args
+      super
       @colors = { hints: [255, :black ], header: [232,:grey60 ],
         selected: :grey25, alternate: :grey10, rows: {} }.merge @colors
       @selected = { fields:[], columns:[], rows:[] }.merge @selected