data_shifter 0.3.3 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f9ab924aaeb0638f2061907484bc7ba4f5e795a1ea58e96f1ae8b0a7542b150
-  data.tar.gz: 24a81ebe9a5e1f0d27d4cec1494fd26c4c8d1209ddca2aba6cd606dec14e4dda
+  metadata.gz: 2b117c23db49ab1654f56e2901792147277a957da4b65e308a893197846d24e4
+  data.tar.gz: 26cae4d79c699e8f84e52570bde8de7150e31bc812562197c1ffd9f1e4fdaf58
 SHA512:
-  metadata.gz: f5834ec7a2545de4342cc3f9205c8ce0f3a0b53fdfbebacd1452b7196c1b7cb606c4fa4d32e8e7d92532ff7e958f5537d2cba51e0176f9d760cdad9fa8b31498
-  data.tar.gz: cefd020aedd8a63f65f0bb507bcf8843a65fac12debfb78e47cd0e74b485e98746a8d3b805e0c2be6071254488308a1c10b47fb9e5280f13425d6eade6f4113d
+  metadata.gz: 6cc508407a213fae51bb740e352b27d8c470496cc7d6608bdf5a209360f55a801e7a60e9028aa62336b2d32475da7c189d9c79215970e950c30dc5577e056b4d
+  data.tar.gz: d3d625d0876a3574994ba877cc89e4c698f4ce083ebab597f1b92051122a78047cec201c2794aac7096e1b958d141c15dddc24d24582c6092a1adbb198502370

data/CHANGELOG.md

@@ -2,7 +2,15 @@
 
 ## [Unreleased]
 
-* N/A
+## [0.3.4]
+
+* [Changed] `COMMIT` / `DRY_RUN` are now parsed as real booleans (`1/true/t/yes/y/on` vs `0/false/f/no/n/off`, case- and whitespace-insensitive). **`DRY_RUN=1` now means a dry run** — previously the `DRY_RUN == "true"` compare read `DRY_RUN=1` as "not dry" and committed the shift, which is data loss for a value that is truthy in every other tool. Unrecognized values (e.g. `COMMIT=garbage`) now raise `ArgumentError` instead of silently dry-running. `DRY_RUN=false` / `COMMIT=1` still commit.
+* [Changed] Bumped the minimum Rails (ActiveRecord, ActiveSupport, Railties) to `>= 7.2`, matching upstream `axn`. Its `on_success` now fires via `ActiveRecord.after_all_transactions_commit`, which requires ActiveRecord 7.2+.
+* [Feature] `throttle` now accepts an optional `per:` keyword. When set, the sleep is inserted only after processing that many records instead of after every record (e.g. `throttle 1.second, per: 100` sleeps once per 100 records).
+* [Feature] `task` now accepts an Axn class as sugar for a one-axn task: `task "label", SomeAxn, foo: 1` forwards to `SomeAxn.call!(foo: 1)`, so a helper axn's failure is never silently swallowed. Keyword args are static (evaluated at class-load); use the block form when you need runtime values. Passing both a class and a block raises.
+* [Feature] `inline_csv` reads CSV colocated with the shift after a `__END__` marker, so small data sets can live alongside the code. Returns the data rows (`CSV::Row` objects by default, so `row["id"]` works); options forward to `CSV.parse`. Typically used as `def collection = inline_csv`. `csv` is required lazily (not a hard dependency) — add `gem "csv"` to your Gemfile if you're on Ruby 3.4+ and hit a load error.
+* [Changed] Configuration now rides on the upstream `Axn::Configurable` DSL instead of a hand-rolled config object. The public API is unchanged — `DataShifter.configure { |c| ... }`, `DataShifter.config.x`, and the per-shift `progress`/`suppress_repeated_logs` overrides all keep working. This raises the minimum `axn` to `>= 0.1.0.alpha.5` (the first release shipping `Axn::Configurable`), now depended on from rubygems rather than a git pin.
+* [Changed] Replaced the removed `log_calls false` DSL with `auto_log false` (axn renamed the method on main). The previous `respond_to?(:log_calls)` guard silently no-op'd, re-enabling axn's per-call logging that shifts intend to suppress.
 
 ## [0.3.3]
 

