true_table 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de3dc5997b4c8ebd6995d960924a0e40212bd2d276b0bc86dd212cbd3202686c
-  data.tar.gz: 8b2c0a8b433450c0b35672efd948309c88f41c9579884abbe85d251cf6a1398f
+  metadata.gz: 9c778d54af435cbd53a4dfc45df1026d954dd79fda06c12ca7de9c5203054bd5
+  data.tar.gz: ecb8c574d6f53b7936cf7c668e55050f4effee32063922b92605200f48569d94
 SHA512:
-  metadata.gz: 836d46c004f4b660928684a5860f34378dda5157dec22b0fd2cb100750b4761fcab619e390adc650aba00f069d6517cc1e61afac94d8dabcde3be977cddc9dfa
-  data.tar.gz: afffb78d4d731c67164ce9731f1dc8e5eef80a9d7f4902e528a6d2beb28ee87d9d670e96fe5baa4410609f2edf893c7be7eb6551d9674cff69c3154e13f46e65
+  metadata.gz: 9cc7983ee8202a8ce1c1e4414dc5e5a2c34f5ed4e70c2789e2c940c325431cb1034d99ddaaae6c11e7771b993b8f0f747c3e3a7a792445b22f6376573e02b638
+  data.tar.gz: 3f2e42e7b50716d0e93e0676fd7c161a8e6bab1962c50358b734fb301d7b967785acaa7db79382a1b70fffce28c54d6ed9e1e27a88e45c237db717c2ddca6ed5

data/README.md

@@ -5,7 +5,8 @@
 
 ---
 
-Simple and intuitive tabular data type, which is an Array of Hashes.
+Simple and intuitive tabular data type, which is a subclass of `Array` where
+each row is a `Hash`.
 
 ---
 

data/lib/true_table/table.rb

@@ -7,7 +7,7 @@ module TrueTable
       result
     end
 
-    # Returns a new table without specified columns
+    # Returns a new table without the specified columns
     def -(cols)
       keep_keys = headers - cols
       result = self.class.new
@@ -17,12 +17,17 @@ module TrueTable
 
     # Returns a row or a column
     def [](key)
-      key.is_a?(Symbol) || key.is_a?(String) ? col(key.to_sym) : super
+      key.is_a?(Symbol) ? col(key) : 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
+      key.is_a?(Symbol) ? add_col(key.to_sym, value) : super
+    end
+
+    # Returns a deep copy of self
+    def clone
+      self.class.new map(&:clone)
     end
 
     # Returns a column as Array
@@ -69,7 +74,7 @@ module TrueTable
     # Extracts nested value. Accepts row, column or column, row
     def dig(*indexes)
       key = indexes.shift
-      if key.is_a?(Symbol) || key.is_a?(String)
+      if key.is_a?(Symbol)
         col(key.to_sym).dig *indexes
       else
         row(key).dig *indexes
@@ -84,6 +89,22 @@ module TrueTable
     # Iterates over rows
     alias each_row each_with_index
 
+    def fetch(key, *default)
+      if key.is_a?(Symbol)
+        if headers.include? key
+          col(key.to_sym)
+        elsif default.any?
+          default.first
+        elsif block_given?
+          yield key
+        else
+          raise IndexError, "row :#{key} does not exist"
+        end
+      else
+        super
+      end
+    end
+
     # Returns an array of column headers
     def headers
       first.keys
@@ -119,6 +140,11 @@ module TrueTable
       self.class.new super
     end
 
+    # Returns a new table with the element at `count` as the first element
+    def rotate(count = 1)
+      self.class.new super
+    end
+
     # Returns a row
     alias row []
 
@@ -128,6 +154,11 @@ module TrueTable
     end
     alias filter select
 
+    # Returns a new shuffled tables
+    def shuffle(*args)
+      self.class.new super
+    end
+
     # Returns a new sorted table
     def sort
       self.class.new super
@@ -143,6 +174,12 @@ module TrueTable
       join(row_separator, col_separator, with_headers: true)
     end
 
+    # Returns a hash representation of the table using the values of the
+    # first column as hash keys
+    def to_h
+      map { |row| [row.values.first, row] }.to_h
+    end
+
     # Returns only values, without any headers (array of arrays)
     def values
       map { |row| row.values }

data/lib/true_table/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: true_table
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Danny Ben Shitrit
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-08-03 00:00:00.000000000 Z
+date: 2020-09-06 00:00:00.000000000 Z
 dependencies: []
 description: Simple and intuitive tabular data type
 email: db@dannyben.com
@@ -32,7 +32,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="