output_mode 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4d5f1fa1744eeff5535f33a65593b370d317124736089a8b24e2d76cb824b6e
-  data.tar.gz: 10e77ade81138ebe9c6ca3e6b3299ba864c213603e54682eebb611057f72e2d6
+  metadata.gz: 4beed6d9f51548ef131e475bb68aa9c6d6fe079e39672b4691566ff80ffb65c2
+  data.tar.gz: df648ec5ee82875c189123dca55bfaabfa3bf4d5ba24e160be1d0f15bb1a624b
 SHA512:
-  metadata.gz: a754089932ba840c19e0070b03e99e10fd4a957e4204ee08806dde91d54d51899950f817b8a34d3736f6c1fa9df4f85321fd938909c381f12230fe53df312ed1
-  data.tar.gz: 7d5858053e4d55868893bbfa2c13ed63a52bd39f05f6b4ae690a29072c0ab7f7a4d9919204c6fd387dc2bd0ad19efec2fa5e0d023e22929452d2efa616cdf6d6
+  metadata.gz: 4e19a13c9e5b0b6e3fa497aadd4d1ed59bb6297fd8063f88d7f6a01bd4dd84f801baae9be8efe46a0e42e63024824d227fa51c0f7b84ad283baec7f5960fb2f6
+  data.tar.gz: b9ea560f3b42886ca8baaa04452cc5e4557c82ddf23068b095b544f2649b425b5b30a30212d6ef7955cd1fde41c624b4f9fbe73cfc32a3a2ddb1092f6d16fd54

data/.travis.yml

@@ -3,7 +3,6 @@ sudo: false
 language: ruby
 cache: bundler
 rvm:
-  - 2.6.5
   - 2.7.0
 before_install: gem install bundler -v 2.0.2
 script: bundle exec rspec --format documentation --order random

data/bin/byebug

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'byebug' 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("byebug", "byebug")

data/bin/demo

@@ -29,61 +29,50 @@ require "bundler/setup"
 require "output_mode"
 require 'erb'
 
-module DemoIndex
-  extend OutputMode::TLDR::Index
-
-  register_callable(header: 'Integer', row_color: [:yellow, :bold]) { |i| i }
-  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'
+class DemoIndex < OutputMode::Formatters::Index
+  constructor do
+    register(header: 'Integer', row_color: [:yellow, :bold]) { |i| i }
+    register(header: 'Standard', header_color: [:strikethrough] ) { 'always visible' }
+    if verbose?
+      register(header: 'Verbose') { 'verbose visible' }
     else
-      'non-interactive-simplified'
+      register(header: 'Simplified') { 'simplified visible' }
     end
+    if interactive?
+      register(header: 'Interactive') { 'interactive visible' }
+    else
+      register(header: 'Non Interactive') { 'non-interactive visible' }
+    end
+    register(header: 'Yes/True') { true }
+    register(header: 'No/False', row_color: [:clear]) { false }
+    register(header: 'Missing') { nil }
   end
 end
 
-module DemoShow
-  extend OutputMode::TLDR::Show
-
-  register_callable(header: 'Integer') { |i| i }
-  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" }
+class DemoShow < OutputMode::Formatters::Show
+  constructor do
+    register(header: 'Integer') { |i| i }
+    register(header: 'Standard') { 'always visible' }
+    if verbose?
+      register(header: 'Verbose') { 'verbose visible' }
+    else
+      register(header: 'Simplified') { 'simplified visible' }
+    end
+    if interactive?
+      register(header: 'Interactive') { 'interactive visible' }
+    else
+      register(header: 'Non Interactive') { 'non-interactive visible' }
+    end
+    register(header: 'Yes/True', section: :boolean) { true }
+    register(header: 'No/False', section: :boolean) { false }
+    register(header: 'Missing') { nil }
+    register(header: 'Tab') { "tab1\ttab2" }
+    register(header: 'New line') { "line1\nline2" }
+  end
 end
 
 data = [1, 2, 3]
 
