strong_schema 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8f99b64786bd64749ee2d1057010e8611c69467b0d062cef5769b924810b8df2
+  data.tar.gz: f2bafd2bad2d5ee36da1db286df226475dbcb48f516ef7102202e6dabfd21322
+SHA512:
+  metadata.gz: f4e791a186fe1d8861350ab1074e93c1cc51f2c2b595b01bfd3457f6d964a9a9338945731ba00d7f751b81b18c208f2f2426dc8f98b0e6fe420beb6d9f5e6271
+  data.tar.gz: 972badf7551749b3bef9d3530fe933999fdefe68b159bfdae818196c67c24f11000b4966014d694d63725abaf35696994b227c850ca40b29a456036bf89c8728

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-02-15
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 shoma07
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,92 @@
+# Strong Schema
+
+🛡️ Brings [Strong Migrations](https://github.com/ankane/strong_migrations) safety checks to schema-based database management.
+
+## Overview
+
+Tools using `ActiveRecord::Schema` for declarative database management lack safety checks for dangerous operations. This can lead to production issues—such as removing columns without proper safeguards or adding indexes that lock tables.
+
+Strong Schema brings the same proven safety checks from Strong Migrations to schema-based workflows, catching unsafe operations before they reach your database.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'strong_schema'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+## Usage
+
+### Configuration
+
+To customize settings, create a configuration file:
+
+```ruby
+# config/strong_schema.rb
+require "strong_schema"
+
+StrongMigrations.start_after = 20260214142757
+StrongMigrations.lock_timeout = 10.seconds
+StrongMigrations.statement_timeout = 1.hour
+StrongMigrations.auto_analyze = true
+```
+
+### Integration with Ridgepole
+
+When using Ridgepole, load the configuration file using the `-r` option:
+
+```bash
+$ ridgepole --apply -c config/database.yml -r ./config/strong_schema.rb
+```
+
+### Ignoring Specific Operations
+
+When you need to bypass safety checks for operations you've verified as safe, use `StrongSchema.add_ignore`:
+
+```ruby
+# config/strong_schema.rb
+require "strong_schema"
+
+# Ignore a specific column removal
+StrongSchema.add_ignore do |method, args|
+  method == :remove_column && 
+    args[0].to_s == "users" && 
+    args[1].to_s == "old_email"
+end
+
+# Ignore by table name (all operations on the table)
+StrongSchema.add_ignore do |method, args|
+  args[0].to_s == "legacy_table"
+end
+```
+
+The block receives:
+- `method`: Operation symbol (`:add_column`, `:remove_column`, `:change_column`, etc.)
+- `args`: Arguments array. First element is typically the table name.
+
+**Note:** Operations inside `change_table` blocks are detected with their original method names (`:remove_column`, `:add_column`, etc.), not as `:change_table`. The same ignore rules work for both direct operations and operations within `change_table` blocks.
+
+## Acknowledgments
+
+This gem stands on the shoulders of giants. Special thanks to the following project:
+
+- [Strong Migrations](https://github.com/ankane/strong_migrations) - Safety checks for migrations
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/shoma07/strong_schema.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new(:lint) do |t|
+  t.options = ["--parallel"]
+end
+
+require "steep/rake_task"
+
+Steep::RakeTask.new(:typecheck) do |t|
+  t.check.severity_level = :error
+  t.watch.verbose
+end
+
+namespace :rbs do
+  desc "Generated RBS files from rbs-inline"
+  task :inline do
+    require "rbs/inline"
+    require "rbs/inline/cli"
+    io = StringIO.new
+    RBS::Inline::CLI.new(stdout: io).run(%w[lib --opt-out])
+    result = io.tap(&:rewind)
+               .each_line.grep_v(/\A[[:blank:]]*#/).join
+               .sub(/\A(?:[[:blank:]]*\n)+/, "")
+               .sub(/(?:\n[[:blank:]]*)+\z/, "\n")
+    File.write("sig/strong_schema.rbs", result)
+  end
+end
+
+task default: %i[rbs:inline typecheck spec lint]

data/Steepfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+target :lib do
+  signature "sig"
+  ignore_signature "sig-private"
+
+  check "lib"
+end

data/lib/strong_schema/ignore_checks.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module StrongSchema
+  module IgnoreChecks
+    #:  () { (Symbol, Array[untyped]) -> bool } -> void
+    def add_ignore(&block)
+      ignore_checks << block
+    end
+
+    #:  () -> Array[Proc]
+    def ignore_checks
+      @ignore_checks ||= []
+    end
+
+    #:  () -> void
+    def reset_ignores!
+      @ignore_checks = []
+    end
+
+    #:  (Symbol, Array[untyped]) -> bool
+    def should_ignore?(method, args)
+      ignore_checks.any? { |check| check.call(method, args) }
+    end
+  end
+end

data/lib/strong_schema/railtie.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module StrongSchema
+  class Railtie < Rails::Railtie
+    initializer "strong_schema.configure" do
+      ActiveSupport.on_load(:active_record) do
+        StrongSchema.setup
+      end
+    end
+  end
+end

data/lib/strong_schema/schema_extension.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module StrongSchema
+  module SchemaExtension
+    #:  (Symbol, *untyped) -> untyped
+    def method_missing(method, *args)
+      return super if method == :change_table || StrongSchema.should_ignore?(method, args)
+
+      catch(:safe) do
+        StrongMigrations::Checker.new(self).tap { |c| c.direction = :up }.perform(method, *args) do
+          super
+        end
+      end
+    end
+
+    begin
+      ruby2_keywords(:method_missing)
+    rescue NameError
+      # ruby2_keywords is unavailable in some Ruby versions.
+    end
+  end
+end

data/lib/strong_schema/table_extension.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module StrongSchema
+  module TableExtension
+    OPERATION_MAP = {
+      column: :add_column,
+      index: :add_index,
+      change: :change_column,
+      change_default: :change_column_default,
+      change_null: :change_column_null,
+      remove: :remove_column,
+      remove_index: :remove_index,
+      remove_timestamps: :remove_timestamps,
+      rename: :rename_column,
+      references: :add_reference,
+      belongs_to: :add_reference,
+      remove_references: :remove_reference,
+      remove_belongs_to: :remove_reference,
+      foreign_key: :add_foreign_key,
+      check_constraint: :add_check_constraint
+    }.freeze #: Hash[Symbol, Symbol]
+    public_constant :OPERATION_MAP
+
+    OPERATION_MAP.each do |table_method, migration_method|
+      define_method(table_method) do |*args, **kwargs, &block|
+        return super(*args, **kwargs, &block) if StrongSchema.should_ignore?(migration_method, [@name, *args])
+
+        catch(:safe) do
+          checker = StrongMigrations::Checker.new(MigrationProxy.instance).tap { |c| c.direction = :up }
+          checker.perform(migration_method, @name, *args, **kwargs) { super(*args, **kwargs, &block) }
+        end
+      end
+    end
+
+    class MigrationProxy
+      include Singleton
+
+      #:  () -> false
+      def reverting?
+        false
+      end
+
+      #:  () -> nil
+      def version; end
+
+      #:  () -> ActiveRecord::ConnectionAdapters::AbstractAdapter
+      def connection
+        ActiveRecord::Base.connection
+      end
+
+      #:  (String, ?header: String) -> void
+      def stop!(message, header: "Custom check")
+        raise StrongMigrations::UnsafeMigration, "\n=== #{header} #strong_migrations ===\n\n#{message}\n"
+      end
+    end
+  end
+end

data/lib/strong_schema/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module StrongSchema
+  VERSION = "0.1.0" #: String
+end

data/lib/strong_schema.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "singleton"
+require "strong_migrations"
+
+require_relative "strong_schema/version"
+require_relative "strong_schema/ignore_checks"
+require_relative "strong_schema/schema_extension"
+require_relative "strong_schema/table_extension"
+
+module StrongSchema
+  extend IgnoreChecks
+
+  class << self
+    # @rbs!
+    #   @setup_done: bool?
+
+    #:  () -> void
+    def setup
+      return if @setup_done
+
+      ActiveRecord::Schema.prepend(SchemaExtension)
+      ActiveRecord::ConnectionAdapters::Table.prepend(TableExtension)
+
+      @setup_done = true
+    end
+
+    #:  () -> void
+    def install_boot_hook
+      if defined?(Rails::Railtie)
+        require_relative "strong_schema/railtie"
+      elsif defined?(ActiveRecord::Base)
+        setup
+      elsif defined?(ActiveSupport)
+        ActiveSupport.on_load(:active_record) { StrongSchema.setup }
+      end
+    end
+  end
+end
+
+StrongSchema.install_boot_hook

data/rbs_collection.lock.yaml

@@ -0,0 +1,156 @@
+---
+path: ".gem_rbs_collection"
+gems:
+- name: activemodel
+  version: '7.1'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: f17b218ad76ff3800d651e9bc42a15ba311095b4
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: activerecord
+  version: '8.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: f17b218ad76ff3800d651e9bc42a15ba311095b4
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: activesupport
+  version: '7.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: f17b218ad76ff3800d651e9bc42a15ba311095b4
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: base64
+  version: 0.3.0
+  source:
+    type: rubygems
+- name: bigdecimal
+  version: '4.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: f17b218ad76ff3800d651e9bc42a15ba311095b4
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: concurrent-ruby
+  version: '1.1'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: f17b218ad76ff3800d651e9bc42a15ba311095b4
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: connection_pool
+  version: '2.4'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: f17b218ad76ff3800d651e9bc42a15ba311095b4
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: date
+  version: '0'
+  source:
+    type: stdlib
+- name: delegate
+  version: '0'
+  source:
+    type: stdlib
+- name: digest
+  version: '0'
+  source:
+    type: stdlib
+- name: erb
+  version: '0'
+  source:
+    type: stdlib
+- name: i18n
+  version: '1.10'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: f17b218ad76ff3800d651e9bc42a15ba311095b4
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: json
+  version: '0'
+  source:
+    type: stdlib
+- name: logger
+  version: '0'
+  source:
+    type: stdlib
+- name: minitest
+  version: '5.25'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: f17b218ad76ff3800d651e9bc42a15ba311095b4
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: monitor
+  version: '0'
+  source:
+    type: stdlib
+- name: openssl
+  version: '0'
+  source:
+    type: stdlib
+- name: prism
+  version: 1.9.0
+  source:
+    type: rubygems
+- name: railties
+  version: '6.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: f17b218ad76ff3800d651e9bc42a15ba311095b4
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: securerandom
+  version: '0'
+  source:
+    type: stdlib
+- name: singleton
+  version: '0'
+  source:
+    type: stdlib
+- name: socket
+  version: '0'
+  source:
+    type: stdlib
+- name: stringio
+  version: '0'
+  source:
+    type: stdlib
+- name: time
+  version: '0'
+  source:
+    type: stdlib
+- name: timeout
+  version: '0'
+  source:
+    type: stdlib
+- name: tsort
+  version: '0'
+  source:
+    type: stdlib
+- name: tzinfo
+  version: '2.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: f17b218ad76ff3800d651e9bc42a15ba311095b4
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: uri
+  version: '0'
+  source:
+    type: stdlib
+gemfile_lock_path: Gemfile.lock

data/rbs_collection.yaml

@@ -0,0 +1,12 @@
+# Download sources
+sources:
+  - type: git
+    name: ruby/gem_rbs_collection
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    revision: main
+    repo_dir: gems
+
+path: .gem_rbs_collection
+
+gems:
+  - name: railties

data/sig/strong_schema.rbs

@@ -0,0 +1,59 @@
+module StrongSchema
+  module IgnoreChecks
+    def add_ignore: () { (Symbol, Array[untyped]) -> bool } -> void
+
+    def ignore_checks: () -> Array[Proc]
+
+    def reset_ignores!: () -> void
+
+    def should_ignore?: (Symbol, Array[untyped]) -> bool
+  end
+end
+
+
+module StrongSchema
+  class Railtie < Rails::Railtie
+  end
+end
+
+
+module StrongSchema
+  module SchemaExtension
+    def method_missing: (Symbol, *untyped) -> untyped
+  end
+end
+
+
+module StrongSchema
+  module TableExtension
+    OPERATION_MAP: Hash[Symbol, Symbol]
+
+    class MigrationProxy
+      include Singleton
+
+      def reverting?: () -> false
+
+      def version: () -> nil
+
+      def connection: () -> ActiveRecord::ConnectionAdapters::AbstractAdapter
+
+      def stop!: (String, ?header: String) -> void
+    end
+  end
+end
+
+
+module StrongSchema
+  VERSION: String
+end
+
+
+module StrongSchema
+  extend IgnoreChecks
+
+  @setup_done: bool?
+
+  def self.setup: () -> void
+
+  def self.install_boot_hook: () -> void
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: strong_schema
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- shoma07
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: strong_migrations
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.8'
+description: Adds safety checks to declarative schema operations in ActiveRecord::Schema.
+email:
+- 23730734+shoma07@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- Steepfile
+- lib/strong_schema.rb
+- lib/strong_schema/ignore_checks.rb
+- lib/strong_schema/railtie.rb
+- lib/strong_schema/schema_extension.rb
+- lib/strong_schema/table_extension.rb
+- lib/strong_schema/version.rb
+- rbs_collection.lock.yaml
+- rbs_collection.yaml
+- sig/strong_schema.rbs
+homepage: https://github.com/shoma07/strong_schema
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/shoma07/strong_schema
+  source_code_uri: https://github.com/shoma07/strong_schema
+  changelog_uri: https://github.com/shoma07/strong_schema/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Safety checks for declarative database schema changes
+test_files: []