csv-utils 0.1.7 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d426e3be79ea7c3424c7778e2eb28ac750a55d0af374115021791506cfe933d
-  data.tar.gz: 00fec1a3995a515fca21f8032d40f9447cdbccfb53e7f22644982ff4c3d703a6
+  metadata.gz: ecb75f60c8e9b9db4cc3eb0e4ca3a0ac53aad67726ed995b7e8c341cd0dc76a3
+  data.tar.gz: 5138b5cc82eec0b7667c9e3435c2662bbfa1de51e469582372a158b943e57d7f
 SHA512:
-  metadata.gz: d560c6b227162d297f396213cb26b277b437dc744a05f072f9f5716ea6920ff35dbedcdfcd544e4b5b8589f0e8e1322e79b5cdcb63d9d9e5f26019c141d77772
-  data.tar.gz: 7fd77c041baefdc87e4166781739bd97dc1183824414cb928c4a369adb972423d460f67562f848ac4373fb1c19cde9d962ee73a554590b0950d0bc9462e42b52
+  metadata.gz: 1a7d685b0db28805833596b32793fca968c6a5a1f57346223b487579622423d0151a122253c69806e377015fe0cf9cf02381bafbee37cb0ba54fa290a857c1cc
+  data.tar.gz: 7c572f9e7c74d626084612afa188bb15b036377bbac16ed5374d7fcff300e58fab8100a77729c2fa428e4294ac6b3b643feb00b2e87e7de78883c8548193de54

data/.ruby-gemset

@@ -0,0 +1 @@
+csv-utils

data/.ruby-version

@@ -0,0 +1 @@
+2.6.3

data/Gemfile

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+source 'http://rubygems.org'
+
+gem 'inheritance-helper'
+
+group :development do
+  gem 'rake'
+  gem 'rubocop'
+end
+
+group :spec do
+  gem 'rspec'
+  gem 'simplecov'
+end

data/Gemfile.lock