-other_template = ERB.new(<<~TEMPLATE, nil, '-')
-# Non boolean values
-<% each(:other) do |value, field:, padding:, **_| -%>
-<%= padding -%><%= pastel.blue.bold field -%><%= pastel.bold ':' -%> <%= pastel.green value %>
-<% end -%>
-
-# Boolean Values
-<% each(:boolean) do |value, field:, padding:, **_| -%>
-<%= padding -%><%= pastel.blue.bold field -%><%= pastel.bold ':' -%> <%= pastel.green value %>
-<% end -%>
-TEMPLATE
-
 puts <<~EOF
 #==============================================================================
 #==============================================================================
@@ -95,34 +84,34 @@ puts <<~EOF
 # Default Demo Index
 # Simplified in interactive shells, verbose in non-interactive
 #==============================================================================
-#{DemoIndex.build_output.render(*data)}
+#{DemoIndex.render(*data)}
 
 #==============================================================================
 # Demo Verbose Index
 #==============================================================================
-#{DemoIndex.build_output(verbose: true).render(*data)}
+#{DemoIndex.render(*data, verbose: true)}
 
 #==============================================================================
 # Demo "Simplified" Index
 #==============================================================================
-#{DemoIndex.build_output(verbose: false).render(*data)}
+#{DemoIndex.render(*data, verbose: false)}
 
 #==============================================================================
 # Force Interactive
 # Always print as if the shell is interactive
 #==============================================================================
-#{DemoIndex.build_output(interactive: true).render(*data)}
+#{DemoIndex.render(*data, interactive: true)}
 
 #==============================================================================
 # Force Non-Interactive
 # Always print as if the shell is non-interactive
 #==============================================================================
-#{DemoIndex.build_output(interactive: false).render(*data)}
+#{DemoIndex.render(*data, interactive: false)}
 
 #==============================================================================
 # Demo ASCII Index
 #==============================================================================
-#{DemoIndex.build_output(ascii: true).render(*data)}
+#{DemoIndex.render(*data, ascii: true)}
 
 #==============================================================================
 #==============================================================================
@@ -134,39 +123,32 @@ puts <<~EOF
 # Default Settings
 # Simplified in interactive shells, verbose in non-interactive
 #==============================================================================
-#{DemoShow.build_output.render(*data)}
+#{DemoShow.render(data.first)}
 
 #==============================================================================
 # Demo Verbose Show
 #==============================================================================
-#{DemoShow.build_output(verbose: true).render(*data)}
+#{DemoShow.render(data.first, verbose: true)}
 
 #==============================================================================
 # Demo "Simplified" Show
 #==============================================================================
-#{DemoShow.build_output(verbose: false).render(*data)}
+#{DemoShow.render(data.first, verbose: false)}
 
 #==============================================================================
 # Force Interactive
 # Always print as if the shell is interactive
 #==============================================================================
-#{DemoShow.build_output(interactive: true).render(*data)}
+#{DemoShow.render(data.first, interactive: true)}
 
 #==============================================================================
 # Force Non-Interactive
 # Always print as if the shell is non-interactive
 #==============================================================================
-#{DemoShow.build_output(interactive: false).render(*data)}
+#{DemoShow.render(data.first, interactive: false)}
 
 #==============================================================================
 # Demo ASCII Index
 #==============================================================================
-#{DemoShow.build_output(ascii: true).render(*data)}
-
-#==============================================================================
-# Group the boolean value separately
-# NOTE: This only occurs in interactive mode
-#       Non-Interactive sessions have a fix order
-#==============================================================================
-#{DemoShow.build_output(template: other_template).render(*data)}
+#{DemoShow.render(data.first, ascii: true)}
 EOF

data/lib/output_mode/callable.rb

@@ -58,7 +58,7 @@ module OutputMode
       @callables.each(&block)
     end
 
