matt-harvey/tabulo

View on GitHub
lib/tabulo/row.rb

Summary

Maintainability
A
0 mins
Test Coverage
module Tabulo

  class Row
    include Enumerable

    # @return the element of the {Table}'s underlying enumerable to which this {Row} corresponds
    attr_reader :source

    # @!visibility private
    def initialize(table, source, divider:, header:, index:)
      @table = table
      @source = source
      @divider = divider
      @header = header
      @index = index
    end

    # Calls the given block once for each {Cell} in the {Row}, passing that {Cell} as parameter.
    #
    # @example
    #   table = Tabulo::Table.new([1, 10], columns: %i(itself even?))
    #   row = table.first
    #   row.each do |cell|
    #     puts cell.value   # => 1,       => false
    #   end
    def each
      @table.column_registry.each_with_index do |(_, column), column_index|
        yield column.body_cell(@source, row_index: @index, column_index: column_index)
      end
    end

    # @return a String being an "ASCII" graphical representation of the {Row}, including
    #   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, divider: @divider, header: @header, index: @index)
      else
        ""
      end
    end

    # @return a Hash representation of the {Row}, with column labels acting as keys and the {Cell}s the values.
    def to_h
      @table.column_registry.map.with_index do |(label, column), column_index|
        [label, column.body_cell(@source, row_index: @index, column_index: column_index)]
      end.to_h
    end
  end
end