natty-ui 0.5.3 → 0.6.0

data/lib/natty-ui/ansi_wrapper.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-require 'io/console'
-require_relative 'wrapper'
 require_relative 'ansi'
+require_relative 'wrapper'
 
 module NattyUI
   class AnsiWrapper < Wrapper
@@ -110,18 +109,48 @@ module NattyUI
       MSG = Ansi[:bold, 231].freeze
     end
 
-    class Framed < Framed
+    class Framed < Section
       protected
 
+      def initialize(parent, title:, type:, **opts)
+        @parent = parent
+        title = title.to_s.tr("\r\n", '')
+        topl, topr, botl, botr, hor, vert = *components(type)
+        width = available_width
+        rcount = [width - _plain_width(title) - 6, 0].max
+        parent.puts(
+          "#{COLOR}#{topl}#{hor}#{hor}#{Ansi.reset} " \
+            "#{TITLE_ATTR}#{title}#{Ansi.reset} " \
+            "#{COLOR}#{hor * rcount}#{topr}#{Ansi.reset}"
+        )
+        @bottom = "#{COLOR}#{botl}#{hor * (width - 2)}#{botr}#{Ansi.reset}"
+        vert = "#{COLOR}#{vert}#{Ansi.reset}"
+        super(
+          parent,
+          prefix: "#{vert} ",
+          suffix:
+            "#{Ansi.cursor_right_aligned}" \
+              "#{Ansi.cursor_left(suffix_width)}#{vert}",
+          **opts
+        )
+      end
+
+      def suffix = "#{super} "
+      def finish = parent.puts(@bottom)
+
       def components(type)
-        top_start, top_suffix, left, bottom = super
-        [
-          "#{Ansi[39]}#{top_start}#{Ansi[:bold, 231]}",
-          "#{Ansi[:reset, 39]}#{top_suffix}#{Ansi.reset}",
-          Ansi.embellish(left, 39),
-          Ansi.embellish(bottom, 39)
-        ]
+        COMPONENTS[type] || raise(ArgumentError, "invalid frame type - #{type}")
       end
+
+      COLOR = Ansi[39].freeze
+      TITLE_ATTR = Ansi[:bold, 231].freeze
+      COMPONENTS = {
+        rounded: %w[╭ ╮ ╰ ╯ ─ │],
+        simple: %w[┌ ┐ └ ┘ ─ │],
+        heavy: %w[┏ ┓ ┗ ┛ ━ ┃],
+        semi: %w[┍ ┑ ┕ ┙ ━ │],
+        double: %w[╔ ╗ ╚ ╝ ═ ║]
+      }.compare_by_identity.freeze
     end
 
     class Ask < Ask
@@ -136,6 +165,14 @@ module NattyUI
       PREFIX = "#{Ansi[:bold, :italic, 220]}▶︎#{Ansi[:reset, 220]}".freeze
     end
 
+    class Request < Request
+      def prompt(question) = "#{prefix}#{PREFIX} #{question}#{Ansi.reset} "
+      def finish = (wrapper.stream << FINISH).flush
+
+      PREFIX = "#{Ansi[:bold, :italic, 220]}▶︎#{Ansi[:reset, 220]}".freeze
+      FINISH = (Ansi.cursor_line_up + Ansi.line_erase_to_end).freeze
+    end
+
     class Query < Query
       protected
 
@@ -155,9 +192,9 @@ module NattyUI
     class Progress < Progress
       protected
 
-      def draw_title(title)
+      def draw(title)
         @prefix = "#{prefix}#{TITLE_PREFIX}#{title}#{Ansi.reset} "
-        (wrapper.stream << @prefix).flush
+        (wrapper.stream << @prefix << Ansi.cursor_hide).flush
         @prefix = "#{Ansi.line_clear}#{@prefix}"
         if @max_value
           @prefix << BAR_COLOR
@@ -167,26 +204,21 @@ module NattyUI
         end
       end
 
