brakeman 5.2.2 → 7.1.1

data/bundle/ruby/3.1.0/gems/terminal-table-4.0.0/README.md

@@ -0,0 +1,417 @@
+[![CI status](https://github.com/tj/terminal-table/workflows/CI/badge.svg)](https://github.com/tj/terminal-table/actions)
+[![Gem Version](https://badge.fury.io/rb/terminal-table.svg)](https://badge.fury.io/rb/terminal-table)
+
+# Terminal Table
+
+## Description
+
+Terminal Table is a fast and simple, yet feature rich table generator
+written in Ruby.  It supports ASCII and Unicode formatted tables.
+
+## Installation
+
+```
+$ gem install terminal-table
+```
+## Usage
+
+### Basics
+
+To use Terminal Table:
+
+```ruby
+require 'terminal-table'
+```
+To generate a table, provide an array of arrays (which are interpreted as
+rows):
+
+```ruby
+rows = []
+rows << ['One', 1]
+rows << ['Two', 2]
+rows << ['Three', 3]
+table = Terminal::Table.new :rows => rows
+
+# > puts table
+#
+# +-------+---+
+# | One   | 1 |
+# | Two   | 2 |
+# | Three | 3 |
+# +-------+---+
+```
+The constructor can also be given a block which is either yielded the Table
+object or instance evaluated:
+
+```ruby
+table = Terminal::Table.new do |t|
+  t.rows = rows
+end
+
+table = Terminal::Table.new do
+  self.rows = rows
+end
+```
+Adding rows one by one:
+
+```ruby
+table = Terminal::Table.new do |t|
+  t << ['One', 1]
+  t.add_row ['Two', 2]
+end
+```
+To add separators between rows:
+
+```ruby
+table = Terminal::Table.new do |t|
+  t << ['One', 1]          # Using << (push) as an alias for add_row
+  t << :separator          # Using << with :separator as an alias for add_separator
+  t.add_row ['Two', 2]
+  t.add_separator          # Note - this version allows setting the separator's border_type
+  t.add_row ['Three', 3]
+end
+
+# > puts table
+#
+# +-------+---+
+# | One   | 1 |
+# +-------+---+
+# | Two   | 2 |
+# +-------+---+
+# | Three | 3 |
+# +-------+---+
+```
+Cells can handle multiline content:
+
+```ruby
+table = Terminal::Table.new do |t|
+  t << ['One', 1]
+  t << :separator
+  t.add_row ["Two\nDouble", 2]
+  t.add_separator
+  t.add_row ['Three', 3]
+end
+
+# > puts table
+#
+# +--------+---+
+# | One    | 1 |
+# +--------+---+
+# | Two    | 2 |
+# | Double |   |
+# +--------+---+
+# | Three  | 3 |
+# +--------+---+
+```
+### Head
+
+To add a head to the table:
+
+```ruby
+table = Terminal::Table.new :headings => ['Word', 'Number'], :rows => rows
+
+# > puts table
+#
+# +-------+--------+
+# | Word  | Number |
+# +-------+--------+
+# | One   | 1      |
+# | Two   | 2      |
+# | Three | 3      |
+# +-------+--------+
+```
+### Title
+
+To add a title to the table:
+
+```ruby
+table = Terminal::Table.new :title => "Cheatsheet", :headings => ['Word', 'Number'], :rows => rows
+
+# > puts table
+#
+# +---------------------+
+# |     Cheatsheet      |
+# +------------+--------+
+# | Word       | Number |
+# +------------+--------+
+# | One        | 1      |
+# | Two        | 2      |
+# | Three      | 3      |
+# +------------+--------+
+```
+### Alignment
+
+To align the second column to the right:
+
+```ruby
+table.align_column(1, :right)
+
+# > puts table
+#
+# +-------+--------+
+# | Word  | Number |
+# +-------+--------+
+# | One   |      1 |
+# | Two   |      2 |
+# | Three |      3 |
+# +-------+--------+
+```
+To align an individual cell, you specify the cell value in a hash along the
+alignment:
+
+```ruby
+table << ["Four", {:value => 4.0, :alignment => :center}]
+
+# > puts table
+#
+# +-------+--------+
+# | Word  | Number |
+# +-------+--------+
+# | One   |      1 |
+# | Two   |      2 |
+# | Three |      3 |
+# | Four  |  4.0   |
+# +-------+--------+
+```
+### Style
+
+To specify style options:
+
+```ruby
+table = Terminal::Table.new :headings => ['Word', 'Number'], :rows => rows, :style => {:width => 80}
+
+# > puts table
+#
+# +--------------------------------------+---------------------------------------+
+# | Word                                 | Number                                |
+# +--------------------------------------+---------------------------------------+
+# | One                                  | 1                                     |
+# | Two                                  | 2                                     |
+# | Three                                | 3                                     |
+# +--------------------------------------+---------------------------------------+
+```
+And change styles on the fly:
+
+```ruby
+table.style = {:width => 40, :padding_left => 3, :border_x => "=", :border_i => "x"}
+
+# > puts table
+#
+# x======================================x
+# |               Cheatsheet             |
+# x====================x=================x
+# |   Word             |   Number        |
+# x====================x=================x
+# |   One              |   1             |
+# |   Two              |   2             |
+# |   Three            |   3             |
+# x====================x=================x
+```
+You can also use styles to add a separator after every row:
+
+```ruby
+table = Terminal::Table.new do |t|
+  t.add_row [1, 'One']
+  t.add_row [2, 'Two']
+  t.add_row [3, 'Three']
+  t.style = {:all_separators => true}
+end
+
+# > puts table
+#
+# +---+-------+
+# | 1 | One   |
+# +---+-------+
+# | 2 | Two   |
+# +---+-------+
+# | 3 | Three |
+# +---+-------+
+```
+You can also use styles to disable top and bottom borders of the table.
+
+```ruby
+table = Terminal::Table.new do |t|
+  t.headings = ['id', 'name']
+  t.rows = [[1, 'One'], [2, 'Two'], [3, 'Three']]
+  t.style = { :border_top => false, :border_bottom => false }
+end
+
+# > puts table
+# | id | name  |
+# +----+-------+
+# | 1  | One   |
+# | 2  | Two   |
+# | 3  | Three |
+```
+
+And also to disable left and right borders of the table.
+
+```ruby
+table = Terminal::Table.new do |t|
+  t.headings = ['id', 'name']
+  t.rows = [[1, 'One'], [2, 'Two'], [3, 'Three']]
+  t.style = { :border_left => false, :border_right => false }
+end
+
+# > puts table
+# ----+-------
+#  id | name
+# ----+-------
+#  1  | One
+#  2  | Two
+#  3  | Three
+# ----+-------
+```
+
+To change the default style options:
+
+```ruby
+Terminal::Table::Style.defaults = {:width => 80}
+```
+All Table objects created afterwards will inherit these defaults.
+
+### Constructor options and setter methods
+
+Valid options for the constructor are `:rows`, `:headings`, `:style` and `:title` -
+and all options can also be set on the created table object by their setter
+method:
+
+```ruby
+table = Terminal::Table.new
+table.title = "Cheatsheet"
+table.headings = ['Word', 'Number']
+table.rows = rows
+table.style = {:width => 40}
+```
+
+## New Formatting
+
+### Unicode Table Borders
+Support for Unicode 'box art' borders presented a challenge, as the original terminal-table only handled three border types:  horizontal (x), vertical (y), and intersection (i).  For proper box-art, it became necessary to enable different types of corners/edges for multiple intersection types.
+
+For the sake of backward compatiblity, the previous interface is still supported, as this gem has been around a long time and making breaking changes would have been inconvenient.  The new interface is required for any complex and/or Unicode style bordering. A few variations on border style are supported via some new classes and creation of additional classes (or modification of characters used in existing ones) will allow for customized border types.
+
+The simplest way to use an alternate border is one of the following:
+```
+table.style = { :border => :unicode }
+table.style = { :border => :unicode_round }
+table.style = { :border => :unicode_thick_edge }
+```
+
+These are a convenience wrapper around setting border using an instance of a class that inherits from Table::Terminal::Border
+```
+table.style = { :border => Terminal::Table::UnicodeBorder.new() }
+table.style = { :border => Terminal::Table::UnicodeRoundBorder.new() }
+table.style = { :border => Terminal::Table::UnicodeThickEdgeBorder.new() }
+```
+
+If you define a custom class and wish to use the symbol shortcut, you must namespace within `Terminal::Table` and end your class name with `Border`.
+
+### Markdown Compatiblity
+Per popular request, Markdown formatted tables can be generated by using the following border style:
+
+```
+table.style = { :border => :markdown }
+```
+
+### Ascii Borders
+Ascii borders are default, but can be explicitly set with:
+```
+table.style = { :border => :ascii }
+```
+
+### Customizing Borders
+Inside the `UnicodeBorder` class, there are definitions for a variety of corner/intersection and divider types.
+
+```ruby
+@data = {
+  nil => nil,
+  nw: "┌", nx: "─", n:  "┬", ne: "┐",
+  yw: "│",          y:  "│", ye: "│", 
+  aw: "╞", ax: "═", ai: "╪", ae: "╡", ad: '╤', au: "╧", # double
+  bw: "┝", bx: "━", bi: "┿", be: "┥", bd: '┯', bu: "┷", # heavy/bold/thick
+  w:  "├", x:  "─", i:  "┼", e:  "┤", dn: "┬", up: "┴", # normal div
+  sw: "└", sx: "─", s:  "┴", se: "┘",
+  # alternative dots/dashes
+  x_dot4:  '┈', x_dot3:  '┄', x_dash:  '╌',
+  bx_dot4: '┉', bx_dot3: '┅', bx_dash: '╍',
+}
+```
+
+Note that many are defined as directional (:nw == north-west), others defined in terms of 'x' or 'y'.
+The border that separates headings (below each heading) is of type `:double` and is defined with `a*` entries.
+Alternate `:heavy` types that can be applied to separators can be defined with `b*` entries.
+
+When defining a new set of borders, it's probably easiest to define a new class that inherits from UnicodeBorder and replaces the `@data` Hash.
+However, these elements can be these can be overridden by poking setting the Hash, should the need arise:
+
+```
+table.style = {border: :unicode}
+table.style.border[:nw] = '*'  # Override the north-west corner of the table
+```
+
+### Customizing row separators
+
+Row-separators can now be customized in a variety of ways.  The default separator's border_type is referred to as `:div`.  Additional separator border types (e.g. `:double`, `:heavy`, `:dash` - see full list below) can be applied to separate the sections (e.g. header/footer/title).
+
+The separator's `border_type`  may be specified when a user-defined separator is added.  Alternatively, borders may be adjusted after the table's rows are elaborated, but before the table is rendered.
+
+Separator `border_type`s can be adjusted to be heavy, use double-lines, and different dash/dot styles.  The border type should be one of:
+
+    div dash dot3 dot4 
+    thick thick_dash thick_dot3 thick_dot4
+    heavy heavy_dash heavy_dot3 heavy_dot4
+    bold bold_dash bold_dot3 bold_dot4
+    double
+
+To manually set the separator border_type, the `add_separator` method may be called.
+```ruby
+add_separator(border_type: :heavy_dash)
+```
+
+Alternatively, if `style: :all_separators` is used at the table level, it may be necessary to elaborate the implicit Separator rows prior to rendering.
+```ruby
+table = Terminal::Table.new do |t|
+  t.add_row [1, 'One']
+  t.add_row [2, 'Two']
+  t.add_row [3, 'Three']
+  t.style = {:all_separators => true}
+end
+rows = table.elaborate_rows
+rows[2].border_type = :heavy # modify separator row: emphasize below title
+puts table.render
+```
+
+## Example: Displaying a small CSV spreadsheet
+
+This example code demonstrates using Terminal-table and CSV to display a small spreadsheet.
+
+```ruby
+#!/usr/bin/env ruby
+require "csv"
+require "terminal-table"
+use_stdin = ARGV[0].nil? || (ARGV[0] == '-')
+io_object = use_stdin ? $stdin : File.open(ARGV[0], 'r')
+csv = CSV.new(io_object)
+csv_array = csv.to_a
+user_table = Terminal::Table.new do |v|
+  v.style = { :border => :unicode_round } # >= v3.0.0
+  v.title = "Some Title"
+  v.headings = csv_array[0]
+  v.rows = csv_array[1..-1]
+end
+puts user_table
+```
+
+See also `examples/show_csv_table.rb` in the source distribution.
+
+## More examples
+
+For more examples, please see the `examples` directory included in the
+source distribution.
+
+## Author
+
+TJ Holowaychuk <tj@vision-media.ca>
+
+Unicode table support by Ben Bowers https://github.com/nanobowers

data/bundle/ruby/3.1.0/gems/terminal-table-4.0.0/lib/terminal-table/cell.rb

@@ -0,0 +1,94 @@
+require 'unicode/display_width'
+
+module Terminal
+  class Table
+    class Cell
+      ##
+      # Cell value.
+
+      attr_reader :value
+
+      ##
+      # Column span.
+
+      attr_reader :colspan
+
+      ##
+      # Initialize with _options_.
+
+      def initialize options = nil
+        @value, options = options, {} unless Hash === options
+        @value = options.fetch :value, value
+        @alignment = options.fetch :alignment, nil
+        @colspan = options.fetch :colspan, 1
+        @width = options.fetch :width, @value.to_s.size
+        @index = options.fetch :index
+        @table = options.fetch :table
+      end
+
+      def alignment?
+        !@alignment.nil?
+      end
+
+      def alignment
+        @alignment || @table.style.alignment || :left
+      end
+
+      def alignment=(val)
+        supported = %w(left center right)
+        if supported.include?(val.to_s)
+          @alignment = val
+        else
+          raise "Aligment must be one of: #{supported.join(' ')}"
+        end
+      end
+
+      def align(val, position, length)
+        positions = { :left => :ljust, :right => :rjust, :center => :center }
+        val.public_send(positions[position], length)
+      end
+      def lines
+        @value.to_s.encode("utf-8", invalid: :replace).split(/\n/)
+      end
+
+      ##
+      # Render the cell.
+
+      def render(line = 0)
+        left = " " * @table.style.padding_left
+        right = " " * @table.style.padding_right
+        display_width = Unicode::DisplayWidth.of(Util::ansi_escape(lines[line]))
+        render_width = lines[line].to_s.size - display_width + width
+        align("#{left}#{lines[line]}#{right}", alignment, render_width + @table.cell_padding)
+      end
+      alias :to_s :render
+
+      ##
+      # Returns the longest line in the cell and
+      # removes all ANSI escape sequences (e.g. color)
+
+      def value_for_column_width_recalc
+        lines.map{ |s| Util::ansi_escape(s) }.max_by{ |s| Unicode::DisplayWidth.of(s) }
+      end
+
+      ##
+      # Returns the width of this cell
+
+      def width
+        padding = (colspan - 1) * @table.cell_spacing
+        inner_width = (1..@colspan).to_a.inject(0) do |w, counter|
+          w + @table.column_width(@index + counter - 1)
+        end
+        inner_width + padding
+      end
+
+      def inspect
+        fields = %i[alignment colspan index value width].map do |name|
+          val = self.instance_variable_get('@'+name.to_s)
+          "@#{name}=#{val.inspect}"
+        end.join(', ')
+        return "#<#{self.class} #{fields}>"
+      end
+    end
+  end
+end

data/bundle/ruby/3.1.0/gems/terminal-table-4.0.0/lib/terminal-table/row.rb

@@ -0,0 +1,66 @@
+module Terminal
+  class Table
+    class Row
+
+      ##
+      # Row cells
+
+      attr_reader :cells
+
+      attr_reader :table
+
+      ##
+      # Initialize with _width_ and _options_.
+
+      def initialize table, array = [], **_kwargs
+        @cell_index = 0
+        @table = table
+        @cells = []
+        array.each { |item| self << item }
+      end
+
+      def add_cell item
+        options = item.is_a?(Hash) ? item : {:value => item}
+        cell = Cell.new(options.merge(:index => @cell_index, :table => @table))
+        @cell_index += cell.colspan
+        @cells << cell
+      end
+      alias << add_cell
+
+      def [] index
+        cells[index]
+      end
+
+      def height
+        cells.map { |c| c.lines.count }.max || 0
+      end
+
+      def render
+        vleft, vcenter, vright = @table.style.vertical
+        (0...height).to_a.map do |line|
+          vleft + cells.map do |cell|
+            cell.render(line)
+          end.join(vcenter) + vright
+        end.join("\n")
+      end
+
+      def number_of_columns
+        @cells.collect(&:colspan).inject(0, &:+)
+      end
+
+      # used to find indices where we have table '+' crossings.
+      # in cases where the colspan > 1, then we will skip over some numbers
+      # if colspan is always 1, then the list should be incrementing by 1.
+      #
+      # skip 0 entry, because it's the left side.
+      # skip last entry, because it's the right side.
+      # we only care about "+/T" style crossings.
+      def crossings
+        idx = 0
+        @cells[0...-1].map { |c| idx += c.colspan } 
+      end
+      
+    end
+
+  end
+end

data/bundle/ruby/3.1.0/gems/terminal-table-4.0.0/lib/terminal-table/separator.rb

@@ -0,0 +1,66 @@
+module Terminal
+  class Table
+    class Separator < Row
+
+      ##
+      # `prevrow`, `nextrow` contain references to adjacent rows.
+      #
+      # `border_type` is a symbol used to control which type of border is used
+      # on the separator (:top for top-edge, :bot for bottom-edge,
+      # :div for interior, and :strong for emphasized-interior)
+      #
+      # `implicit` is false for user-added separators, and true for
+      # implicit/auto-generated separators.
+      
+      def initialize(*args, border_type: :div, implicit: false)
+        super
+        @prevrow, @nextrow = nil, nil
+        @border_type = border_type
+        @implicit = implicit
+      end
+
+      attr_accessor :border_type
+      attr_reader :implicit
+      
+      def render
+        left_edge, ctrflat, ctrud, right_edge, ctrdn, ctrup = @table.style.horizontal(border_type)
+        
+        prev_crossings = @prevrow.respond_to?(:crossings) ? @prevrow.crossings : []
+        next_crossings = @nextrow.respond_to?(:crossings) ? @nextrow.crossings : []
+        rval = [left_edge]
+        numcols = @table.number_of_columns
+        (0...numcols).each do |idx|
+          rval << ctrflat * (@table.column_width(idx) + @table.cell_padding)
+          pcinc = prev_crossings.include?(idx+1)
+          ncinc = next_crossings.include?(idx+1)
+          border_center = if pcinc && ncinc
+                            ctrud
+                          elsif pcinc
+                            ctrup
+                          elsif ncinc
+                            ctrdn
+                          elsif !ctrud.empty?
+                            # special case if the center-up-down intersection is empty
+                            # which happens when verticals/intersections are removed. in that case
+                            # we do not want to replace with a flat element so return empty-string in else block
+                            ctrflat
+                          else
+                            ''
+                          end
+          rval << border_center if idx < numcols-1
+        end
+          
+        rval << right_edge
+        rval.join
+      end
+
+      # Save off neighboring rows, so that we can use them later in determining
+      # which types of table edges to use.
+      def save_adjacent_rows(prevrow, nextrow)
+        @prevrow = prevrow
+        @nextrow = nextrow
+      end
+      
+    end
+  end
+end