whirled_peas 0.3.0 → 0.7.0

data/lib/whirled_peas/settings/grid_settings.rb

@@ -0,0 +1,19 @@
+require 'whirled_peas/utils/title_font'
+
+require_relative 'container_settings'
+
+module WhirledPeas
+  module Settings
+    class GridSettings < ContainerSettings
+      attr_accessor :num_cols
+
+      def set_scrollbar(*)
+        raise NotImplementedError, 'Grids do not support scrollbars'
+      end
+
+      def sizing=(*)
+        raise NotImplementedError, 'Grids only support the default sizing model'
+      end
+    end
+  end
+end

data/lib/whirled_peas/settings/margin.rb

@@ -0,0 +1,8 @@
+require_relative 'spacing'
+
+module WhirledPeas
+  module Settings
+    class Margin < Spacing
+    end
+  end
+end

data/lib/whirled_peas/settings/padding.rb

@@ -0,0 +1,8 @@
+require_relative 'spacing'
+
+module WhirledPeas
+  module Settings
+    class Padding < Spacing
+    end
+  end
+end

data/lib/whirled_peas/settings/position.rb

@@ -0,0 +1,15 @@
+module WhirledPeas
+  module Settings
+    class Position
+      attr_writer :left, :top
+
+      def left
+        @left || 0
+      end
+
+      def top
+        @top || 0
+      end
+    end
+  end
+end

data/lib/whirled_peas/settings/scrollbar.rb

@@ -0,0 +1,15 @@
+module WhirledPeas
+  module Settings
+    class Scrollbar
+      attr_writer :horiz, :vert
+
+      def horiz?
+        @horiz == true
+      end
+
+      def vert?
+        @vert == true
+      end
+    end
+  end
+end

data/lib/whirled_peas/settings/sizing.rb

@@ -0,0 +1,19 @@
+module WhirledPeas
+  module Settings
+    class Sizing
+      CONTENT = :content
+      BORDER = :border
+
+      DEFAULT = CONTENT
+
+      VALID = [CONTENT, BORDER]
+      private_constant :VALID
+
+      def self.validate!(sizing)
+        return if sizing.nil?
+        return sizing if VALID.include?(sizing)
+        raise ArgumentError, "Unsupported sizing model: #{sizing.inspect}"
+      end
+    end
+  end
+end

data/lib/whirled_peas/settings/spacing.rb

@@ -0,0 +1,58 @@
+module WhirledPeas
+  module Settings
+    class Spacing
+      attr_writer :left, :top, :right, :bottom
+
+      def left=(value)
+        @left = validate!(value)
+      end
+
+      def left
+        @left || 0
+      end
+
+      def top=(value)
+        @top = validate!(value)
+      end
+
+      def top
+        @top || 0
+      end
+
+      def right=(value)
+        @right = validate!(value)
+      end
+
+      def right
+        @right || 0
+      end
+
+      def bottom=(value)
+        @bottom = validate!(value)
+      end
+
+      def bottom
+        @bottom || 0
+      end
+
+      def horiz=(value)
+        self.left = self.right = value
+      end
+
+      def vert=(value)
+        self.top = self.bottom = value
+      end
+
+      private
+
+      def validate!(value)
+        if value && value < 0
+          raise ArgumentError, "Negative values for #{self.class.name.split('::').last.downcase} are not allowed"
+        else
+          value
+        end
+      end
+    end
+    private_constant :Spacing
+  end
+end

data/lib/whirled_peas/settings/text_color.rb

@@ -0,0 +1,21 @@
+require 'whirled_peas/utils/ansi'
+
+require_relative 'color'
+
+module WhirledPeas
+  module Settings
+    class TextColor < Color
+      BLACK = new(Utils::Ansi::BLACK)
+      RED = new(Utils::Ansi::RED)
+      GREEN = new(Utils::Ansi::GREEN)
+      YELLOW = new(Utils::Ansi::YELLOW)
+      BLUE = new(Utils::Ansi::BLUE)
+      MAGENTA = new(Utils::Ansi::MAGENTA)
+      CYAN = new(Utils::Ansi::CYAN)
+      WHITE = new(Utils::Ansi::WHITE)
+      GRAY = BLACK.bright
+
+      DEFAULT = nil  # Use system defined default
+    end
+  end
+end