data/README.md

@@ -58,6 +58,33 @@ module DataShifts
 end
 ```
 
+### Inline CSV data (small data sets)
+
+When the data driving a shift is small, you can colocate it with the code after a `__END__` marker instead of keeping a separate file. `inline_csv` parses that section and returns the rows (`CSV::Row` objects by default, so `row["col"]` works):
+
+```ruby
+module DataShifts
+  class BackfillTimeZones < DataShifter::Shift
+    description "Set time zones from a fixed list"
+
+    def collection = inline_csv
+
+    def process_record(row)
+      User.find(row["id"]).update!(time_zone: row["time_zone"])
+    end
+  end
+end
+
+__END__
+id,time_zone
+1,Pacific Time (US & Canada)
+2,Eastern Time (US & Canada)
+```
+
+Options forward straight to `CSV.parse` (e.g. `inline_csv(col_sep: ";")`). Large data sets (the multi-thousand-row variety) are better kept in a separate `.csv` you load yourself, so they can be opened in a spreadsheet editor.
+
+`inline_csv` requires the `csv` library lazily, so it isn't a dependency unless you use it. `csv` ships with Ruby through 3.3 and is a bundled gem on 3.4+; on Ruby 3.4+ you may need to add `gem "csv"` to your Gemfile.
+
 ### Task-based shifts (targeted, one-off changes)
 
 For targeted changes to specific records (e.g. fixing a bug for particular IDs), use `task` blocks instead:
@@ -86,6 +113,15 @@ end
 
 Task blocks run in the context of the shift instance, so they have access to private helper methods, `dry_run?`, `log`, `skip!`, `find_exactly!`, and any other instance methods you define. Use private methods to DRY up shared lookups across tasks.
 
+When a task is just a single helper [axn](https://github.com/teamshares/axn), pass the class instead of a block — its keyword args are forwarded to `.call!`, so a failure is reported instead of silently swallowed:
+
+```ruby
+task "Recalculate company totals", RecalculateTotals, company_id: 123
+# equivalent to: task("Recalculate company totals") { RecalculateTotals.call!(company_id: 123) }
+```
+
+The kwargs are evaluated at class-load time, so this form is for static values; use the block form when you need runtime or instance state.
+
 Task blocks:
 
 - Run in sequence within the same lifecycle (transaction, dry run protection, summary)
@@ -105,6 +141,8 @@ Shifts run in **dry run** mode by default. DB changes are always rolled back in
 - **Commit**: `COMMIT=1 rake data:shift:backfill_foo`
   - (`COMMIT=true` or `DRY_RUN=false` also commit)
 
+`COMMIT` and `DRY_RUN` are parsed as booleans — `1`, `true`, `t`, `yes`, `y`, `on` are truthy; `0`, `false`, `f`, `no`, `n`, `off` are falsey (case- and whitespace-insensitive). `COMMIT=<truthy>` commits; otherwise `DRY_RUN` decides, defaulting to a dry run — so `DRY_RUN=1` is a **dry run**, not a commit. An unrecognized value (e.g. `COMMIT=please`) raises rather than guessing a side.
+
 ### Automatic side-effect guards (dry run)
 
 In **dry run** mode, DataShifter automatically blocks or fakes these side effects so unguarded code is less likely to hit the network or send mail/jobs:
@@ -310,11 +348,14 @@ Skip reasons are grouped: the summary shows the top 10 reasons by count (e.g. `"
 
 ```ruby
 class SomeShift < DataShifter::Shift
-  throttle 0.1       # sleep seconds between records
-  progress false    # disable progress bar rendering
+  throttle 0.1                  # sleep 0.1s after every record
+  throttle 1.second, per: 100   # sleep 1s after every 100 records
+  progress false                # disable progress bar rendering
 end
 ```
 
