db_fuel 2.0.0 → 2.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 532f508d6074e44c1dd4bb57dcecf343f32e035d44f6bdbfcb0405127ede5552
-  data.tar.gz: dccd390d0c15277ab9ca6c93027d12db85ebe7ad970333ebc2eadc7fc6f39b8c
+  metadata.gz: 6153de5e6e01820bf9c5b0bb67260ab4aa71198a82b775e1f34c771d4a520140
+  data.tar.gz: a95690fcf11543f4fdeb247190e993efe53c05f946ec866eb8e482378fd75e68
 SHA512:
-  metadata.gz: b49ad96e45049b564625a2288786e26087701e84c063aa71b316fde794237006c430fb9cc101ef2704efd79117702c36427e3bdf41098622ddb747e2af01d2f0
-  data.tar.gz: 1d426794ea2045a5a6c1966352b1e9a00ae991cf4d2996315011da26c99fa652ab0ce719dc3a8cd9a495f61df350a1cc1584d7e47a3aa0317276fbea866e6f37
+  metadata.gz: e446d0a87845c79afbcfb1d20859b6fc363e39cf6069c10e833f8524a161f66f4ef254282294e0188193f4e41054877b18b781077287f2c19bb10d1a03cba545
+  data.tar.gz: 172f25cbc3503861f0f82ffa20885697b7a1b46fd04f44d80a8a565f6781e7d72f1e714a57aab98ca2245e2fcbf44667bfb692a88e69f2021aedc8eba92e6a73

data/.circleci/config.yml

@@ -0,0 +1,73 @@
+version: 2.1
+
+orbs:
+  status_to_ms_teams: bluemarblepayroll/status_to_ms_teams_pure_bash@1.0.0
+
+jobs:
+  build:
+    parameters:
+      use-bundler-cache:
+        type: boolean
+        default: true
+
+    docker:
+      - image: circleci/ruby:2.6.6-buster
+        environment:
+          FORBID_FOCUSED_SPECS: 1
+          AR_VERSION: 5
+    working_directory: ~/db_fuel
+    steps:
+      - checkout
+      - run: cp spec/config/database.yaml.ci spec/config/database.yaml
+
+      # TODO: wrap bundler caching logic into an Orb:
+      - when:
+          condition: << parameters.use-bundler-cache >>
+          steps:
+            - restore_cache:
+                key: v1.0.0-build-ruby-dependency-cache-{{ checksum "db_fuel.gemspec" }}-{{ checksum "Gemfile" }}-{{ checksum ".ruby-version" }}
+
+      - run: bundle install --path vendor/bundle
+
+      - when:
+          condition: << parameters.use-bundler-cache >>
+          steps:
+            - save_cache:
+                key: v1.0.0-build-ruby-dependency-cache-{{ checksum "db_fuel.gemspec" }}-{{ checksum "Gemfile" }}-{{ checksum ".ruby-version" }}
+                paths:
+                  - vendor/bundle
+
+      - store_artifacts:
+          path: Gemfile.lock
+
+      - run: bundle exec rubocop
+
+      - run: COVERAGE=true bundle exec rspec -r rspec_junit_formatter --format progress --format RspecJunitFormatter -o test-results/rspec/results.xml
+
+      - store_test_results:
+          path: test-results
+
+      - store_artifacts:
+          path: coverage
+
+      - status_to_ms_teams/report:
+          webhook_url: $MS_TEAMS_WEBHOOK_URL
+
+workflows:
+  version: 2.1
+  build:
+    jobs:
+      - build:
+          context: org-global
+  monthly-gem-dependency-refresh-check:
+    triggers:
+      - schedule:
+          cron: '0 0 1 * *'
+          filters:
+            branches:
+              only:
+                - master
+    jobs:
+      - build:
+          context: org-global
+          use-bundler-cache: false

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+
+# 2.2.0 (May 23rd, 2021)
+
+Updates:
+
+* Updating dependencies for dbee to include newest versions.
+# 2.1.0 (May 19th, 2021)
+
+Additions:
+
+* Added keys_register to all db_fuel/active_record jobs.
+
+# 2.0.1 (March 18th, 2021)
+
+Changes:
+
+* Updated attribute_renderer_set to avoid an evaluation time issue with acts_as_hashable.
+
 # 2.0.0 (March 16th, 2021)
 
 New Jobs:

data/README.md

@@ -1,6 +1,6 @@
 # DB Fuel
 
-[![Gem Version](https://badge.fury.io/rb/db_fuel.svg)](https://badge.fury.io/rb/db_fuel) [![Build Status](https://travis-ci.org/bluemarblepayroll/db_fuel.svg?branch=master)](https://travis-ci.org/bluemarblepayroll/db_fuel) [![Maintainability](https://api.codeclimate.com/v1/badges/21945483950d9c35fabb/maintainability)](https://codeclimate.com/github/bluemarblepayroll/db_fuel/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/21945483950d9c35fabb/test_coverage)](https://codeclimate.com/github/bluemarblepayroll/db_fuel/test_coverage) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CircleCI](https://circleci.com/bb/bluemarble-ondemand/db_fuel/tree/master.svg?style=svg&circle-token=f1b2aed3fa173235db39da671c5b5db22e061609)](https://circleci.com/bb/bluemarble-ondemand/db_fuel/tree/master)
 
 This library is a plugin for [Burner](https://github.com/bluemarblepayroll/burner).  Burner, by itself, cannot use a database.  So, if you wish to use a database as a data source or as a target for mutation then you need to add a library similar to this.
 
@@ -24,11 +24,11 @@ Refer to the [Burner](https://github.com/bluemarblepayroll/burner) library for m
 
 ### ActiveRecord Jobs
 
-* **db_fuel/active_record/find_or_insert** [name, table_name, attributes, debug, primary_keyed_column, register, separator, timestamps, unique_attributes]: An extension of the `db_fuel/active_record/insert` job that adds an existence check before SQL insertion. The  `unique_attributes` will be converted to WHERE clauses for performing the existence check.
-* **db_fuel/active_record/insert** [name, table_name, attributes, debug, primary_keyed_column, register, separator, timestamps]: This job can take the objects in a register and insert them into a database table.  If primary_keyed_column is specified then its key will be set to the primary key.  Note that composite primary keys are not supported.  Attributes defines which object properties to convert to SQL.  Refer to the class and constructor specification for more detail.
-* **db_fuel/active_record/update_all** [name, table_name, attributes, debug, register, separator, timestamps, unique_attributes]: This job can take the objects in a register and updates them within a database table.  Attributes defines which object properties to convert to SQL SET clauses while unique_attributes translate to WHERE clauses. One or more records may be updated at a time.  Refer to the class and constructor specification for more detail.
-* **db_fuel/active_record/update** [name, table_name, attributes, debug, register, primary_keyed_column, separator, timestamps, unique_attributes]: This job can take the unique objects in a register and updates them within a database table.  Attributes defines which object properties to convert to SQL SET clauses while unique_attributes translate to WHERE clauses to find the records to update. The primary_keyed_column is used to update the unique record. Only one record will be updated per statement. Note that composite primary keys are not supported.  Refer to the class and constructor specification for more detail.
-* **db_fuel/active_record/upsert** [name, table_name, attributes, debug, primary_keyed_column, register, separator, timestamps, unique_attributes]: This job can take the objects in a register and either inserts or updates them within a database table.  Attributes defines which object properties to convert to SQL SET clauses while each key in unique_attributes become a WHERE clause in order to check for the existence of a specific record. The updated record will use the primary_keyed_column specified to perform the UPDATE operation. Note that composite primary keys are not supported. Refer to the class and constructor specification for more detail.
+* **db_fuel/active_record/find_or_insert** [name, table_name, attributes, debug, primary_keyed_column, keys_register, register, separator, timestamps, unique_attributes]: An extension of the `db_fuel/active_record/insert` job that adds an existence check before SQL insertion. The  `unique_attributes` will be converted to WHERE clauses for performing the existence check.
+* **db_fuel/active_record/insert** [name, table_name, attributes, debug, primary_keyed_column, keys_register, register, separator, timestamps]: This job can take the objects in a register and insert them into a database table.  If primary_keyed_column is specified then its key will be set to the primary key.  Note that composite primary keys are not supported.  Attributes defines which object properties to convert to SQL.  Refer to the class and constructor specification for more detail.
+* **db_fuel/active_record/update_all** [name, table_name, attributes, debug, keys_register, register, separator, timestamps, unique_attributes]: This job can take the objects in a register and updates them within a database table.  Attributes defines which object properties to convert to SQL SET clauses while unique_attributes translate to WHERE clauses. One or more records may be updated at a time.  Refer to the class and constructor specification for more detail.
+* **db_fuel/active_record/update** [name, table_name, attributes, debug, keys_register, register, primary_keyed_column, separator, timestamps, unique_attributes]: This job can take the unique objects in a register and updates them within a database table.  Attributes defines which object properties to convert to SQL SET clauses while unique_attributes translate to WHERE clauses to find the records to update. The primary_keyed_column is used to update the unique record. Only one record will be updated per statement. Note that composite primary keys are not supported.  Refer to the class and constructor specification for more detail.
+* **db_fuel/active_record/upsert** [name, table_name, attributes, debug, primary_keyed_column, keys_register, register, separator, timestamps, unique_attributes]: This job can take the objects in a register and either inserts or updates them within a database table.  Attributes defines which object properties to convert to SQL SET clauses while each key in unique_attributes become a WHERE clause in order to check for the existence of a specific record. The updated record will use the primary_keyed_column specified to perform the UPDATE operation. Note that composite primary keys are not supported. Refer to the class and constructor specification for more detail.
 
 ### Dbee Jobs
 
@@ -331,7 +331,7 @@ Each database record should have been updated with their new respective middle n
 
 #### Upserting Records
 
-Let's say we don't know if these chart_number values already exist or not. 
+Let's say we don't know if these chart_number values already exist or not.
 So we want db_fuel to either insert a record if the chart_number doesn't exist or update the record if the chart_number already exists.
 
 ````ruby
@@ -378,6 +378,10 @@ Notes:
 
 * The `unique_attributes` translate to WHERE clauses.
 * Set `debug: true` to print out each UPDATE statement in the output (not for production use.)
+
+#### Limiting The Columns Being Inserted/Updated
+
+All the db_fuel/active_record/* jobs now feature an optional `keys_register` option.  If this is set, the register will be read and used as a key filter for which fields to set.  For example, if you configure a db_fuel/active_record/insert job to update A, B, C, and D, but your keys_register contains [A,B] then only A and B will be inserted/set.  This is helpful in scenarios where you may want to outline how to update _all_ possible fields but your input set only contains a subset of those fields and you do not wish to set the others to null.
 ## Contributing
 
 ### Development Environment Configuration
@@ -417,7 +421,7 @@ Note: ensure you have proper authorization before trying to publish new versions
 After code changes have successfully gone through the Pull Request review process then the following steps should be followed for publishing new versions:
 
 1. Merge Pull Request into master
-2. Update `lib/db_fuel/version.rb` using [semantic versioning](https://semver.org/)
+2. Update `version.rb` using [semantic versioning](https://semver.org/)
 3. Install dependencies: `bundle`
 4. Update `CHANGELOG.md` with release notes
 5. Commit & push master to remote and ensure CI builds master successfully

data/db_fuel.gemspec

@@ -16,15 +16,7 @@ Gem::Specification.new do |s|
   s.files       = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   s.bindir      = 'exe'
   s.executables = %w[]
-  s.homepage    = 'https://github.com/bluemarblepayroll/db_fuel'
   s.license     = 'MIT'
-  s.metadata    = {
-    'bug_tracker_uri' => 'https://github.com/bluemarblepayroll/db_fuel/issues',
-    'changelog_uri' => 'https://github.com/bluemarblepayroll/db_fuel/blob/master/CHANGELOG.md',
-    'documentation_uri' => 'https://www.rubydoc.info/gems/db_fuel',
-    'homepage_uri' => s.homepage,
-    'source_code_uri' => s.homepage
-  }
 
   s.required_ruby_version = '>= 2.5'
 
@@ -43,14 +35,15 @@ Gem::Specification.new do |s|
   s.add_dependency('activerecord', activerecord_version)
   s.add_dependency('acts_as_hashable', '~>1.2')
   s.add_dependency('burner', '~>1.7')
-  s.add_dependency('dbee', '~>2.1')
-  s.add_dependency('dbee-active_record', '~>2.1')
+  s.add_dependency('dbee', '~>3.0')
+  s.add_dependency('dbee-active_record', '~>2.2')
   s.add_dependency('objectable', '~>1.0')
 
   s.add_development_dependency('guard-rspec', '~>4.7')
   s.add_development_dependency('pry', '~>0')
   s.add_development_dependency('rake', '~> 13')
   s.add_development_dependency('rspec', '~> 3.8')
+  s.add_development_dependency('rspec_junit_formatter')
   s.add_development_dependency('rubocop', '~>1.7.0')
   s.add_development_dependency('simplecov', '~>0.18.5')
   s.add_development_dependency('simplecov-console', '~>0.7.0')

data/lib/db_fuel/library/active_record/base.rb

@@ -19,25 +19,31 @@ module DbFuel
         NOW_TYPE   = 'r/value/now'
         UPDATED_AT = :updated_at
 
-        attr_reader :attribute_renderers,
-                    :db_provider,
+        attr_reader :db_provider,
                     :debug,
+                    :keys_register,
                     :resolver,
-                    :attribute_renderers_set
+                    :record_transformer
 
         def initialize(
           table_name:,
           name: '',
           attributes: [],
           debug: false,
+          keys_register: nil,
           register: Burner::DEFAULT_REGISTER,
           separator: ''
         )
           super(name: name, register: register)
 
-          @resolver = Objectable.resolver(separator: separator)
-          @attribute_renderers_set = Modeling::AttributeRendererSet.new(resolver: resolver,
-                                                                        attributes: attributes)
+          @keys_register = keys_register.to_s
+          @resolver      = Objectable.resolver(separator: separator)
+
+          @record_transformer = Modeling::RecordTransformer.new(
+            resolver: resolver,
+            attributes: attributes
+          )
+
           @db_provider = DbProvider.new(table_name)
           @debug = debug || false
         end
@@ -49,6 +55,16 @@ module DbFuel
 
           output.detail(message)
         end
+
+        def resolve_key_set(output, payload)
+          return Set.new if keys_register.empty?
+
+          keys = array(payload[keys_register]).map(&:to_s).to_set
+
+          output.detail("Limiting to only keys: #{keys.to_a.join(', ')}") if keys.any?
+
+          keys
+        end
       end
     end
   end

data/lib/db_fuel/library/active_record/find_or_insert.rb

@@ -57,6 +57,7 @@ module DbFuel
           name: '',
           attributes: [],
           debug: false,
+          keys_register: nil,
           primary_keyed_column: nil,
           register: Burner::DEFAULT_REGISTER,
           separator: '',
@@ -66,6 +67,7 @@ module DbFuel
 
           super(
             name: name,
+            keys_register: keys_register,
             table_name: table_name,
             attributes: attributes,
             debug: debug,
@@ -82,6 +84,7 @@ module DbFuel
           total_existed  = 0
 
           payload[register] = array(payload[register])
+          keys              = resolve_key_set(output, payload)
 
           payload[register].each do |row|
             exists = find_record(output, row, payload.time)
@@ -91,7 +94,7 @@ module DbFuel
               next
             end
 
-            insert_record(output, row, payload.time)
+            insert_record(output, row, payload.time, keys)
 
             total_inserted += 1
           end

data/lib/db_fuel/library/active_record/insert.rb

@@ -45,6 +45,7 @@ module DbFuel
         #               to the current UTC timestamp.
         def initialize(
           table_name:,
+          keys_register: nil,
           name: '',
           attributes: [],
           debug: false,
@@ -53,11 +54,11 @@ module DbFuel
           separator: '',
           timestamps: true
         )
-
           attributes = Burner::Modeling::Attribute.array(attributes)
 
           super(
             name: name,
+            keys_register: keys_register,
             table_name: table_name,
             attributes: attributes,
             debug: debug,
@@ -70,8 +71,11 @@ module DbFuel
 
         def perform(output, payload)
           payload[register] = array(payload[register])
+          keys              = resolve_key_set(output, payload)
+
+          output.detail("Inserting #{payload[register].count} record(s)")
 
-          payload[register].each { |row| insert_record(output, row, payload.time) }
+          payload[register].each { |row| insert_record(output, row, payload.time, keys) }
         end
       end
     end

data/lib/db_fuel/library/active_record/update.rb

@@ -57,6 +57,7 @@ module DbFuel
           attributes: [],
           debug: false,
           primary_keyed_column: nil,
+          keys_register: nil,
           register: Burner::DEFAULT_REGISTER,
           separator: '',
           timestamps: true,
@@ -70,6 +71,7 @@ module DbFuel
             table_name: table_name,
             attributes: attributes,
             debug: debug,
+            keys_register: keys_register,
             primary_keyed_column: primary_keyed_column,
             register: register,
             separator: separator,
@@ -81,20 +83,16 @@ module DbFuel
         end
 
         def perform(output, payload)
-          total_rows_affected = 0
-
           payload[register] = array(payload[register])
+          keys              = resolve_key_set(output, payload)
 
-          payload[register].each do |row|
-            rows_affected = 0
-
-            first_record = update_record(output, row, payload.time)
-
-            rows_affected = 1 if first_record
+          total_rows_affected = payload[register].inject(0) do |memo, row|
+            first_record  = update_record(output, row, payload.time, keys)
+            rows_affected = first_record ? 1 : 0
 
             debug_detail(output, "Individual Rows Affected: #{rows_affected}")
 
-            total_rows_affected += rows_affected
+            memo + rows_affected
           end
 
           output.detail("Total Rows Affected: #{total_rows_affected}")

data/lib/db_fuel/library/active_record/update_all.rb

@@ -50,6 +50,7 @@ module DbFuel
           attributes: [],
           debug: false,
           register: Burner::DEFAULT_REGISTER,
+          keys_register: nil,
           separator: '',
           timestamps: true,
           unique_attributes: []
@@ -63,6 +64,7 @@ module DbFuel
             attributes: attributes,
             debug: debug,
             primary_keyed_column: nil,
+            keys_register: keys_register,
             register: register,
             separator: separator,
             timestamps: timestamps,
@@ -73,19 +75,16 @@ module DbFuel
         end
 
         def perform(output, payload)
-          total_rows_affected = 0
-
           payload[register] = array(payload[register])
+          keys              = resolve_key_set(output, payload)
 
-          payload[register].each do |row|
-            where_object = attribute_renderers_set
-                           .transform(unique_attribute_renderers, row, payload.time)
-
-            rows_affected = update(output, row, payload.time, where_object)
+          total_rows_affected = payload[register].inject(0) do |memo, row|
+            where_object  = unique_record_transformer.transform(row, payload.time)
+            rows_affected = update(output, row, payload.time, where_object, keys)
 
             debug_detail(output, "Individual Rows Affected: #{rows_affected}")
 
-            total_rows_affected += rows_affected
+            memo + rows_affected
           end
 
           output.detail("Total Rows Affected: #{total_rows_affected}")

data/lib/db_fuel/library/active_record/upsert.rb

@@ -21,7 +21,7 @@ module DbFuel
       # Expected Payload[register] input: array of objects
       # Payload[register] output: array of objects.
       class Upsert < Base
-        attr_reader :primary_keyed_column, :timestamps, :unique_attribute_renderers
+        attr_reader :primary_keyed_column, :timestamps, :unique_record_transformer
 
         # Arguments:
         #   name: name of the job within the Burner::Pipeline.
@@ -59,6 +59,7 @@ module DbFuel
         def initialize(
           table_name:,
           primary_keyed_column:,
+          keys_register: nil,
           name: '',
           attributes: [],
           debug: false,
@@ -69,6 +70,7 @@ module DbFuel
         )
           super(
             name: name,
+            keys_register: keys_register,
             table_name: table_name,
             attributes: attributes,
             debug: debug,
@@ -78,8 +80,10 @@ module DbFuel
 
           @primary_keyed_column = Modeling::KeyedColumn.make(primary_keyed_column, nullable: true)
 
-          @unique_attribute_renderers = attribute_renderers_set
-                                        .make_renderers(unique_attributes)
+          @unique_record_transformer = Modeling::RecordTransformer.new(
+            resolver: resolver,
+            attributes: unique_attributes
+          )
 
           @timestamps = timestamps
 
@@ -93,9 +97,10 @@ module DbFuel
           total_updated  = 0
 
           payload[register] = array(payload[register])
+          keys              = resolve_key_set(output, payload)
 
           payload[register].each do |row|
-            record_updated = insert_or_update(output, row, payload.time)
+            record_updated = insert_or_update(output, row, payload.time, keys)
 
             if record_updated
               total_updated += 1
@@ -111,7 +116,7 @@ module DbFuel
         protected
 
         def find_record(output, row, time)
-          unique_row = attribute_renderers_set.transform(unique_attribute_renderers, row, time)
+          unique_row = unique_record_transformer.transform(row, time)
 
           first_sql = db_provider.first_sql(unique_row)
 
@@ -128,16 +133,14 @@ module DbFuel
           first_record
         end
 
-        def insert_record(output, row, time)
-          dynamic_attrs = if timestamps
-                            # doing an INSERT and timestamps should be set
-                            # set the created_at and updated_at fields
-                            attribute_renderers_set.timestamp_created_attribute_renderers
-                          else
-                            attribute_renderers_set.attribute_renderers
-                          end
-
-          set_object = attribute_renderers_set.transform(dynamic_attrs, row, time)
+        def insert_record(output, row, time, keys = Set.new)
+          set_object = record_transformer.transform(
+            row,
+            time,
+            keys: keys,
+            created_at: timestamps,
+            updated_at: timestamps
+          )
 
           insert_sql = db_provider.insert_sql(set_object)
 
@@ -152,7 +155,7 @@ module DbFuel
         end
 
         # Updates only a single record. Lookups primary key to update the record.
-        def update_record(output, row, time)
+        def update_record(output, row, time, keys)
           raise ArgumentError, 'primary_keyed_column is required' unless primary_keyed_column
 
           first_record = find_record(output, row, time)
@@ -165,23 +168,20 @@ module DbFuel
             where_object = { primary_keyed_column.column => id }
 
             # update record using the primary key as the WHERE clause
-            update(output, row, time, where_object)
+            update(output, row, time, where_object, keys)
           end
 
           first_record
         end
 
         # Updates one or many records depending on where_object passed
-        def update(output, row, time, where_object)
-          dynamic_attrs = if timestamps
-                            # doing an UPDATE and timestamps should be set,
-                            # modify the updated_at field, don't modify the created_at field
-                            attribute_renderers_set.timestamp_updated_attribute_renderers
-                          else
-                            attribute_renderers_set.attribute_renderers
-                          end
-
-          set_object = attribute_renderers_set.transform(dynamic_attrs, row, time)
+        def update(output, row, time, where_object, keys)
+          set_object = record_transformer.transform(
+            row,
+            time,
+            keys: keys,
+            updated_at: timestamps
+          )
 
           update_sql = db_provider.update_sql(set_object, where_object)
 
@@ -194,14 +194,14 @@ module DbFuel
 
         private
 
-        def insert_or_update(output, row, time)
-          first_record = update_record(output, row, time)
+        def insert_or_update(output, row, time, keys)
+          first_record = update_record(output, row, time, keys)
 
           if first_record
             first_record
           else
             # create the record
-            insert_record(output, row, time)
+            insert_record(output, row, time, keys)
             nil
           end
         end

data/lib/db_fuel/modeling/record_transformer.rb

@@ -0,0 +1,99 @@
+# 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 DbFuel
+  module Modeling
+    # Creates attribute renderers based on attributes passed.
+    # Also constains methods to transform attribute renderers
+    # and include timestamp attributes if needed.
+    class RecordTransformer # :nodoc:
+      NOW_TYPE   = 'r/value/now'
+      CREATED_AT = 'created_at'
+      UPDATED_AT = 'updated_at'
+
+      attr_reader :attribute_renderers, :resolver
+
+      def initialize(resolver:, attributes: [])
+        raise ArgumentError, 'resolver is required' unless resolver
+
+        @resolver            = resolver
+        @attribute_renderers = make_renderers(attributes)
+
+        freeze
+      end
+
+      def transform(row, time, keys: Set.new, created_at: false, updated_at: false)
+        dynamic_attributes, all_keys = make_dynamic_attributes(
+          keys: keys,
+          created_at: created_at,
+          updated_at: updated_at
+        )
+
+        dynamic_attributes.each_with_object({}) do |attribute_renderer, memo|
+          next if all_keys.any? && all_keys.exclude?(attribute_renderer.key)
+
+          value = attribute_renderer.transform(row, time)
+
+          resolver.set(memo, attribute_renderer.key, value)
+        end
+      end
+
+      private
+
+      def make_dynamic_attributes(keys:, created_at:, updated_at:)
+        dynamic_attributes = attribute_renderers
+        all_keys           = keys
+
+        if created_at
+          dynamic_attributes += [
+            Burner::Modeling::AttributeRenderer.new(created_at_timestamp_attribute, resolver)
+          ]
+
+          all_keys += [CREATED_AT] if keys.any?
+        end
+
+        if updated_at
+          dynamic_attributes += [
+            Burner::Modeling::AttributeRenderer.new(updated_at_timestamp_attribute, resolver)
+          ]
+
+          all_keys += [UPDATED_AT] if keys.any?
+        end
+
+        [
+          dynamic_attributes,
+          all_keys
+        ]
+      end
+
+      def make_renderers(attributes)
+        Burner::Modeling::Attribute
+          .array(attributes)
+          .map { |a| Burner::Modeling::AttributeRenderer.new(a, resolver) }
+      end
+
+      def created_at_timestamp_attribute
+        timestamp_attribute(CREATED_AT)
+      end
+
+      def updated_at_timestamp_attribute
+        timestamp_attribute(UPDATED_AT)
+      end
+
+      def timestamp_attribute(key)
+        Burner::Modeling::Attribute.make(
+          key: key,
+          transformers: [
+            { type: NOW_TYPE }
+          ]
+        )
+      end
+    end
+  end
+end

data/lib/db_fuel/modeling.rb

@@ -8,4 +8,4 @@
 #
 
 require_relative 'modeling/keyed_column'
-require_relative 'modeling/attribute_renderer_set'
+require_relative 'modeling/record_transformer'

data/lib/db_fuel/version.rb

@@ -8,5 +8,5 @@
 #
 
 module DbFuel
-  VERSION = '2.0.0'
+  VERSION = '2.2.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: db_fuel
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.2.1
 platform: ruby
 authors:
 - Matthew Ruggio
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-03-16 00:00:00.000000000 Z
+date: 2021-12-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -65,28 +65,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: dbee-active_record
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '2.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: objectable
   requirement: !ruby/object:Gem::Requirement
@@ -157,6 +157,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.8'
+- !ruby/object:Gem::Dependency
+  name: rspec_junit_formatter
+  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: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -222,12 +236,12 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".circleci/config.yml"
 - ".editorconfig"
 - ".gitignore"
 - ".rubocop.yml"
 - ".ruby-version"
 - ".tool-versions"
-- ".travis.yml"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
@@ -251,18 +265,13 @@ files:
 - lib/db_fuel/library/dbee/query.rb
 - lib/db_fuel/library/dbee/range.rb
 - lib/db_fuel/modeling.rb
-- lib/db_fuel/modeling/attribute_renderer_set.rb
 - lib/db_fuel/modeling/keyed_column.rb
+- lib/db_fuel/modeling/record_transformer.rb
 - lib/db_fuel/version.rb
-homepage: https://github.com/bluemarblepayroll/db_fuel
+homepage:
 licenses:
 - MIT
-metadata:
-  bug_tracker_uri: https://github.com/bluemarblepayroll/db_fuel/issues
-  changelog_uri: https://github.com/bluemarblepayroll/db_fuel/blob/master/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/db_fuel
-  homepage_uri: https://github.com/bluemarblepayroll/db_fuel
-  source_code_uri: https://github.com/bluemarblepayroll/db_fuel
+metadata: {}
 post_install_message:
 rdoc_options: []
 require_paths:

data/.travis.yml

@@ -1,28 +0,0 @@
-env:
-  global:
-    - CC_TEST_REPORTER_ID=2d57d597269e2cb04a63d0a7262927cf811abb7ab528da7de681943b212b4134
-  jobs:
-    - AR_VERSION=5
-    - AR_VERSION=6
-language: ruby
-rvm:
-  # Build on the latest stable of all supported Rubies (https://www.ruby-lang.org/en/downloads/):
-  - 2.5.8
-  - 2.6.6
-  - 2.7.1
-cache: bundler
-before_script:
-  - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
-  - chmod +x ./cc-test-reporter
-  - ./cc-test-reporter before-build
-  - cp spec/config/database.yaml.ci spec/config/database.yaml
-script:
-  - bundle exec rubocop
-  - bundle exec rspec spec --format documentation
-after_script:
-  - ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT
-addons:
-  # https://docs.travis-ci.com/user/uploading-artifacts/
-  artifacts:
-    paths:
-      - Gemfile.lock

data/lib/db_fuel/modeling/attribute_renderer_set.rb

@@ -1,70 +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 DbFuel
-  module Modeling
-    # Creates attribute renderers based on attributes passed.
-    # Also constains methods to transform attribute renderers
-    # and include timestamp attributes if needed.
-    class AttributeRendererSet # :nodoc:
-      NOW_TYPE   = 'r/value/now'
-
-      CREATED_AT = Burner::Modeling::Attribute.make(
-        key: :created_at, transformers: [{ type: NOW_TYPE }]
-      )
-
-      UPDATED_AT = Burner::Modeling::Attribute.make(
-        key: :updated_at, transformers: [{ type: NOW_TYPE }]
-      )
-
-      attr_reader :attribute_renderers, :resolver
-
-      def initialize(resolver:, attributes: [])
-        raise ArgumentError, 'resolver is required' unless resolver
-
-        @resolver            = resolver
-        @attribute_renderers = make_renderers(attributes)
-
-        freeze
-      end
-
-      # Adds the attributes for created_at and updated_at to the currrent attribute renderers.
-      def timestamp_created_attribute_renderers
-        timestamp_attributes = [CREATED_AT, UPDATED_AT]
-
-        timestamp_attributes.map do |a|
-          Burner::Modeling::AttributeRenderer.new(a, resolver)
-        end + attribute_renderers
-      end
-
-      # Adds the attribute for updated_at to the currrent attribute renderers.
-      def timestamp_updated_attribute_renderers
-        timestamp_attributes = [UPDATED_AT]
-
-        timestamp_attributes.map do |a|
-          Burner::Modeling::AttributeRenderer.new(a, resolver)
-        end + attribute_renderers
-      end
-
-      def make_renderers(attributes)
-        Burner::Modeling::Attribute
-          .array(attributes)
-          .map { |a| Burner::Modeling::AttributeRenderer.new(a, resolver) }
-      end
-
-      def transform(attribute_renderers, row, time)
-        attribute_renderers.each_with_object({}) do |attribute_renderer, memo|
-          value = attribute_renderer.transform(row, time)
-
-          resolver.set(memo, attribute_renderer.key, value)
-        end
-      end
-    end
-  end
-end