-      def draw_final = (wrapper.stream << Ansi.line_clear).flush
-
       def redraw
         (wrapper.stream << @prefix << (@max_value ? fullbar : indicator)).flush
       end
 
+      def end_draw = (wrapper.stream << ERASE).flush
       def indicator = '─╲│╱'[(@indicator += 1) % 4]
+      # def indicator = '⣷⣯⣟⡿⢿⣻⣽⣾'[(@indicator += 1) % 8]
 
       def fullbar
         percent = @value / @max_value
         count = (30 * percent).to_i
+        mv = max_value.to_i.to_s
         "#{'█' * count}#{BAR_BACK}#{'▁' * (30 - count)}" \
-          "#{BAR_INK} #{
-            format(
-              '%<value>.0f/%<max_value>.0f (%<percent>.2f%%)',
-              value: @value,
-              max_value: @max_value,
-              percent: percent * 100
-            )
-          }"
+          "#{BAR_INK} #{value.to_i.to_s.rjust(mv.size)}/#{mv} " \
+          "(#{(percent * 100).round(2).to_s.rjust(6)})"
       end
 
       TITLE_PREFIX = "#{Ansi[:bold, :italic, 117]}➔#{Ansi[:reset, 117]} ".freeze
@@ -194,6 +226,7 @@ module NattyUI
       BAR_COLOR = Ansi[39, 295].freeze
       BAR_BACK = Ansi[236, 492].freeze
       BAR_INK = Ansi[:bold, 255, :on_default].freeze
+      ERASE = (Ansi.line_clear + Ansi.cursor_show).freeze
     end
 
     PAGE_BEGIN =

data/lib/natty-ui/features.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module NattyUI
+  #
+  # Features of {NattyUI} - methods to display natty elements.
+  #
+  module Features
+    # Print a horizontal rule
+    #
+    # @param [#to_s] symbol string to build the horizontal rule
+    # @return [Wrapper, Wrapper::Element] itself
+    def hr(symbol = '═')
+      symbol = symbol.to_s
+      size = _plain_width(symbol)
+      return self if size.zero?
+      msg = symbol * ((available_width - 1) / size)
+      return puts(msg, prefix: Ansi[39], suffix: Ansi.reset) if wrapper.ansi?
+      puts(msg)
+    end
+
+    protected
+
+    def _plain_width(str) = NattyUI.display_width(NattyUI.plain(str))
+    def _blemish_width(str) = NattyUI.display_width(Ansi.blemish(str))
+
+    def _element(type, *args)
+      wrapper.class.const_get(type).__send__(:new, self).__send__(:_call, *args)
+    end
+
+    def _section(owner, type, args, **opts, &block)
+      sec = wrapper.class.const_get(type).__send__(:new, owner, **opts)
+      sec.puts(*args) if args && !args.empty?
+      block ? sec.__send__(:_call, &block) : sec
+    end
+  end
+end

data/lib/natty-ui/{wrapper/mixins.rb → mixins.rb}

@@ -12,7 +12,7 @@ module NattyUI
   #
   module ProgressAttributes
     # @attribute [r] completed?
-    # @return [Boolean] whether the task completed sucessfully
+    # @return [Boolean] whether the task completed successfully
     def completed? = (@status == :completed)
 
     # @attribute [r] failed?

data/lib/natty-ui/version.rb

@@ -2,5 +2,5 @@
 
 module NattyUI
   # @return [String] the version number of the gem
-  VERSION = '0.5.3'
+  VERSION = '0.6.0'
 end

data/lib/natty-ui/wrapper/ask.rb

@@ -17,7 +17,7 @@ module NattyUI
     #   when true
     #     sec.info('Yeah!!')
     #   when false
-    #     sec.write("That's pitty!")
+    #     sec.write("That's pity!")
     #   else
     #     sec.failed('You should have an opinion!')
     #   end
@@ -67,9 +67,9 @@ module NattyUI
 
       def grab(yes, no)
         yes = yes.to_s.chars.uniq