+`per:` is optional. Without it, the sleep runs after every record. With `per: N`, the sleep runs after every Nth record — useful for large collections where per-record sleeping would add too much wall-clock time.
+
 
 ## Generator
 
@@ -367,7 +408,8 @@ end
 ## Requirements
 
 - Ruby ≥ 3.2.1
-- Rails (ActiveRecord, ActiveSupport, Railties) ≥ 7.0
+- Rails (ActiveRecord, ActiveSupport, Railties) ≥ 7.2
 - `axn` (Shift classes include `Axn`)
 - `ruby-progressbar` (for progress bars)
 - `webmock` (for dry-run HTTP blocking; optional allowlist via `allow_external_requests [...]` / `DataShifter.config.allow_external_requests`)
+- `csv` — only if you use `inline_csv`; required lazily, not a hard dependency (ships with Ruby through 3.3, a bundled gem on 3.4+)

data/lib/data_shifter/internal/env.rb

@@ -7,14 +7,27 @@ module DataShifter
     module Env
       module_function
 
-      # Determine dry_run mode from environment variables.
-      # COMMIT=1 or COMMIT=true means dry_run=false
-      # DRY_RUN=false means dry_run=false; default is true
+      TRUTHY = %w[1 true t yes y on].freeze
+      FALSEY = %w[0 false f no n off].freeze
+
+      # COMMIT=<truthy> means commit. Otherwise DRY_RUN decides, defaulting to a dry run.
       def dry_run?
-        if ENV["COMMIT"].present?
-          !%w[1 true].include?(ENV["COMMIT"].to_s.downcase)
+        return !boolean!("COMMIT") if ENV["COMMIT"].present?
+        return true if ENV["DRY_RUN"].blank?
+
+        boolean!("DRY_RUN")
+      end
+
+      # Raises on anything unrecognized rather than picking a side. The old `DRY_RUN == "true"`
+      # compare silently read `DRY_RUN=1` as "not dry" and committed the shift — a value that is
+      # truthy in every other tool has to mean dry run here or it means data loss.
+      def boolean!(var)
+        raw = ENV.fetch(var, nil)
+        case raw.to_s.strip.downcase
+        when *TRUTHY then true
+        when *FALSEY then false
         else
-          ENV.fetch("DRY_RUN", "true") == "true"
+          raise ArgumentError, "#{var}=#{raw.inspect} is not a boolean — use one of: #{(TRUTHY + FALSEY).join(", ")}"
         end
       end
 

data/lib/data_shifter/settings.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "axn"
+
+# Global configuration for DataShifter, declared via the Axn::Configurable DSL.
+#
+# Configure via:
+#   DataShifter.configure do |config|
+#     config.allow_external_requests = ["api.readonly.example.com"]
+#     config.suppress_repeated_logs = false
+#   end
+#
+# Or access directly:
+#   DataShifter.config.progress_enabled = false
+#
+# This supplies DataShifter.config / .configure / .reset_config! plus per-setting
+# accessors and predicates. `progress_enabled` and `suppress_repeated_logs` are
+# `overridable: true`, so individual shifts can override them per-class (see Shift).
+#
+# Required from both data_shifter.rb and shift.rb (idempotent, like any require)
+# so `include DataShifter.overrides` in Shift works whichever is required first.
+module DataShifter
+  extend Axn::Configurable
+
+  # Namespaces DataShifter's overridable settings (`suppress_repeated_logs`, `progress_enabled`) so
+  # they can't collide with axn core's own `:core`-namespaced overridable settings — both compose
+  # onto every Shift subclass, since Shift `include Axn` as well as `DataShifter.overrides`. Declared
+  # explicitly (matching Axn::Configuration's own `config_namespace :core`) even though the default
+  # (this module object) is already collision-safe; must come before any `setting`.
+  config_namespace :data_shifter
+
+  # Hosts or regexes allowed for HTTP during dry run only (combined with per-shift allow_external_requests).
+  # Has no effect in commit mode — HTTP is unrestricted when dry_run is false.
+  setting :allow_external_requests, default: []
+
+  # Whether to allow loopback HTTP (127.0.0.1, ::1, localhost) during dry runs. Default: true.
+  # Loopback is rarely "external" and is needed for tracing/metrics sidecars (Datadog agent on
+  # 8126, statsd on 8125, OTLP collector, etc.). Set to false if you want strict net blocking.
+  setting :allow_loopback_requests, default: true
+
+  # Whether to suppress repeated log messages during a shift run. Default: true.
+  # Can be overridden per shift with `suppress_repeated_logs true/false`.
+  setting :suppress_repeated_logs, default: true, overridable: true
+
+  # Maximum unique log messages to track for deduplication. Default: 1000.
+  # When exceeded, entries with count == 1 are cleared first; repeated entries are kept.
+  setting :repeated_log_cap, default: 1000
+
+  # Global default for progress bar visibility. Default: true.
+  # Per-shift `progress true/false` overrides this.
+  setting :progress_enabled, default: true, overridable: true
+
+  # Default status print interval in seconds when ENV STATUS_INTERVAL is not set. Default: nil.
+  setting :status_interval_seconds, default: nil
+end

