csv-probe 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 138cd78aa31ccab66bbaa4a629c4f2c0d3b37a547006ed635e6fed935a223051
-  data.tar.gz: 87f700fcb9c7a620f101b5a63bf095b9f6a611f72d83f876b11ca33797564a72
+  metadata.gz: 83d63f020bf4ed1e557518b78820b440cc24da36a7d93f6ded23b604aa7161ed
+  data.tar.gz: df4e094f0f0451c9578ac5f02c34eb967d851a4782926dc64f0b96bdcd1eb9f8
 SHA512:
-  metadata.gz: 1357f59d7446f937c3719feeafd86aa29a10844203d72dd20f30c338243ad347adeca2c5d1dca93195cd223403fb024263330f398f029455f8ae5562fd906812
-  data.tar.gz: aee4fa829429c8cc4590351da2b303b5879a163b412d987ec7dff63f5c45e5e8e9e4b5dd40af4619a19ceaa166bf09670e3f4f0b50b79f83e4c048552ec0ec7c
+  metadata.gz: 9b3be13578b537577b62fd1efa51ec00f2d0a5a38755b2e8399dfeacf9f3ceaa1f30a65381336af5464cb4d08c32797bb0de5199f34f4e437041db9ec70ab681
+  data.tar.gz: 2eb6bfdeb32a7d3f819cf52b412b311984d7e45366426ed81a788ccf2f9a83504733cbe348c8da34421f23855eab2f8e5efe40e3fd4086a94a656758cdef3e4b

data/.rubocop.yml

@@ -1,5 +1,6 @@
 AllCops:
   TargetRubyVersion: 2.6
+  NewCops: enable
 
 Style/StringLiterals:
   Enabled: true

data/README.md

@@ -23,7 +23,7 @@ Or install it yourself as:
 
 Example how to use Probe
 
-```
+```ruby
   # load CSV into CSV::Table
   csv_table = CSV.parse(<<~ROWS, headers: true)
     col1,col2,col3,col4,col5,col6,col7
@@ -54,7 +54,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/csv-probe.
+Bug reports and pull requests are welcome on GitHub at https://github.com/homebase-dev/csv-probe.
 
 ## License
 

data/csv-probe.gemspec

@@ -9,12 +9,14 @@ Gem::Specification.new do |spec|
   spec.email = ["homebase.dev@gmail.com"]
 
   spec.summary = "Allows validation of CSV::Table or CSV::Rows via custom rules"
-  spec.description = "This gem provides a simple framework for CSV::Table/CSV::Row validation using custom rules for columns and rows"
+  spec.description = "This gem provides a simple framework for CSV::Table/CSV::Row linting"\
+                     "using custom rules for columns and rows"
   spec.homepage = "https://gitlab.com/homebase-dev/csv-probe"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 2.6.0"
 
   # spec.metadata["allowed_push_host"] = "TODO: Set to your gem server 'https://example.com'"
+  spec.metadata["rubygems_mfa_required"] = "true"
 
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://gitlab.com/homebase-dev/csv-probe"

data/lib/csv/probe/checks.rb

@@ -5,30 +5,35 @@ module Probe
 
   class LintingError < Error; end
 
+  # Linting error in CSV::Row, if the rule applies to multiple columns of a row
   class RowError < LintingError
     def initialize(msg = "CheckRowError")
       super
     end
   end
 
+  # Linting warning in CSV::Row, if the rule applies to multiple columns of a row
   class RowWarning < LintingError
     def initialize(msg = "CheckRowWarning")
       super
     end
   end
 
+  # Linting error in CSV::Column, if the rule applies to a single column of a row
   class ColumnError < LintingError
     def initialize(msg = "CheckColumnError")
       super
     end
   end
 
+  # Linting warning in CSV::Column, if the rule applies to a single column of a row
   class ColumnWarning < LintingError
     def initialize(msg = "CheckColumnWarning")
       super
     end
   end
 
+  # Abstract class of a CSV::Row check
   class RowMeetsCondition
     attr_accessor :ok_condition_fn, :fail_msg, :severity, :pre_checks
 
@@ -102,6 +107,7 @@ module Probe
     end
   end
 
+  # Abstract class of a CSV::Row single field (= column) check
   class ColumnMeetsCondition < RowMeetsCondition
     attr_accessor :varname, :ok_condition_fn, :fail_msg
 
@@ -120,10 +126,14 @@ module Probe
 
     def evaluate(row, opts = {})
       evaluate_pre_checks(row, opts)
-      raise @error_classes.fetch(@severity), error_msg(row, opts) unless @ok_condition_fn.call(row.fetch(@varname), opts)
+
+      unless @ok_condition_fn.call(row.fetch(@varname), opts) # rubocop:disable Style/GuardClause
+        raise @error_classes.fetch(@severity), error_msg(row, opts)
+      end
     end
   end
 
+  # Check if a column value is equal to a provided value (Pay attention to types!)
   class ColumnIsEqualTo < ColumnMeetsCondition
     def initialize(varname, expected_val, _placeholder = nil)
       super(varname, nil, nil)
@@ -132,6 +142,7 @@ module Probe
     end
   end
 
+  # Check if a column value is one of a list of provided value
   class ColumnIsOneOf < ColumnMeetsCondition
     def initialize(varname, expected_vals_arr, _placeholder = nil)
       super(varname, nil, nil)
@@ -140,8 +151,9 @@ module Probe
     end
   end
 
+  # Check if a column value is a date with a given format
   class ColumnIsDate < ColumnMeetsCondition
