tabulo 2.1.1 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1417a8a8aa4d8bbeea0b0c983e49fee669e0717cc01e2aa2b04c0e80d1d38a8c
-  data.tar.gz: 3f45955cce5a731536f7b9e11fcc11bc637f29ba7952d33c4361a13dc4efb7ca
+  metadata.gz: 295d0e4161611edd684ef1f65143767b418af24f0e630e83bb6554cf25636e44
+  data.tar.gz: e4a0e0fcc8a2efdedb251d413f65f2627b7706136af55026728d6c906f0bc311
 SHA512:
-  metadata.gz: 499bcbd5686f20554c1e08d6945883f9cdbd930933f422e550c6254a0b8f7ace45949deb95c7963fcf48b044ae7931d4c298d3449a61b0bc03ca798ca12ea2aa
-  data.tar.gz: 81d5531791eff6a85f8e0f9a41887cd193526ccd31472763660da66cdd312639a48529cac1b33239e096c6976975c8b33d45ed1cb9c609b80de748f3c62cba12
+  metadata.gz: 8cc23cce74adbe70451dc387007baa32339ac8d0942d55594e8516ac871880c4ef8176a69db5da7dad2dcfa122d83ae838cb9129e3df8212f3a1ae4ab337c92a
+  data.tar.gz: dfa4e051e1f45a41e3611b8c22422ee9f043671d4d7f432318fab6465c6b888c5a3e67302a3950e241d73dc17e99d3b26e2d2738b3eacc162f5a4e07b628acaa

data/CHANGELOG.md

@@ -1,9 +1,17 @@
 # Changelog
 
+### v2.2.0
+
+* New `column_formatter` option on `Tabulo::Table` initializer, enabling the table's default column
+  formatter to be customized.
+* New `row_divider_frequency` option on `Tabulo::Table` initializer, to add a horizontal dividing line
+  after every N rows.
+
 ### v2.1.1
 
 * Fix issue where blank lines appear in table when certain border types (e.g. `:classic`) are
-  used with a non-nil `:border_styler`.
+  used with a non-nil `border_styler`.
+* Minor documentation fix
 
 ### v2.1.0
 

data/README.md