data/lib/data_shifter/shift.rb

@@ -2,6 +2,7 @@
 
 require "axn"
 require "active_support/isolated_execution_state"
+require_relative "settings"
 require_relative "internal/env"
 require_relative "internal/output"
 require_relative "internal/signal_handler"
@@ -49,10 +50,17 @@ require_relative "internal/colors"
 module DataShifter
   class Shift
     include Axn
+    # Per-class overrides for `progress_enabled` and `suppress_repeated_logs`
+    # (declared `overridable: true` on the DataShifter module). Adds class-level
+    # `progress_enabled` (bare reader resolves the override, else falls back to
+    # config) / `progress_enabled_override` (and likewise for suppress_repeated_logs)
+    # accessors; the thin `progress` / `suppress_repeated_logs` aliases below
+    # preserve the historical public DSL.
+    include DataShifter.overrides
 
     expects :dry_run, type: :boolean, default: true
 
-    log_calls false if respond_to?(:log_calls)
+    auto_log false
 
     around :_with_log_deduplication
     around :_with_side_effect_guards
@@ -62,12 +70,11 @@ module DataShifter
     on_error :_print_summary_for_axn_error
 
     class_attribute :_transaction_mode, default: :single
-    class_attribute :_progress_enabled, default: nil
     class_attribute :_description, default: nil
     class_attribute :_task_name, default: nil
     class_attribute :_throttle_interval, default: nil
+    class_attribute :_throttle_per, default: 1
     class_attribute :_allow_external_requests, default: [], instance_accessor: false
-    class_attribute :_suppress_repeated_logs, default: nil, instance_accessor: false
     class_attribute :_task_blocks, default: [], instance_accessor: false
 
     # Internal exception used by skip! to abort the current process_record.
@@ -105,16 +112,22 @@ module DataShifter
         end
       end
 
+      # Per-shift override for progress bar visibility. Overrides DataShifter.config.progress_enabled.
+      # Thin alias over the `progress_enabled` override accessor generated by DataShifter.overrides.
+      #   progress false   # set override (coerced to a boolean)
+      #   progress         # read the raw override (nil when unset; does NOT fall back to config)
       def progress(enabled = nil)
         if enabled.nil?
-          _progress_enabled
+          raw = progress_enabled_override
+          Axn::Configurable::UNSET.equal?(raw) ? nil : raw
         else
-          self._progress_enabled = !!enabled
+          progress_enabled(!!enabled)
         end
       end
 
-      def throttle(interval)
+      def throttle(interval, per: 1)
         self._throttle_interval = interval
+        self._throttle_per = per
       end
 
       # Allow these hosts (or regexes) for HTTP during dry run only. Combines with DataShifter.config.allow_external_requests.
@@ -125,22 +138,36 @@ module DataShifter
       end
 
       # Enable/disable log deduplication for this shift. Overrides DataShifter.config.suppress_repeated_logs.
