tabulo 2.7.1 → 2.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63054578d0f667075a8e2888d3fc0a2572ec9b8a93e3f74468f058613a7c2f19
-  data.tar.gz: 3d0b8bad1b9ad7fa2949037ec6de683f7b43c7ecc73ca02c53bbb14f926139fe
+  metadata.gz: f2419c20288ae285e4fcbfefd5627f6dac370ab3940969093216283407df6ee4
+  data.tar.gz: '08ee67482f630a3f185319fcc7fec4844b3a64d70042f3afc9abb993e4a65260'
 SHA512:
-  metadata.gz: d8626993288417bdd75b581819ea4ef9ef79bfcdfb5d18e7469ac2699e303096405f6155b690a289f5bbc27a8235cc80fb4cb0ad8e62146c664f198fefce9a7e
-  data.tar.gz: 9a306fb542677778f3e6998ee83352f87802bf6d07b422846b61d1fe42acdd8b40a914daa87a10e5abe2f84e6d4b8cd5ddc5711e49d9b5d066113b167b4cf4a9
+  metadata.gz: 97f9cc96273afdc2fb30f341cc7dede4440cc2198209035bdbb65bf4872628a0db6a42f29287a7f9a2aa08c0fd2495bd7cdf189529ef1ce93f62797a5cfdb8dd
+  data.tar.gz: 96e4fd149487e51a49bb3935ec4341c0a327f101d028019b8bf73279b3e239cf3d8deb0fd5efda92c8d10d79c5bf1973b16344e45e753695b6920c6c4111f852

data/.github/workflows/tests.yml

@@ -23,9 +23,9 @@ jobs:
           '2.3.8',
           '2.4.10',
           '2.5.9',
-          '2.6.8',
-          '2.7.4',
-          '3.0.2',
+          '2.6.9',
+          '2.7.5',
+          '3.0.3',
         ]
     steps:
     - uses: actions/checkout@v2

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+### v2.7.2
+
+* Minor documentation improvements and tweaks
+* Upgrade Ruby patch versions in CI config
+
 ### v2.7.1
 
 * Dependency version upgrades

data/README.md

@@ -6,8 +6,7 @@
 [![Coverage Status][CS img]][Coverage Status]
 [![Awesome][AR img]][Awesome Ruby]
 
-Tabulo is a Ruby library for generating plain text tables (also known as “terminal tables”
-or “ASCII tables”). It is both highly configurable and very easy to use.
+Tabulo is a Ruby library for generating plain text tables. It is both highly configurable and very easy to use.
 
 <a name="overview"></a>
 ## Overview