@@ -72,6 +72,7 @@ Tabulo has also been ported to Crystal (with some modifications): see [Tablo](ht
      * [Accessing the underlying enumerable](#accessing-sources)
      * [Transposing rows and columns](#transposition)
      * [Border configuration](#borders)
+     * [Row dividers](#dividers)
   * [Comparison with other libraries](#motivation)
   * [Contributing](#contributing)
   * [License](#license)
@@ -425,6 +426,31 @@ Note the numbers in the "Reciprocal" column in this example are still right-alig
 the callable passed to `formatter` returns a String. Default cell alignment is determined by the type
 of the underlying cell value, not the way it is formatted. This is usually the desired result.
 
+If you want to set the default formatter for all columns of the table to something other than
+`#to_s`, use the `formatter` option when initializing the table:
+
+```ruby
+table = Tabulo::Table.new(1..3, formatter: -> (n) { "%.2f" % n }) do |t|
+  t.add_column("N", &:itself)
+  t.add_column("Reciprocal") { |n| 1.0 / n }
+  t.add_column("Half") { |n| n / 2.0 }
+end
+```
+
+```
+> puts table
++--------------+--------------+--------------+
+|       N      |  Reciprocal  |     Half     |
++--------------+--------------+--------------+
+|         1.00 |         1.00 |         0.50 |
+|         2.00 |         0.50 |         1.00 |
+|         3.00 |         0.33 |         1.50 |
++--------------+--------------+--------------+
+```
+
+Formatters set for individual columns on calling `#add_column` always override the default formatter for
+the table.
+
 <a name="colours-and-styling"></a>
 ### Colours and styling
 
@@ -651,7 +677,7 @@ a new table in which the rows and columns are swapped:
 By default, a header row is added to the new table, showing the string value of the element
 represented in that column. This can be configured, however, along with other aspects of
 `transpose`'s behaviour. For details, see the
-[documentation](https://www.rubydoc.info/gems/tabulo/2.1.1/Tabulo/Table#transpose-instance_method).
+[documentation](https://www.rubydoc.info/gems/tabulo/2.2.0/Tabulo/Table#transpose-instance_method).
 
 <a name="borders"></a>
 ### Configuring borders
@@ -745,6 +771,48 @@ but without a bottom border:
 |            3 |     false    |     true     |
 ```
 
+Note that, by default, none of the border options includes lines drawn _between_ rows in the body of the table.
+These are configured via a separate option: see [below](#dividers).
+
+<a name="dividers"></a>
+### Row dividers
+
+To add lines between rows in the table body, use the `row_divider_frequency` option when initializing
+the table. The default value for this option is `nil`, meaning there are no dividing lines between
+rows. But if this option passed is a positive integer N, then a dividing line is inserted before
+every Nth row. For example:
+
+```
+> puts Tabulo::Table.new(1..6, :itself, :even?, :odd?, row_divider_frequency: 2)
++--------------+--------------+--------------+
+|    itself    |     even?    |     odd?     |
++--------------+--------------+--------------+
+|            1 |     false    |     true     |
+|            2 |     true     |     false    |
++--------------+--------------+--------------+
+|            3 |     false    |     true     |
+|            4 |     true     |     false    |
++--------------+--------------+--------------+
+|            5 |     false    |     true     |
+|            6 |     true     |     false    |
++--------------+--------------+--------------+
+```
+
+If you want a line before every row, pass `1` to `row_divider_frequency`. For example:
+
+```
+> puts Tabulo::Table.new(1..3, :itself, :even?, :odd?, border: :modern, row_divider_frequency: 1)
+┌──────────────┬──────────────┬──────────────┐
+│    itself    │     even?    │     odd?     │
+├──────────────┼──────────────┼──────────────┤
+│            1 │     false    │     true     │
+├──────────────┼──────────────┼──────────────┤
+│            2 │     true     │     false    │
+├──────────────┼──────────────┼──────────────┤
+│            3 │     false    │     true     │
+└──────────────┴──────────────┴──────────────┘
+```
+
 <a name="motivation"></a>
 ## Comparison with other libraries
 
@@ -847,14 +915,14 @@ The gem is available as open source under the terms of the [MIT
 License](http://opensource.org/licenses/MIT).
 
 [Gem Version]: https://rubygems.org/gems/tabulo
-[Documentation]: http://www.rubydoc.info/gems/tabulo/2.1.1
+[Documentation]: http://www.rubydoc.info/gems/tabulo/2.2.0
 [Build Status]: https://travis-ci.org/matt-harvey/tabulo
 [Coverage Status]: https://coveralls.io/r/matt-harvey/tabulo
 [Code Climate]: https://codeclimate.com/github/matt-harvey/tabulo
 [Awesome Ruby]: https://github.com/markets/awesome-ruby#cli-utilities
 
 [GV img]: https://img.shields.io/gem/v/tabulo.svg
-[DC img]: https://img.shields.io/badge/documentation-v2.1.1-blue.svg
+[DC img]: https://img.shields.io/badge/documentation-v2.2.0-blue.svg
 [BS img]: https://img.shields.io/travis/matt-harvey/tabulo.svg
 [CS img]: https://img.shields.io/coveralls/matt-harvey/tabulo.svg
 [CC img]: https://codeclimate.com/github/matt-harvey/tabulo/badges/gpa.svg

data/VERSION

@@ -1 +1 @@
-2.1.1
+2.2.0

data/lib/tabulo/row.rb

@@ -7,10 +7,11 @@ module Tabulo
     attr_reader :source
 
     # @!visibility private
-    def initialize(table, source, header: :top)
+    def initialize(table, source, header: :top, divider: false)
       @table = table
       @source = source
       @header = header
+      @divider = divider
     end
 
     # Calls the given block once for each {Cell} in the {Row}, passing that {Cell} as parameter.
@@ -28,11 +29,12 @@ module Tabulo
     end
 
     # @return a String being an "ASCII" graphical representation of the {Row}, including
-    #   any column headers that appear just above it in the {Table} (depending on where this Row is
-    #   in the {Table} and how the {Table} was configured with respect to header frequency).
+    #   any column headers or row divider that appear just above it in the {Table} (depending on where
+    #   this Row is in the {Table}, and how the {Table} was configured with respect to header frequency
+    #   and divider frequency).
     def to_s
       if @table.column_registry.any?
-        @table.formatted_body_row(@source, header: @header)
+        @table.formatted_body_row(@source, header: @header, divider: @divider)
       else
         ""
       end

data/lib/tabulo/table.rb

@@ -35,40 +35,14 @@ module Tabulo
     #   be unique. Each element of the Array  will be used to create a column whose content is
     #   created by calling the corresponding method on each element of sources. Note
     #   the {#add_column} method is a much more flexible way to set up columns on the table.
-    # @param [Integer, nil] column_width The default column width for columns in this
-    #   table, not excluding padding. If <tt>nil</tt>, then {DEFAULT_COLUMN_WIDTH} will be used.
-    # @param [:start, nil, Integer] header_frequency Controls the display of column headers.
-    #   If passed <tt>:start</tt>, headers will be shown at the top of the table only. If passed <tt>nil</tt>,
-    #   headers will not be shown. If passed an Integer N (> 0), headers will be shown at the top of the table,
-    #   then repeated every N rows.
-    # @param [nil, Integer] wrap_header_cells_to Controls wrapping behaviour for header
-    #   cells if the content thereof is longer than the column's fixed width. If passed <tt>nil</tt> (default),
-    #   content will be wrapped for as many rows as required to accommodate it. If passed an Integer N (> 0),
-    #   content will be wrapped up to N rows and then truncated thereafter.
-    # @param [nil, Integer] wrap_body_cells_to Controls wrapping behaviour for table cells (excluding
-    #   headers), if their content is longer than the column's fixed width. If passed <tt>nil</tt>, content will
-    #   be wrapped for as many rows as required to accommodate it. If passed an Integer N (> 0), content will be
-    #   wrapped up to N rows and then truncated thereafter.
-    #   headers), if their content is longer than the column's fixed width. If passed <tt>nil</tt>, content will
-    #   be wrapped for as many rows as required to accommodate it. If passed an Integer N (> 0), content will be
-    #   wrapped up to N rows and then truncated thereafter.
-    # @param [nil, String] truncation_indicator Determines the character used to indicate that a
-    #   cell's content has been truncated. If omitted or passed <tt>nil</tt>,
-    #   defaults to {DEFAULT_TRUNCATION_INDICATOR}. If passed something other than <tt>nil</tt> or
-    #   a single-character String, raises {InvalidTruncationIndicatorError}.
-    # @param [nil, Integer, Array] column_padding (1) Determines the amount of blank space with which to pad
-    #   either side of each column. If passed an Integer, then the given amount of padding is
-    #   applied to each side of each column. If passed a two-element Array, then the first element of the
-    #   Array indicates the amount of padding to apply to the left of each column, and the second
-    #   element indicates the amount to apply to the right.
-    # @param [:left, :right, :center] align_header (:center) Determines the alignment of header text
-    #   for columns in this Table. Can be overridden for individual columns using the
-    #   <tt>align_header</tt> option passed to {#add_column}
     # @param [:left, :right, :center, :auto] align_body (:auto) Determines the alignment of body cell
     #   (i.e. non-header) content within columns in this Table. Can be overridden for individual columns
     #   using the <tt>align_body</tt> option passed to {#add_column}. If passed <tt>:auto</tt>,
     #   alignment is determined by cell content, with numbers aligned right, booleans
     #   center-aligned, and other values left-aligned.
+    # @param [:left, :right, :center] align_header (:center) Determines the alignment of header text
+    #   for columns in this Table. Can be overridden for individual columns using the
+    #   <tt>align_header</tt> option passed to {#add_column}
     # @param [:ascii, :markdown, :modern, :blank, nil] border (nil) Determines the characters used
     #   for the Table border, including both the characters around the outside of table, and the lines drawn
     #   within the table to separate columns from each other and the header row from the Table body.
@@ -93,22 +67,67 @@ module Tabulo
     #   {border_styler} is not taken into consideration by the internal table rendering calculations
     #   Thus it can be used to apply ANSI escape codes to border characters, to colour the borders
     #   for example, without breaking the table formatting.
+    # @param [nil, Integer, Array] column_padding (1) Determines the amount of blank space with which to pad
+    #   either side of each column. If passed an Integer, then the given amount of padding is
+    #   applied to each side of each column. If passed a two-element Array, then the first element of the
+    #   Array indicates the amount of padding to apply to the left of each column, and the second
+    #   element indicates the amount to apply to the right.
+    # @param [Integer, nil] column_width The default column width for columns in this
+    #   table, not excluding padding. If <tt>nil</tt>, then {DEFAULT_COLUMN_WIDTH} will be used.
+    # @param [nil, #to_proc] formatter (:to_s.to_proc) The default value for the `formatter` option
+    #   when columns are added to this table via {#add_column}.
+    # @param [:start, nil, Integer] header_frequency (:start) Controls the display of column headers.
+    #   If passed <tt>:start</tt>, headers will be shown at the top of the table only. If passed <tt>nil</tt>,
+    #   headers will not be shown. If passed an Integer N (> 0), headers will be shown at the top of the table,
+    #   then repeated every N rows.
+    # @param [nil, Integer] row_divider_frequency (nil) Controls the display of horizontal row dividers within
+    #   the table body. If passed <tt>nil</tt>, dividers will not be shown. If passed an Integer N (> 0),
+    #   dividers will be shown after every N rows. The characters used to form the dividers are
+    #   determined by the `border` option, and are the same as those used to form the bottom edge of the
+    #   header row.
+    # @param [nil, String] truncation_indicator Determines the character used to indicate that a
+    #   cell's content has been truncated. If omitted or passed <tt>nil</tt>,
+    #   defaults to {DEFAULT_TRUNCATION_INDICATOR}. If passed something other than <tt>nil</tt> or
+    #   a single-character String, raises {InvalidTruncationIndicatorError}.
+    # @param [nil, Integer] wrap_body_cells_to Controls wrapping behaviour for table cells (excluding
+    #   headers), if their content is longer than the column's fixed width. If passed <tt>nil</tt>, content will
+    #   be wrapped for as many rows as required to accommodate it. If passed an Integer N (> 0), content will be
+    #   wrapped up to N rows and then truncated thereafter.
+    #   headers), if their content is longer than the column's fixed width. If passed <tt>nil</tt>, content will
+    #   be wrapped for as many rows as required to accommodate it. If passed an Integer N (> 0), content will be
+    #   wrapped up to N rows and then truncated thereafter.
+    # @param [nil, Integer] wrap_header_cells_to Controls wrapping behaviour for header
+    #   cells if the content thereof is longer than the column's fixed width. If passed <tt>nil</tt> (default),
+    #   content will be wrapped for as many rows as required to accommodate it. If passed an Integer N (> 0),
+    #   content will be wrapped up to N rows and then truncated thereafter.
     # @return [Table] a new {Table}
     # @raise [InvalidColumnLabelError] if non-unique Symbols are provided to columns.
     # @raise [InvalidBorderError] if invalid option passed to `border` parameter.
-    def initialize(sources, *columns, column_width: nil, column_padding: nil, header_frequency: :start,
-      wrap_header_cells_to: nil, wrap_body_cells_to: nil, truncation_indicator: nil, align_header: :center,
-      align_body: :auto, border: nil, border_styler: nil)
+    def initialize(
+      sources,
+      *columns,
+      align_body:            :auto,
+      align_header:          :center,
+      border:                nil,
+      border_styler:         nil,
+      column_padding:        nil,
+      column_width:          nil,
+      formatter:             :to_s.to_proc,
+      header_frequency:      :start,
+      row_divider_frequency: nil,
+      truncation_indicator:  nil,
+      wrap_body_cells_to:    nil,
+      wrap_header_cells_to:  nil)
 
       @sources = sources
-      @header_frequency = header_frequency
-      @wrap_header_cells_to = wrap_header_cells_to
-      @wrap_body_cells_to = wrap_body_cells_to
-      @column_width = (column_width || DEFAULT_COLUMN_WIDTH)
-      @align_header = align_header
-      @align_body = align_body
 
+      @align_body = align_body
+      @align_header = align_header
+      @border = (border || DEFAULT_BORDER)
+      @border_styler = border_styler
+      @border_instance = Border.from(@border, @border_styler)
       @column_padding = (column_padding || DEFAULT_COLUMN_PADDING)
+
       @left_column_padding, @right_column_padding =
         case @column_padding
         when Array
@@ -117,12 +136,14 @@ module Tabulo
           [@column_padding, @column_padding]
         end
 
-      @border = (border || DEFAULT_BORDER)
-      @border_styler = border_styler
-      @border_instance = Border.from(@border, @border_styler)
-
+      @column_width = (column_width || DEFAULT_COLUMN_WIDTH)
+      @formatter = formatter
+      @header_frequency = header_frequency
+      @row_divider_frequency = row_divider_frequency
       @truncation_indicator = validate_character(truncation_indicator,
         DEFAULT_TRUNCATION_INDICATOR, InvalidTruncationIndicatorError, "truncation indicator")
+      @wrap_body_cells_to = wrap_body_cells_to
+      @wrap_header_cells_to = wrap_header_cells_to
 
       @column_registry = { }
       columns.each { |item| add_column(item) }
@@ -138,13 +159,6 @@ module Tabulo
     #   a method to be called on each item in the table sources to provide the content
     #   for this column. If a String is passed as the label, then it will be converted to
     #   a Symbol for the purpose of serving as this label.
-    # @param [nil, #to_s] header (nil) Text to be displayed in the column header. If passed nil,
-    #   the column's label will also be used as its header text.
-    # @param [:left, :center, :right, nil] align_header (nil) Specifies how the header text
-    #   should be aligned. If <tt>nil</tt> is passed, then the alignment is determined
-    #   by the Table-level setting passed to the <tt>align_header</tt> (which itself defaults
-    #   to <tt>:center</tt>). Otherwise, this option determines the alignment of the header
-    #   content for this column.
     # @param [:left, :center, :right, :auto, nil] align_body (nil) Specifies how the cell body contents
     #   should be aligned. If <tt>nil</tt> is passed, then the alignment is determined
     #   by the Table-level setting passed to the <tt>align_body</tt> option on Table initialization
@@ -152,15 +166,33 @@ module Tabulo
     #   this column. If <tt>:auto</tt> is passed, the alignment is determined by the type of the cell
     #   value, with numbers aligned right, booleans center-aligned, and other values left-aligned.
     #   Note header text alignment is configured separately using the :align_header param.
-    # @param [Integer] width (nil) Specifies the width of the column, excluding padding. If
-    #   nil, then the column will take the width provided by the `column_width` param
-    #   with which the Table was initialized.
-    # @param [#to_proc] formatter (:to_s.to_proc) A lambda or other callable object that
+    # @param [:left, :center, :right, nil] align_header (nil) Specifies how the header text
+    #   should be aligned. If <tt>nil</tt> is passed, then the alignment is determined
+    #   by the Table-level setting passed to the <tt>align_header</tt> (which itself defaults
+    #   to <tt>:center</tt>). Otherwise, this option determines the alignment of the header
+    #   content for this column.
+    # @param [#to_proc] formatter (nil) A lambda or other callable object that
     #   will be passed the calculated value of each cell to determine how it should be displayed. This
     #   is distinct from the extractor (see below). For example, if the extractor for this column
     #   generates a Date, then the formatter might format that Date in a particular way.
-    #   If no formatter is provided, then <tt>.to_s</tt> will be called on
-    #   the extracted value of each cell to determine its displayed content.
+    #   If no formatter is provided, then the callable that was passed to the `formatter` option
+    #   of the table itself on its creation (see {#initialize}) (which itself defaults to
+    #   `:to_s.to_proc`), will be used as the formatter for the column.
+    # @param [nil, #to_s] header (nil) Text to be displayed in the column header. If passed nil,
+    #   the column's label will also be used as its header text.
+    # @param [nil, #to_proc] header_styler (nil) A lambda or other callable object taking
+    #   a single parameter, representing a single line of within the header content for
+    #   this column. For example, if the header cell content is wrapped over three lines, then
+    #   the {header_styler} will be called once for each line. If passed <tt>nil</tt>, then
+    #   no additional styling will be applied to the header cell content. If passed a callable,
+    #   then that callable will be called for each line of content within the header cell, and the
+    #   resulting string rendered in place of that line. The extra width of the string returned by the
+    #   {header_styler} is not taken into consideration by the internal table and
+    #   cell width calculations involved in rendering the table. Thus it can be used to apply
+    #   ANSI escape codes to header cell content, to colour the cell content for example, without
+    #   breaking the table formatting.
+    #   Note that if the header content is truncated, then any {header_styler} will be applied to the
+    #   truncation indicator character as well as to the truncated content.
     # @param [nil, #to_proc] styler (nil) A lambda or other callable object that will be passed
     #   two arguments: the calculated value of the cell (prior to the {formatter} being applied);
     #   and a string representing a single formatted line within the cell. For example, if the
@@ -176,19 +208,9 @@ module Tabulo
     #   breaking the table formatting.
     #   Note that if the content of a cell is truncated, then the whatever styling is applied by the
     #   {styler} to the cell content will also be applied to the truncation indicator character.
-    # @param [nil, #to_proc] header_styler (nil) A lambda or other callable object taking
-    #   a single parameter, representing a single line of within the header content for
-    #   this column. For example, if the header cell content is wrapped over three lines, then
-    #   the {header_styler} will be called once for each line. If passed <tt>nil</tt>, then
-    #   no additional styling will be applied to the header cell content. If passed a callable,
-    #   then that callable will be called for each line of content within the header cell, and the
-    #   resulting string rendered in place of that line. The extra width of the string returned by the
-    #   {header_styler} is not taken into consideration by the internal table and
-    #   cell width calculations involved in rendering the table. Thus it can be used to apply
-    #   ANSI escape codes to header cell content, to colour the cell content for example, without
-    #   breaking the table formatting.
-    #   Note that if the header content is truncated, then any {header_styler} will be applied to the
-    #   truncation indicator character as well as to the truncated content.
+    # @param [Integer] width (nil) Specifies the width of the column, excluding padding. If
+    #   nil, then the column will take the width provided by the `column_width` param
+    #   with which the Table was initialized.
     # @param [#to_proc] extractor A block or other callable
     #   that will be passed each of the Table sources to determine the value in each cell of this
     #   column. If this is not provided, then the column label will be treated as a method to be
@@ -196,8 +218,16 @@ module Tabulo
     # @raise [InvalidColumnLabelError] if label has already been used for another column in this
     #   Table. (This is case-sensitive, but is insensitive to whether a String or Symbol is passed
     #   to the label parameter.)
-    def add_column(label, header: nil, align_header: nil, align_body: nil,
-      width: nil, formatter: :to_s.to_proc, styler: nil, header_styler: nil, &extractor)
+    def add_column(
+      label,
+      align_body:    nil,
+      align_header:  nil,
+      formatter:     nil,
+      header:        nil,
+      header_styler: nil,
+      styler:        nil,
+      width:         nil,
+      &extractor)
 
       column_label =
         case label
@@ -213,16 +243,16 @@ module Tabulo
 
       @column_registry[column_label] =
         Column.new(
-          header: (header || label).to_s,
-          align_header: align_header || @align_header,
           align_body: align_body || @align_body,
-          width: (width || @column_width),
-          formatter: formatter,
-          extractor: (extractor || label.to_proc),
-          styler: styler,
+          align_header: align_header || @align_header,
+          extractor: extractor || label.to_proc,
+          formatter: formatter || @formatter,
+          header: (header || label).to_s,
           header_styler: header_styler,
-          truncation_indicator: @truncation_indicator,
           padding_character: PADDING_CHARACTER,
+          styler: styler,
+          truncation_indicator: @truncation_indicator,
+          width: width || @column_width,
         )
     end
 
@@ -262,7 +292,10 @@ module Tabulo
           else
             @header_frequency
           end
-        yield body_row(source, header: header)
+
+        show_divider = @row_divider_frequency && (index != 0) && (index % @row_divider_frequency == 0)
+
+        yield Row.new(self, source, header: header, divider: show_divider)
       end
     end
 
@@ -360,11 +393,12 @@ module Tabulo
     #
     # @param [Hash] opts Options for configuring the new, transposed {Table}.
     #   The following options are the same as the keyword params for the {#initialize} method for
-    #   {Table}: <tt>column_width</tt>, <tt>column_padding</tt>, <tt>header_frequency</tt>,
-    #   <tt>wrap_header_cells_to</tt>, <tt>wrap_body_cells_to</tt>, <tt>border</tt>,
-    #   <tt>border_styler</tt>, <tt>truncation_indicator</tt>, <tt>align_header</tt>, <tt>align_body</tt>.
-    #   These are applied in the same way as documented for {#initialize}, when creating the
-    #   new, transposed Table. Any options not specified explicitly in the call to {#transpose}
+    #   {Table}: <tt>column_width</tt>, <tt>column_padding</tt>, <tt>formatter</tt>,
+    #   <tt>header_frequency</tt>, <tt>row_divider_frequency</tt>, <tt>wrap_header_cells_to</tt>,
+    #   <tt>wrap_body_cells_to</tt>, <tt>border</tt>, <tt>border_styler</tt>, <tt>truncation_indicator</tt>,
+    #   <tt>align_header</tt>, <tt>align_body</tt>.
+    #   These are applied in the same way as documented for {#initialize}, when
+    #   creating the new, transposed Table. Any options not specified explicitly in the call to {#transpose}
     #   will inherit their values from the original {Table} (with the exception of settings
     #   for the left-most column, containing the field names, which are determined as described
     #   below). In addition, the following options also apply to {#transpose}:
@@ -386,9 +420,9 @@ module Tabulo
     # @return [Table] a new {Table}
     # @raise [InvalidBorderError] if invalid argument passed to `border` parameter.
     def transpose(opts = {})
-      default_opts = [:column_width, :column_padding, :header_frequency, :wrap_header_cells_to,
-        :wrap_body_cells_to, :truncation_indicator, :align_header, :align_body, :border,
-        :border_styler].map do |sym|
+      default_opts = [:column_width, :column_padding, :formatter, :header_frequency,
+        :row_divider_frequency, :wrap_header_cells_to, :wrap_body_cells_to, :truncation_indicator, :align_header,
+        :align_body, :border, :border_styler].map do |sym|
         [sym, instance_variable_get("@#{sym}")]
       end.to_h
 
@@ -419,9 +453,10 @@ module Tabulo
     end
 
     # @!visibility private
-    def formatted_body_row(source, header: nil)
+    def formatted_body_row(source, header:, divider:)
       cells = column_registry.map { |_, column| column.body_cell(source) }
       inner = format_row(cells, @wrap_body_cells_to)
+
       if header
         join_lines([
           horizontal_rule(header == :top ? :top : :middle),
@@ -429,6 +464,11 @@ module Tabulo
           horizontal_rule(:middle),
           inner,
         ].reject(&:empty?))
+      elsif divider
+        join_lines([
+          horizontal_rule(:middle),
+          inner,
+        ].reject(&:empty?))
       else
         inner
       end
@@ -464,11 +504,6 @@ module Tabulo
       end
     end
 
-    # @!visibility private
-    def body_row(source, header: nil)
-      Row.new(self, source, header: header)
-    end
-
     # @!visibility private
     #
     # Formats a single header row or body row as a String.

data/lib/tabulo/version.rb

@@ -1,3 +1,3 @@
 module Tabulo
-  VERSION = "2.1.1"
+  VERSION = "2.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tabulo
 version: !ruby/object:Gem::Version
-  version: 2.1.1
+  version: 2.2.0
 platform: ruby
 authors:
 - Matthew Harvey
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-12-31 00:00:00.000000000 Z
+date: 2020-01-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tty-screen