+      # Thin alias over the `suppress_repeated_logs` override accessor generated by DataShifter.overrides
+      # (which would otherwise read the resolved value when called with no args); we always treat a call
+      # with an argument as a set, coercing to a boolean.
       # Example: suppress_repeated_logs false
       def suppress_repeated_logs(enabled)
-        self._suppress_repeated_logs = !!enabled
+        super(!!enabled)
       end
 
-      # Define a task block to run instead of collection/process_record.
-      # Multiple blocks run in sequence; labels appear in errors and summary.
-      # Example:
+      # Define a task to run instead of collection/process_record.
+      # Multiple tasks run in sequence; labels appear in errors and summary.
+      #
+      # Block form (arbitrary code, runtime/instance state available):
       #   task "Fix user A" do
       #     User.find(123).update!(...)
       #   end
-      #   task "Fix user B" do
-      #     User.find(456).update!(...)
-      #   end
-      def task(label = nil, &block)
-        raise ArgumentError, "task requires a block" unless block_given?
+      #
+      # Axn class form (sugar for one helper axn; kwargs are static, evaluated
+      # at class-load time, and forwarded to .call! so a failure is never
+      # silently swallowed). Use the block form when you need runtime values:
+      #   task "Recalculate totals", RecalculateTotals, company_id: 123
+      #   # => RecalculateTotals.call!(company_id: 123)
+      def task(label = nil, axn = nil, **axn_kwargs, &block)
+        if axn
+          raise ArgumentError, "task accepts either an Axn class or a block, not both" if block
+          raise ArgumentError, "task expected an Axn class but got #{axn.inspect}" unless axn.is_a?(Class) && axn.include?(Axn)
+
+          block = -> { axn.call!(**axn_kwargs) }
+        elsif block.nil?
+          raise ArgumentError, "task requires a block or an Axn class"
+        end
 
         self._task_blocks = (_task_blocks || []).dup + [{ label: label.presence, block: }]
       end
@@ -174,6 +201,24 @@ module DataShifter
       ids.map { |id| records_by_id[id] }
     end
 
+    # Parse CSV colocated with the shift, after a `__END__` marker, so small
+    # data sets can live alongside the code. Returns the data rows as an array
+    # (CSV::Row objects when headers: true, the default — so `row["id"]` works);
+    # extra options forward straight to CSV.parse. Typically used as the
+    # collection:
+    #   def collection = inline_csv
+    #   def process_record(row) = User.find(row["id"]).update!(...)
+    #   __END__
+    #   id,...
+    #
+    # Lazily requires `csv` (a bundled gem on Ruby 3.4+); raises with a hint to
+    # add it to the Gemfile if unavailable.
+    def inline_csv(**csv_opts)
+      _require_csv!
+      parsed = CSV.parse(_inline_data_body, headers: true, **csv_opts)
+      parsed.is_a?(CSV::Table) ? parsed.each.to_a : parsed
+    end
+
     def dry_run? = dry_run
 
     def skip!(reason = nil)
@@ -192,7 +237,10 @@ module DataShifter
     # --- Axn lifecycle hooks ---
 
     def _with_log_deduplication(chain)
-      effective = self.class._suppress_repeated_logs.nil? ? DataShifter.config.suppress_repeated_logs : self.class._suppress_repeated_logs
+      # DataShifter.resolve_override_for, not the generated `suppress_repeated_logs` reader:
+      # that name is shadowed by Shift's own class method (a required-arg setter, see above),
+      # which would raise ArgumentError rather than resolve the override + config fallback.
+      effective = DataShifter.resolve_override_for(self.class, :suppress_repeated_logs)
       unless effective && defined?(::Rails) && ::Rails.respond_to?(:logger) && ::Rails.logger
         chain.call
         return
@@ -399,19 +447,29 @@ module DataShifter
     end
 
     def _iterate(enum, total)
