compact_csv 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3dbb0962e7cbb7f04777000bc6e2534701939eb0
+  data.tar.gz: 420a6b3f16eccce240928c540b5976894608065e
+SHA512:
+  metadata.gz: a07ff8599a91e282ce914db8eab092fd9ba7756e473e7a8e2010bd3ef33024ecb279aea64c545a54803f917eaa59ea534e2c39606db392f7c6af4ab7776ab8da
+  data.tar.gz: 9ef10c138a4e98d5c5090bcbbd3dea25d34a91cadc3aa431b96830e769f14a5197423c7a865953ca3a923570abf7afe811ded03e076d2c28448c6920dd6c7eba

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.ruby-version

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

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

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 NAKANO Ryusuke
+
+MIT License
+
+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,46 @@
+# CompactCSV
+
+[![Build Status](https://travis-ci.org/rnakano/compact_csv.svg?branch=master)](https://travis-ci.org/rnakano/compact_csv)
+[![Coverage Status](https://coveralls.io/repos/rnakano/compact_csv/badge.svg?branch=master&service=github)](https://coveralls.io/github/rnakano/compact_csv?branch=master)
+[![Dependency Status](https://gemnasium.com/rnakano/compact_csv.svg)](https://gemnasium.com/rnakano/compact_csv)
+
+CompactCSV is memory efficient csv module for ruby. Reading operations are compatible with default CSV module.
+
+However, operations which change fields/values structure of row are not available in CompactCSV. If you want to do this, please use default CSV module.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'compact_csv'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install compact_csv
+
+## Usage
+
+```ruby
+csv = CompactCSV.read('sample.csv', headers: true)
+csv.each do |row|
+  p row # => #<CompactCSV::Row "ID":"1" "VALUE":"A">
+  row['VALUE'] = 'AAA'
+  p row # => #<CompactCSV::Row "ID":"1" "VALUE":"AAA">
+end
+```
+
+## Links
+
+* ruby default CSV module: https://github.com/ruby/ruby/blob/trunk/lib/csv.rb
+
+## Contributing
+
+1. Fork it ( http://github.com/rnakano/compact_csv/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/compact_csv.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'compact_csv/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "compact_csv"
+  spec.version       = VERSION
+  spec.authors       = ["NAKANO Ryusuke"]
+  spec.email         = ["rsk.nakano@gmail.com"]
+  spec.summary       = %q{Memory efficient CSV}
+  spec.description   = %q{Memory efficient CSV}
+  spec.homepage      = "https://github.com/rnakano/compact_csv"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "coveralls"
+end

data/lib/compact_csv/version.rb

@@ -0,0 +1 @@
+VERSION = "0.0.1"

data/lib/compact_csv.rb

@@ -0,0 +1,146 @@
+require 'csv'
+
+class CompactCSV < CSV
+  require_relative 'compact_csv/version'
+
+  class CompatibilityError < StandardError
+  end
+
+  class Table < CSV::Table
+  end
+
+  class Row < CSV::Row
+    def initialize(headers, fields, header_row = false)
+      headers.freeze
+      @headers = headers
+      @row_values = fields
+    end
+
+    def headers
+      @headers
+    end
+
+    def row
+      if @headers.size >= @row_values.size
+        @headers.zip(@row_values).to_a
+      else
+        @row_values.zip(@headers).map { |pair| pair.reverse! }
+      end
+    end
+
+    def header_row?
+      false
+    end
+
+    def each(&block)
+      row.each(&block)
+      self
+    end
+
+    def fields(*headers_and_or_indices)
+      if headers_and_or_indices.empty?
+        size_diff = @headers.size - @row_values.size
+        if size_diff <= 0
+          @row_values
+        elsif size_diff > 0
+          @row_values + Array.new(size_diff, nil)
+        end
+      else
+        headers_and_or_indices.map do |index|
+          field(index)
+        end
+      end
+    end
+
+    def size
+      [ @row_values.size, @headers.size ].max
+    end
+    alias_method :length, :size
+
+    def empty?
+      @row_values.empty?
+    end
+
+    def fetch(header, *varargs)
+      raise ArgumentError, "Too many arguments" if varargs.length > 1
+      pair = row.assoc(header)
+      if pair
+        pair.last
+      else
+        if block_given?
+          yield header
+        elsif varargs.empty?
+          raise KeyError, "key not found: #{header}"
+        else
+          varargs.first
+        end
+      end
+    end
+
+    def has_key?(header)
+      !!row.assoc(header)
+    end
+
+    def [](index)
+      if index.is_a?(Integer)
+        @row_values[index]
+      else
+        i = headers.find_index(index)
+        i ? @row_values[i] : nil
+      end
+    end
+    alias_method :field, :[]
+
+    def []=(index, value)
+      if index.is_a?(Integer)
+        @row_values[index] = value
+      else
+        i = headers.find_index(index)
+        @row_values[i] = value if i
+      end
+    end
+
+    def to_hash
+      hash = {}
+      @row_values.zip(headers) do |value, row|
+        hash[row] = value
+      end
+      hash
+    end
+
+    def ==(other)
+      return row == other.row if other.is_a? CompactCSV::Row
+      row == other
+    end
+
+    # not compatible methods
+    def <<(arg)
+      raise CompatibilityError.new("CompactCSV does not allow to append fields into row. Please use CSV module.")
+    end
+
+    def push(*args)
+      raise CompatibilityError.new("CompactCSV does not allow to append fields into row. Please use CSV module.")
+    end
+
+    def delete(header_or_index, minimum_index = 0)
+      raise CompatibilityError.new("CompactCSV does not allow to delete fields from row. Please use CSV module.")
+    end
+
+    def delete_if(&block)
+      raise CompatibilityError.new("CompactCSV does not allow to delete fields from row. Please use CSV module.")
+    end
+  end
+
+  def read
+    rows = to_a
+    if @use_headers
+      CompactCSV::Table.new(rows)
+    else
+      rows
+    end
+  end
+end
+
+def CompactCSV(*args, &block)
+  CompactCSV.instance(*args, &block)
+end

data/spec/compact_csv_spec.rb

@@ -0,0 +1,156 @@
+require 'spec_helper'
+
+describe CompactCSV do
+  it 'should have a version number' do
+    expect(CompactCSV::VERSION).not_to be nil
+  end
+
+  describe '.read' do
+    let(:csv_path) { './spec/data/sample.csv' }
+
+    it 'loads Array instance from csv file' do
+      csv = CompactCSV.read(csv_path)
+      expect(csv).to be_instance_of(Array)
+    end
+
+    it 'loads CompactCSV::Table instance from csv file' do
+      csv = CompactCSV.read(csv_path, headers: true)
+      expect(csv).to be_instance_of(CompactCSV::Table)
+      expect(csv).to be_kind_of(CSV::Table)
+    end
+  end
+end
+
+describe CompactCSV::Table do
+  describe '#each' do
+    let(:csv) { CompactCSV.read('./spec/data/sample.csv', headers: true) }
+
+    it 'returns rows iterator' do
+      csv.each do |row|
+        expect(row).to be_instance_of(CompactCSV::Row)
+      end
+    end
+  end
+end
+
+describe CompactCSV::Row do
+  let(:csv) { CompactCSV.read('./spec/data/sample.csv', headers: true) }
+  let(:row) { csv.each.first }
+
+  describe '#each' do
+    it 'returns fields iterator' do
+      row.each do |field|
+        expect(field).to be_instance_of(Array)
+      end
+    end
+  end
+
+  describe '#field' do
+    it 'reads field value' do
+      expect(row['ID']).to eq '1'
+      expect(row[0]).to eq '1'
+      expect(row['VALUE']).to eq 'A'
+      expect(row[1]).to eq 'A'
+    end
+  end
+
+  describe '#fields' do
+    it 'returns fileds of array' do
+      expect(row.fields).to eq ['1', 'A']
+    end
+
+    it 'returns specific fields of array' do
+      expect(row.fields('VALUE')).to eq ['A']
+    end
+  end
+
+  describe '#size' do
+    it 'returns size of fields' do
+      expect(row.size).to be 2
+    end
+  end
+
+  describe '#to_hash' do
+    it 'returns hash form' do
+      expect(row.to_hash).to eq({ 'ID' => '1', 'VALUE' => 'A' })
+    end
+  end
+
+  describe '#empty?' do
+    it 'returns true if values empty' do
+      expect(CompactCSV::Row.new([], []).empty?).to be true
+    end
+
+    it 'returns flase if values exist' do
+      expect(row.empty?).to be false
+    end
+  end
+
+  describe '#fetch' do
+    it 'returns value if field exists' do
+      expect(row.fetch('VALUE')).to eq 'A'
+    end
+
+    it 'throw KeyError if field does not exist' do
+      expect { row.fetch('value') }.to raise_error(KeyError)
+    end
+
+    it 'returns varags if field does not exist' do
+      expect(row.fetch('value', 1)).to be 1
+    end
+  end
+
+  describe '#has_key?' do
+    it 'returns true if field exists' do
+      expect(row.has_key?('ID')).to be true
+    end
+
+    it 'returns false if field does not exist' do
+      expect(row.has_key?('id')).to be false
+    end
+  end
+
+  describe '#[]=' do
+    it 'change field value' do
+      modify_row = row.dup
+      modify_row['VALUE'] = 'AAA'
+      expect(modify_row.fields).to eq ['1', 'AAA']
+    end
+  end
+
+  describe '#==' do
+    it 'returns true with same object' do
+      expect(row == row).to be true
+    end
+
+    it 'returns false with other object' do
+      dirty_row = row.dup
+      dirty_row['VALUE'] = 'B'
+      expect(row == dirty_row).to be true
+    end
+  end
+
+  describe '#<<' do
+    it 'raise CompatibilityError' do
+      expect { row << [1, 2] }.to raise_error(CompactCSV::CompatibilityError)
+    end
+  end
+
+  describe '#push' do
+    it 'raise CompatibilityError' do
+      expect { row.push(1) }.to raise_error(CompactCSV::CompatibilityError)
+    end
+  end
+
+  describe '#delete' do
+    it 'raise CompatibilityError' do
+      expect { row.delete(1) }.to raise_error(CompactCSV::CompatibilityError)
+    end
+  end
+
+  describe '#delete_if' do
+    it 'raise CompatibilityError' do
+      expect { row.delete_if(&:nil?) }.to raise_error(CompactCSV::CompatibilityError)
+    end
+  end
+end

data/spec/data/sample.csv

@@ -0,0 +1,5 @@
+ID,VALUE
+1,"A"
+2,"B"
+3,"C"
+4,"B"

data/spec/original_csv_tests/README.md

@@ -0,0 +1,2 @@
+This directory was copied and modified from https://github.com/ruby/ruby/tree/ruby_2_2/test/csv
+

data/spec/original_csv_tests/base.rb

@@ -0,0 +1,7 @@
+require "test/unit"
+
+require_relative "../spec_helper"
+require_relative "with_different_ofs.rb"
+
+class TestCompactCSV < Test::Unit::TestCase
+end

data/spec/original_csv_tests/test_interface.rb

@@ -0,0 +1,362 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+
+# tc_interface.rb
+#
+#  Created by James Edward Gray II on 2005-10-31.
+#  Copyright 2005 James Edward Gray II. You can redistribute or modify this code
+#  under the terms of Ruby's license.
+
+require_relative "base"
+require "tempfile"
+
+class TestCompactCSV::Interface < TestCompactCSV
+  extend DifferentOFS
+
+  def setup
+    super
+    @tempfile = Tempfile.new(%w"temp .csv")
+    @tempfile.close
+    @path = @tempfile.path
+
+    File.open(@path, "wb") do |file|
+      file << "1\t2\t3\r\n"
+      file << "4\t5\r\n"
+    end
+
+    @expected = [%w{1 2 3}, %w{4 5}]
+  end
+
+  def teardown
+    @tempfile.close(true)
+    super
+  end
+
+  ### Test Read Interface ###
+
+  def test_foreach
+    CompactCSV.foreach(@path, col_sep: "\t", row_sep: "\r\n") do |row|
+      assert_equal(@expected.shift, row)
+    end
+  end
+
+  def test_foreach_enum
+    CompactCSV.foreach(@path, col_sep: "\t", row_sep: "\r\n").zip(@expected) do |row, exp|
+      assert_equal(exp, row)
+    end
+  end
+
+  def test_open_and_close
+    csv = CompactCSV.open(@path, "r+", col_sep: "\t", row_sep: "\r\n")
+    assert_not_nil(csv)
+    assert_instance_of(CompactCSV, csv)
+    assert_not_predicate(csv, :closed?)
+    csv.close
+    assert_predicate(csv, :closed?)
+
+    ret = CompactCSV.open(@path) do |new_csv|
+      csv = new_csv
+      assert_instance_of(CompactCSV, new_csv)
+      "Return value."
+    end
+    assert_predicate(csv, :closed?)
+    assert_equal("Return value.", ret)
+  end
+
+  def test_parse
+    data = File.binread(@path)
+    assert_equal( @expected,
+                  CompactCSV.parse(data, col_sep: "\t", row_sep: "\r\n") )
+
+    CompactCSV.parse(data, col_sep: "\t", row_sep: "\r\n") do |row|
+      assert_equal(@expected.shift, row)
+    end
+  end
+
+  def test_parse_line
+    row = CompactCSV.parse_line("1;2;3", col_sep: ";")
+    assert_not_nil(row)
+    assert_instance_of(Array, row)
+    assert_equal(%w{1 2 3}, row)
+
+    # shortcut interface
+    row = "1;2;3".parse_csv(col_sep: ";")
+    assert_not_nil(row)
+    assert_instance_of(Array, row)
+    assert_equal(%w{1 2 3}, row)
+  end
+
+  def test_parse_line_with_empty_lines
+    assert_equal(nil,       CompactCSV.parse_line(""))  # to signal eof
+    assert_equal(Array.new, CompactCSV.parse_line("\n1,2,3"))
+  end
+
+  def test_read_and_readlines
+    assert_equal( @expected,
+                  CompactCSV.read(@path, col_sep: "\t", row_sep: "\r\n") )
+    assert_equal( @expected,
+                  CompactCSV.readlines(@path, col_sep: "\t", row_sep: "\r\n") )
+
+
+    data = CompactCSV.open(@path, col_sep: "\t", row_sep: "\r\n") do |csv|
+      csv.read
+    end
+    assert_equal(@expected, data)
+    data = CompactCSV.open(@path, col_sep: "\t", row_sep: "\r\n") do |csv|
+      csv.readlines
+    end
+    assert_equal(@expected, data)
+  end
+
+  def test_table
+    table = CompactCSV.table(@path, col_sep: "\t", row_sep: "\r\n")
+    assert_instance_of(CompactCSV::Table, table)
+    assert_equal([[:"1", :"2", :"3"], [4, 5, nil]], table.to_a)
+  end
+
+  def test_shift  # aliased as gets() and readline()
+    CompactCSV.open(@path, "rb+", col_sep: "\t", row_sep: "\r\n") do |csv|
+      assert_equal(@expected.shift, csv.shift)
+      assert_equal(@expected.shift, csv.shift)
+      assert_equal(nil, csv.shift)
+    end
+  end
+
+  def test_enumerators_are_supported
+    CompactCSV.open(@path, col_sep: "\t", row_sep: "\r\n") do |csv|
+      enum = csv.each
+      assert_instance_of(Enumerator, enum)
+      assert_equal(@expected.shift, enum.next)
+    end
+  end
+
+  ### Test Write Interface ###
+
+  def test_generate
+    str = CompactCSV.generate do |csv|  # default empty String
+      assert_instance_of(CompactCSV, csv)
+      assert_equal(csv, csv << [1, 2, 3])
+      assert_equal(csv, csv << [4, nil, 5])
+    end
+    assert_not_nil(str)
+    assert_instance_of(String, str)
+    assert_equal("1,2,3\n4,,5\n", str)
+
+    CompactCSV.generate(str) do |csv|   # appending to a String
+      assert_equal(csv, csv << ["last", %Q{"row"}])
+    end
+    assert_equal(%Q{1,2,3\n4,,5\nlast,"""row"""\n}, str)
+  end
+
+  def test_generate_line
+    line = CompactCSV.generate_line(%w{1 2 3}, col_sep: ";")
+    assert_not_nil(line)
+    assert_instance_of(String, line)
+    assert_equal("1;2;3\n", line)
+
+    # shortcut interface
+    line = %w{1 2 3}.to_csv(col_sep: ";")
+    assert_not_nil(line)
+    assert_instance_of(String, line)
+    assert_equal("1;2;3\n", line)
+  end
+
+  def test_write_header_detection
+    File.unlink(@path)
+
+    headers = %w{a b c}
+    CompactCSV.open(@path, "w", headers: true) do |csv|
+      csv << headers
+      csv << %w{1 2 3}
+      assert_equal(headers, csv.instance_variable_get(:@headers))
+    end
+  end
+
+  def test_write_lineno
+    File.unlink(@path)
+
+    CompactCSV.open(@path, "w") do |csv|
+      lines = 20
+      lines.times { csv << %w{a b c} }
+      assert_equal(lines, csv.lineno)
+    end
+  end
+
+  def test_write_hash
+    File.unlink(@path)
+
+    lines = [{a: 1, b: 2, c: 3}, {a: 4, b: 5, c: 6}]
+    CompactCSV.open( @path, "wb", headers:           true,
+                           header_converters: :symbol ) do |csv|
+      csv << lines.first.keys
+      lines.each { |line| csv << line }
+    end
+    CompactCSV.open( @path, "rb", headers:           true,
+                           converters:        :all,
+                           header_converters: :symbol ) do |csv|
+      csv.read.each { |line| assert_equal(lines.shift, line.to_hash) }
+    end
+  end
+
+  def test_write_hash_with_string_keys
+    File.unlink(@path)
+
+    lines = [{a: 1, b: 2, c: 3}, {a: 4, b: 5, c: 6}]
+    CompactCSV.open( @path, "wb", headers: true ) do |csv|
+      csv << lines.first.keys
+      lines.each { |line| csv << line }
+    end
+    CompactCSV.open( @path, "rb", headers: true ) do |csv|
+      csv.read.each do |line|
+        csv.headers.each_with_index do |header, h|
+          keys = line.to_hash.keys
+          assert_instance_of(String, keys[h])
+          assert_same(header, keys[h])
+        end
+      end
+    end
+  end
+
+  def test_write_hash_with_headers_array
+    File.unlink(@path)
+
+    lines = [{a: 1, b: 2, c: 3}, {a: 4, b: 5, c: 6}]
+    CompactCSV.open(@path, "wb", headers: [:b, :a, :c]) do |csv|
+      lines.each { |line| csv << line }
+    end
+
+    # test writing fields in the correct order
+    File.open(@path, "rb") do |f|
+      assert_equal("2,1,3", f.gets.strip)
+      assert_equal("5,4,6", f.gets.strip)
+    end
+
+    # test reading CompactCSV with headers
+    CompactCSV.open( @path, "rb", headers:    [:b, :a, :c],
+                           converters: :all ) do |csv|
+      csv.read.each { |line| assert_equal(lines.shift, line.to_hash) }
+    end
+  end
+
+  def test_write_hash_with_headers_string
+    File.unlink(@path)
+
+    lines = [{"a" => 1, "b" => 2, "c" => 3}, {"a" => 4, "b" => 5, "c" => 6}]
+    CompactCSV.open(@path, "wb", headers: "b|a|c", col_sep: "|") do |csv|
+      lines.each { |line| csv << line }
+    end
+
+    # test writing fields in the correct order
+    File.open(@path, "rb") do |f|
+      assert_equal("2|1|3", f.gets.strip)
+      assert_equal("5|4|6", f.gets.strip)
+    end
+
+    # test reading CompactCSV with headers
+    CompactCSV.open( @path, "rb", headers:    "b|a|c",
+                           col_sep:    "|",
+                           converters: :all ) do |csv|
+      csv.read.each { |line| assert_equal(lines.shift, line.to_hash) }
+    end
+  end
+
+  def test_write_headers
+    File.unlink(@path)
+
+    lines = [{"a" => 1, "b" => 2, "c" => 3}, {"a" => 4, "b" => 5, "c" => 6}]
+    CompactCSV.open( @path, "wb", headers:       "b|a|c",
+                           write_headers: true,
+                           col_sep:       "|" ) do |csv|
+      lines.each { |line| csv << line }
+    end
+
+    # test writing fields in the correct order
+    File.open(@path, "rb") do |f|
+      assert_equal("b|a|c", f.gets.strip)
+      assert_equal("2|1|3", f.gets.strip)
+      assert_equal("5|4|6", f.gets.strip)
+    end
+
+    # test reading CompactCSV with headers
+    CompactCSV.open( @path, "rb", headers:    true,
+                           col_sep:    "|",
+                           converters: :all ) do |csv|
+      csv.read.each { |line| assert_equal(lines.shift, line.to_hash) }
+    end
+  end
+
+  def test_append  # aliased add_row() and puts()
+    File.unlink(@path)
+
+    CompactCSV.open(@path, "wb", col_sep: "\t", row_sep: "\r\n") do |csv|
+      @expected.each { |row| csv << row }
+    end
+
+    test_shift
+
+    # same thing using CompactCSV::Row objects
+    File.unlink(@path)
+
+    CompactCSV.open(@path, "wb", col_sep: "\t", row_sep: "\r\n") do |csv|
+      @expected.each { |row| csv << CompactCSV::Row.new(Array.new, row) }
+    end
+
+    test_shift
+  end
+
+  ### Test Read and Write Interface ###
+
+  def test_filter
+    assert_respond_to(CompactCSV, :filter)
+
+    expected = [[1, 2, 3], [4, 5]]
+    CompactCSV.filter( "1;2;3\n4;5\n", (result = String.new),
+                in_col_sep: ";", out_col_sep: ",",
+                converters: :all ) do |row|
+      assert_equal(row, expected.shift)
+      row.map! { |n| n * 2 }
+      row << "Added\r"
+    end
+    assert_equal("2,4,6,\"Added\r\"\n8,10,\"Added\r\"\n", result)
+  end
+
+  def test_instance
+    csv = String.new
+
+    first = nil
+    assert_nothing_raised(Exception) do
+      first =  CompactCSV.instance(csv, col_sep: ";")
+      first << %w{a b c}
+    end
+
+    assert_equal("a;b;c\n", csv)
+
+    second = nil
+    assert_nothing_raised(Exception) do
+      second =  CompactCSV.instance(csv, col_sep: ";")
+      second << [1, 2, 3]
+    end
+
+    assert_equal(first.object_id, second.object_id)
+    assert_equal("a;b;c\n1;2;3\n", csv)
+
+    # shortcuts
+    assert_equal(STDOUT, CompactCSV.instance.instance_eval { @io })
+    assert_equal(STDOUT, CompactCSV { |new_csv| new_csv.instance_eval { @io } })
+  end
+
+  def test_options_are_not_modified
+    opt = {}.freeze
+    assert_nothing_raised {  CompactCSV.foreach(@path, opt)       }
+    assert_nothing_raised {  CompactCSV.open(@path, opt){}        }
+    assert_nothing_raised {  CompactCSV.parse("", opt)            }
+    assert_nothing_raised {  CompactCSV.parse_line("", opt)       }
+    assert_nothing_raised {  CompactCSV.read(@path, opt)          }
+    assert_nothing_raised {  CompactCSV.readlines(@path, opt)     }
+    assert_nothing_raised {  CompactCSV.table(@path, opt)         }
+    assert_nothing_raised {  CompactCSV.generate(opt){}           }
+    assert_nothing_raised {  CompactCSV.generate_line([], opt)    }
+    assert_nothing_raised {  CompactCSV.filter("", "", opt){}     }
+    assert_nothing_raised {  CompactCSV.instance("", opt)         }
+  end
+end

data/spec/original_csv_tests/with_different_ofs.rb

@@ -0,0 +1,17 @@
+module DifferentOFS
+  module WithDifferentOFS
+    def setup
+      super
+      @ofs, $, = $,, "-"
+    end
+    def teardown
+      $, = @ofs
+      super
+    end
+  end
+
+  def self.extended(klass)
+    super(klass)
+    klass.const_set(:DifferentOFS, Class.new(klass).class_eval {include WithDifferentOFS}).name
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+require 'coveralls'
+Coveralls.wear!
+
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'compact_csv'

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification
+name: compact_csv
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- NAKANO Ryusuke
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-12-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Memory efficient CSV
+email:
+- rsk.nakano@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- compact_csv.gemspec
+- lib/compact_csv.rb
+- lib/compact_csv/version.rb
+- spec/compact_csv_spec.rb
+- spec/data/sample.csv
+- spec/original_csv_tests/README.md
+- spec/original_csv_tests/base.rb
+- spec/original_csv_tests/test_interface.rb
+- spec/original_csv_tests/with_different_ofs.rb
+- spec/spec_helper.rb
+homepage: https://github.com/rnakano/compact_csv
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Memory efficient CSV
+test_files:
+- spec/compact_csv_spec.rb
+- spec/data/sample.csv
+- spec/original_csv_tests/README.md
+- spec/original_csv_tests/base.rb
+- spec/original_csv_tests/test_interface.rb
+- spec/original_csv_tests/with_different_ofs.rb
+- spec/spec_helper.rb