true_table 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: de3dc5997b4c8ebd6995d960924a0e40212bd2d276b0bc86dd212cbd3202686c
+  data.tar.gz: 8b2c0a8b433450c0b35672efd948309c88f41c9579884abbe85d251cf6a1398f
+SHA512:
+  metadata.gz: 836d46c004f4b660928684a5860f34378dda5157dec22b0fd2cb100750b4761fcab619e390adc650aba00f069d6517cc1e61afac94d8dabcde3be977cddc9dfa
+  data.tar.gz: afffb78d4d731c67164ce9731f1dc8e5eef80a9d7f4902e528a6d2beb28ee87d9d670e96fe5baa4410609f2edf893c7be7eb6551d9674cff69c3154e13f46e65

data/README.md

@@ -0,0 +1,20 @@
+# True Table
+
+[![Gem Version](https://badge.fury.io/rb/true_table.svg)](https://badge.fury.io/rb/true_table)
+[![Build Status](https://github.com/DannyBen/true_table/workflows/Test/badge.svg)](https://github.com/DannyBen/true_table/actions?query=workflow%3ATest)
+
+---
+
+Simple and intuitive tabular data type, which is an Array of Hashes.
+
+---
+
+## Installation
+
+```
+$ gem install true_table
+```
+
+## Usage
+
+TODO

data/lib/true_table.rb

@@ -0,0 +1,2 @@
+require 'true_table/table'
+require 'byebug' if ENV['BYEBUG']

data/lib/true_table/table.rb

@@ -0,0 +1,161 @@
+module TrueTable
+  class Table < Array
+    # Combines table with other and returns a new one
+    def +(other)
+      result = self.class.new
+      each_row { |row, i| result << row.merge(other[i]) }
+      result
+    end
+
+    # Returns a new table without specified columns
+    def -(cols)
+      keep_keys = headers - cols
+      result = self.class.new
+      each_row { |row, i| result << row.slice(*keep_keys) }
+      result
+    end
+
+    # Returns a row or a column
+    def [](key)
+      key.is_a?(Symbol) || key.is_a?(String) ? col(key.to_sym) : super
+    end
+
+    # Adds or updates a row or a column
+    def []=(key, value)
+      key.is_a?(Symbol) || key.is_a?(String) ? add_col(key.to_sym, value) : super
+    end
+
+    # Returns a column as Array
+    def col(key)
+      map { |row| row[key] }
+    end
+
+    # Returns a hash of columns
+    def cols
+      result = {}
+      each_col { |col, header| result[header] = col }
+      result
+    end
+
+    # Returns a copy of self without rows that contain nil in any column
+    def compact
+      dup.compact!
+    end
+
+    # Removes rows with nil in any column
+    def compact!
+      delete_if { |row| row.values.include? nil }
+    end
+
+    # Delete a row or a column in place and returns the deleted row/column
+    def delete_at(index)
+      if index.is_a?(Symbol) || index.is_a?(String)
+        result = self[index]
+        return nil unless result
+        each_row { |row, i| row.delete index }
+        result
+      else
+        super
+      end
+    end
+    alias delete_col delete_at
+    alias delete_row delete_at
+
+    # Returns a table with different rows
+    def difference(*others)
+      self.class.new super
+    end
+
+    # Extracts nested value. Accepts row, column or column, row
+    def dig(*indexes)
+      key = indexes.shift
+      if key.is_a?(Symbol) || key.is_a?(String)
+        col(key.to_sym).dig *indexes
+      else
+        row(key).dig *indexes
+      end
+    end
+
+    # Iterates over columns
+    def each_col
+      headers.each { |header| yield col(header), header }
+    end
+
+    # Iterates over rows
+    alias each_row each_with_index
+
+    # Returns an array of column headers
+    def headers
+      first.keys
+    end
+
+    # Returns a new table with intersecting rows
+    def intersection(*others)
+      self.class.new super
+    end
+
+    # Returns a string with joined rows and columns
+    def join(row_separator = $,, col_separator = nil, with_headers: false)
+      if col_separator
+        result = map { |row| row.values.join col_separator }.join(row_separator)
+        with_headers ? headers.join(col_separator) + row_separator + result : result
+      else
+        super row_separator
+      end
+    end
+
+    # Returns the last row or a new table with the last N rows
+    def last(*args)
+      args.empty? ? super : self.class.new(super)
+    end
+
+    # Returns a new table without rejected rows
+    def reject
+      self.class.new super
+    end
+
+    # Returns a reversed copy
+    def reverse
+      self.class.new super
+    end
+
+    # Returns a row
+    alias row []
+
+    # Returns a new table with selected rows
+    def select
+      self.class.new super
+    end
+    alias filter select
+
+    # Returns a new sorted table
+    def sort
+      self.class.new super
+    end
+
+    # Returns a new sorted table
+    def sort_by
+      self.class.new super
+    end
+
+    # Returns a CSV string
+    def to_csv(row_separator = "\n", col_separator = ",")
+      join(row_separator, col_separator, with_headers: true)
+    end
+
+    # Returns only values, without any headers (array of arrays)
+    def values
+      map { |row| row.values }
+    end
+
+  protected
+
+    def add_col(key, values)
+      values.each_with_index do |value, i|
+        self[i] ||= {}
+        self[i][key] = value
+      end
+    end
+
+  end
+end

data/lib/true_table/version.rb

@@ -0,0 +1,3 @@
+module TrueTable
+  VERSION = "0.1.1"
+end

metadata

@@ -0,0 +1,46 @@
+--- !ruby/object:Gem::Specification
+name: true_table
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Danny Ben Shitrit
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-08-03 00:00:00.000000000 Z
+dependencies: []
+description: Simple and intuitive tabular data type
+email: db@dannyben.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/true_table.rb
+- lib/true_table/table.rb
+- lib/true_table/version.rb
+homepage: https://github.com/dannyben/true_table
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: Simple and intuitive tabular data type
+test_files: []