output_mode 1.3.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aba3d3f1c1ef5bd16dc8397b9500218ccc652af7dc6c11d85dfbb16cd7ec0ee0
-  data.tar.gz: 9568bee91c9a89576fa24a97e8d0fba2cbf86f28fb4d2f6ede3093b773bade17
+  metadata.gz: e4d5f1fa1744eeff5535f33a65593b370d317124736089a8b24e2d76cb824b6e
+  data.tar.gz: 10e77ade81138ebe9c6ca3e6b3299ba864c213603e54682eebb611057f72e2d6
 SHA512:
-  metadata.gz: 409dc9ad72f0a1771ad325995905bde702dcae4d3839b983c7cf02a5ace8927ef9cecc70954666dbce3a634b144d0ee8e8bf3f7981a55edcc52c480545ce36eb
-  data.tar.gz: 8663a174778b268e3ea596a81856ff2f53b3a4d3387e68e329bddb38f6d3e002bfc8838d3634304a7680cf8a998db99468dc18b210356259522b1c69aea34d00
+  metadata.gz: a754089932ba840c19e0070b03e99e10fd4a957e4204ee08806dde91d54d51899950f817b8a34d3736f6c1fa9df4f85321fd938909c381f12230fe53df312ed1
+  data.tar.gz: 7d5858053e4d55868893bbfa2c13ed63a52bd39f05f6b4ae690a29072c0ab7f7a4d9919204c6fd387dc2bd0ad19efec2fa5e0d023e22929452d2efa616cdf6d6

data/Gemfile

@@ -28,3 +28,10 @@ source "https://rubygems.org"
 
 # Specify your gem's dependencies in output_mode.gemspec
 gemspec
+
+# NOTE: Checks out the openflight version of tty-table with the 'rotate' flag
+# fix. This should eventually become part of the mainline version of TTY::Table
+#
+# This is intentionally not part of the gemspec so older versions of TTY::Table
+# can still be used
+gem 'tty-table', github: 'openflighthpc/tty-table', branch: '9b326fcbe04968463da58c000fbb1dd5ce178243'

data/bin/bundle