-    def pad_each(*ctx, **input_opts)
+    def pad_each(*ctx, **input_opts, &block)
       fields = self.map do |callables|
         field = callables.config[:header]
         if field.respond_to?(:call)
@@ -83,11 +83,14 @@ module OutputMode
         [callable, { padding: ' ' * length, field: field }]
       end
 
-      if block_given?
-        pads.each { |c, opts|  yield(c, **opts) }
-      else
-        pads.each
+      # Generate an enum
+      # NOTE: This fixes the double splate deprecation warning
+      enum = Enumerator.new do |yielder|
+        pads.each do |callable, opts|
+          yielder.yield(callable, **opts)
+        end
       end
+      enum.each(&block)
     end
 
     def config_select(key, *values)
@@ -138,6 +141,8 @@ module OutputMode
 
     # Handles the dynamic +<query>?+ and +<explicit-negation>!+ methods
     #
+    # DEPRECATED: The explicit! negation operator should not be used
+    #
     # @return [Boolean] The result of the query or explicit-negation
     # @raise [NoMethodError] All other method calls
     def method_missing(s, *args, &b)
@@ -197,6 +202,7 @@ module OutputMode
       callable.call(*a)
     end
 
+    # DEPRECATED: Use a Formatter class
     def generator(output)
       ->(*a) do
         # Implicitly determine which parts of the context can be passed through

data/lib/output_mode/formatter.rb

@@ -0,0 +1,146 @@
+#==============================================================================
+# 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 'tty-color'
+
+module OutputMode
+  class Formatter
+    def self.constructor(&block)
+      @constructor ||= block
+    end
+
+    def self.build(*objects, **opts)
+      new(*objects, **opts).tap do |policy|
+        next unless constructor
+        policy.instance_exec(&constructor)
+      end
+    end
+
+    def self.render(*objects, **opts)
+      build(*objects, **opts).render
+    end
+
+    def initialize(*objects, verbose: nil, ascii: nil, interactive: nil, color: nil)
+      @verbose = verbose
+      @ascii = ascii
+      @interactive = interactive
+      @color = color
+
+      # NOTE: This is intentionally not exposed on the base class
+      #       It is up to the individual implementations to expose it
+      @objects = objects
+    end
+
+    def callables
+      @callables ||= Callables.new
+    end
+
+    def register(**config, &block)
+      callables << Callable.new(**config) do |*args, **opts|
+        value = block.call(*args, **opts)
+        format(value, **config)
+      end
+    end
+
+    def format(value, **config)
+      case value
+      when TrueClass
+        config[:yes] || yes
+      when FalseClass
+        config[:no] || no
+      when NilClass
+        config[:default] || default
+      when Time
+        format = config[:time] || time
+        value.strftime(format)
+      else
+        value
+      end
+    end
+
+    def build_output
+      raise NotImplementedError
+    end
+
+    def render
+      build_output.render(*@objects)
+    end
+
+    def interactive?
+      if @interactive.nil?
+        $stdout.tty?
+      else
+        @interactive
+      end
+    end
+
+    def color?
+      if @color.nil? && (ascii? || !interactive?)
+        false
+      elsif @color.nil?
+        TTY::Color.color?
+      else
+        @color
+      end
+    end
+
+    def ascii?
+      if @ascii.nil?
+        !interactive?
+      else
+        @ascii
+      end
+    end
+
+    def verbose?
+      if @verbose.nil?
+        !interactive?
+      else
+        @verbose
+      end
+    end
+
+    def yes(value = nil)
+      @yes = value unless value.nil?
+      @yes ? @yes : (ascii? ? 'yes' : '✓')
+    end
+
+    def no(value = nil)
+      @no = value unless value.nil?
+      @no ? @no : (ascii? ? 'no' : '✕')
+    end
+
+    def default(value = nil)
+      @default = value unless value.nil?
+      @default ? @default : (interactive? ? '(none)' : '')
+    end
+
+    def time(value = nil)
+      @time = value unless value.nil?
+      @time ? @time : (verbose? ? "%Y-%m-%dT%H:%M:%S%:z" : "%d/%m/%y %H:%M")
+    end
+  end
+end

