portable 1.0.0.pre.alpha.3 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 32da634ac58591d5130ab01ddb7e6953144f663b563fdce844817473db370bde
-  data.tar.gz: c7b6ded1144b5cdb46ab702a5d23480d4a778b4bfa134c21f4ae884bf1ecc220
+  metadata.gz: 563f9b0e89cfa8fecd2346faa4448a88919ee8188c08ddfbcb0dfe0033acf0b6
+  data.tar.gz: 3f3d82c6a9539e93028cf781b72bdd42d3bd753ccb0a6a2018286a3afc71e20f
 SHA512:
-  metadata.gz: b3cbe61597e5ea310d8084cafcaea7cf75476d969e5ad833ee140397d92cfe9d7c2baf2f5d930754f1870dd1f1b757f91562d79bfdee74e870670f21c981712f
-  data.tar.gz: 3a101c3f5c3467060cfe7b237efec41e51435d0fe0941a753d6e6b03ba776b99f8aad1845d62015e6cf54a6bbd464902414f8bd0128d7c3cbc8682afd4d084bc
+  metadata.gz: 511a1e5ccea009b86e5c4f8838945c6d6cadf150709f5f31e6d6163b59431d05a0a2604ecc4686529f8aa505857f55607de4a74510348b20d52c71ec23b559af
+  data.tar.gz: 93c0c1a1480d961fedfe4c46a909b0ecb25958bfcfb55c8dd0575d7318c7575176b0347588c543d1830b22938a22a473283ce78a109378d9926f423a0848c41b

data/.rubocop.yml

@@ -20,7 +20,7 @@ Metrics/MethodLength:
   Max: 30
 
 Metrics/AbcSize:
-  Max: 17
+  Max: 20
 
 Metrics/ClassLength:
   Max: 125

data/.travis.yml

@@ -2,8 +2,6 @@ env:
   global:
     - CC_TEST_REPORTER_ID=f40f0e6f9946420b05b247f1640b2f5fcef181ca86659a2e71c747f790fcecdd
 language: ruby
-services:
-  - mysql
 rvm:
   # Build on the latest stable of all supported Rubies (https://www.ruby-lang.org/en/downloads/):
   - 2.5.8

data/CHANGELOG.md

@@ -1,3 +1,3 @@
-# 1.0.0 (TBD)
+# 1.0.0 (August 25th, 2020)
 
 Initial implementation.

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at oss@bluemarblepayroll.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/README.md

