Allow table rotation and resizing to be disabled

README.md

@@ -355,7 +355,8 @@ Rendering of **TTY-Table** includes numerous customization options:
 * `:indent` - indentation applied to rendered table, by default 0
 * `:multiline` - when `true` will wrap text at new line or column width, when `false` will escape special characters
 * `:padding` - array of integers to set table fields padding. Defaults to `[0,0,0,0]`.
-* `:resize` - when `true` will expand/shrink table column sizes to match the terminal width, otherwise when `false` will rotate table vertically. Defaults to `false`.
+* `:resize` - when `true` will expand/shrink table column sizes to match the terminal width, when `false` the behaviour is determined by `rotate`. Defaults to `false`.
+* `:rotate`: - when `true` will rotate the table vertically if `resize: false` causes the width to exceed the terminal size. When `false` the line wrapping is determined by the terminal. Defaults to `true`.
 * `:width` - constrains the table total width. Defaults to value automatically calculated based on the content and terminal size.
 
 The `render` method can accept as a second argument the above options either as hash value:

lib/tty/table/column_constraint.rb

@@ -86,27 +86,35 @@ def natural_width
       # @api public
       def enforce
         assert_minimum_width
-        padding = renderer.padding
 
         if natural_width <= renderer.width
           if renderer.resize
             expand_column_widths
           else
-            renderer.column_widths.map do |width|
-              padding.left + width + padding.right
-            end
+            natural_column_widths
           end
         else
           if renderer.resize
             shrink
-          else
+          elsif renderer.rotate
             rotate
+          else
+            natural_column_widths
           end
         end
       end
 
       private
 
+      # Determine the column widths without expanding or shrinking
+      #
+      # @api private
+      def natural_column_widths
+        renderer.column_widths.map do |width|
+          renderer.padding.left + width + renderer.padding.right
+        end
+      end
+
       # Rotate table to vertical orientation and print information to stdout
       #
       # @api private

lib/tty/table/renderer/basic.rb

@@ -85,6 +85,13 @@ class Basic
         # @api public
         attr_accessor :resize
 
+        # The table automatic rotation behaviour. If true and resize is false
+        # the table will be rotated to vertical. Has no effect if resize is
+        # true. By default it's true.
+        #
+        # @api public
+        attr_accessor :rotate
+
         # The table padding settings
         #
         # @return [TTY::Table::Padder]
@@ -124,6 +131,7 @@ def initialize(table, options = {})
           @border_class  = options.fetch(:border_class) { Border::Null }
           @indent        = options.fetch(:indent) { 0 }
           @resize        = options.fetch(:resize) { false }
+          @rotate        = options.fetch(:rotate) { true }
           @padding       = Strings::Padder.parse(options[:padding])
         end
 

spec/unit/column_constraint/enforce_spec.rb

@@ -33,7 +33,7 @@
     let(:renderer) { TTY::Table::Renderer::Basic.new(table, options) }
 
     context 'with resize' do
-      let(:options) { { width: 8, resize: true } }
+      let(:options) { { width: 8, resize: true, rotate: true } }
 
       it 'calls shrink' do
         allow(columns).to receive(:shrink)
@@ -42,8 +42,8 @@
       end
     end
 
-    context 'without resize' do
-      let(:options) { { width: 8, resize: false }}
+    context 'with rotate and without resize' do
+      let(:options) { { width: 8, resize: false, rotate: true } }
 
       it 'changes table orientation to vertical' do
         allow(Kernel).to receive(:warn)
@@ -54,6 +54,17 @@
         expect(table.orientation.name).to eql(:vertical)
       end
     end
+
+    context 'without resize nor rotate' do
+      let(:options) { { width: 8, resize: false, rotate: false } }
+
+      it 'does not alter the column width nor table orientation' do
+        expect(columns).not_to receive(:shrink)
+        column_widths = columns.enforce
+        expect(column_widths).to eql([2,2,2,2])
+        expect(table.orientation.name).to eql(:horizontal)
+      end
+    end
   end
 
   context 'with table less than allowed width' do