safe_migrations 1.0.4 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: edeb710ced06f1f448d724ce1df93fcb40b537a2f46bde150d6ef2861f2335dd
-  data.tar.gz: 7d2125344e432d548c9e2389f762fba2a5b187d3d715588483ee75acfcbef838
+  metadata.gz: 3ef83718af52c34c752b51c61a5e8fb690fd9530299898c300ac51ba54d17341
+  data.tar.gz: 84a966d12c263a36fc8b8a9bce27e2d2589e21f66647c7e743f4480350c4906f
 SHA512:
-  metadata.gz: f337746ab082454d1257f59bc5609571ef525959a70013e4cbab71ba1750af3502a1f673c4051cfae50142ef0328310a375cde43a84d3abc57e75fff7a739e49
-  data.tar.gz: 72a3a411835da83974fa314a1c31f69dace5ac855d06398b8de9675e42537b95db8758ca174eea896faa1bc48eab974b4a55936b718d70d8629bde99e3c820ed
+  metadata.gz: 7918fb6c428ec15e024aeb8fabef6a1134f749f544df4a6b53643004ea3b0dec5f54e1bbea5ef7141942aa7542bf4a2aa94c905c22617750ff9201bd6186146a
+  data.tar.gz: b2f6952bfb9474d17f2eaa6c9ab544cdb87f959f1f5cab4e59eb736353fff4f513d723e8583c4bc36df2845921a87f80f817385201643fc49b5d667f388d05e5

data/.gitignore

@@ -7,5 +7,8 @@
 /spec/reports/
 /tmp/
 
+# macOS Finder metadata
+.DS_Store
+
 # rspec failure tracking
 .rspec_status

data/.rubocop.yml

@@ -1,2 +1,11 @@
+plugins:
+  - rubocop-rake
+  - rubocop-rspec
+
 AllCops:
   TargetRubyVersion: 3.2
+  NewCops: enable
+
+# Migration integration examples verify a complete transaction lifecycle.
+RSpec/ExampleLength:
+  Max: 15

data/.ruby-version

@@ -1 +1 @@
-3.2.9
+4.0.6

data/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2026-09-08
+
+### Added
+
+- Class-level `dry_runnable` option to automatically wrap upward `up` and `change` execution.
+- `dry_runnable { ... }` block helper and `dry_run?` predicate, controlled by `DRY_RUN`.
+- Dry runs execute real database changes, then roll back through Rails' migration transaction and leave the migration pending.
+- Guards reject dry runs when DDL transactions are disabled, unsupported, or no transaction is active.
+
 ## [1.0.0] - 2025-10-24
 
 ### Added
@@ -14,3 +23,4 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - N/A (initial release)
 
 [1.0.0]: https://github.com/moskvin/safe_migrations/releases/tag/v1.0.0
+[1.1.0]: https://github.com/moskvin/safe_migrations/releases/tag/v1.1.0

data/Gemfile

@@ -7,6 +7,12 @@ git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 # Specify your gem's dependencies in safe_migrations.gemspec
 gemspec
 
+gem 'bundler', '~> 2.7'
+gem 'rake', '~> 13.0'
+gem 'rubocop'
+gem 'rubocop-rake'
+gem 'rubocop-rspec'
+
 group :test do
   gem 'rspec', '~> 3.12'
   gem 'sqlite3', '~> 2.7'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    safe_migrations (1.0.4)
+    safe_migrations (1.1.0)
       activerecord (>= 7.0)
 
 GEM
@@ -40,12 +40,14 @@ GEM
     lint_roller (1.1.0)
     logger (1.7.0)
     mini_portile2 (2.8.9)
-    minitest (5.26.0)
+    minitest (6.0.6)
+      drb (~> 2.0)
+      prism (~> 1.5)
     parallel (1.27.0)
     parser (3.3.9.0)
       ast (~> 2.4.1)
       racc