@@ -35,7 +35,7 @@ patients = [
 data_provider = Portable::Data::Provider.new(
   data_sources: {
     data_rows: patients,
-    fields: %i[first last dob]
+    keys: %i[first last dob]
   }
 )
 ````
@@ -50,7 +50,7 @@ document = nil # or {} or Portable::Document.new
 
 The above document says I would like a document with one sheet, and since I did not provide a data_table specification, I would like all the fields emitted from the data source.
 
-Combining a document + writer + data provider yields a set of documents (it may be more than one if the writer does not know how to write intra-file sheets, i.e. CSV files.)
+Combining a document + writer + data provider yields a set of documents.  It may emit more than one file if the writer does not know how to write intra-file sheets (i.e. CSV files).
 
 ````ruby
 writer    = Portable::Writers::Csv.new(document)
@@ -72,6 +72,18 @@ This library uses Realize under the hood, so you have the option of configuring
 Let's expand our CSV example above with different headers and date formatting:
 
 ````ruby
+patients = [
+  { first: 'Marky', last: 'Mark', dob: '2000-04-05' },
+  { first: 'Frank', last: 'Rizzo', dob: '1930-09-22' }
+]
+
+data_provider = Portable::Data::Provider.new(
+  data_sources: {
+    data_rows: patients,
+    keys: %i[first last dob]
+  }
+)
+
 document = {
   sheets: [
     {
@@ -101,14 +113,20 @@ document = {
     }
   ]
 }
+
+writer    = Portable::Writers::Csv.new(document)
+name      = File.join('tmp', 'patients.csv')
+written   = writer.write!(filename: name, data_provider: data_provider)
 ````
 
 Executing it the same way would now yield a different CSV file:
 
+````
 First Name | Last Name | Date of Birth
 ---------- | --------- | -------------
 Marky      | Mark      | 04/05/2000
 Frank      | Rizzo     | 09/22/1930
+````
 
 Realize is also [pluggable](https://github.com/bluemarblepayroll/realize#plugging-in-transformers), so you are able to create your own and plug them directly into Realize.
 
@@ -120,7 +138,7 @@ Each writer can choose how and which options to support.
 
 The following options are available for customizing CSV documents:
 
-* byte_order_mark: (optional, default is nothing): This option will write out a byte order mark identifying the encoding for the file.  This is useful for ensuring applications like Microsoft Excel open CSV files properly.  See Portable::Modeling::ByteOrderMark constants for acceptable values.
+* byte_order_mark: (optional, default is nothing): This option will write out a [byte order mark](https://en.wikipedia.org/wiki/Byte_order_mark) identifying the endianess for the file.  This is useful for ensuring applications like Microsoft Excel open CSV files properly.  See Portable::Modeling::ByteOrderMark constants for acceptable values.
 
 ### Static Header/Footer Rows
 
@@ -135,7 +153,7 @@ patients = [
 data_provider = Portable::Data::Provider.new(
   data_sources: {
     data_rows: patients,
-    fields: %i[first last dob],
+    keys: %i[first last dob],
     header_rows: [
       %w[FIRST_START LAST_START DOB_START]
     ],
@@ -160,6 +178,10 @@ document = {
     }
   ]
 }
+
+writer    = Portable::Writers::Csv.new(document)
+name      = File.join('tmp', 'patients.csv')
+written   = writer.write!(filename: name, data_provider: data_provider)
 ````
 
 Using this document configuration would yield a CSV with four "header rows" at the top, one "data table header row", two data rows, and one "footer row".  This is not easily illustrated in Markdown, but this would be the result:
@@ -169,10 +191,12 @@ Run Date   | 04/05/2000
 Run By     | Hops the Bunny
 
 BEGIN
-First Name | Last Name | Date of Birth
----------- | --------- | -------------
-Marky      | Mark      | 04/05/2000
-Frank      | Rizzo     | 09/22/1930
+FIRST_START | LAST_START | DOB_START
+first       | last       | dob
+----------- | ---------- | -------------
+Marky       | Mark       | 2000-04-05
+Frank       | Rizzo      | 1930-09-22
+FIRST_END   | LAST_END   | DOB_END
 END
 ````
 

data/lib/portable.rb

@@ -8,6 +8,7 @@
 #
 
 require 'acts_as_hashable'
+require 'benchmark'
 require 'csv'
 require 'fileutils'
 require 'forwardable'
@@ -16,7 +17,7 @@ require 'realize'
 require 'time'
 
 # Shared modules/classes
-require_relative 'portable/uniqueness'
+require_relative 'portable/util'
 
 # Main implementation points
 require_relative 'portable/data'

data/lib/portable/data/provider.rb

@@ -14,7 +14,8 @@ module Portable
     # Container of data sources that is inputted into a writer alongside a document.
     # It contains all the data sources the writer will use to render a document.
     class Provider
-      include Uniqueness
+      include Util::Pivotable
+      include Util::Uniqueness
       acts_as_hashable
 
       def initialize(data_sources: [])
@@ -26,19 +27,16 @@ module Portable
         freeze
       end
 
+      # Fail hard if we cannot identify which data source to use.  This should help prevent
+      # possible configuration issues (i.e. typos.)
       def data_source(name)
-        data_sources_by_name.fetch(name.to_s, Source.new)
+        data_sources_by_name[name.to_s] ||
+          raise(ArgumentError, "data source: '#{name}' cannot be found.")
       end
 
       private
 
       attr_reader :data_sources_by_name
-
-      def pivot_by_name(data_sources)
-        data_sources.each_with_object({}) do |data_source, memo|
-          memo[data_source.name] = data_source
-        end
-      end
     end
   end
 end

data/lib/portable/data/source.rb

@@ -19,17 +19,17 @@ module Portable
       attr_reader :header_rows,
                   :footer_rows,
                   :data_rows,
-                  :fields,
+                  :keys,
                   :name
 
       # Individial header and footer rows are arrays, while individual data_rows is an object
       # like a hash, Struct, OpenStruct, or really any PORO.
-      def initialize(name: '', header_rows: [], footer_rows: [], data_rows: [], fields: [])
+      def initialize(name: '', header_rows: [], footer_rows: [], data_rows: [], keys: [])
         @name        = name.to_s
         @header_rows = header_rows || []
         @footer_rows = footer_rows || []
         @data_rows   = data_rows   || []
-        @fields      = fields      || []
+        @keys        = keys        || []
 
         freeze
       end

data/lib/portable/document.rb

@@ -13,19 +13,37 @@ require_relative 'modeling/sheet'
 module Portable
   # Top-level object model for a renderable document.
   class Document
-    include Uniqueness
+    include Util::Pivotable
+    include Util::Uniqueness
     acts_as_hashable
 
-    attr_reader :sheets, :options
+    attr_reader :options
 
     def initialize(sheets: [], options: {})
-      @sheets = Modeling::Sheet.array(sheets)
-      @sheets << Modeling::Sheet.new if @sheets.empty?
-      @options = Modeling::Options.make(options)
-
-      assert_no_duplicate_names(@sheets)
+      @sheets_by_name = make_unique_sheets_by_name(sheets)
+      @options        = Modeling::Options.make(options, nullable: false)
 
       freeze
     end
+
+    def sheet(name)
+      sheets_by_name.fetch(name.to_s)
+    end
+
+    def sheets
+      sheets_by_name.values
+    end
+
+    private
+
+    attr_reader :sheets_by_name
+
+    def make_unique_sheets_by_name(sheets)
+      sheets = Modeling::Sheet.array(sheets)
+      sheets << Modeling::Sheet.new if sheets.empty?
+
+      assert_no_duplicate_names(sheets)
+      pivot_by_name(sheets)
+    end
   end
 end

data/lib/portable/modeling/data_table.rb

@@ -16,10 +16,15 @@ module Portable
     class DataTable
       acts_as_hashable
 
-      attr_reader :columns
+      attr_reader :auto, :columns, :include_headers
 
-      def initialize(columns: [])
-        @columns = Column.array(columns)
+      alias include_headers? include_headers
+      alias auto? auto
+
+      def initialize(auto: true, columns: [], include_headers: true)
+        @auto            = auto || false
+        @columns         = Column.array(columns)
+        @include_headers = include_headers || false
 
         freeze
       end

data/lib/portable/modeling/sheet.rb

@@ -17,31 +17,47 @@ module Portable
     # one file.
     class Sheet
       acts_as_hashable
+      extend Forwardable
 
-      attr_reader :data_table,
+      def_delegators :data_table,
+                     :auto?,
+                     :columns,
+                     :include_headers?
+
+      attr_reader :data_source_name,
+                  :data_table,
                   :footer_rows,
                   :header_rows,
-                  :name,
-                  :include_headers
+                  :name
 
       def initialize(
+        data_source_name: '',
         data_table: nil,
         footer_rows: [],
         header_rows: [],
-        name: '',
-        include_headers: true
+        name: ''
       )
-        @name            = name.to_s
-        @data_table      = DataTable.make(data_table)
-        @footer_rows     = footer_rows || []
-        @header_rows     = header_rows || []
-        @include_headers = include_headers || false
+        @data_source_name = decide_data_source_name(data_source_name, name)
+        @name             = name.to_s
+        @data_table       = DataTable.make(data_table, nullable: false)
+        @footer_rows      = footer_rows || []
+        @header_rows      = header_rows || []
 
         freeze
       end
 
-      def include_headers?
-        include_headers
+      private
+
+      # Use exact name if possible, if not then use the sheet name or else use the
+      # "default" one (noted by a blank name).
+      def decide_data_source_name(data_source_name, sheet_name)
+        if !data_source_name.to_s.empty?
+          data_source_name.to_s
+        elsif !sheet_name.to_s.empty?
+          sheet_name.to_s
+        else
+          ''
+        end
       end
     end
   end

data/lib/portable/rendering/column.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+#
+# Copyright (c) 2020-present, Blue Marble Payroll, LLC
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+#
+
+module Portable
+  module Rendering
+    class Column # :nodoc: all
+      extend Forwardable
+
+      attr_reader :column, :pipeline
+
+      def_delegators :column, :header
+
+      def_delegators :pipeline, :transform
+
+      def initialize(column, resolver: Objectable.resolver)
+        raise ArgumentError, 'column is required' unless column
+
+        @column   = column
+        @pipeline = Realize::Pipeline.new(column.transformers, resolver: resolver)
+
+        freeze
+      end
+    end
+  end
+end

data/lib/portable/rendering/row.rb

@@ -7,34 +7,37 @@
 # LICENSE file in the root directory of this source tree.
 #
 
+require_relative 'column'
+
 module Portable
   module Rendering
     # Internal intermediary class that knows how to combine columns specification
     # instances with their respective Realize pipelines.
     class Row # :nodoc: all
-      attr_reader :column_pipelines
+      attr_reader :columns, :resolver
 
       def initialize(columns, resolver: Objectable.resolver)
-        @column_pipelines = columns.each_with_object({}) do |column, memo|
-          memo[column] = Realize::Pipeline.new(column.transformers, resolver: resolver)
-        end
+        @resolver = resolver
+        @columns  = columns.map { |column| Column.new(column, resolver: resolver) }
 
         freeze
       end
 
       def render(object, time)
-        column_pipelines.each_with_object({}) do |(column, pipeline), memo|
-          memo[column.header] = pipeline.transform(object, time)
-        end
-      end
-
-      def columns
-        column_pipelines.keys
+        columns.map { |column| column.transform(object, time) }
       end
 
       def headers
         columns.map(&:header)
       end
+
+      def model_columns
+        columns.map(&:column)
+      end
+
+      def merge(other)
+        self.class.new(model_columns + other.model_columns, resolver: resolver)
+      end
     end
   end
 end

data/lib/portable/rendering/sheet.rb

@@ -21,27 +21,32 @@ module Portable
         @resolver = resolver
 
         @row_renderers = @document.sheets.each_with_object({}) do |sheet, memo|
-          next unless sheet.data_table
-
-          memo[sheet.name] = Row.new(sheet.data_table.columns, resolver: resolver)
+          memo[sheet.name] = Row.new(sheet.columns, resolver: resolver)
         end
 
         freeze
       end
 
-      def row_renderer(sheet_name, fields)
-        row_renderers.fetch(sheet_name, dynamic_row_renderer(fields))
+      def row_renderer(sheet_name, keys)
+        sheet        = document.sheet(sheet_name)
+        row_renderer = row_renderers.fetch(sheet_name.to_s)
+
+        return row_renderer unless sheet.auto?
+
+        dynamic_row_renderer(keys).merge(row_renderer)
       end
 
       private
 
       attr_reader :row_renderers
 
-      def dynamic_row_renderer(fields)
-        fields  = (fields || []).map { |f| { header: f.to_s } }
-        columns = Modeling::Column.array(fields)
+      def fields_to_columns(keys)
+        key_objects = (keys || []).map { |f| { header: f.to_s } }
+        Modeling::Column.array(key_objects)
+      end
 
-        Row.new(columns, resolver: resolver)
+      def dynamic_row_renderer(keys)
+        Row.new(fields_to_columns(keys), resolver: resolver)
       end
     end
   end

data/lib/portable/util.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+#
+# Copyright (c) 2020-present, Blue Marble Payroll, LLC
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+#
+
+require_relative 'util/pivotable'
+require_relative 'util/uniqueness'

data/lib/portable/util/pivotable.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+#
+# Copyright (c) 2020-present, Blue Marble Payroll, LLC
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+#
+
+module Portable
+  module Util # :nodoc: all
+    # Mixes in helpers for asserting uniqueness across collections
+    module Pivotable
+      def pivot_by_name(array)
+        array.each_with_object({}) { |object, memo| memo[object.name] = object }
+      end
+    end
+  end
+end

data/lib/portable/util/uniqueness.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+#
+# Copyright (c) 2020-present, Blue Marble Payroll, LLC
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+#
+
+module Portable
+  module Util # :nodoc: all
+    # Mixes in helpers for asserting uniqueness across collections
+    module Uniqueness
+      class DuplicateNameError < StandardError; end
+
+      def assert_no_duplicate_names(array)
+        names = array.map { |a| a.name.downcase }
+
+        return if names.uniq.length == array.length
+
+        raise DuplicateNameError, "cannot contain duplicate names (case insensitive): #{names}"
+      end
+    end
+  end
+end

data/lib/portable/version.rb

@@ -8,5 +8,5 @@
 #
 
 module Portable
-  VERSION = '1.0.0-alpha.3'
+  VERSION = '1.0.0'
 end

data/lib/portable/writers/base.rb

@@ -20,6 +20,14 @@ module Portable
 
         freeze
       end
+
+      private
+
+      def ensure_directory_exists(filename)
+        path = File.dirname(filename)
+
+        FileUtils.mkdir_p(path) unless File.exist?(path)
+      end
     end
   end
 end

data/lib/portable/writers/csv.rb

@@ -8,6 +8,7 @@
 #
 
 require_relative 'base'
+require_relative 'result'
 
 module Portable
   module Writers
@@ -18,16 +19,18 @@ module Portable
 
         ensure_directory_exists(filename)
 
-        sheet_filenames = extrapolate_filenames(filename)
+        sheet_filenames = extrapolate_filenames(filename, document.sheets.length)
 
-        document.sheets.each do |sheet|
-          data_source    = data_provider.data_source(sheet.name)
-          sheet_filename = sheet_filenames[sheet.name]
+        document.sheets.map.with_index do |sheet, index|
+          data_source    = data_provider.data_source(sheet.data_source_name)
+          sheet_filename = sheet_filenames[index]
 
-          write_sheet(sheet_filename, sheet, data_source, time)
-        end
+          time_in_seconds = Benchmark.measure do
+            write_sheet(sheet_filename, sheet, data_source, time)
+          end.real
 
-        sheet_filenames.values
+          Result.new(sheet_filename, time_in_seconds)
+        end
       end
 
       private
@@ -49,12 +52,12 @@ module Portable
       end
 
       def write_data_table(csv, sheet, data_source, time)
-        row_renderer = sheet_renderer.row_renderer(sheet.name, data_source.fields)
+        row_renderer = sheet_renderer.row_renderer(sheet.name, data_source.keys)
 
         csv << row_renderer.headers if sheet.include_headers?
 
         data_source.data_rows.each do |row|
-          csv << row_renderer.render(row, time).values
+          csv << row_renderer.render(row, time)
         end
       end
 
@@ -64,27 +67,17 @@ module Portable
         sheet.footer_rows.each { |row| csv << row }
       end
 
-      def ensure_directory_exists(filename)
-        path = File.dirname(filename)
-
-        FileUtils.mkdir_p(path) unless File.exist?(path)
-      end
-
-      def extrapolate_filenames(filename)
-        index    = 0
+      def extrapolate_filenames(filename, count)
         dir      = File.dirname(filename)
         ext      = File.extname(filename)
         basename = File.basename(filename, ext)
 
-        document.sheets.each_with_object({}) do |sheet, memo|
-          memo[sheet.name] =
-            if index.positive?
-              File.join(dir, "#{basename}.#{index}#{ext}")
-            else
-              filename
-            end
-
-          index += 1
+        (0..count).map do |index|
+          if index.positive?
+            File.join(dir, "#{basename}.#{index}#{ext}")
+          else
+            filename
+          end
         end
       end
     end

data/lib/portable/writers/result.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+#
+# Copyright (c) 2020-present, Blue Marble Payroll, LLC
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+#
+
+module Portable
+  module Writers
+    # Result return object from a Writer#write! call.
+    class Result
+      attr_reader :filename, :time_in_seconds
+
+      def initialize(filename, time_in_seconds)
+        @filename        = filename
+        @time_in_seconds = time_in_seconds
+
+        freeze
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: portable
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre.alpha.3
+  version: 1.0.0
 platform: ruby
 authors:
 - Matthew Ruggio
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-08-07 00:00:00.000000000 Z
+date: 2020-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: acts_as_hashable
@@ -165,6 +165,7 @@ files:
 - ".ruby-version"
 - ".travis.yml"
 - CHANGELOG.md
+- CODE_OF_CONDUCT.md
 - Gemfile
 - Guardfile
 - LICENSE
@@ -183,13 +184,17 @@ files:
 - lib/portable/modeling/options.rb
 - lib/portable/modeling/sheet.rb
 - lib/portable/rendering.rb
+- lib/portable/rendering/column.rb
 - lib/portable/rendering/row.rb
 - lib/portable/rendering/sheet.rb
-- lib/portable/uniqueness.rb
+- lib/portable/util.rb
+- lib/portable/util/pivotable.rb
+- lib/portable/util/uniqueness.rb
 - lib/portable/version.rb
 - lib/portable/writers.rb
 - lib/portable/writers/base.rb
 - lib/portable/writers/csv.rb
+- lib/portable/writers/result.rb
 - portable.gemspec
 homepage: https://github.com/bluemarblepayroll/portable
 licenses:
@@ -211,9 +216,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.0.3
 signing_key: 

data/lib/portable/uniqueness.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-#
-# Copyright (c) 2020-present, Blue Marble Payroll, LLC
-#
-# This source code is licensed under the MIT license found in the
-# LICENSE file in the root directory of this source tree.
-#
-
-module Portable
-  # Mixes in helpers for asserting uniqueness across collections
-  module Uniqueness
-    class DuplicateNameError < StandardError; end
-
-    def assert_no_duplicate_names(array)
-      names = array.map { |a| a.name.downcase }
-
-      return if names.uniq.length == array.length
-
-      raise DuplicateNameError, "cannot contain duplicate names: #{names}"
-    end
-  end
-end