+        raise(ArgumentError, ':yes can not be empty') if yes.empty?
         no = no.to_s.chars.uniq
-        raise(ArgumentError, ':yes can not be emoty') if yes.empty?
-        raise(ArgumentError, ':no can not be emoty') if no.empty?
+        raise(ArgumentError, ':no can not be empty') if no.empty?
         return yes, no if (yes & no).empty?
         raise(ArgumentError, 'chars in :yes and :no can not be intersect')
       end

data/lib/natty-ui/wrapper/element.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative 'features'
+require_relative '../features'
 
 module NattyUI
   class Wrapper
@@ -36,7 +36,10 @@ module NattyUI
       protected
 
       def prefix = "#{@parent.__send__(:prefix)}#{@prefix}"
-      def suffix = "#{@parent.__send__(:suffix)}#{@suffix}"
+      def suffix = "#{@suffix}#{@parent.__send__(:suffix)}"
+      def prefix_width = _blemish_width(prefix)
+      def suffix_width = _blemish_width(suffix)
+      def available_width = wrapper.screen_columns - prefix_width - suffix_width
       def finish = nil
 
       def wrapper

data/lib/natty-ui/wrapper/list_in_columns.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require_relative 'element'
+
+module NattyUI
+  module Features
+    #
+    # Print items of a given list as columns.
+    # In the default compact format columns may have diffrent widths and the
+    # list items are ordered column-wise.
+    # The non-compact format prints all columns in same width and order the list
+    # items row-wise.
+    #
+    # @param [Array<#to_s>] args items to print
+    # @param [Boolean] compact whether to use compact format
+    # @return [Wrapper, Wrapper::Element] itself
+    def ls(*args, compact: true) = _element(:ListInColumns, args, compact)
+  end
+
+  class Wrapper
+    #
+    # An {Element} to print items of a given list as columns.
+    #
+    # @see Features#ls
+    class ListInColumns < Element
+      protected
+
+      def _call(list, compact)
+        list.flatten!
+        return parent if list.empty?
+        list.map! { |item| Item.new(item = item.to_s, _plain_width(item)) }
+        if compact
+          each_compacted(list, available_width) { |line| parent.puts(line) }
+        else
+          each(list, available_width) { |line| parent.puts(line) }
+        end
+        parent
+      end
+
+      def each(list, max_width)
+        width = list.max_by(&:width).width + 3
+        list.each_slice(max_width / width) do |slice|
+          yield(slice.map { |item| item.to_s(width) }.join)
+        end
+      end
+
+      def each_compacted(list, max_width)
+        found, widths = find_columns(list, max_width)
+        fill(found[-1], found[0].size)
+        found.transpose.each do |row|
+          row = row.each_with_index.map { |item, col| item&.to_s(widths[col]) }
+          yield(row.join)
+        end
+      end
+
+      def find_columns(list, max_width)
+        found = [list]
+        widths = [list.max_by(&:width).width]
+        1.upto(list.size - 1) do |slice_size|
+          candidate = list.each_slice(list.size / slice_size).to_a
+          cwidths = candidate.map { |ary| ary.max_by(&:width).width + 3 }
+          cwidths[-1] -= 3
+          break if cwidths.sum > max_width
+          found = candidate
+          widths = cwidths
+        end
+        [found, widths]
+      end
+
+      def fill(ary, size)
+        diff = size - ary.size
+        ary.fill(nil, ary.size, diff) if diff.positive?
+      end
+
+      Item =
+        Data.define(:str, :width) do
+          def to_s(in_width) = "#{str}#{' ' * (in_width - width)}"
+        end
+    end
+  end
+end

data/lib/natty-ui/wrapper/progress.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'element'
-require_relative 'mixins'
+require_relative '../mixins'
 
 module NattyUI
   module Features
@@ -35,11 +35,11 @@ module NattyUI
         @max_value = [0, max_value.to_f].max if max_value
         @value = 0
         @progress = 0