data/lib/whirled_peas/settings/text_settings.rb

@@ -0,0 +1,15 @@
+require 'whirled_peas/utils/title_font'
+
+require_relative 'element_settings'
+
+module WhirledPeas
+  module Settings
+    class TextSettings < ElementSettings
+      attr_reader :title_font
+
+      def title_font=(font)
+        @title_font = Utils::TitleFont.validate!(font)
+      end
+    end
+  end
+end

data/lib/whirled_peas/settings/vert_alignment.rb

@@ -0,0 +1,24 @@
+module WhirledPeas
+  module Settings
+    module VertAlignment
+      TOP = :top
+      MIDDLE = :middle
+      BOTTOM = :bottom
+      BETWEEN = :between
+      AROUND = :around
+      EVENLY = :evenly
+
+      DEFAULT = TOP
+
+      VALID = [TOP, MIDDLE, BOTTOM, BETWEEN, AROUND, EVENLY]
+      private_constant :VALID
+
+      def self.validate!(valign)
+        return if valign.nil?
+        return valign if VALID.include?(valign)
+        raise ArgumentError, "Unsupported vertical alignment: #{valign.inspect}"
+      end
+    end
+    private_constant :VertAlignment
+  end
+end

data/lib/whirled_peas/utils.rb

@@ -0,0 +1,5 @@
+module WhirledPeas
+  module Utils
+  end
+  private_constant :Utils
+end

data/lib/whirled_peas/utils/ansi.rb

@@ -0,0 +1,53 @@
+module WhirledPeas
+  module Utils
+    # Helper module for working with ANSI escape codes. The most useful ANSI escape codes
+    # relate to text formatting.
+    #
+    # @see https://en.wikipedia.org/wiki/ANSI_escape_code
+    module Ansi
+      ESC = "\033"
+
+      END_FORMATTING = 0
+      private_constant :END_FORMATTING
+
+      # Text formatting constants
+      BOLD = 1
+      UNDERLINE = 4
+
+      # Text and background color constants
+      BLACK = 30
+      RED = 31
+      GREEN = 32
+      YELLOW = 33
+      BLUE = 34
+      MAGENTA = 35
+      CYAN = 36
+      WHITE = 37
+
+      # Bright colors are offset by this much from their standard versions
+      BRIGHT_OFFSET = 60
+
+      class << self
+        def cursor_pos(top: 0, left: 0)
+          "#{ESC}[#{top + 1};#{left + 1}H"
+        end
+
+        def cursor_visible(visible)
+          visible ? "#{ESC}[?25h" : "#{ESC}[?25l"
+        end
+
+        def clear_down
+          "#{ESC}[J"
+        end
+
+        def clear
+          esc_seq(END_FORMATTING)
+        end
+
+        def esc_seq(code)
+          "#{ESC}[#{code}m"
+        end
+      end
+    end
+  end
+end

data/lib/whirled_peas/utils/formatted_string.rb

@@ -0,0 +1,64 @@
+require_relative 'ansi'
+
+module WhirledPeas
+  module Utils
+    class FormattedString
+      def self.blank
+        new('')
+      end
+
+      def initialize(raw, formatting=nil)
+        @raw = raw
+        @formatting = [*formatting]
+      end
+
+      def length
+        raw.length
+      end
+
+      def [](index_or_range)
+        self.class.new(raw[index_or_range], foramtting)
+      end
+
+      def blank?
+        raw.empty?
+      end
+
+      def hash
+        [raw, formatting].hash
+      end
+
+      def ==(other)
+        case other
+        when self.class
+          hash == other.hash
+        when String
+          formatting.empty? && raw == other
+        else
+          false
+        end
+      end
+
+      def to_s
+        if raw.empty? || formatting.length == 0
+          raw
+        else
+          start_formatting = formatting.map { |code| Ansi.esc_seq(code) }.join
+          "#{start_formatting}#{raw}#{Ansi.clear}"
+        end
+      end
+
+      def inspect
+        if raw.empty? || formatting.length == 0
+          raw.inspect
+        else
+          "<#{formatting.join(', ')}>#{raw}<0>".inspect
+        end
+      end
+
+      private
+
+      attr_reader :raw, :formatting
+    end
+  end
+end