data/lib/output_mode/formatters/index.rb

@@ -0,0 +1,59 @@
+#==============================================================================
+# 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.
+#==============================================================================
+
+module OutputMode
+  module Formatters
+    class Index < Formatter
+      attr_reader :objects
+
+      def header_color(value = nil)
+        @header_color = value unless value.nil?
+        @header_color ? @header_color : :bold
+      end
+
+      def row_color(value = nil)
+        @row_color = value unless value.nil?
+        @row_color ? @row_color : :cyan
+      end
+
+      def build_output
+        if interactive?
+          opts = {
+            renderer: ascii? ? :ascii : :unicode,
+            header_color: header_color,
+            row_color: row_color,
+            colorize: color?,
+            rotate: false,
+            padding: [0, 1]
+          }
+          Outputs::Tabulated.new(*callables, **opts)
+        else
+          Outputs::Delimited.new(*callables, col_sep: "\t")
+        end
+      end
+    end
+  end
+end

data/lib/output_mode/formatters/show.rb

@@ -0,0 +1,98 @@
+#==============================================================================
+# 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 'output_mode/default_erb'
+require 'output_mode/non_interactive_erb'
+
+module OutputMode
+  module Formatters
+    class Show < Formatter
+      include Enumerable
+
+      # Limit the policy to a single object
+      def initialize(object, **opts)
+        super
+      end
+
+      def object
+        @objects.first
+      end
+
+      def template(value = nil)
+        @template = value unless value.nil?
+        @template ? @template : (interactive? ? DEFAULT_ERB : NON_INTERACTIVE_ERB)
+      end
+
+      def scope(value = nil)
+        @scope = value unless value.nil?
+        @scope ? @scope : self
+      end
+
+      def build_output
+        opts = {
+          template: template,
+          colorize: color?,
+          bind: scope.instance_exec { binding }
+        }
+        OutputMode::Outputs::Templated.new(*callables, **opts)
+      end
+
+      # @yieldparam value An attribute to be rendered
+      # @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, &block)
+        # Select the callable objects
+        selected = if section == nil
+                     callables
+                   elsif section == :default
+                     callables.config_select(:section, :default, nil)
+                   else
+                     callables.config_select(:section, section)
+                   end
+
+        # Yield each selected attribute
+        objs = selected.pad_each(object).map do |callable, opts|
+          field = opts[:field]
+          padding = opts[:padding]
+          value = callable.call(object)
+          [value, { field: field, padding: padding }]
+        end
+
+        # Runs the provided block
+        objs.each do |model, opts|
+          block.call(model, **opts)
+        end
+      end
+
+      # Library for colorizing the output. It is automatically disabled when the
+      # +colorize+ flag is +false+
+      def pastel
+        @pastel ||= Pastel.new(enabled: color?)
+      end
+    end
+  end
+end

data/lib/output_mode/formatters.rb

@@ -0,0 +1,36 @@
+#==============================================================================
+# 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.
+#==============================================================================
+
+module OutputMode
+  autoload 'Formatter', File.expand_path('formatter.rb', __dir__)
+
+  module Formatters
+    Dir.glob(File.expand_path('formatters/*.rb', __dir__)).each do |path|
+      autoload File.basename(path).chomp('.rb').capitalize, path
+    end
+  end
+end
+

data/lib/output_mode/outputs/templated.rb

@@ -55,7 +55,9 @@ module OutputMode
           end
 
           # Runs the provided block
-          objs.each(&block)
+          objs.each do |model, opts|
+            block.call(model, **opts)
+          end
         end
 
         # Renders an ERB object within the entry's context. This provides access to the