-        draw_title(title)
+        draw(title)
       end
 
-      def draw_title(title) = (wrapper.stream << prefix << "➔ #{title} ").flush
-      def draw_final = (wrapper.stream << "\n")
+      def draw(title) = (wrapper.stream << prefix << "➔ #{title} ").flush
+      def end_draw = (wrapper.stream << "\n")
 
       def redraw
         return (wrapper.stream << '.').flush unless @max_value
@@ -50,10 +50,15 @@ module NattyUI
       end
 
       def finish
-        draw_final
+        end_draw
         return @parent.failed(*@final_text) if failed?
-        @status = :ok if @status == :closed
-        @parent.completed(*@final_text)
+        _section(
+          @parent,
+          :Message,
+          @final_text,
+          title: @final_text.shift,
+          symbol: @status = :completed
+        )
       end
     end
   end

data/lib/natty-ui/wrapper/query.rb

@@ -28,7 +28,7 @@ module NattyUI
     #
     # @param question [#to_s] Question to display
     # @param choices [#to_s] choices selectable via index (0..9)
-    # @param result  [Symbol] defines how the result ist returned
+    # @param result  [Symbol] defines how the result will be returned
     # @param kw_choices [{Char => #to_s}] choices selectable with given char
     # @return [Char] when `result` is configured as `:char`
     # @return [#to_s] when `result` is configured as `:choice`
@@ -80,7 +80,7 @@ module NattyUI
           .to_h
           .merge!(kw_choices)
           .transform_keys! { |k| [k.to_s[0], ' '].max }
-          .transform_values! { |v| v.to_s.tr("\r\n", ' ') }
+          .transform_values! { |v| v.to_s.tr("\r\n\t", ' ') }
       end
     end
   end

data/lib/natty-ui/wrapper/request.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative 'element'
+
+module NattyUI
+  module Features
+    # Request user input.
+    #
+    # @param question [#to_s] Question to display
+    # @return [String] the user input
+    # @return [nil] when input was aborted with `^C` or `^D`
+    def request(question) = _element(:Request, question)
+  end
+
+  class Wrapper
+    #
+    # An {Element} to request user input.
+    #
+    # @see Features#request
+    class Request < Element
+      protected
+
+      def _call(question)
+        NattyUI.readline(prompt(question), stream: wrapper.stream)
+      ensure
+        finish
+      end
+
+      def prompt(question) = "#{prefix}▶︎ #{question}: "
+    end
+  end
+end

data/lib/natty-ui/wrapper/section.rb

@@ -56,7 +56,7 @@ module NattyUI
           *args,
           max_width: max_width,
           prefix: prefix ? "#{@prefix}#{prefix}" : @prefix,
-          suffix: suffix ? "#{@suffix}#{suffix}" : @suffix
+          suffix: suffix ? "#{suffix}#{@suffix}" : @suffix
         )
         self
       end
@@ -68,7 +68,7 @@ module NattyUI
       # @return [Section] itself
       def space(lines = 1)
         @parent.puts(
-          "\n" * ([lines.to_i, 1].max - 1),
+          "\n" * [lines.to_i, 1].max,
           prefix: @prefix,
           suffix: @suffix
         )

data/lib/natty-ui/wrapper/task.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'section'
-require_relative 'mixins'
+require_relative '../mixins'
 
 module NattyUI
   module Features

data/lib/natty-ui/wrapper.rb

@@ -1,11 +1,14 @@
 # frozen_string_literal: true
 
+require 'io/console'
 require_relative 'wrapper/ask'
 require_relative 'wrapper/framed'
 require_relative 'wrapper/heading'
+require_relative 'wrapper/list_in_columns'
 require_relative 'wrapper/message'
 require_relative 'wrapper/progress'
 require_relative 'wrapper/query'
+require_relative 'wrapper/request'
 require_relative 'wrapper/section'
 require_relative 'wrapper/task'
 