-      progress_on = _progress_enabled.nil? ? DataShifter.config.progress_enabled : _progress_enabled
+      # DataShifter.resolve_override_for: the shadow-proof framework path (see
+      # _with_log_deduplication). progress_enabled isn't currently shadowed on Shift,
+      # but resolving this way is consistent and doesn't depend on that staying true.
+      progress_on = DataShifter.resolve_override_for(self.class, :progress_enabled)
       bar = Internal::ProgressBar.create(total:, dry_run: dry_run?, enabled: progress_on)
+      throttle_count = 0
       if enum.respond_to?(:find_each)
         enum.find_each do |record|
           _process_one(record) { yield record }
           bar&.increment
-          sleep(_throttle_interval) if _throttle_interval
+          if _throttle_interval
+            throttle_count += 1
+            sleep(_throttle_interval) if (throttle_count % _throttle_per).zero?
+          end
         end
       else
         enum.each do |record|
           _process_one(record) { yield record }
           bar&.increment
-          sleep(_throttle_interval) if _throttle_interval
+          if _throttle_interval
+            throttle_count += 1
+            sleep(_throttle_interval) if (throttle_count % _throttle_per).zero?
+          end
         end
       end
     end
@@ -445,6 +503,44 @@ module DataShifter
       _print_progress
     end
 
+    # `csv` is lazily required (not a hard dependency) so it isn't dragged into
+    # apps that never call inline_csv. csv ships with Ruby through 3.3 and is a
+    # bundled gem on 3.4+, so this normally just works; on 3.5+ without it in the
+    # Gemfile we surface an actionable message instead of a bare LoadError.
+    def _require_csv!
+      require "csv"
+    rescue LoadError
+      raise LoadError, 'inline_csv needs the csv library. Add `gem "csv"` to your Gemfile (csv is no longer a default gem on Ruby 3.4+).'
+    end
+
+    # The raw text after this shift file's `__END__` marker. Resolves the
+    # source file via the class constant (works however the shift is invoked,
+    # unlike Ruby's `DATA`, which is only defined for the main script). Uses
+    # Ripper (not a text-based split) to find the real `__END__` token, so a
+    # `__END__`-looking line inside a heredoc or comment isn't mistaken for it.
+    def _inline_data_body
+      @_inline_data_body ||= begin
+        class_name = self.class.name
+        source = class_name && Object.const_source_location(class_name)&.first
+        raise ArgumentError, "inline_csv requires the shift to be a named class defined in a file" unless source && File.exist?(source)
+
+        require "ripper"
+        content = File.read(source)
+        offset = 0
+        found = false
+        Ripper.lex(content).each do |(_pos, type, token, _state)|
+          offset += token.length
+          if type == :on___end__
+            found = true
+            break
+          end
+        end
+        raise ArgumentError, "inline_csv: no __END__ data section found in #{source}" unless found
+
+        content[offset..]
+      end
+    end
+
     def _format_error(e)
       msg = e.message.to_s
       msg += "\n  Caused by: #{e.cause.class}: #{e.cause.message}" if e.respond_to?(:cause) && e.cause

data/lib/data_shifter/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DataShifter
-  VERSION = "0.3.3"
+  VERSION = "0.3.4"
 end

data/lib/data_shifter.rb

@@ -1,27 +1,8 @@
 # frozen_string_literal: true
 
 require_relative "data_shifter/version"
-require_relative "data_shifter/configuration"
+require_relative "data_shifter/settings"
 require_relative "data_shifter/errors"
 require_relative "data_shifter/internal/rake_exception_reporting"
 require_relative "data_shifter/shift"
 require_relative "data_shifter/railtie"
-
-module DataShifter
-  class << self
-    # Returns the global configuration instance.
-    def config
-      @config ||= Configuration.new
-    end
-
-    # Yields the configuration for block-style setup.
-    #
-    #   DataShifter.configure do |c|
-    #     c.allow_external_requests = ["api.readonly.example.com"]
-    #     c.suppress_repeated_logs = false
-    #   end
-    def configure
-      yield config
-    end
-  end
-end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: data_shifter
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.3.4
 platform: ruby
 authors:
 - Kali Donovan
