blufin 0.1.0

data/lib/core/yml/yml_meta_writer_base.rb

@@ -0,0 +1,300 @@
+module Blufin
+
+    class YmlMetaWriterBase < Blufin::YmlWriterBase
+
+        TYPE                 = 'TYPE'
+        MAX_LENGTH           = 'MAX_LENGTH'
+        FLAG                 = 'FLAG'
+        FLAG_AUTO_INCREMENT  = 'FLAG_AUTO_INCREMENT'
+        FLAG_INDEX           = 'FLAG_INDEX'
+        FLAG_NULLABLE        = 'FLAG_NULLABLE'
+        FLAG_PRIMARY_KEY     = 'FLAG_PRIMARY_KEY'
+        FLAG_UNIQUE          = 'FLAG_UNIQUE'
+        FKEY                 = 'FKEY'
+        LINK                 = 'LINK'
+        DESCRIPTION          = 'DESCRIPTION'
+        REQUIRED             = 'REQUIRED'
+        REQUIRED_IF          = 'REQUIRED_IF'
+        ENCRYPTED            = 'ENCRYPTED'
+        TRANSIENT            = 'TRANSIENT'
+        CHILD_OF             = 'CHILD_OF'
+        CURRENCY_CODE        = 'CURRENCY_CODE'
+        DECIMAL_DISTRIBUTION = 'DECIMAL_DISTRIBUTION'
+        ENUM_NAME            = 'ENUM_NAME'
+        ENUM_VALUES          = 'ENUM_VALUES'
+
+        def handle_description(value)
+            @description = "            put(#{DESCRIPTION}, \"#{value.gsub('"', '\"')}\");" if value != '' && !value.nil?
+        end
+
+        def handle_type(value, schema, table, column_name, column_data)
+
+            converted_type = value
+            max_length     = nil
+
+            if value == Blufin::YmlSchemaValidator::TYPE_BOOLEAN
+            elsif Blufin::YmlSchemaValidator::DATETIME_TYPES.include?(value)
+                if value == Blufin::YmlSchemaValidator::TYPE_DATETIME_INSERT || value == Blufin::YmlSchemaValidator::TYPE_DATETIME_UPDATE
+                    converted_type = 'DATETIME_INSERT' if value == Blufin::YmlSchemaValidator::TYPE_DATETIME_INSERT
+                    converted_type = 'DATETIME_UPDATE' if value == Blufin::YmlSchemaValidator::TYPE_DATETIME_UPDATE
+                    @transient     = "            put(#{TRANSIENT}, true);"
+                end
+            elsif value =~ Blufin::YmlSchemaValidator::REGEX_DECIMAL
+                decimal_m, decimal_d = Blufin::YmlCommon::decimal_extract_values(value)
+                converted_type       = 'DECIMAL' # DECIMAL(2,2) =>  "0.25" => length: 4 characters.
+                max_length           = decimal_m + 1 + (decimal_m == decimal_d ? 1 : 0) # DECIMAL(4,2) => "42.25" => length: 5 characters.
+                @import_statements << 'import org.blufin.base.helper.Pair;'
+                @decimal_distribution = "            put(#{DECIMAL_DISTRIBUTION}, Pair.of(#{decimal_m.to_i}, #{decimal_d.to_i}));"
+            elsif Blufin::YmlSchemaValidator::INT_TYPES.include?(value)
+                converted_type = 'INT_AUTO' if value == Blufin::YmlSchemaValidator::TYPE_INT_AUTO
+            elsif value == Blufin::YmlSchemaValidator::TYPE_INT_TINY
+                converted_type = 'INT_TINY'
+            elsif value == Blufin::YmlSchemaValidator::TYPE_INT_SMALL
+                converted_type = 'INT_SMALL'
+            elsif value == Blufin::YmlSchemaValidator::TYPE_INT_BIG
+                converted_type = 'INT_BIG'
+            elsif Blufin::YmlSchemaValidator::TEXT_TYPES.include?(value)
+                # Do nothing.
+            elsif value =~ Blufin::YmlSchemaValidator::REGEX_VARCHAR
+                converted_type = 'VARCHAR'
+                max_length     = Blufin::Strings::extract_using_regex(value, /\(\d+\)\z/, %w{( )})
+            elsif value =~ Blufin::YmlSchemaValidator::REGEX_ENUM
+                enum_values    = Blufin::YmlCommon::enum_value_extractor(value, @site)
+                converted_type = 'ENUM'
+                max_length     = enum_values.max_by(&:length).length
+                @import_statements << 'import java.util.Arrays;'
+                @enum_name   = "            put(#{ENUM_NAME}, \"#{Blufin::Strings::snake_case_to_camel_case(table)}#{Blufin::Strings::snake_case_to_camel_case(column_name)}\");"
+                @enum_values = "            put(#{ENUM_VALUES}, Arrays.asList(\"#{enum_values.join('", "')}\"));"
+            elsif value =~ Blufin::YmlSchemaValidator::REGEX_ENUM_CUSTOM
+                custom_enum_name = Blufin::YmlCommon::enum_name_extractor(value)
+                enum_values      = @yml_enum_scanner.get_enum_custom_values_for(custom_enum_name)
+                converted_type   = 'ENUM_CUSTOM'
+                max_length       = enum_values.max_by(&:length).length
+                @import_statements << "import #{get_package(@site, schema, 'enums', Blufin::SiteServices::SDK)}.#{custom_enum_name};"
+                @enum_name   = "            put(#{ENUM_NAME}, \"#{custom_enum_name}\");"
+                @enum_values = "            put(#{ENUM_VALUES}, getEnumValues(#{custom_enum_name}.values()));"
+            elsif value =~ Blufin::YmlSchemaValidator::REGEX_ENUM_SYSTEM
+                system_enum_name = Blufin::YmlCommon::enum_name_extractor(value)
+                enum_values      = @yml_enum_scanner.get_enum_system_values_for(system_enum_name)
+                converted_type   = 'ENUM_SYSTEM'
+                max_length       = enum_values.max_by(&:length).length
+                @import_statements << "import #{Blufin::SiteServices::PACKAGE_SYSTEM_ENUMS}.#{system_enum_name};"
+                @enum_name   = "            put(#{ENUM_NAME}, \"#{system_enum_name}\");"
+                @enum_values = "            put(#{ENUM_VALUES}, getEnumValues(#{system_enum_name}.values()));"
+            elsif value == Blufin::YmlSchemaValidator::TYPE_ENUM_SYSTEM
+                # This only applies to Embedded Objects.
+                enum_values    = @yml_enum_scanner.get_enum_system_values_for(column_data[:type_java])
+                converted_type = 'ENUM_SYSTEM'
+                max_length     = enum_values.max_by(&:length).length
+                @import_statements << "import #{Blufin::SiteServices::PACKAGE_SYSTEM_ENUMS}.#{column_data[:type_java]};"
+                @enum_name   = "            put(#{ENUM_NAME}, \"#{column_data[:type_java]}\");"
+                @enum_values = "            put(#{ENUM_VALUES}, getEnumValues(#{column_data[:type_java]}.values()));"
+            elsif [
+                Blufin::ScannerJavaEmbeddedObjects::OBJECT,
+                Blufin::ScannerJavaEmbeddedObjects::OBJECT_LIST,
+                Blufin::ScannerJavaEmbeddedObjects::OBJECT_LINK,
+            ].include?(value)
+                # Do Nothing. Fix for @Embedded Meta-Writer.
+            else
+                raise RuntimeError, "Unrecognized type in #{__FILE__}: #{value}"
+            end
+            @type       = "            put(#{TYPE}, DataType.#{converted_type});"
+            @max_length = "            put(#{MAX_LENGTH}, #{max_length.to_i});" unless max_length.nil?
+        end
+
+        def handle_type_where_implied(table, column_name)
+            if column_name =~ /\A(#{Blufin::YmlSchemaValidator::VALID_SCHEMAS_REGEX})\.[a-z_]+\z/
+                @type = "            put(#{TYPE}, DataType.OBJECT);"
+            elsif column_name =~ /\A(#{Blufin::YmlSchemaValidator::VALID_SCHEMAS_REGEX})\.[a-z_]+\[\]\z/
+                @type = "            put(#{TYPE}, DataType.OBJECT_LIST);"
+            elsif column_name =~ /\A[a-z_.]+\[#{Blufin::YmlSchemaValidator::LINK}\]/
+                @type = "            put(#{TYPE}, DataType.OBJECT_LINK);"
+                @link = "            put(#{LINK}, \"#{Blufin::YmlCommon::get_link_table_name(table, column_name)}\");"
+            end
+        end
+
+        def handle_flag(value)
+            if value != '' && !value.nil?
+                flags_array = []
+                flags_data  = Blufin::YmlCommon::extract_flags(value)[0]
+                flags_array << FLAG_AUTO_INCREMENT unless flags_data.auto_increment.nil?
+                flags_array << FLAG_INDEX unless flags_data.index.nil?
+                flags_array << FLAG_NULLABLE unless flags_data.nullable.nil?
+                flags_array << FLAG_PRIMARY_KEY unless flags_data.primary_key.nil?
+                flags_array << FLAG_UNIQUE unless flags_data.unique.nil?
+                if flags_array.any?
+                    @import_statements << 'import java.util.Arrays;'
+                    @flag = "            put(#{FLAG}, Arrays.asList("
+                    flags_array.each do |flag|
+                        @flag += "#{flag}, "
+                    end
+                    @flag = @flag[0...-2]
+                    @flag += '));'
+                end
+            end
+        end
+
+        def handle_fkey(value)
+            @fkey = "            put(#{FKEY}, \"#{value.to_s.gsub('"', '\"')}\");"
+        end
+
+        def handle_required(schema, table, value, table_data)
+            @required = "            put(#{REQUIRED}, true);"
+        end
+
+        def handle_required_if(schema, table, value, table_data)
+            value_split = value.split('=')
+            enum_value  = table_data[value_split[0]][Blufin::YmlSchemaValidator::TYPE]
+            if enum_value =~ /#{Blufin::YmlSchemaValidator::REGEX_ENUM}/
+                enum_class_name = "#{Blufin::Strings::snake_case_to_camel_case(table)}#{Blufin::Strings.snake_case_to_camel_case(value_split[0].dup)}"
+                enum_package    = get_package(@site, schema, 'enums', Blufin::SiteServices::SDK)
+            elsif enum_value =~ /#{Blufin::YmlSchemaValidator::REGEX_ENUM_CUSTOM}/
+                enum_class_name = Blufin::Strings.snake_case_to_camel_case(value_split[0].dup)
+                enum_package    = get_package(@site, schema, 'enums', Blufin::SiteServices::SDK)
+            elsif enum_value =~ /#{Blufin::YmlSchemaValidator::REGEX_ENUM_SYSTEM}/
+                enum_class_name = Blufin::YmlCommon::enum_name_extractor(enum_value)
+                enum_package    = Blufin::SiteServices::PACKAGE_SYSTEM_ENUMS
+            else
+                raise RuntimeError, "'#{enum_value}' doesn't match regex for ENUM, ENUM_CUSTOM or ENUM_SYSTEM."
+            end
+
+            @required_if = "            put(#{REQUIRED_IF}, Pair.of(FIELD_#{value_split[0].upcase}, #{enum_class_name}.#{value_split[1].upcase}));"
+            @import_statements << 'import org.blufin.base.helper.Pair;'
+            @import_statements << "import #{enum_package}.#{enum_class_name};"
+        end
+
+        def handle_encrypted(value)
+            raise RuntimeError, "Encrypted value is something other than 'true' \xe2\x86\x92 #{value}" unless value == 'true' || value == true
+            @encrypted = "            put(#{ENCRYPTED}, true);"
+        end
+
+        def handle_transient(value)
+            @transient = "            put(#{TRANSIENT}, \"#{value[0]}.#{value[1]}\");"
+        end
+
+        def handle_child_of(value)
+            @child_of = "            put(#{CHILD_OF}, \"#{value}\");"
+        end
+
+        def handle_child_type(value)
+            raise RuntimeError, "@child_type is being set twice! Was originally: #{@child_type} , now being set to: #{value}" unless @child_type.nil?
+            @child_type = value
+        end
+
+        # This build the "hierarchy" Array in the MetaData constructors.
+        # schema_tables_array is an Array like [app.data_center, app.db, common.cron]...
+        # @return Array (of Data)
+        def extract_hierarchy(schema, table, dependents_array, schema_tables_array)
+            hierarchy             = ["\"#{table}\""]
+            hierarchy_nested_only = []
+            unless dependents_array.nil?
+                dependents_array.each do |dependent|
+                    ds_array   = []
+                    ds_current = ''
+                    ds_buffer  = ''
+                    ds         = dependent.split('_')
+                    ds_counter = 0
+                    ds_levels  = []
+                    ds.each do |n|
+                        ds_current += "_#{n}"
+                        ds_current = ds_current.gsub(/^_/, '')
+                        ds_buffer  += "_#{n}"
+                        ds_buffer  = ds_buffer.gsub(/^_/, '')
+                        if schema_tables_array.include?("#{schema}.#{ds_current}")
+                            if ds_current =~ /^#{table}/
+                                ds_counter = ds_counter + 1
+                                ds_array << ds_buffer
+                                ds_levels << [ds_counter, ds_array.join('_')]
+                                ds_buffer = ''
+                            end
+                        end
+                    end
+                    hierarchy << "\"#{ds_array.join('/')}\""
+                    hierarchy_nested_only << ds_array.join('_')
+                end
+            end
+            hierarchy.uniq!
+            hierarchy.sort!
+            [hierarchy, hierarchy_nested_only]
+        end
+
+        def generate_content(content, embedded, consts, fields, hierarchy, hierarchy_nested_only, schema, table, class_name, import_statements, child_type)
+
+            parent = @schema_resources["#{schema}.#{table}"][:parent]
+            parent = (parent.nil? || parent.strip == '') ? 'null' : "\"#{parent}\""
+
+            if import_statements.any?
+                import_statements.uniq!
+                content = content.push(*import_statements)
+                content << ''
+            end
+
+            content << 'import java.util.HashMap;'
+            content << 'import java.text.MessageFormat;'
+            content << 'import lombok.Getter;'
+            content << 'import org.blufin.base.enums.SchemaType;'
+            content << ''
+            content << "public final class #{class_name} extends Abstract#{Blufin::YmlJavaMetaWriter::META_DATA} {"
+            content << ''
+            content << '    @Getter'
+            content << "    private static final #{class_name} instance = new #{class_name}();"
+            content << ''
+
+            if consts.any?
+                consts.each do |const|
+                    content << const
+                end
+                content << ''
+            end
+
+            content << "    private #{class_name}() {"
+            content << ''
+
+            # Hacky-fix for test classes. DO NOT remove this or Java won't compile.
+            constructor_schema = (schema == Blufin::YmlSchemaValidator::MOCK) ? 'null' : "SchemaType.#{schema.upcase}"
+            content << "        super(#{constructor_schema}, \"#{table}\", #{parent}, Arrays.asList(#{hierarchy.join(', ')}), #{child_type.nil? ? 'null' : child_type});"
+            content << ''
+
+            if fields.any?
+                fields.each_with_index do |field, idx|
+                    if idx == fields.length - 1
+                        content << field[0...-1]
+                    else
+                        content << field
+                    end
+                end
+            end
+
+            content << '    }'
+
+            if hierarchy_nested_only.any?
+                content << ''
+                content << '    @Override'
+                content << '    public AbstractMetaData getNestedMetaData(String nestedTable) {'
+                content << ''
+                content << '        switch (nestedTable) {'
+                content << ''
+                hierarchy_nested_only.each do |n|
+                    content << "            case \"#{n}\":"
+                    content << "                return #{embedded}#{Blufin::Strings::snake_case_to_camel_case(n)}MetaData.getInstance();"
+                    content << ''
+                end
+                content << '            default:'
+                content << "                throw new RuntimeException(MessageFormat.format(\"#{embedded}#{class_name} doesn''t have nested metadata for table: {0}\", nestedTable));"
+                content << '        }'
+                content << '    }'
+
+            else
+                content << ''
+                content << '    @Override'
+                content << '    public AbstractMetaData getNestedMetaData(String nestedTable) {'
+                content << ''
+                content << "        throw new RuntimeException(\"Nested metadata not available for #{embedded}#{class_name}. This method should never be called manually.\");"
+                content << '    }'
+            end
+            content << '}'
+            content
+        end
+    end
+
+end

data/lib/core/yml/yml_outputter.rb

@@ -0,0 +1,307 @@
+module Blufin
+
+    class YmlOutputter
+
+        include Columnist
+
+        AUTO = 'AUTO'
+        CUSTOM = 'CUSTOM'
+        SYSTEM = 'SYSTEM'
+
+        def initialize(site)
+
+            @site = Blufin::SiteResolver::validate_site(site)
+
+            @auto_increment = []
+            @auto_increment_indexed = []
+
+            @resources = []
+
+            @schema_fks_links = {}
+
+            @yml_enum_scanner = Blufin::ScannerJavaEnums.new(@site)
+
+        end
+
+        # Renders the AUTO_INCREMENT table.
+        # @return void
+        def show_auto_increment
+
+            cnt = 0
+            max = [@auto_increment.length, @auto_increment_indexed.length].max.to_i
+
+            Blufin::Terminal::custom('SUMMARY', 23, Blufin::YmlSchemaValidator::FLAG_AUTO_INCREMENT, "Below you can see which tables have what #{Blufin::Terminal::format_highlight(Blufin::YmlSchemaValidator::FLAG_AUTO_INCREMENT)} values applied")
+
+            table(:border => false) do
+
+                row do
+                    column('', :width => 4)
+                    column('AUTO_INCREMENT', :width => 60, :color => 34)
+                    column('AUTO_INCREMENT(?)', :width => 60, :color => 34)
+                end
+
+                while cnt + 1 < max
+                    row do
+                        column('')
+                        column(@auto_increment[cnt], :color => 240)
+                        column(@auto_increment_indexed[cnt], :color => 240)
+                    end
+                    cnt = cnt + 1
+                end
+
+            end
+
+            puts "\x1B[0m"
+        end
+
+        # Renders a summary of all enums that are available (including their possible values).
+        # @return void
+        def show_enums
+
+            terminal_width = Blufin::Terminal::get_terminal_width
+
+            Blufin::Terminal::error('Cannot display data because terminal window is too narrow.', ["Current width is: #{Blufin::Terminal::format_highlight(terminal_width)}", "Minimum width is: #{Blufin::Terminal::format_highlight('90')}"], true) if terminal_width < 90 && all
+            Blufin::Terminal::custom('SUMMARY', 58, 'ENUMS', "Below is a list of all available #{Blufin::Terminal::format_highlight('ENUMS')} for \x1B[38;5;106m#{Blufin::SiteResolver::get_site_title(@site)}\x1B[0m.")
+
+            terminal_width = Blufin::Terminal::get_terminal_width
+
+            all_enums = []
+
+            auto_enums = @yml_enum_scanner.get_auto_enums
+            custom_enums = @yml_enum_scanner.get_custom_enums
+            system_enums = @yml_enum_scanner.get_system_enums
+
+            auto_enums.keys.each { |enum| all_enums << enum }
+            custom_enums.keys.each { |enum| all_enums << enum }
+            system_enums.keys.each { |enum| all_enums << enum }
+
+            max_enum_width = all_enums.max_by(&:length).length
+            value_column_max_width = terminal_width - 30 - max_enum_width
+
+            enum_column_width = ((max_enum_width + 5) < 10) ? 10 : (max_enum_width + 5)
+
+            table(:border => false) do
+
+                row do
+                    column('', :width => 17, :align => 'right')
+                    column('', :width => 1, :color => 255)
+                    column('', :width => enum_column_width, :color => 240, :align => 'left')
+                    column('', :width => value_column_max_width)
+                end
+
+                show_enums_common_table(custom_enums, value_column_max_width, AUTO)
+                show_enums_common_table(auto_enums, value_column_max_width, CUSTOM)
+                show_enums_common_table(system_enums, value_column_max_width, SYSTEM)
+
+            end
+
+
+        end
+
+        # Renders a summary of all resource end-points exposed by the API.
+        # @return void
+        def show_resources(as_json = false)
+
+            if @resources.any?
+
+                if as_json
+
+                    puts @resources.inspect
+
+                else
+
+                    width_schema = []
+                    width_group = []
+                    width_resource = []
+                    width_type = []
+
+                    # Get column widths (to make as narrow as possible).
+                    @resources.each do |data|
+                        data.each do |key, resource|
+                            width_schema << resource[:schema].length
+                            width_group << resource[:resource].split('/')[0].length
+                            width_resource << resource[:resource].length
+                            width_type << resource[:type].length
+                        end
+                    end
+
+                    Blufin::Terminal::custom('SUMMARY', 161, 'RESOURCES', "Below is a summary of the final #{Blufin::Terminal::format_highlight('RESOURCE STRUCTURE')}")
+
+                    table(:border => false) do
+
+                        current_group = nil
+
+                        @resources.each do |data|
+
+                            data.each do |key, resource|
+
+                                group = resource[:resource].split('/')[0]
+                                extra = ''
+                                extra_color = 240
+
+                                case resource[:type]
+                                    when Blufin::YmlSchemaValidator::RESOURCE_TYPE_PARENT
+                                        type_text = "\xe2\x80\x94"
+                                        type_color = 240
+                                    when Blufin::YmlSchemaValidator::RESOURCE_TYPE_OBJECT
+                                        type_text = Blufin::YmlSchemaValidator::RESOURCE_TYPE_OBJECT
+                                        type_color = 147
+                                    when Blufin::YmlSchemaValidator::RESOURCE_TYPE_OBJECT_LIST
+                                        type_text = Blufin::YmlSchemaValidator::RESOURCE_TYPE_OBJECT_LIST
+                                        type_color = 197
+                                    when Blufin::YmlSchemaValidator::RESOURCE_TYPE_OBJECT_LINK
+                                        type_text = Blufin::YmlSchemaValidator::RESOURCE_TYPE_OBJECT_LINK
+                                        type_color = 118
+                                    else
+                                        raise RuntimeError, "Type not found in \xe2\x86\x92 show_resources()."
+                                end
+
+                                # If this is a LINKED table, show list of tables where it's referenced from.
+                                if resource[:type] == Blufin::YmlSchemaValidator::RESOURCE_TYPE_OBJECT_LINK
+                                    unless @schema_fks_links[key].nil?
+                                        extra = []
+                                        @schema_fks_links[key].each do |table|
+                                            extra << table.split('.')[1]
+                                        end
+                                        extra = "\xe2\x86\x92 #{extra.join(', ')}"
+                                        extra_color = 220
+                                    end
+                                end
+
+                                row do
+                                    column((group != current_group) ? "#{resource[:schema]} \xe2\x86\x92" : '', :color => 250, :width => (width_schema.max.to_i) + 4, :align => 'right')
+                                    column((group != current_group) ? group : '', :color => 154, :width => (width_group.max.to_i) + 2)
+                                    column(resource[:resource], :color => 240, :width => (width_resource.max.to_i) + 2)
+                                    column("#{type_text}", :color => type_color, :width => width_type.max.to_i, :align => 'right')
+                                    column(extra, :color => extra_color, :width => 100)
+                                end
+
+                                current_group = group
+                                current_schema = resource[:schema]
+
+                            end
+
+                        end
+
+                        row do
+                            column('')
+                            column('')
+                            column('')
+                            column('')
+                            column('')
+                        end
+
+                    end
+
+                end
+
+            end
+
+        end
+
+        def add_auto_increment_table(schema, table)
+            @auto_increment << "#{schema}.#{table}"
+        end
+
+        def add_auto_increment_indexed_table(schema, table, amount)
+            @auto_increment_indexed << "(#{amount}) \xe2\x86\x92 #{schema}.#{table}"
+        end
+
+        def add_resource(key, data)
+            @resources << {key => data}
+        end
+
+        def set_schema_fks_links(hash)
+            @schema_fks_links = hash
+        end
+
+        private
+
+        def show_enums_common_table(enum_hash, value_column_width, type)
+
+            case type
+                when AUTO
+                    text_type = 'ENUM_AUTO'
+                    color_one = 97
+                    color_two = 183
+                when CUSTOM
+                    text_type = 'ENUM_CUSTOM'
+                    color_one = 34
+                    color_two = 118
+                when SYSTEM
+                    text_type = 'ENUM_SYSTEM'
+                    color_one = 31
+                    color_two = 153
+                else
+                    raise RuntimeError, "Unrecognized enum type: #{type}"
+            end
+
+
+            enum_hash.each do |enum, values|
+
+                vals = values.dup
+                vals_all = []
+                row_output = []
+                vals_per_row = vals.length.to_f
+
+                vals.each { |val| vals_all << val }
+
+                next unless vals_all.any?
+
+                # The length of the longest ENUM value (plus 2) -- rounded up to nearest 5.
+                vals_max = vals_all.max_by(&:length).length + 2
+                vals_max = vals_max + (5 - (vals_max % 5)) if (vals_max % 5) > 0
+
+                # The maximum number of values we can have in a row before we run out of Terminal.
+                cols_max = (value_column_width / vals_max).to_f
+
+                while vals_per_row > cols_max do
+                    vals_per_row = vals_per_row / 2
+                end
+
+                number_of_rows = (vals.length / vals_per_row).to_i
+
+                raise RuntimeError, '(number_of_rows * vals_per_row) should not be less than vals.length' if (number_of_rows * vals_per_row) < vals.length
+
+                number_of_rows.times do
+                    output = ''
+                    vals_per_row.ceil.times do
+                        output << vals.shift.to_s.ljust(vals_max, ' ')
+                    end
+                    row_output << output if output.strip.length > 0
+                end
+
+                row do
+                    column(text_type, :color => color_one)
+                    column('→')
+                    column("#{enum} ", :color => color_two)
+                    column(row_output[0], :color => 244)
+                end
+
+                row_output.shift
+
+                if row_output.length > 1
+                    row_output.each do |val|
+                        row do
+                            column('')
+                            column('')
+                            column('')
+                            column(val, :color => 244)
+                        end
+                    end
+                end
+
+                row do
+                    column('')
+                    column('')
+                    column('')
+                    column('')
+                end
+
+            end
+
+        end
+
+    end
+
+end