@@ -86,7 +88,8 @@ module OutputMode
       # @!attribute [r] fields
       # @!attribute [r] colorize
       # @!attribute [r] sections
-      attr_reader :erb, :fields, :separator, :colorize, :sections
+      # @!attribute [r] bind
+      attr_reader :erb, :fields, :separator, :colorize, :sections, :bind
 
       # Create a new +output+ which will render using +ERB+. The provided +template+ should
       # only render the +output+ for a single +entry+ (aka model, record, data object, etc).
@@ -104,10 +107,11 @@ module OutputMode
       #   @param [Array] *procs see {OutputMode::Output#initialize}
       #   @param [ERB] template: The +template+ object used by the renderer
       #   @param [Array] fields: An optional array of field headers that map to the procs, repeating the last value if required
-      #   @param fields: A static value to use as all field headers
+      #   @param fields: DEPRECATED A static value to use as all field headers
       #   @param separator: The character(s) used to join the "entries" together
       #   @param colorize: Flags if the caller wants the colorized version, this maybe ignored by +template+
-      #   @param sections: An optional array that groups the procs into sections. This is ignored by default
+      #   @param sections: DEPRECATED An optional array that groups the procs into sections
+      #   @param bind: An optional execution context to render the template within
       #   @param [Hash] **config see {OutputMode::Output#initialize}
       def initialize(*procs,
                      template: nil,
@@ -115,6 +119,7 @@ module OutputMode
                      separator: "\n",
                      colorize: false,
                      sections: nil,
+                     bind: nil,
                      **config)
         @erb = case template
         when String
@@ -128,6 +133,7 @@ module OutputMode
         @separator = separator
         @colorize = colorize
         @sections = sections
+        @bind = bind
         super(*procs, **config)
       end
 
@@ -137,11 +143,17 @@ module OutputMode
       #
       # @see OutputMode::Output#render
       def render(*data)
-        data.map { |d| Entry.new(self, d, colorize).render(erb) }
-            .join(separator)
+        data.map do |datum|
+          if bind
+            erb.result(bind)
+          else
+            Entry.new(self, datum, colorize).render(erb)
+          end
+        end.join(separator)
       end
 
       # Returns the length of the maximum field
+      # DEPRECATED
       def max_field_length
         if fields.is_a? Array
           fields.map { |f| f.to_s.length }.max

data/lib/output_mode/version.rb

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

data/lib/output_mode.rb

@@ -29,6 +29,7 @@ require 'output_mode/errors'
 
 require 'output_mode/outputs'
 require 'output_mode/callable'
+require 'output_mode/formatters'
 require 'output_mode/builder_dsl'
 require 'output_mode/tldr'
 

data/output_mode.gemspec

@@ -57,4 +57,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rake", ">= 12.3.3"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "pry", "> 0.11"
+  spec.add_development_dependency "pry-byebug", "~> 3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: output_mode
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.7.0
 platform: ruby
 authors:
 - William McCumsite
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-05-24 00:00:00.000000000 Z
+date: 2021-10-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tty-table
@@ -108,6 +108,20 @@ dependencies:
     - - ">"
       - !ruby/object:Gem::Version
         version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 description: 
 email:
 - openlicense.williams@gmail.com
@@ -123,6 +137,7 @@ files:
 - README.md
 - Rakefile
 - bin/bundle
+- bin/byebug
 - bin/coderay
 - bin/console
 - bin/demo
@@ -137,6 +152,10 @@ files:
 - lib/output_mode/callable.rb
 - lib/output_mode/default_erb.rb
 - lib/output_mode/errors.rb
+- lib/output_mode/formatter.rb
+- lib/output_mode/formatters.rb
+- lib/output_mode/formatters/index.rb
+- lib/output_mode/formatters/show.rb
 - lib/output_mode/non_interactive_erb.rb
 - lib/output_mode/output.rb
 - lib/output_mode/outputs.rb