@@ -0,0 +1,114 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'bundle' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "rubygems"
+
+m = Module.new do
+  module_function
+
+  def invoked_as_script?
+    File.expand_path($0) == File.expand_path(__FILE__)
+  end
+
+  def env_var_version
+    ENV["BUNDLER_VERSION"]
+  end
+
+  def cli_arg_version
+    return unless invoked_as_script? # don't want to hijack other binstubs
+    return unless "update".start_with?(ARGV.first || " ") # must be running `bundle update`
+    bundler_version = nil
+    update_index = nil
+    ARGV.each_with_index do |a, i|
+      if update_index && update_index.succ == i && a =~ Gem::Version::ANCHORED_VERSION_PATTERN
+        bundler_version = a
+      end
+      next unless a =~ /\A--bundler(?:[= ](#{Gem::Version::VERSION_PATTERN}))?\z/
+      bundler_version = $1
+      update_index = i
+    end
+    bundler_version
+  end
+
+  def gemfile
+    gemfile = ENV["BUNDLE_GEMFILE"]
+    return gemfile if gemfile && !gemfile.empty?
+
+    File.expand_path("../../Gemfile", __FILE__)
+  end
+
+  def lockfile
+    lockfile =
+      case File.basename(gemfile)
+      when "gems.rb" then gemfile.sub(/\.rb$/, gemfile)
+      else "#{gemfile}.lock"
+      end
+    File.expand_path(lockfile)
+  end
+
+  def lockfile_version
+    return unless File.file?(lockfile)
+    lockfile_contents = File.read(lockfile)
+    return unless lockfile_contents =~ /\n\nBUNDLED WITH\n\s{2,}(#{Gem::Version::VERSION_PATTERN})\n/
+    Regexp.last_match(1)
+  end
+
+  def bundler_version
+    @bundler_version ||=
+      env_var_version || cli_arg_version ||
+        lockfile_version
+  end
+
+  def bundler_requirement
+    return "#{Gem::Requirement.default}.a" unless bundler_version
+
+    bundler_gem_version = Gem::Version.new(bundler_version)
+
+    requirement = bundler_gem_version.approximate_recommendation
+
+    return requirement unless Gem::Version.new(Gem::VERSION) < Gem::Version.new("2.7.0")
+
+    requirement += ".a" if bundler_gem_version.prerelease?
+
+    requirement
+  end
+
+  def load_bundler!
+    ENV["BUNDLE_GEMFILE"] ||= gemfile
+
+    activate_bundler
+  end
+
+  def activate_bundler
+    gem_error = activation_error_handling do
+      gem "bundler", bundler_requirement
+    end
+    return if gem_error.nil?
+    require_error = activation_error_handling do
+      require "bundler/version"
+    end
+    return if require_error.nil? && Gem::Requirement.new(bundler_requirement).satisfied_by?(Gem::Version.new(Bundler::VERSION))
+    warn "Activating bundler (#{bundler_requirement}) failed:\n#{gem_error.message}\n\nTo install the version of bundler this project requires, run `gem install bundler -v '#{bundler_requirement}'`"
+    exit 42
+  end
+
+  def activation_error_handling
+    yield
+    nil
+  rescue StandardError, LoadError => e
+    e
+  end
+end
+
+m.load_bundler!
+
+if m.invoked_as_script?
+  load Gem.bin_path("bundler", "bundle")
+end

data/bin/coderay

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'coderay' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("coderay", "coderay")

data/bin/demo

@@ -36,9 +36,22 @@ module DemoIndex
   register_callable(header: 'Standard', header_color: [:strikethrough] ) { 'always visible' }
   register_callable(header: 'Verbose', verbose: true) { 'verbose visible' }
   register_callable(header: 'Simplified', verbose: false) { 'simplified visible' }
+  register_callable(header: 'Interactive', interactive: true) { 'interactive visible' }
+  register_callable(header: 'Non Interactive', interactive: false) { 'non-interactive visible' }
   register_callable(header: 'Yes/True') { true }
   register_callable(header: 'No/False', row_color: [:clear]) { false }
   register_callable(header: 'Missing') { nil }
+  register_callable(header: 'Inline') do |interactive:, verbose:|
+    if interactive && verbose
+      'interactive-verbose'
+    elsif interactive
+      'interactive-simplified'
+    elsif verbose
+      'non-interactive-verbose'
+    else
+      'non-interactive-simplified'
+    end
+  end
 end
 
 module DemoShow
@@ -48,9 +61,13 @@ module DemoShow
   register_callable(header: 'Standard') { 'always visible' }
   register_callable(header: 'Verbose', verbose: true) { 'verbose visible' }
   register_callable(header: 'Simplified', verbose: false) { 'simplified visible' }
+  register_callable(header: 'Interactive', interactive: true) { 'interactive visible' }
+  register_callable(header: 'Non Interactive', interactive: false) { 'non-interactive visible' }
   register_callable(header: 'Yes/True', section: :boolean) { true }
   register_callable(header: 'No/False', section: :boolean) { false }
   register_callable(header: 'Missing') { nil }
+  register_callable(header: 'Tab') { "tab1\ttab2" }
+  register_callable(header: 'New line') { "line1\nline2" }
 end
 
 data = [1, 2, 3]
@@ -74,6 +91,12 @@ puts <<~EOF
 #==============================================================================
 #==============================================================================
 
+#==============================================================================
+# Default Demo Index
+# Simplified in interactive shells, verbose in non-interactive
+#==============================================================================
+#{DemoIndex.build_output.render(*data)}
+
 #==============================================================================
 # Demo Verbose Index
 #==============================================================================
@@ -81,7 +104,6 @@ puts <<~EOF
 
 #==============================================================================
 # Demo "Simplified" Index
-# NOTE: Disabled for non-interactive shell, shows the verbose output instead
 #==============================================================================
 #{DemoIndex.build_output(verbose: false).render(*data)}
 
@@ -108,6 +130,12 @@ puts <<~EOF
 #==============================================================================
 #==============================================================================
 
+#==============================================================================
+# Default Settings
+# Simplified in interactive shells, verbose in non-interactive
+#==============================================================================
+#{DemoShow.build_output.render(*data)}
+
 #==============================================================================
 # Demo Verbose Show
 #==============================================================================
@@ -115,7 +143,6 @@ puts <<~EOF
 
 #==============================================================================
 # Demo "Simplified" Show
-# NOTE: Disabled for non-interactive shell, shows the verbose output instead
 #==============================================================================
 #{DemoShow.build_output(verbose: false).render(*data)}
 

data/bin/htmldiff

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'htmldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("diff-lcs", "htmldiff")

data/bin/ldiff

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'ldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("diff-lcs", "ldiff")

data/bin/pry

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'pry' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("pry", "pry")

data/bin/rake

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rake", "rake")

data/bin/rspec

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rspec-core", "rspec")

data/lib/output_mode/builder_dsl.rb

@@ -36,7 +36,9 @@ module OutputMode
     # @param config Directly provided to {OutputMode::Callable#initialize}
     # @yield Directly provided to {OutputMode::Callable#initialize}
     def register_callable(**config, &b)
-      output_callables << Callable.new(**config, &b)
+      Callable.new(**config, &b).tap do |c|
+        output_callables << c
+      end
     end
 
     # Provides the base method signature

data/lib/output_mode/callable.rb

@@ -26,16 +26,19 @@
 
 module OutputMode
   # Internal array like object that will convert procs to Callable
-  class Callables < Array
+  class Callables
+    include Enumerable
+
     # @api private
     def initialize(callables = nil)
+      @callables = []
       case callables
-      when Array
-        super().tap do |all|
-          callables.each { |c| all << c }
+      when Array, Callables
+        callables.each do |c|
+          @callables << (c.is_a?(Callable) ? c : Callable.new(&c))
         end
       when nil
-        super()
+        # NOOP
       else
         raise "Can not convert #{callables.class} into a #{self.class}"
       end
@@ -43,13 +46,65 @@ module OutputMode
 
     def <<(item)
       if item.is_a? Callable
-        super
+        @callables << item
       elsif item.respond_to?(:call)
-        super(Callable.new(&item))
+        @callables << Callable.new(&item)
       else
         raise Error, "#{item.class} is not callable"
       end
     end
+
+    def each(&block)
+      @callables.each(&block)
+    end
+
+    def pad_each(*ctx, **input_opts)
+      fields = self.map do |callables|
+        field = callables.config[:header]
+        if field.respond_to?(:call)
+          opts =  if field.parameters.include?(:keyrest)
+                    input_opts.dup
+                  else
+                    keys = field.parameters
+                                 .select { |type, _| [:key, :keyreq].include?(type) }
+                                 .map { |_, k| k }
+                    input_opts.slice(*keys)
+                  end
+          opts.empty? ? field.call(*ctx) : field.call(*ctx, **opts)
+        else
+          field
+        end
+      end
+
+      max_length = fields.map { |f| f.to_s.length }.max
+      pads = self.each_with_index.map do |callable, idx|
+        field = fields[idx]
+        length = max_length - field.to_s.length
+        [callable, { padding: ' ' * length, field: field }]
+      end
+
+      if block_given?
+        pads.each { |c, opts|  yield(c, **opts) }
+      else
+        pads.each
+      end
+    end
+
+    def config_select(key, *values)
+      selected = self.select do |callable|
+        conf = callable.config[key]
+        if conf.is_a? Array
+          !(conf & values).empty?
+        else
+          values.include?(conf)
+        end
+      end
+      Callables.new(selected)
+    end
+
+    def length
+      @callables.length
+    end
   end
 
   class Callable
@@ -141,6 +196,29 @@ module OutputMode
     def call(*a)
       callable.call(*a)
     end
+
+    def generator(output)
+      ->(*a) do
+        # Implicitly determine which parts of the context can be passed through
+        ctx = if callable.parameters.any? { |type, _| type == :keyrest }
+                output.context
+              else
+                keys = callable.parameters.select { |type, _| [:key, :keyreq].include?(type) }
+                                      .map { |_, k| k }
+                output.context.slice(*keys)
+              end
+        raw = call(*a, **ctx)
+        if raw == true
+          config[:yes] || output.yes
+        elsif raw == false
+          config[:no] ||  output.no
+        elsif [nil, ''].include?(raw)
+          config[:default] || output.default
+        else
+          raw
+        end
+      end
+    end
   end
 end
 

data/lib/output_mode/default_erb.rb

@@ -1,5 +1,27 @@
 #==============================================================================
-# Refer to LICENSE.txt for licensing terms
+# Copyright 2021 William McCumstie
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer.
+#
+# 2. 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.
 #==============================================================================
 
 require 'erb'

data/lib/output_mode/non_interactive_erb.rb

@@ -0,0 +1,41 @@
+#==============================================================================
+# Copyright 2021 William McCumstie
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer.
+#
+# 2. 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.
+#==============================================================================
+
+require 'erb'
+
+module OutputMode
+  NON_INTERACTIVE_ERB = ERB.new(<<~TEMPLATE, nil, '-')
+    <% each do |value, field:, padding:, **_| -%>
+    <%   if value.nil? && field.nil? -%>
+    \t
+    <%   elsif field.nil? -%>
+    \t<%= value %>
+    <%   else -%>
+    <%= field -%>\t<%= value.to_s.dump[1...-1] %>
+    <%   end -%>
+    <% end -%>
+  TEMPLATE
+end

data/lib/output_mode/output.rb

@@ -36,45 +36,41 @@ module OutputMode
     # @!attribute [r] config
     #   @return [Hash] additional key-values to modify the render
     # @!attribute [r] default
-    #   @return either a static default or a column based array of defaults
+    #   @return either a static default
     # @!attribute [r] yes
-    #   @return either a static yes value or a column based array of values
+    #   @return either a static yes value
     # @!attribute [r] no
-    #   @return either a static no value or a column based array of values
-    attr_reader :procs, :config, :yes, :no, :default
+    #   @return either a static no value
+    # @!attribute [r] context
+    #   @return a hash of keys to be provided to the callables
+    attr_reader :procs, :config, :yes, :no, :default, :context
 
     # Creates a new outputting instance from an array of procs
     #
     # @param *procs [Array<#call>] an array of procs (or callable objects)
     # @param default: [String] replaces _blanks_ with a static string
-    # @param default: [Array] replace _blanks_ on a per column basis. The last value is repeated if the +procs+ are longer.
     # @param yes: [String] replaces +true+ with a static string
-    # @param yes: [Array] replaces +true+ on a per column basis. The last value is repeated if the +procs+ are longer.
     # @param no: [String] replaces +false+ with a static string
-    # @param no: [Array] replaces +false+ on a per column basis. The last value is repeated if the +procs+ are longer.
+    # @param context: [Hash] of keys to be provided to the callables
     # @param **config [Hash] a hash of additional keys to be stored
-    def initialize(*procs, default: nil, yes: 'true', no: 'false', **config)
-      @procs = procs
+    def initialize(*procs, default: nil, yes: 'true', no: 'false', context: {}, **config)
+      @procs = Callables.new(procs)
       @config = config
       @yes = yes
       @no = no
       @default = default
+      @context = context
+    end
+
+    def callables
+      procs
     end
 
     # Returns the results of the +procs+ for a particular +object+. It will apply the
     # +default+, +yes+, and +no+ values.
     def generate(object)
-      procs.each_with_index.map do |p, idx|
-        raw = p.call(object)
-        if raw == true
-          index_selector(:yes, idx)
-        elsif raw == false
-          index_selector(:no, idx)
-        elsif !default.nil? && (raw.nil? || raw == '')
-          index_selector(:default, idx)
-        else
-          raw
-        end
+      procs.map do |callable|
+        callable.generator(self).call(object)
       end
     end
 
@@ -91,37 +87,5 @@ module OutputMode
     def render(*data)
       raise NotImplementedError
     end
-
-    # A helper method for selecting elements from a source array or return
-    # a static value.
-    #
-    # @param [Symbol] method The source method on the +output+
-    # @param [Integer] index The index to lookup
-    #
-    # @overload index_selector(array_method, valid_index)
-    #   @param array_method A method that returns an array
-    #   @param valid_index An index that is less than the array's length
-    #   @return the value at the index
-    #
-    # @overload index_selector(array_method, out_of_bounds)
-    #   @param array_method A method that returns an array
-    #   @param out_of_bounds An index greater than the maximum array length
-    #   @return the last element of the array
-    #
-    # @overload index_selector(non_array_method, _)
-    #   @param non_array_method A method that does not return an array
-    #   @param _ The index is ignored
-    #   @return the result of the non_array_method
-    def index_selector(method, index)
-      source = public_send(method)
-      is_array = source.is_a? Array
-      if is_array && source.length > index
-        source[index]
-      elsif is_array
-        source.last
-      else
-        source
-      end
-    end
   end
 end

data/lib/output_mode/outputs/delimited.rb

@@ -40,7 +40,12 @@ module OutputMode
       def render(*data)
         io = StringIO.new
         csv = CSV.new(io, **config)
-        data.each { |d| csv << generate(d) }
+        data.each do |datum|
+          csv << generate(datum).map do |value|
+            next nil if value.nil?
+            value.to_s.dump[1...-1]
+          end
+        end
         io.tap(&:rewind).read
       end
     end

data/lib/output_mode/outputs/tabulated.rb

@@ -31,8 +31,6 @@ module OutputMode
     class Tabulated < Output
       # @!attribute [r] renderer
       #   @return [Symbol] the renderer type, see: https://github.com/piotrmurach/tty-table#32-renderer
-      # @!attribute [r] header
-      #   @return [Array] An optional header row for the table
       # @!attribute [r] block
       #   @return [#call] an optional block of code that configures the renderer
       # @!attribute [r] colorize
@@ -41,28 +39,25 @@ module OutputMode
       #   @return An optional header color or array of colors
       # @!attribute [r] row_color
       #   @return An optional data color or array of colors
-      attr_reader :renderer, :header, :default, :block, :yes, :no,
+      attr_reader :renderer, :default, :block, :yes, :no,
                   :header_color, :row_color, :colorize
 
       # @return [Hash] additional options to +TTY::Table+ renderer
       # @see https://github.com/piotrmurach/tty-table#33-options
       def config; super; end
 
-      # @overload initialize(*procs, renderer: nil, header: nil, **config)
+      # @overload initialize(*procs, renderer: nil, **config)
       #   @param [Array] *procs see {OutputMode::Outputs::Base#initialize}
       #   @param [Symbol] :renderer override the default renderer
-      #   @param [Array<String>] :header the header row of the table
       #   @param [Hash] **config additional options to the renderer
       #   @yieldparam tty_table_renderer [TTY::Table::Renderer::Base] optional access the underlining TTY::Table renderer
       def initialize(*procs,
                      renderer: :unicode,
                      colorize: false,
-                     header: nil,
                      header_color: nil,
                      row_color: nil,
                      **config,
                      &block)
-        @header = header
         @renderer =  renderer
         @block = block
         @header_color = header_color
@@ -76,31 +71,38 @@ module OutputMode
       # @see https://github.com/piotrmurach/tty-table
       def render(*data)
         table = TTY::Table.new header: processed_header
-        data.each { |d| table << process_row(generate(d)) }
+        data.each { |d| table << process_row(d) }
         table.render(renderer, **config, &block) || ''
       end
 
       private
 
+      def has_header?
+        callables.any? { |c| c.config.key?(:header) }
+      end
+
       # Colorizes the header when requested
       def processed_header
-        header&.each_with_index&.map do |h, idx|
-          color = index_selector(:header_color, idx)
+        return nil unless has_header?
+        callables.map do |callable|
+          header = callable.config.fetch(:header, '')
+          color = callable.config.fetch(:header_color, nil) || header_color
           case color
           when nil
-            h.to_s
+            header.to_s
           when Array
-            pastel.decorate(h.to_s, *color)
+            pastel.decorate(header.to_s, *color)
           else
-            pastel.decorate(h.to_s, color)
+            pastel.decorate(header.to_s, color)
           end
         end
       end
 
       # Colorizes the row when requested
-      def process_row(data)
-        data.each_with_index.map do |d, idx|
-          color = index_selector(:row_color, idx)
+      def process_row(model)
+        callables.map do |callable|
+          d = callable.generator(self).call(model)
+          color = callable.config[:row_color] || row_color
           case color
           when NilClass
             d.to_s

data/lib/output_mode/outputs/templated.rb

@@ -38,27 +38,24 @@ module OutputMode
         # @yieldparam field: An optional field header for the value
         # @yieldparam padding: A padding string which will right align the +field+
         # @yieldparam **config TBA
-        def each(section = nil)
-          # Select the indices for the relevant section
-          indices = (0...output.procs.length).to_a
-          if section
-            indices.select! do |idx|
-              output.index_selector(:sections, idx) == section
-            end
-          end
-
-          # Find the max field length
-          max = indices.map do |idx|
-            output.index_selector(:fields, idx).to_s.length
-          end.max
+        def each(section = nil, &block)
+          # Select the callable objects
+          callables = if section == nil
+                        output.callables
+                      elsif section == :default
+                        output.callables.config_select(:section, :default, nil)
+                      else
+                        output.callables.config_select(:section, section)
+                      end
 
           # Yield each selected attribute
-          indices.each do |idx|
-            value = generated[idx]
-            field = output.index_selector(:fields, idx)
-            padding = ' ' * (max - field.to_s.length)
-            yield(value, field: field, padding: padding)
+          objs = callables.pad_each(model, **output.context).map do |callable, padding:, field:|
+            value = callable.generator(output).call(model)
+            [value, { field: field, padding: padding }]
           end
+
+          # Runs the provided block
+          objs.each(&block)
         end
 
         # Renders an ERB object within the entry's context. This provides access to the

data/lib/output_mode/tldr/index.rb

@@ -35,12 +35,18 @@ module OutputMode
       # @overload register_callable(header:, verbose: true)
       #   @param header: The column's header field when displaying to humans
       #   @param verbose: Whether the column will be shown in the verbose output
+      #   @param interactive: Whether the field will be show in the interactive output
       #   @param header_color: Override the default color for the header
       #   @param row_color: Override the default color for the row
+      #   @param modes: Additional modes flags for the callable
       #   @yieldparam model The subject the column is describing, some sort of data model
-      def register_callable(header:, verbose: nil, header_color: nil, row_color: nil, &b)
-        super(modes: { verbose: verbose }, header: header,
-              header_color: header_color, row_color: row_color, &b)
+      def register_callable(modes: {}, header:, verbose: nil, interactive: nil, header_color: nil, row_color: nil, &b)
+        modes = modes.map { |m| [m, true] }.to_h if modes.is_a? Array
+        super(modes: modes.merge(verbose: verbose, interactive: interactive),
+              header: header,
+              header_color: header_color,
+              row_color: row_color,
+              &b)
       end
       alias_method :register_column, :register_callable
 
@@ -65,8 +71,16 @@ module OutputMode
       #
       # An interative/ non-interactive output can be forced by setting the
       # +interactive+ flag to +true+/+false+ respectively
-      def build_output(verbose: false, ascii: false, interactive: nil, header_color: [:blue, :bold], row_color: :green)
-        callables = if verbose || !$stdout.tty?
+      def build_output(verbose: nil, ascii: nil, interactive: nil, header_color: [:blue, :bold], row_color: :green, context: {})
+        # Set the interactive and verbose flags if not provided
+        interactive = $stdout.tty?  if interactive.nil?
+        verbose =     !interactive  if verbose.nil?
+        ascii =       !interactive  if ascii.nil?
+
+        # Update the rendering context with the verbosity/interactive settings
+        context = context.merge(interactive: interactive, verbose: verbose, ascii: ascii)
+
+        callables = if verbose
           # Filter out columns that are explicitly not verbose
           output_callables.select { |o| o.verbose?(true) }
         else
@@ -74,27 +88,37 @@ module OutputMode
           output_callables.reject(&:verbose?)
         end
 
-        if interactive || (interactive.nil? && $stdout.tty?)
+        callables = if interactive
+          # Filter out columns that are explicitly not interactive
+          callables.select { |o| o.interactive?(true) }
+        else
+          # Filter out columns that are explicitly interactive
+          callables.reject { |o| o.interactive? }
+        end
+
+        if interactive
           # Creates the human readable output
           opts = if ascii
                    { yes: 'yes', no: 'no', renderer: :ascii }
                  else
                    {
                      yes: '✓', no: '✕', renderer: :unicode, colorize: TTY::Color.color?,
-                     header_color: callables.map { |c| c.config[:header_color] || header_color },
-                     row_color: callables.map { |c| c.config[:row_color] || row_color }
+                     header_color: header_color,
+                     row_color: row_color
                    }
                  end
 
           Outputs::Tabulated.new(*callables,
-                                 header: callables.map { |c| c.config.fetch(:header, 'missing') },
+                                 rotate: false,
                                  padding: [0,1],
                                  default: '(none)',
+                                 context: context,
                                  **opts
                                  )
         else
           # Creates the machine readable output
-          Outputs::Delimited.new(*callables, col_sep: "\t", yes: 'yes', no: 'no', default: '')
+          Outputs::Delimited.new(*callables, col_sep: "\t", yes: 'yes', no: 'no', default: nil,
+                                context: context)
         end
       end
     end

data/lib/output_mode/tldr/show.rb

@@ -25,6 +25,8 @@
 #==============================================================================
 
 require 'tty-color'
+require 'output_mode/default_erb'
+require 'output_mode/non_interactive_erb'
 
 module OutputMode
   module TLDR
@@ -35,10 +37,16 @@ module OutputMode
       # @overload register_callable(header:, verbose: true)
       #   @param header: The human readable key to the field, uses the term 'header' for consistency
       #   @param verbose: Whether the field will be shown in the verbose output
+      #   @param interactive: Whether the field will be show in the interactive output
       #   @param section: Define the grouping a callable belongs to. Ignored by default
+      #   @param modes: Additional modes flags for the callable
       #   @yieldparam model The subject the column is describing, some sort of data model
-      def register_callable(header:, verbose: nil, section: :other, &b)
-        super(modes: { verbose: verbose }, header: header, section: section, &b)
+      def register_callable(modes: {}, header:, verbose: nil, interactive: nil, section: :default, &b)
+        modes = modes.map { |m| [m, true] }.to_h if modes.is_a? Array
+        super(modes: modes.merge(verbose: verbose, interactive: interactive),
+              header: header,
+              section: section,
+              &b)
       end
       alias_method :register_attribute, :register_callable
 
@@ -61,12 +69,24 @@ module OutputMode
       # for consumption by machines. This output ignores the provided +verbose+
       # flag as it is always verbose.
       #
-      # The +template+ overrides the default erb template for the output
+      # The +template+ overrides the default erb template for interactive sessions.
+      # The +non_interactive_template+ overrides the template for non-interactive
+      # sessions.
       #
       # An interative/ non-interactive output can be forced by setting the
       # +interactive+ flag to +true+/+false+ respectively
-      def build_output(verbose: false, ascii: false, interactive: nil, template: nil)
-        callables = if verbose || !$stdout.tty?
+      def build_output(verbose: nil, ascii: nil, interactive: nil, context: {},
+                       template: OutputMode::DEFAULT_ERB,
+                       non_interactive_template: OutputMode::NON_INTERACTIVE_ERB)
+        # Set the interactive and verbose flags if not provided
+        interactive = $stdout.tty?  if interactive.nil?
+        verbose =     !interactive  if verbose.nil?
+        ascii =       !interactive  if ascii.nil?
+
+        # Update the rendering context with the verbosity/interactive settings
+        context = context.merge(interactive: interactive, verbose: verbose, ascii: ascii)
+
+        callables = if verbose
           # Filter out columns that are explicitly not verbose
           output_callables.select { |o| o.verbose?(true) }
         else
@@ -74,26 +94,30 @@ module OutputMode
           output_callables.reject(&:verbose?)
         end
 
-        if interactive || (interactive.nil? && $stdout.tty?)
-          # Creates the human readable output
-          opts =  if ascii
-                    { yes: 'yes', no: 'no', colorize: false }
-                  else
-                    { yes: '✓', no: '✕', colorize: TTY::Color.color? }
-                  end
-
-          sections = callables.map { |o| o.config[:section] }
-
-          Outputs::Templated.new(*callables,
-                                 fields: callables.map { |c| c.config.fetch(:header, 'missing') },
-                                 default: '(none)',
-                                 sections: sections,
-                                 template: template,
-                                 **opts)
+        callables = if interactive
+          # Filter out columns that are explicitly not interactive
+          callables.select { |o| o.interactive?(true) }
         else
-          # Creates the machine readable output
-          Outputs::Delimited.new(*callables, col_sep: "\t", yes: 'yes', no: 'no', default: '')
+          # Filter out columns that are explicitly interactive
+          callables.reject { |o| o.interactive? }
         end
+
+        # Define the templating parameters
+        opts =  if ascii && interactive
+                  { yes: 'yes', no: 'no', colorize: false, default: '(none)', template: template }
+                elsif interactive
+                  { yes: '✓', no: '✕', colorize: TTY::Color.color?, default: '(none)', template: template }
+                else
+                  { yes: 'yes', no: 'no', colorize: false, default: '', template: non_interactive_template }
+                end
+
+        sections = callables.map { |o| o.config[:section] }
+
+        Outputs::Templated.new(*callables,
+                               fields: callables.map { |c| c.config.fetch(:header, 'missing') },
+                               sections: sections,
+                               context: context,
+                               **opts)
       end
     end
   end

data/lib/output_mode/version.rb

@@ -25,5 +25,5 @@
 #==============================================================================
 
 module OutputMode
-  VERSION = "1.3.0"
+  VERSION = "1.6.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: output_mode
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.6.0
 platform: ruby
 authors:
 - William McCumsite
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-11-04 00:00:00.000000000 Z
+date: 2021-05-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tty-table
@@ -122,14 +122,22 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- bin/bundle
+- bin/coderay
 - bin/console
 - bin/demo
+- bin/htmldiff
+- bin/ldiff
+- bin/pry
+- bin/rake
+- bin/rspec
 - bin/setup
 - lib/output_mode.rb
 - lib/output_mode/builder_dsl.rb
 - lib/output_mode/callable.rb
 - lib/output_mode/default_erb.rb
 - lib/output_mode/errors.rb
+- lib/output_mode/non_interactive_erb.rb
 - lib/output_mode/output.rb
 - lib/output_mode/outputs.rb
 - lib/output_mode/outputs/delimited.rb