@@ -15,35 +15,35 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: axn
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.0.pre.alpha.4
+        version: 0.1.0.pre.alpha.5
     - - "<"
       - !ruby/object:Gem::Version
         version: 0.2.0
@@ -53,7 +53,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.0.pre.alpha.4
+        version: 0.1.0.pre.alpha.5
     - - "<"
       - !ruby/object:Gem::Version
         version: 0.2.0
@@ -63,14 +63,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -107,14 +107,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".husky/pre-commit"
-- ".lintstagedrc"
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
-- Rakefile
 - lib/data_shifter.rb
-- lib/data_shifter/configuration.rb
 - lib/data_shifter/errors.rb
 - lib/data_shifter/internal/colors.rb
 - lib/data_shifter/internal/env.rb
@@ -127,6 +123,7 @@ files:
 - lib/data_shifter/internal/side_effect_guards.rb
 - lib/data_shifter/internal/signal_handler.rb
 - lib/data_shifter/railtie.rb
+- lib/data_shifter/settings.rb
 - lib/data_shifter/shift.rb
 - lib/data_shifter/spec_helper.rb
 - lib/data_shifter/version.rb

data/.husky/pre-commit

@@ -1 +0,0 @@
-npx lint-staged

data/.lintstagedrc

@@ -1,3 +0,0 @@
-{
-  "*.rb": ["bundle exec rubocop -A -c .rubocop.yml --force-exclusion"]
-}

data/Rakefile

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-require "rubocop/rake_task"
-
-task :spec do
-  sh "bundle exec rspec"
-end
-
-RuboCop::RakeTask.new
-
-task default: %i[spec rubocop]
-
-# Ensure specs and rubocop pass before release (must run first; enhance appends)
-release_task = Rake::Task["release"]
-release_task.prerequisites.unshift(:default)

data/lib/data_shifter/configuration.rb

@@ -1,48 +0,0 @@
-# frozen_string_literal: true
-
-module DataShifter
-  # Global configuration for DataShifter.
-  #
-  # Configure via:
-  #   DataShifter.configure do |config|
-  #     config.allow_external_requests = ["api.readonly.example.com"]
-  #     config.suppress_repeated_logs = true
-  #   end
-  #
-  # Or access directly:
-  #   DataShifter.config.progress_enabled = false
-  class Configuration
-    # Hosts or regexes allowed for HTTP during dry run only (combined with per-shift allow_external_requests).
-    # Has no effect in commit mode — HTTP is unrestricted when dry_run is false.
-    attr_accessor :allow_external_requests
-
-    # Whether to allow loopback HTTP (127.0.0.1, ::1, localhost) during dry runs. Default: true.
-    # Loopback is rarely "external" and is needed for tracing/metrics sidecars (Datadog agent on
-    # 8126, statsd on 8125, OTLP collector, etc.). Set to false if you want strict net blocking.
-    attr_accessor :allow_loopback_requests
-
-    # Whether to suppress repeated log messages during a shift run. Default: true.
-    # Can be overridden per shift with `suppress_repeated_logs true/false`.
-    attr_accessor :suppress_repeated_logs
-
-    # Maximum unique log messages to track for deduplication. Default: 1000.
-    # When exceeded, entries with count == 1 are cleared first; repeated entries are kept.
-    attr_accessor :repeated_log_cap
-
-    # Global default for progress bar visibility. Default: true.
-    # Per-shift `progress true/false` overrides this.
-    attr_accessor :progress_enabled
-
-    # Default status print interval in seconds when ENV STATUS_INTERVAL is not set. Default: nil.
-    attr_accessor :status_interval_seconds
-
-    def initialize
-      @allow_external_requests = []
-      @allow_loopback_requests = true
-      @suppress_repeated_logs = true
-      @repeated_log_cap = 1000
-      @progress_enabled = true
-      @status_interval_seconds = nil
-    end
-  end
-end