@@ -160,6 +163,12 @@ module NattyUI
     def prefix = nil
     alias suffix prefix
 
+    def prefix_width = 0
+    alias suffix_width prefix_width
+    alias width prefix_width
+
+    alias available_width screen_columns
+
     private_class_method :new
   end
 end

data/lib/natty-ui.rb

@@ -2,9 +2,10 @@
 
 require 'readline'
 unless defined?(Reline)
-  # only load the Reline::Unicode part
+  # load the Reline::Unicode part only
   # @!visibility private
   module Reline
+    # @!visibility private
     def self.ambiguous_width = 1
   end
   require 'reline/unicode'
@@ -156,19 +157,28 @@ module NattyUI
 
     # Read user input line from {.in_stream}.
     #
+    # This method uses Ruby's Readline implementation (default gem). See there
+    # for more information.
+    #
     # @see .valid_out?
     #
     # @param [#to_s] prompt input prompt
+    # @param [false, nil, #call] completion disable autocompletion, use default
+    #   autocompletion or use given completion proc
     # @param [IO] stream writeable IO used to display output
     # @return [String] user input line
-    # @return [nil] when user interrputed input with `^C` or `^D`
-    def readline(prompt = nil, stream: StdOut.stream)
+    # @return [nil] when user interrupted input with `^C` or `^D`
+    def readline(prompt = nil, completion: false, stream: StdOut.stream)
+      cp = Readline.completion_proc
+      Readline.completion_proc = completion == false ? ->(*_) {} : completion
       Readline.output = stream
       Readline.input = @in_stream
       Readline.readline(prompt.to_s)
     rescue Interrupt
       stream.puts
       nil
+    ensure
+      Readline.completion_proc = cp
     end
 
     private

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: natty-ui
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: 0.6.0
 platform: ruby
 authors:
 - Mike Blumtritt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-11-11 00:00:00.000000000 Z
+date: 2023-11-17 00:00:00.000000000 Z
 dependencies: []
 description: |
   This is the beautiful, nice, nifty, fancy, neat, pretty, cool, lovely,
@@ -25,25 +25,28 @@ extra_rdoc_files:
 files:
 - LICENSE
 - README.md
+- examples/attributes.rb
 - examples/basic.rb
-- examples/colors.rb
-- examples/illustration.svg
+- examples/illustration.png
+- examples/list_in_columns.rb
 - examples/progress.rb
 - examples/query.rb
 - lib/natty-ui.rb
 - lib/natty-ui/ansi.rb
 - lib/natty-ui/ansi_wrapper.rb
+- lib/natty-ui/features.rb
+- lib/natty-ui/mixins.rb
 - lib/natty-ui/version.rb
 - lib/natty-ui/wrapper.rb
 - lib/natty-ui/wrapper/ask.rb
 - lib/natty-ui/wrapper/element.rb
-- lib/natty-ui/wrapper/features.rb
 - lib/natty-ui/wrapper/framed.rb
 - lib/natty-ui/wrapper/heading.rb
+- lib/natty-ui/wrapper/list_in_columns.rb
 - lib/natty-ui/wrapper/message.rb
-- lib/natty-ui/wrapper/mixins.rb
 - lib/natty-ui/wrapper/progress.rb
 - lib/natty-ui/wrapper/query.rb
+- lib/natty-ui/wrapper/request.rb
 - lib/natty-ui/wrapper/section.rb
 - lib/natty-ui/wrapper/task.rb
 homepage: https://github.com/mblumtritt/natty-ui
@@ -69,7 +72,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.21
+rubygems_version: 3.4.22
 signing_key:
 specification_version: 4
 summary: This is the beautiful, nice, nifty, fancy, neat, pretty, cool, lovely, natty

data/examples/colors.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-# require 'natty-ui'
-require_relative '../lib/natty-ui'
-
-256.times { |i| print NattyUI::Ansi.embellish("color #{i}  ", i) }
-puts