data/lib/whirled_peas/utils/title_font.rb

@@ -0,0 +1,75 @@
+module WhirledPeas
+  module Utils
+    module TitleFont
+      PREFERRED_DEFAULT_FONT = :ansishadow
+      FONT_CACHE = File.join(ENV['HOME'] || '.', '.whirled_peas.fonts')
+
+      class << self
+        def validate!(font_key)
+          return if font_key.nil?
+          return font_key if fonts.key?(font_key)
+          allowed = fonts.keys.map(&:inspect).sort
+          message = "Unrecognized font: '#{font_key.inspect}', expecting one of #{allowed.join(', ')}"
+          raise ArgumentError, message
+        end
+
+        def to_s(string, font_key)
+          require 'ruby_figlet'
+          RubyFiglet::Figlet.new(string, fonts[font_key]).to_s
+        end
+
+        def fonts
+          return @fonts if @fonts
+          File.exist?(FONT_CACHE) ? load_fonts_from_cache : load_fonts_from_figlet
+          @fonts
+        end
+
+        def load_fonts_from_cache
+          require 'json'
+          @fonts = {}
+          File.open(FONT_CACHE, 'r') do |fp|
+            JSON.parse(fp.read).each do |key, value|
+              @fonts[key.to_sym] = value
+            end
+          end
+          @fonts
+        end
+
+        def load_fonts_from_figlet
+          require 'ruby_figlet'
+          require 'json'
+          @fonts = {}
+          RubyFiglet::Figlet.available.strip.split("\n").each do |font|
+            # Load the font to be sure it exists on the system
+            next unless available?(font)
+            string_key = font.downcase.gsub(/\W/, '')
+            string_key = "_#{string_key}" if string_key[0] !~ /[a-z]/
+            string_key.gsub!(/\d+$/, '')
+            next if @fonts.key?(string_key)
+            @fonts[string_key.to_sym] = font
+          end
+          @fonts[:default] ||= @fonts[PREFERRED_DEFAULT_FONT] || @fonts.values.first
+          File.open(FONT_CACHE, 'w') { |fp| fp.write(JSON.generate(@fonts)) }
+          @fonts
+        end
+
+        private
+
+        def available?(font)
+          # Figlet's font loader prints to STDOUT if the font file is not found.
+          # Temporarily redirect STDOUT to /dev/null while the font file is loaded
+          # then remove the redirect in an ensure block. Also, if a font file is
+          # not available, a SystemExit is raise :/
+          original_stdout = $stdout.clone
+          $stdout.reopen(File.new('/dev/null', 'w'))
+          RubyFiglet::Figlet.new('Text', font)
+          true
+        rescue SystemExit, NoMethodError
+          false
+        ensure
+          $stdout.reopen(original_stdout)
+        end
+      end
+    end
+  end
+end

data/lib/whirled_peas/version.rb

@@ -1,3 +1,3 @@
 module WhirledPeas
-  VERSION = '0.3.0'
+  VERSION = '0.7.0'
 end

data/screen_test/elements/box.frame

@@ -0,0 +1 @@
+[?25lTOP LEFTBOTTOM LEFT TOP RIGHT    BOTTOM RIGHT[?25h

data/screen_test/elements/box.rb

@@ -0,0 +1,20 @@
+require 'whirled_peas'
+
+class TemplateFactory
+  def build(*)
+    WhirledPeas.template do |composer|
+      composer.add_box('Container') do |composer, settings|
+        composer.add_box do |composer, settings|
+          settings.flow = :t2b
+          composer.add_box('TopLeft') { "TOP LEFT" }
+          composer.add_box('BottomLeft') { "BOTTOM LEFT" }
+        end
+        composer.add_box do |composer, settings|
+          settings.flow = :t2b
+          composer.add_box('TopRight') { " TOP RIGHT   " }
+          composer.add_box('BottomRight') { " BOTTOM RIGHT" }
+        end
+      end
+    end
+  end
+end