table_transform 0.1.0

data/.ruby-gemset

@@ -0,0 +1 @@
+tabletransform

data/.ruby-version

@@ -0,0 +1 @@
+2.2.2

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.2.2

data/CHANGELOG.md

@@ -0,0 +1,14 @@
+# TableTransform change log
+
+All notable changes to this project will be documented in this file.
+
+TableTransform is still in pre-release state. This means that its APIs and behavior are subject to breaking changes without deprecation notices. Until 1.0, version numbers will follow a [Semver][]-ish `0.y.z` format, where `y` is incremented when new features or breaking changes are introduced, and `z` is incremented for lesser changes or bug fixes.
+
+## [Unreleased]
+
+## 0.1.0 (2016-02-10)
+
+* Initial release including Table
+
+[Semver]: http://semver.org
+[Unreleased]: https://github.com/jonas-lantto/table_transform/compare/v0.1.0...HEAD

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in table_transform.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Jonas Lantto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,69 @@
+# TableTransform
+[![Gem Version](https://badge.fury.io/rb/table_transform.svg)](http://badge.fury.io/rb/table_transform)
+[![Build Status](https://travis-ci.org/jonas-lantto/table_transform.svg)](https://travis-ci.org/jonas-lantto/table_transform)
+[![Code Climate](https://codeclimate.com/github/jonas-lantto/table_transform/badges/gpa.svg)](https://codeclimate.com/github/jonas-lantto/table_transform)
+
+Utility to work with csv type data in a name safe environment with utilities to transform data
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'table_transform'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install table_transform
+
+## Usage
+
+### Create and populate
+
+    # Create from file
+    t = TableTransform::Table::create_from_file('data.csv')
+
+    # Create empty table with given column names 
+    t = TableTransform::Table::create_empty(%w(Col1 Col2))
+    t << {'Col1' => 1, 'Col2' => 2}
+
+    # Create from an array of arrays. First row column names
+    data = [ %w(Name Age), %w(Jane 22)]
+    t = TableTransform::Table.new(data)
+
+### Work with the table
+    # Add a new column to the far right
+    t.add_column('NameLength'){|row| row['Name'].size}
+
+    # Change values in existing column
+    t.change_column('Age'){|row| row['Age'].to_i}
+    
+    # Will remove given columns. One or several can be specified.
+    t.delete_column('Name', 'Address')
+    
+    # Create a new Table with given column in specified order
+    t.extract(%w(Length Name))
+    
+    # Filter table 
+    t.filter{|row| row['Age].to_i > 20}
+
+    # Adds rows of two tables with same header
+    t1 = TableTransform::Table::create_empty(%w(Col1 Col2))
+    t2 = TableTransform::Table::create_empty(%w(Col1 Col2))
+    t3 = t1 + t2
+    
+    # Export as array
+    t.to_a
+    
+## Contributing
+
+Bug reports and pull requests are welcome on [GitHub](https://github.com/jonas-lantto/table_transform).
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,13 @@
+#!/usr/bin/env rake
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+task :default => [:test]
+
+desc 'Run all tests'
+Rake::TestTask.new(:test) { |t|
+  t.libs << 'lib'
+  t.test_files = FileList['test/*_test.rb']
+  t.verbose = true
+  t.warning = true
+}

data/lib/table_transform.rb

@@ -0,0 +1,3 @@
+require 'table_transform/version'
+require 'table_transform/table'
+

data/lib/table_transform/table.rb

@@ -0,0 +1,140 @@
+require 'csv'
+
+module TableTransform
+  module Util
+    def self.get_col_index(col_name, data)
+      data[col_name] || (raise "No column with name '#{col_name}' exists")
+    end
+  end
+
+  class Table
+    def self.create_from_file(file_name, sep = ',')
+      rows = CSV.read(file_name, { :col_sep => sep })
+      raise "'#{file_name}' contains no data" if rows.empty?
+
+      Table.new(rows)
+    end
+
+    def self.create_empty(header)
+      raise 'Table header need to be array' unless header.is_a? Array
+      raise 'Table, No header defined' if header.empty?
+      Table.new([header])
+    end
+
+    # @throws if column names not unique
+    # @throws if column size for each row match
+    def initialize(rows)
+      @data_rows = rows.clone
+      @header = @data_rows.shift
+      @column_indexes = create_column_name_binding(@header)
+
+      #validate header uniqueness
+      dup = @header.select{ |e| @header.count(e) > 1 }.uniq
+      raise "Column #{dup.map{|x| "'#{x}'"}.join(' and ')} not unique" if dup.size > 0
+
+      #validate column size
+      @data_rows.each_with_index {|x, index| raise "Column size mismatch. On row #{index+1}. Size #{x.size} expected to be #{@header.size}" if @header.size != x.size}
+    end
+
+    def << (hash_values)
+      @data_rows << create_row(hash_values)
+      self
+    end
+
+    # Add two tables
+    # @throws if header do not match
+    def +(table)
+      t2 = table.to_a
+      t2_header = t2.shift
+      raise 'Tables cannot be added due to header mismatch' if @header != t2_header
+      TableTransform::Table.new(self.to_a + t2)
+    end
+
+    def each_row
+      @data_rows.each{|x|
+        yield Row.new(@column_indexes, x)
+      }
+    end
+
+    # @returns array of data arrays including header row
+    def to_a
+      res = @data_rows.clone
+      res.unshift @header
+    end
+
+    # @returns new table with specified columns specified in given header
+    def extract(header)
+      selected_cols = header.inject([]) { |res, c| res << Util::get_col_index(c, @column_indexes) }
+      Table.new( @data_rows.inject([header]) {|res, row| (res << row.values_at(*selected_cols))} )
+    end
+
+    # @returns new table with rows that match given block
+    def filter
+      Table.new( @data_rows.select {|row| yield Row.new(@column_indexes, row)}.unshift @header.clone )
+    end
+
+    #adds a column with given name to the far right of the table
+    #@throws if given column name already exists
+    def add_column(name)
+      raise "Column '#{name}' already exists" if @header.include?(name)
+      @header << name
+      @data_rows.each{|x|
+        x << (yield Row.new(@column_indexes, x))
+      }
+      @column_indexes[name] = @column_indexes.size
+      self # enable chaining
+    end
+
+    def change_column(name)
+      index = Util::get_col_index(name, @column_indexes)
+      @data_rows.each{|r|
+        r[index] = yield Row.new(@column_indexes, r)
+      }
+      self # enable chaining
+    end
+
+    def delete_column(*names)
+      delete_indexes = names.inject([]){|res, n| res << Util::get_col_index(n, @column_indexes)}
+      delete_indexes.sort!.reverse!
+      delete_indexes.each{|i| @header.delete_at(i)}
+
+      selected_cols = @header.inject([]) { |res, c| res << Util::get_col_index(c, @column_indexes) }
+      @data_rows.map!{|row| row.values_at(*selected_cols)}
+
+      @column_indexes = create_column_name_binding(@header)
+      self
+    end
+
+    class Row
+
+      def initialize(cols, row)
+        @cols = cols #column name and index in row
+        @row  = row  #Specific row
+      end
+
+      # @returns row value with column name or empty string if it does not exist
+      # @throws exception if column name does not exist
+      def [](column_name)
+        index = Util::get_col_index(column_name, @cols)
+        Cell.new @row[ index ].to_s || ''
+      end
+
+    end
+
+    class Cell < String
+      # @returns true if this cell includes any of the given values in list
+      def include_any?(list)
+        list.inject(false){|res, x| res | (self.include? x)}
+      end
+    end
+
+    private
+      def create_column_name_binding(header_row)
+        header_row.map.with_index{ |x, i| [x, i] }.to_h
+      end
+
+      def create_row(hash_values)
+        @header.inject([]) { |row, col| row << hash_values.fetch(col){raise "Value for column '#{col}' could not be found"} }
+      end
+  end
+end

data/lib/table_transform/version.rb

@@ -0,0 +1,3 @@
+module TableTransform
+  VERSION = '0.1.0'
+end

data/table_transform.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'table_transform/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'table_transform'
+  spec.version       = TableTransform::VERSION
+  spec.authors       = ['Jonas Lantto']
+  spec.email         = ['j@lantto.net']
+
+  spec.summary       = %q{Utility to work with csv type data in a name safe environment with utilities to transform data}
+  spec.description   = %q{}
+  spec.homepage      = 'https://github.com/jonas-lantto/table_transform'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.10'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'minitest', '~> 5.0'
+end

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification
+name: table_transform
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jonas Lantto
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-02-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: ''
+email:
+- j@lantto.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".codeclimate.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- ".ruby-gemset"
+- ".ruby-version"
+- ".travis.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/table_transform.rb
+- lib/table_transform/table.rb
+- lib/table_transform/version.rb
+- table_transform.gemspec
+homepage: https://github.com/jonas-lantto/table_transform
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Utility to work with csv type data in a name safe environment with utilities
+  to transform data
+test_files: []