@@ -103,7 +102,7 @@ Tabulo has also been ported to Crystal (with some modifications): see [Tablo](ht
         * [Setting default styles](#default-styles)
         * [Styling borders](#styling-borders)
      * [Repeating headers](#repeating-headers)
-     * [Using a Table Enumerator](#using-a-table-enumerator)
+     * [Using a Table Enumerator](#enumerator)
      * [Accessing cell values](#accessing-cell-values)
      * [Accessing the underlying enumerable](#accessing-sources)
      * [Transposing rows and columns](#transposition)
@@ -793,7 +792,7 @@ the table.
 The `formatter` callback also has an alternative, 2-parameter version. If `formatter` is passed
 a 2-parameter callable, the second parameter will be given a `CellData` instance,
 containing additional information about the cell that may be useful in determining how to format
-it&mdash;see the [documentation](https://www.rubydoc.info/gems/tabulo/2.7.1/Tabulo/CellData.html)
+it&mdash;see the [documentation](https://www.rubydoc.info/gems/tabulo/2.7.2/Tabulo/CellData.html)
 for details.
 
 <a name="colours-and-styling"></a>
@@ -839,7 +838,7 @@ number is even). The second parameter represents the formatted string value of t
 content after any processing by the [formatter](#formatting-cell-values). The third and fourth
 parameters are optional, and contain further information about the cell and its contents that may be useful in
 determining how to style it. See the
-[documentation](https://www.rubydoc.info/gems/tabulo/2.7.1/Tabulo/Table#add_column-instance_method) for details.
+[documentation](https://www.rubydoc.info/gems/tabulo/2.7.2/Tabulo/Table#add_column-instance_method) for details.
 
 If the content of a cell is wrapped over multiple lines, then the `styler` will be called once
 per line, so that each line of the cell will have the escape sequence applied to it separately
@@ -859,7 +858,7 @@ table.add_column(:even?, header_styler: -> (s) { "\033[32m#{s}\033[0m" })
 ```
 
 The `header_styler` option accepts a 1-, 2- or 3-parameter callable. See the
-[documentation](https://www.rubydoc.info/gems/tabulo/2.7.1/Tabulo/Table#add_column-instance_method)
+[documentation](https://www.rubydoc.info/gems/tabulo/2.7.2/Tabulo/Table#add_column-instance_method)
 for details.
 
 <a name="styling-title"></a>
@@ -873,7 +872,7 @@ table = Tabulo::Table.new(1..5, :itself, :even?, :odd?, title: "Numbers", title_
 ```
 
 The `title_styler` option accepts a 1- or 2-parameter callable. See the
-[documentation](https://www.rubydoc.info/gems/tabulo/2.7.1/Tabulo/Table#initialize-instance_method)
+[documentation](https://www.rubydoc.info/gems/tabulo/2.7.2/Tabulo/Table#initialize-instance_method)
 for details.
 
 <a name="styling-borders"></a>
@@ -939,6 +938,12 @@ table = Tabulo::Table.new(1..10, :itself, :even?, header_frequency: 5)
 
 Note that if the table has a [title](#title), it will not be repeated; only column headers are repeated.
 
+One can achieve even finer-grained control over printing of headers within the table body by stepping
+through the table a row at a time (using `.each` or other methods of `Enumerable`) and calling the
+the [`formatted_header`](https://www.rubydoc.info/gems/tabulo/Tabulo/Table#formatted_header-instance_method)
+method in combination with [`horizontal_rule`](https://www.rubydoc.info/gems/tabulo/Tabulo%2FTable:horizontal_rule)
+to produce headers at arbitrary points in the output.
+
 <a name="enumerator"></a>
 ### Using a Table Enumerator [&#x2191;](#contents)
 
@@ -1068,7 +1073,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`&#8217;s behaviour. For details, see the
-[documentation](https://www.rubydoc.info/gems/tabulo/2.7.1/Tabulo/Table#transpose-instance_method).
+[documentation](https://www.rubydoc.info/gems/tabulo/2.7.2/Tabulo/Table#transpose-instance_method).
 
 <a name="borders"></a>
 ### Configuring borders [&#x2191;](#contents)
@@ -1286,6 +1291,11 @@ If you want a line before every row, pass `1` to `row_divider_frequency`. For ex
 +--------------+--------------+--------------+
 ```
 
+In addition to these options, it is also possible to print horizontal dividers at any chosen
+point in the table output, by stepping through the table one row at a time
+and calling the [`horizontal_rule`](https://www.rubydoc.info/gems/tabulo/Tabulo%2FTable:horizontal_rule)
+method as required.
+
 <a name="freezing-a-table"></a>
 ### Using a table as a snapshot rather than as a dynamic view [&#x2191;](#contents)
 
@@ -1459,13 +1469,13 @@ 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.7.1
+[Documentation]: http://www.rubydoc.info/gems/tabulo
 [Build Status]: https://github.com/matt-harvey/tabulo/actions/workflows/tests.yml
 [Coverage Status]: https://coveralls.io/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.7.1-blue.svg
+[DC img]: https://img.shields.io/badge/documentation-v2.7.2-blue.svg
 [BS img]: https://github.com/matt-harvey/tabulo/actions/workflows/tests.yml/badge.svg
 [CS img]: https://img.shields.io/coveralls/matt-harvey/tabulo.svg
 [AR img]: https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg

data/VERSION

@@ -1 +1 @@
-2.7.1
+2.7.2

data/lib/tabulo/table.rb

@@ -420,7 +420,7 @@ module Tabulo
     end
 
     # @return [String] a graphical representation of the Table column headers formatted with fixed
-    #   width plain text.
+    #   width plain text, excluding any horizontal borders above or below.
     def formatted_header
       cells = get_columns.map(&:header_cell)
       format_row(cells, @wrap_header_cells_to)

data/lib/tabulo/version.rb

@@ -1,3 +1,3 @@
 module Tabulo
-  VERSION = "2.7.1"
+  VERSION = "2.7.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tabulo
 version: !ruby/object:Gem::Version
-  version: 2.7.1
+  version: 2.7.2
 platform: ruby
 authors:
 - Matthew Harvey
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-10-08 00:00:00.000000000 Z
+date: 2021-12-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tty-screen
@@ -221,7 +221,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.29
+rubygems_version: 3.2.3
 signing_key: 
 specification_version: 4
 summary: Terminal table generator