-    prism (1.6.0)
+    prism (1.9.0)
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.3.0)
@@ -63,20 +65,27 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.6)
-    rubocop (1.81.6)
-      json (~> 2.3)
+    rubocop (1.90.0)
+      json (>= 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
-      parallel (~> 1.10)
+      parallel (>= 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.47.1, < 2.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.47.1)
+    rubocop-ast (1.50.0)
       parser (>= 3.3.7.2)
-      prism (~> 1.4)
+      prism (~> 1.7)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    rubocop-rspec (3.10.2)
+      lint_roller (~> 1.1)
+      regexp_parser (>= 2.0)
+      rubocop (~> 1.86, >= 1.86.2)
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
     sqlite3 (2.7.4)
@@ -96,7 +105,7 @@ GEM
       concurrent-ruby (~> 1.0)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
-    unicode-emoji (4.1.0)
+    unicode-emoji (4.2.0)
     uri (1.0.4)
 
 PLATFORMS
@@ -115,8 +124,10 @@ PLATFORMS
 DEPENDENCIES
   bundler (~> 2.7)
   rake (~> 13.0)
-  rspec (~> 3.12, ~> 3.0)
+  rspec (~> 3.12)
   rubocop
+  rubocop-rake
+  rubocop-rspec
   safe_migrations!
   sqlite3 (~> 2.7)
 

data/README.md

@@ -2,7 +2,7 @@
 
 G'day, mate! Welcome to **SafeMigrations**, a ripper of a gem that makes your Rails migrations as safe as a kangaroo in the outback. With `safe_` prefixed methods, this gem ensures your database schema changes are idempotent—no dramas if you run 'em twice. Built to play nice with Rails' `CommandRecorder`, it auto-reverses your migrations in the `change` method, so you can crack on with building your app without worrying about dodgy rollbacks.
 
-![safe-pg-migrations](./logo.jpeg)
+![safe_migrations](./logo.jpeg)
 
 [![Gem Version](https://badge.fury.io/rb/safe_migrations.svg)](https://badge.fury.io/rb/safe_migrations)
 [![CI](https://github.com/moskvin/safe_migrations/actions/workflows/ci.yml/badge.svg)](https://github.com/moskvin/safe_migrations/actions)
@@ -61,6 +61,64 @@ end
 - **Rolling Back**: `rails db:rollback` inverts to `safe_drop_table`, `safe_remove_column`, `safe_remove_index` (in reverse order).
 - **Heads Up**: If a table exists before the migration, `safe_create_table` skips it, but rollback may still call `safe_drop_table`. For critical cases, use `reversible`:
 
+### Dry runs (v1.1+)
+
+Declare `dry_runnable` once to wrap the entire upward migration automatically:
+
+```ruby
+class CleanupBrokenLinks < ActiveRecord::Migration[8.0]
+  dry_runnable
+
+  def up
+    # All database writes here run normally
+    Link.where(broken: true).destroy_all 
+  end
+
+  def down
+    raise ActiveRecord::IrreversibleMigration
+  end
+end
+```
+
+```bash
+DRY_RUN=1 bundle exec rails db:migrate:up VERSION=20260817090000
+# Apply for real:
+bundle exec rails db:migrate:up VERSION=20260817090000
+```
+
+With `DRY_RUN=1`, the body executes real SQL so counts and reports reflect real work.
+An `ActiveRecord::Rollback` then reaches Rails' migration transaction, undoing the
+writes and skipping the migration-version record: the migration remains pending.
+Unset `DRY_RUN` (or set it to `0` or `false`) for normal execution.
+
+The declaration is inherited and also supports `change` on upward execution;
+`down` and reversal of `change` are unaffected. Only opted-in migrations are wrapped.
+For existing migrations, the block form remains available:
+
+```ruby
+def up
+  dry_runnable do
+    # Database writes and reporting.
+  end
+end
+```
+
+`dry_run?` exposes the environment flag. Dry runs require Rails' migration runner,
+an active transaction, and an adapter supporting DDL transactions (such as PostgreSQL
+or SQLite). They reject `disable_ddl_transaction!` and unsupported adapters before
+executing the wrapped body. Direct calls to `up` bypass the class-level wrapper.
+Do not rescue `ActiveRecord::Rollback` or swallow it in an enclosing transaction
+around the block helper: it must reach the migration runner to leave the version pending.
+
+Rollback covers writes on the migration connection, not API calls, files, Ruby state,
+or writes on other database connections. Database sequences may still advance.
+Prefer targeting one migration: a full migration run can continue to later migrations
+after rollback, and migrations without the option still apply normally.
+
+When moving from an application-defined helper, remove its `dry_runnable` and
+`dry_run?` definitions so the gem supplies them. Application-specific helpers such
+as PaperTrail's `setup_version` stay in the application.
+
 ## Development
 
 No worries, mate! To get started:
@@ -75,9 +133,23 @@ To install the gem locally:
 $ bundle exec rake install
 ```
 
-To release a new version:
-1. Update the version in `lib/safe_migrations/version.rb`.
-2. Run `bundle exec rake release` to tag the version, push to Git, and ship the gem to [RubyGems.org](https://rubygems.org).
+To release a new version, update `lib/safe_migrations/version.rb` and the changelog,
+update the lockfile, then commit your changes and run:
+
+```bash
+bundle exec rake release:guarded
+# Equivalent:
+bin/release
+```
+
+The helper requires a clean worktree and the default branch (`origin/HEAD`, falling
+back to the current branch). It fetches origin, rejects a behind or diverged branch,
+and checks that the version tag does not already exist locally or remotely.
+It then runs specs and RuboCop, pushes the branch, and invokes Bundler's
+`bundle exec rake release` to build, tag, push, and publish to RubyGems.
+
+Use `bin/release --skip-checks` to skip specs and lint while retaining the git and
+version checks. `bin/release --help` displays usage without releasing anything.
 
 ## Testing
 

data/Rakefile

@@ -6,3 +6,10 @@ require 'rspec/core/rake_task'
 RSpec::Core::RakeTask.new(:spec)
 
 task default: :spec
+
+namespace :release do
+  desc 'Check git, run specs and lint, push the branch, then release to RubyGems'
+  task :guarded do
+    sh File.expand_path('bin/release', __dir__)
+  end
+end

data/bin/release

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+
+root_dir=$(cd "$(dirname "$0")/.." && pwd)
+cd "$root_dir"
+
+if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
+  cat <<'USAGE'
+Usage: bin/release [--skip-checks]
+
+Runs guardrails before releasing:
+1. Requires a clean git worktree
+2. Requires current branch to match origin/HEAD (or local HEAD fallback)
+3. Requires branch to be in sync with origin
+4. Runs test + lint checks (unless --skip-checks)
+5. Pushes the branch, then runs `bundle exec rake release`
+USAGE
+  exit 0
+fi
+
+skip_checks=false
+if [[ $# -gt 1 ]]; then
+  echo "Expected at most one option. Use --help for usage." >&2
+  exit 1
+fi
+
+if [[ "${1:-}" == "--skip-checks" ]]; then
+  skip_checks=true
+elif [[ $# -gt 0 ]]; then
+  echo "Unknown option: $1" >&2
+  exit 1
+fi
+
+if [[ -n "$(git status --porcelain)" ]]; then
+  echo "Working tree is not clean:" >&2
+  git status --short >&2
+  echo "Commit or stash changes before releasing. Plain git stash excludes untracked files; use git stash -u to include them." >&2
+  exit 1
+fi
+
+current_branch=$(git rev-parse --abbrev-ref HEAD)
+default_branch=$(git symbolic-ref --quiet --short refs/remotes/origin/HEAD 2>/dev/null | sed 's|^origin/||')
+default_branch=${default_branch:-$current_branch}
+
+if [[ "$current_branch" != "$default_branch" ]]; then
+  echo "Release must run from '$default_branch' (current: '$current_branch')." >&2
+  exit 1
+fi
+
+echo "Fetching latest refs from origin..."
+git fetch origin
+
+local_sha=$(git rev-parse @)
+remote_sha=$(git rev-parse "origin/$default_branch")
+base_sha=$(git merge-base @ "origin/$default_branch")
+
+if [[ "$local_sha" == "$remote_sha" ]]; then
+  echo "Branch is in sync with origin/$default_branch."
+elif [[ "$local_sha" == "$base_sha" ]]; then
+  echo "Local branch is behind origin/$default_branch. Pull/rebase first." >&2
+  exit 1
+elif [[ "$remote_sha" == "$base_sha" ]]; then
+  echo "Local branch is ahead of origin/$default_branch and will be pushed."
+else
+  echo "Local and origin/$default_branch have diverged. Rebase/merge first." >&2
+  exit 1
+fi
+
+version=$(ruby -e 'require_relative "lib/safe_migrations/version"; puts SafeMigrations::VERSION')
+tag="v$version"
+
+if git rev-parse "$tag" >/dev/null 2>&1 || git ls-remote --tags origin "$tag" | grep -q "$tag"; then
+  echo "Tag '$tag' already exists locally or on origin. Bump version first." >&2
+  exit 1
+fi
+
+if [[ "$skip_checks" == "false" ]]; then
+  echo "Running specs..."
+  bundle exec rspec
+
+  echo "Running RuboCop..."
+  bundle exec rubocop
+fi
+
+echo "Pushing branch '$default_branch' first..."
+git push origin "$default_branch"
+
+echo "Releasing gem with rake task..."
+bundle exec rake release
+
+echo "Release complete: $tag"

data/lib/safe_migrations/command_recorder_extension.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module SafeMigrations
+  # Records safe schema operations and supplies their inverses.
   module CommandRecorderExtension
     SAFE_METHODS = %i[
       safe_create_table
@@ -41,37 +42,47 @@ module SafeMigrations
     }.freeze
 
     def self.apply
-      ActiveRecord::Migration::CommandRecorder.class_eval do
-        SAFE_METHODS.each do |method|
-          define_method(:"#{method}") do |*args, &block|
-            record(:"#{method}", args, &block)
-          end
-          ruby2_keywords(method)
-        end
+      recorder = ActiveRecord::Migration::CommandRecorder
+      register_commands(recorder)
+      register_inverses(recorder)
+      recorder.prepend(SpecialInversions)
+    end
 
-        SAFE_REVERSIBLE_MAP.each do |cmd, inv|
-          define_method(:"invert_#{cmd}") do |args, &block|
-            [inv, args, block]
-          end
+    def self.register_commands(recorder)
+      SAFE_METHODS.each do |method|
+        recorder.define_method(method) do |*args, &block|
+          record(method, args, &block)
         end
+        recorder.send(:ruby2_keywords, method)
+      end
+    end
 
-        # Special case for safe_rename_column (swap column names)
-        def invert_safe_rename_column(args)
-          table, old_col, new_col = args
-          [:safe_rename_column, [table, new_col, old_col]]
+    def self.register_inverses(recorder)
+      SAFE_REVERSIBLE_MAP.each do |cmd, inv|
+        recorder.define_method(:"invert_#{cmd}") do |args, &block|
+          [inv, args, block]
         end
+      end
+    end
 
-        # Special case for safe_change_column_null (needs invert value)
-        def invert_safe_change_column_null(args)
-          table, column, value = args
-          [:safe_change_column_null, [table, column, !value]]
-        end
+    # Operations whose inverses require transformed arguments.
+    module SpecialInversions
+      # Special case for safe_rename_column (swap column names)
+      def invert_safe_rename_column(args)
+        table, old_col, new_col = args
+        [:safe_rename_column, [table, new_col, old_col]]
+      end
 
-        def invert_safe_change_column_default(args)
-          table, column, extra = args
-          reverted_extra = { to: extra[:from], from: extra[:to] }
-          [:safe_change_column_default, [table, column, reverted_extra]]
-        end
+      # Special case for safe_change_column_null (needs invert value)
+      def invert_safe_change_column_null(args)
+        table, column, value = args
+        [:safe_change_column_null, [table, column, !value]]
+      end
+
+      def invert_safe_change_column_default(args)
+        table, column, extra = args
+        reverted_extra = { to: extra[:from], from: extra[:to] }
+        [:safe_change_column_default, [table, column, reverted_extra]]
       end
     end
   end

data/lib/safe_migrations/dry_run.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module SafeMigrations
+  # Runs opted-in migrations inside the migrator's rollback boundary.
+  module DryRun
+    def self.included(base)
+      base.class_attribute(:safe_migrations_dry_runnable, instance_accessor: false, default: false)
+      base.extend(ClassMethods)
+      base.prepend(Execution)
+    end
+
+    # Inheritable migration opt-in.
+    module ClassMethods
+      def dry_runnable
+        self.safe_migrations_dry_runnable = true
+      end
+    end
+
+    # Wraps Rails execution without changing downward migrations.
+    module Execution
+      def exec_migration(conn, direction)
+        if direction == :up && self.class.safe_migrations_dry_runnable
+          perform_dry_run(conn) { super }
+        else
+          super
+        end
+      end
+    end
+
+    def dry_run?
+      !!ActiveModel::Type::Boolean.new.cast(ENV.fetch('DRY_RUN', nil))
+    end
+
+    def dry_runnable(&)
+      perform_dry_run(connection, &)
+    end
+
+    private
+
+    def perform_dry_run(conn)
+      return yield unless dry_run?
+
+      validate_dry_run_transaction!(conn)
+      say 'DRY_RUN: executing inside the migration transaction'
+      yield
+      say 'DRY_RUN: rolling back; migration will remain pending'
+      # This must reach the migrator's transaction, before it records the version.
+      raise ActiveRecord::Rollback
+    end
+
+    def validate_dry_run_transaction!(conn)
+      if self.class.disable_ddl_transaction || !conn.supports_ddl_transactions?
+        raise SafeMigrations::Error,
+              'DRY_RUN requires a migration with DDL transactions enabled and an adapter that supports them'
+      end
+      return if conn.transaction_open?
+
+      raise SafeMigrations::Error,
+            'DRY_RUN requires an active migration transaction; run through Rails migration tasks'
+    end
+  end
+end

data/lib/safe_migrations/migration_helper.rb

@@ -1,34 +1,40 @@
+# frozen_string_literal: true
+
 module SafeMigrations
+  # Adds idempotent schema operations to database adapters.
   module MigrationHelper
     def self.included(base)
       base.send(:include, InstanceMethods)
     end
 
+    # Checks schema state before applying each operation.
     module InstanceMethods
-      def safe_add_column(table, column, type, **options)
+      def safe_add_column(table, column, type, **)
         return unless table_exists?(table)
         return if column_exists?(table, column)
 
-        add_column(table, column, type, **options)
+        add_column(table, column, type, **)
       end
 
-      def safe_remove_column(table, column, type = nil, **options)
-        table_exists?(table) && column_exists?(table, column) && remove_column(table, column, type, **options)
+      def safe_remove_column(table, column, type = nil, **)
+        table_exists?(table) && column_exists?(table, column) && remove_column(table, column, type, **)
       end
 
       def safe_rename_column(table_name, column_name, new_column_name)
-        column_exists?(table_name, column_name) && !column_exists?(table_name, new_column_name) && rename_column(table_name, column_name, new_column_name)
+        column_exists?(table_name, column_name) &&
+          !column_exists?(table_name, new_column_name) &&
+          rename_column(table_name, column_name, new_column_name)
       end
 
-      def safe_add_index(table, column, **options)
+      def safe_add_index(table, column, **)
         return unless table_exists?(table)
-        return if index_exists?(table, column, **options)
+        return if index_exists?(table, column, **)
 
-        add_index(table, column, **options)
+        add_index(table, column, **)
       end
 
-      def safe_remove_index(table, column_name = nil, **options)
-        index_exists?(table, column_name, **options) && remove_index(table, column_name, **options)
+      def safe_remove_index(table, column_name = nil, **)
+        index_exists?(table, column_name, **) && remove_index(table, column_name, **)
       end
 
       def safe_add_column_and_index(table, column, type, column_options = {}, index_options = {})
@@ -41,31 +47,37 @@ module SafeMigrations
         safe_remove_column(table, column, **column_options)
       end
 
-      def safe_change_column(table, column, type, **options)
-        column_exists?(table, column) ? change_column(table, column, type, **options) : add_column(table, column, type, **options)
+      def safe_change_column(table, column, type, **)
+        if column_exists?(table, column)
+          change_column(table, column, type, **)
+        else
+          add_column(table, column, type, **)
+        end
       end
 
       def safe_change_column_null(table, column, null, default = nil)
         column_exists?(table, column) && change_column_null(table, column, null, default)
       end
 
-      def safe_create_table(table, **options, &block)
-        create_table(table, **options, &block) unless table_exists?(table)
+      def safe_create_table(table, **, &)
+        create_table(table, **, &) unless table_exists?(table)
       end
 
       def safe_drop_table(table, **)
         drop_table(table, if_exists: true, **) if table_exists?(table)
       end
 
-      def safe_add_foreign_key(from_table, to_table, **options)
+      def safe_add_foreign_key(from_table, to_table, **)
         return unless table_exists?(from_table) && table_exists?(to_table)
-        return if foreign_key_exists?(from_table, to_table, **options)
+        return if foreign_key_exists?(from_table, to_table, **)
 
-        add_foreign_key(from_table, to_table, **options)
+        add_foreign_key(from_table, to_table, **)
       end
 
-      def safe_remove_foreign_key(from_table, to_table, **options)
-        table_exists?(from_table) && table_exists?(to_table) && foreign_key_exists?(from_table, to_table, **options) && remove_foreign_key(from_table, to_table, **options)
+      def safe_remove_foreign_key(from_table, to_table, **)
+        table_exists?(from_table) && table_exists?(to_table) &&
+          foreign_key_exists?(from_table, to_table, **) &&
+          remove_foreign_key(from_table, to_table, **)
       end
 
       def safe_add_reference(table, ref_name, **)
@@ -75,7 +87,8 @@ module SafeMigrations
       end
 
       def safe_remove_reference(table, ref_name, **)
-        table_exists?(table) && column_exists?(table, "#{ref_name.to_s.singularize}_id") && remove_reference(table, ref_name, **)
+        table_exists?(table) && column_exists?(table, "#{ref_name.to_s.singularize}_id") &&
+          remove_reference(table, ref_name, **)
       end
 
       def check_constraint_exists?(table_name, **options)
@@ -93,7 +106,8 @@ module SafeMigrations
       end
 
       def safe_remove_check_constraint(table, condition, name:, **)
-        table_exists?(table) && check_constraint_exists?(table, name:) && remove_check_constraint(table, condition, name:, **)
+        table_exists?(table) && check_constraint_exists?(table, name:) &&
+          remove_check_constraint(table, condition, name:, **)
       end
 
       def safe_change_column_default(table, column, default_or_changes)

data/lib/safe_migrations/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module SafeMigrations
-  VERSION = '1.0.4'.freeze
+  VERSION = '1.1.0'
 end

data/lib/safe_migrations.rb

@@ -4,6 +4,7 @@ require 'active_record'
 require 'safe_migrations/version'
 require 'safe_migrations/migration_helper'
 require 'safe_migrations/command_recorder_extension'
+require 'safe_migrations/dry_run'
 
 module SafeMigrations
   class Error < StandardError; end
@@ -11,4 +12,5 @@ module SafeMigrations
 end
 
 ActiveRecord::ConnectionAdapters::AbstractAdapter.include(SafeMigrations::MigrationHelper)
+ActiveRecord::Migration.include(SafeMigrations::DryRun)
 SafeMigrations::CommandRecorderExtension.apply

data/safe_migrations.gemspec

@@ -11,7 +11,10 @@ Gem::Specification.new do |spec|
   spec.email         = ['nikolay.moskvin@gmail.com']
 
   spec.summary       = 'Idempotent migration helpers for Rails with safe, reversible operations.'
-  spec.description   = "SafeMigrations enhances Rails migrations with safe_ prefixed methods that prevent errors by checking for existing schema elements before execution. It integrates with Rails' CommandRecorder for automatic reversal in change-based migrations, ensuring safe and reliable database schema management."
+  spec.description   = 'SafeMigrations enhances Rails migrations with safe_ prefixed methods that prevent errors ' \
+                       'by checking for existing schema elements before execution. It integrates with Rails\' ' \
+                       'CommandRecorder for automatic reversal in change-based migrations, ensuring safe and ' \
+                       'reliable database schema management.'
   spec.homepage      = 'https://github.com/moskvin/safe_migrations'
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
@@ -22,9 +25,10 @@ Gem::Specification.new do |spec|
     spec.metadata['homepage_uri'] = spec.homepage
     spec.metadata['source_code_uri'] = 'https://github.com/moskvin/safe_migrations'
     spec.metadata['changelog_uri'] = 'https://github.com/moskvin/safe_migrations/blob/master/CHANGELOG.md'
+    spec.metadata['rubygems_mfa_required'] = 'true'
   else
     raise 'RubyGems 2.0 or newer is required to protect against ' \
-      'public gem pushes.'
+          'public gem pushes.'
   end
 
   # Specify which files should be added to the gem when it is released.
@@ -39,9 +43,4 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 3.2'
 
   spec.add_dependency 'activerecord', '>= 7.0'
-
-  spec.add_development_dependency 'bundler', '~> 2.7'
-  spec.add_development_dependency 'rake', '~> 13.0'
-  spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'rubocop'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: safe_migrations
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.1.0
 platform: ruby
 authors:
 - Nikolay Moskvin
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-03 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -24,62 +23,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.7'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.7'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  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'
 description: SafeMigrations enhances Rails migrations with safe_ prefixed methods
   that prevent errors by checking for existing schema elements before execution. It
   integrates with Rails' CommandRecorder for automatic reversal in change-based migrations,
@@ -103,9 +46,11 @@ files:
 - Rakefile
 - bin/console
 - bin/fix_bundle
+- bin/release
 - bin/setup
 - lib/safe_migrations.rb
 - lib/safe_migrations/command_recorder_extension.rb
+- lib/safe_migrations/dry_run.rb
 - lib/safe_migrations/migration_helper.rb
 - lib/safe_migrations/version.rb
 - logo.jpeg
@@ -117,7 +62,7 @@ metadata:
   homepage_uri: https://github.com/moskvin/safe_migrations
   source_code_uri: https://github.com/moskvin/safe_migrations
   changelog_uri: https://github.com/moskvin/safe_migrations/blob/master/CHANGELOG.md
-post_install_message:
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -132,8 +77,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Idempotent migration helpers for Rails with safe, reversible operations.
 test_files: []