@@ -0,0 +1,57 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    ast (2.4.1)
+    diff-lcs (1.3)
+    docile (1.3.2)
+    inheritance-helper (0.1.5)
+    parallel (1.19.2)
+    parser (2.7.1.4)
+      ast (~> 2.4.1)
+    rainbow (3.0.0)
+    rake (13.0.1)
+    regexp_parser (1.7.1)
+    rexml (3.2.4)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.2)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.3)
+    rubocop (0.86.0)
+      parallel (~> 1.10)
+      parser (>= 2.7.0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
+      rexml
+      rubocop-ast (>= 0.0.3, < 1.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.0.3)
+      parser (>= 2.7.0.1)
+    ruby-progressbar (1.10.1)
+    simplecov (0.18.5)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+    simplecov-html (0.12.2)
+    unicode-display_width (1.7.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  inheritance-helper
+  rake
+  rspec
+  rubocop
+  simplecov
+
+BUNDLED WITH
+   1.17.3

data/csv-utils.gemspec

@@ -2,7 +2,8 @@
 
 Gem::Specification.new do |s|
   s.name        = 'csv-utils'
-  s.version     = '0.1.7'
+  s.version     = '0.2.0'
+  s.licenses    = ['MIT']
   s.summary     = 'CSV Utils'
   s.description = 'Tools for debugging malformed CSV files'
   s.authors     = ['Doug Youch']
@@ -11,4 +12,6 @@ Gem::Specification.new do |s|
   s.files       = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   s.bindir      = 'bin'
   s.executables = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
+
+  s.add_runtime_dependency 'inheritance-helper'
 end

data/lib/csv-utils.rb

@@ -0,0 +1,8 @@
+require 'csv'
+
+# Collection of tools for working with CSV files.
+module CSVUtils
+  autoload :CSVOptions, 'csv_utils/csv_options'
+  autoload :CSVReport, 'csv_utils/csv_report'
+  autoload :CSVRow, 'csv_utils/csv_row'
+end

data/lib/csv_utils/csv_options.rb

@@ -0,0 +1,87 @@
+# Auto detect a csv files options
+module CSVUtils
+  class CSVOptions
+
+    # this list is from https://en.wikipedia.org/wiki/Byte_order_mark
+    BYTE_ORDER_MARKS = {
+      "\xEF\xBB\xBF".force_encoding('ASCII-8BIT') => 'UTF-8',
+      "\xFE\xFF".force_encoding('ASCII-8BIT') => 'UTF-16',
+      "\xFF\xFE".force_encoding('ASCII-8BIT') => 'UTF-16',
+      "\x00\x00\xFE\xFF".force_encoding('ASCII-8BIT') => 'UTF-32',
+      "\xFF\xFE\x00\x00".force_encoding('ASCII-8BIT') => 'UTF-32'
+    }
+
+    COL_SEPARATORS = [
+      "\x02",
+      "\t",
+      '|',
+      ','
+    ]
+
+    ROW_SEPARATORS = [
+      "\r\n",
+      "\n",
+      "\r"
+    ]
+
+    attr_reader :columns,
+                :byte_order_mark,
+                :encoding,
+                :col_separator,
+                :row_separator
+    
+
+    def initialize(io)
+      line =
+        if io.is_a?(String)
+          File.open(io, 'rb', &:readline)
+        else
+          io.readline
+        end
+
+      @col_separator = auto_detect_col_sep(line)
+      @row_separator = auto_detect_row_sep(line)
+      @byte_order_mark = get_byte_order_mark(line)
+      @encoding = get_character_encoding(@byte_order_mark)
+      @columns = get_number_of_columns(line) if @col_separator
+    end
+
+    def valid?
+      return false if @col_separator.nil? || @row_separator.nil?
+
+      true
+    end
+
+    def auto_detect_col_sep(line)
+      COL_SEPARATORS.detect { |sep| line.include?(sep) }
+    end
+
+    def auto_detect_row_sep(line)
+      ROW_SEPARATORS.detect { |sep| line.include?(sep) }
+    end
+
+    def get_headers(line)
+      headers = line.split(col_separator)
+      headers[0] = strip_byte_order_marks(headers[0])
+      headers
+    end
+
+    def get_number_of_columns(line)
+      get_headers(line).size
+    end
+
+    def get_byte_order_mark(line)
+      BYTE_ORDER_MARKS.keys.detect do |bom|
+        line =~ /\A#{bom}/
+      end
+    end
+
+    def get_character_encoding(bom)
+      BYTE_ORDER_MARKS[bom] || 'UTF-8'
+    end
+
+    def strip_byte_order_marks(header)
+      @byte_order_marks ? header.sub(@byte_order_marks, '') : header
+    end
+  end
+end

data/lib/csv_utils/csv_report.rb

@@ -0,0 +1,40 @@
+# Builds a csv file from csv rows
+module CSVUtils
+  class CSVReport
+    attr_reader :csv,
+                :must_close
+
+    def initialize(csv, csv_options = {}, &block)
+      @csv =
+        if csv.is_a?(String)
+          @must_close = true
+          mode = csv_options.delete(:mode) || 'wb'
+          CSV.open(csv, mode, csv_options)
+        else
+          @must_close = false
+          csv
+        end
+
+      generate(&block) if block
+    end
+
+    def generate
+      yield self
+      @csv.close if @must_close
+    end
+
+    def append(csv_row)
+      @csv <<
+        if csv_row.is_a?(Array)
+          csv_row
+        else
+          csv_row.to_a
+        end
+    end
+    alias << append
+
+    def add_headers(csv_row)
+      append(csv_row.is_a?(Array) ? csv_row : csv_row.csv_headers)
+    end
+  end
+end

data/lib/csv_utils/csv_row.rb

@@ -0,0 +1,51 @@
+require 'inheritance-helper'
+
+module CSVUtils
+  module CSVRow
+    def self.included(base)
+      base.extend InheritanceHelper::Methods
+      base.extend ClassMethods
+    end
+
+    module ClassMethods
+      def csv_columns
+        {}
+      end
+
+      def csv_column(header, options = {}, &block)
+        options[:header] ||= header.to_s
+
+        if block
+          options[:proc] = block
+        elsif options[:proc].nil?
+          options[:method] ||= header
+        end
+
+        add_value_to_class_method(:csv_columns, header => options)
+      end
+    end
+
+    def csv_headers
+      self.class.csv_columns.values.map { |column_options| csv_column_header(column_options) }
+    end
+
+    def csv_row
+      self.class.csv_columns.values.map { |column_options| csv_column_value(column_options) }
+    end
+    alias_method :to_a, :csv_row
+
+    private
+
+    def csv_column_header(column_options)
+      column_options[:header]
+    end
+
+    def csv_column_value(column_options)
+      if column_options[:proc]
+        instance_eval(&column_options[:proc])
+      else
+        send(column_options[:method])
+      end
+    end
+  end
+end

data/script/console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH << File.expand_path('../lib', __dir__)
+require 'csv-utils'
+require 'irb'
+IRB.start(__FILE__)

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: csv-utils
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.2.0
 platform: ruby
 authors:
 - Doug Youch
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-03-27 00:00:00.000000000 Z
-dependencies: []
+date: 2020-06-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: inheritance-helper
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Tools for debugging malformed CSV files
 email: dougyouch@gmail.com
 executables:
@@ -20,16 +34,26 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".ruby-gemset"
+- ".ruby-version"
+- Gemfile
+- Gemfile.lock
 - LICENSE
 - README.md
 - bin/csv-change-eol
 - bin/csv-find-error
 - bin/csv-readline
 - csv-utils.gemspec
+- lib/csv-utils.rb
+- lib/csv_utils/csv_options.rb
+- lib/csv_utils/csv_report.rb
+- lib/csv_utils/csv_row.rb
+- script/console
 homepage: https://github.com/dougyouch/csv-utils
-licenses: []
+licenses:
+- MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -45,7 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.0.8
-signing_key: 
+signing_key:
 specification_version: 4
 summary: CSV Utils
 test_files: []