-    def initialize(varname, expected_date_format, _placeholder = nil)
+    def initialize(varname, expected_date_format, _placeholder = nil) # rubocop:disable Metrics/MethodLength
       super(varname, nil, nil)
       @ok_condition_fn = lambda { |val, _cfg|
         success = true
@@ -159,11 +171,13 @@ module Probe
   # class ColumnIsInteger < ColumnMeetsCondition
   #   def initialize(varname, placeholder1=nil, placeholder=nil)
   #     super(varname, nil, nil)
-  #     @ok_condition_fn = ->(val, cfg){ val.is_a? Integer } # TODO: achtung 12abc -> integer auch 1.1 wird zu 1... ist nicht so einfach, lieber über regex prüfen
+  #     @ok_condition_fn = ->(val, cfg){ val.is_a? Integer }
+  #       # TODO: ATTENTION 12abc -> integer, also  1.1 -> 1 ! better do it over regex?
   #     @fail_msg = "expected to be an Integer"
   #   end
   # end
 
+  # Check if a column value is a date with a given format
   class ColumnMatchesRegEx < ColumnMeetsCondition
     def initialize(varname, expected_regex_pattern, _placeholder = nil)
       super(varname, nil, nil)
@@ -172,9 +186,9 @@ module Probe
     end
   end
 
-  # TODO: fixme uniq als eigenen check machen
+  # Check if a tokenized column value is a list of given values
   class ColumnIsListWithDomain < ColumnMeetsCondition
-    def initialize(varname, expected_items_arr, separator, _placeholder = nil)
+    def initialize(varname, expected_items_arr, separator, _placeholder = nil) # rubocop:disable Metrics/MethodLength
       super(varname, nil, nil)
       @ok_condition_fn = lambda { |val, _cfg|
         items = val.split(separator)
@@ -183,13 +197,15 @@ module Probe
       @fail_msg = lambda { |row, _opts|
         items = row.fetch(@varname).split(separator)
         diff_items = items - expected_items_arr
-        "expected that tokenized items of value #{items.inspect} are a subset of #{expected_items_arr.inspect}, but items #{diff_items.inspect} are not"
+        "expected that tokenized items of value #{items.inspect} are a subset of "\
+          "#{expected_items_arr.inspect}, but items #{diff_items.inspect} are not"
       }
     end
   end
 
+  # Check if a tokenized column value is a list of given values
   class ColumnIsSet < ColumnMeetsCondition
-    def initialize(varname, separator, _placeholder = nil)
+    def initialize(varname, separator, _placeholder = nil) # rubocop:disable Metrics/MethodLength
       super(varname, nil, nil)
       @ok_condition_fn = lambda { |val, _cfg|
         return true if val.to_s == ""
@@ -206,8 +222,9 @@ module Probe
     end
   end
 
+  # Check if a tokenized column value is a set of given values (no duplicates)
   class ColumnIsSetWithDomain < ColumnMeetsCondition
-    def initialize(varname, expected_items_arr, separator, _placeholder = nil)
+    def initialize(varname, expected_items_arr, separator, _placeholder = nil) # rubocop:disable Metrics/MethodLength
       super(varname, nil, nil)
       @pre_checks << ColumnIsSet.new(varname, separator)
       @ok_condition_fn = lambda { |val, _cfg|
@@ -221,7 +238,10 @@ module Probe
         items = row.fetch(@varname).split(separator)
         "expected that items of tokenized value #{items.inspect} are a subset of #{expected_items_arr.inspect}"
       }
-      # @fail_msg = ->(row, opts) { "Unexpected value:#{row.fetch(@varname).inspect} for column:#{@varname.inspect}, expected that items of tokenized value #{row.fetch(@varname).split(separator)} are uniqe and a subset of #{expected_items_arr.inspect}" }
+      # @fail_msg = lambda {|row, opts|
+      # "Unexpected value:#{row.fetch(@varname).inspect} for column:#{@varname.inspect},
+      #  expected that items of tokenized value #{row.fetch(@varname).split(separator)}
+      #  are uniqe and a subset of #{expected_items_arr.inspect}" }
     end
   end
 

data/lib/csv/probe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Probe
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/csv/probe.rb

@@ -43,7 +43,7 @@ module Probe
 end
 
 # Extend CSV::Table with .lint(...) method
-class CSV::Table
+class CSV::Table # rubocop:disable Style/ClassAndModuleChildren
   def lint(checks, opts = {})
     opts[:headers] = true unless opts.key?(:headers) # CSV::Table has always headers, hence set :headers = true
     Probe.lint_rows(self, checks, opts)
@@ -51,7 +51,7 @@ class CSV::Table
 end
 
 # Extend CSV::Row with .lint(...) method
-class CSV::Row
+class CSV::Row # rubocop:disable Style/ClassAndModuleChildren
   def lint(checks, opts = {})
     Probe.lint_row(self, checks, opts)
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: csv-probe
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - homebase.dev
@@ -38,8 +38,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
-description: This gem provides a simple framework for CSV::Table/CSV::Row validation
-  using custom rules for columns and rows
+description: This gem provides a simple framework for CSV::Table/CSV::Row lintingusing
+  custom rules for columns and rows
 email:
 - homebase.dev@gmail.com
 executables: []
@@ -64,6 +64,7 @@ homepage: https://gitlab.com/homebase-dev/csv-probe
 licenses:
 - MIT
 metadata:
+  rubygems_mfa_required: 'true'
   homepage_uri: https://gitlab.com/homebase-dev/csv-probe
   source_code_uri: https://gitlab.com/homebase-dev/csv-probe
   changelog_uri: https://gitlab.com/homebase-dev/csv-probe