departure 6.8.0 → 8.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b991b602a5feeb6029d82822b62a5b2ca7227699b225c3ab8443fc7fdb5e2bcd
-  data.tar.gz: 43dee3946ee250402d17158ab5ca8c1e9e8ad92325917273454c049e473ddf2d
+  metadata.gz: f073be830cc9193469fb3d31d99ce910ac32ab2de6838f8ee18fd30e1b5a4f26
+  data.tar.gz: beaffddbe848d268c6a83051c7b98e294ae06ae489111a8038aed3d836febffd
 SHA512:
-  metadata.gz: dda1f7c047249d7c74b5eecf45ed921fc738d73a789dd05a7b6b7f4ab5cac5ce6772f674b8c2072fb287fbaa3f1626f73884a19d7ded320728ca129e0ecb7b65
-  data.tar.gz: 9401df780b63d76dec3d1068ade5720871a0fba8d8c002e1fd03b91e58dd2a6f6251511fa918e15c224c6954e278c0acac3e3ce98602cc7a162b74836eb096ef
+  metadata.gz: 37730fd17a593c457fd02060f1bdf07f8c2feb8c9e9e2ad8bb2e3820c38943b0761efb3ee49b9d6fd2d6dc77949b7f9d2c9d784e12556c0826e7462374a128d1
+  data.tar.gz: 24dff29fd1900e9fd555edd491e1f6715548ca04ce9b7dce0a455e935c07790a6b9ecd8fad52e68fec51834df51c87057b9f937d741159503d73d32c40f3207a

data/.github/workflows/test.yml

@@ -8,14 +8,13 @@ jobs:
       fail-fast: false
       matrix:
         ruby:
-          - 3.1
           - 3.2
           - 3.3
+          - 3.4
         gemfile:
-          - gemfiles/rails_6_1.gemfile
-          - gemfiles/rails_7_0.gemfile
-          - gemfiles/rails_7_1.gemfile
           - gemfiles/rails_7_2.gemfile
+          - gemfiles/rails_8_0.gemfile
+          - gemfiles/rails_8_1.gemfile
     env:
       PERCONA_DB_USER: root
       PERCONA_DB_PASSWORD: root
@@ -43,12 +42,12 @@ jobs:
     env:
       PERCONA_DB_USER: root
       PERCONA_DB_PASSWORD: root
-      BUNDLE_GEMFILE: gemfiles/rails_7_1.gemfile
+      BUNDLE_GEMFILE: gemfiles/rails_8_1.gemfile
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 3.3
+          ruby-version: 3.4
           bundler-cache: true
       - run: bundle exec rubocop --parallel

data/.rubocop.yml

@@ -6,7 +6,7 @@ require:
   - rubocop-performance
 
 AllCops:
-  TargetRubyVersion: 3.1.x
+  TargetRubyVersion: 3.4.x
 
 Metrics/AbcSize:
   Enabled: false

data/Appraisals

@@ -1,15 +1,13 @@
-appraise 'rails-6-1' do
-  gem 'rails', '6.1.7.6'
-end
-
-appraise 'rails-7-0' do
-  gem 'rails', '7.0.8'
+appraise 'rails-7-2' do
+  gem 'bigdecimal'
+  gem 'rails', '7.2.2.1'
 end
 
-appraise 'rails-7-1' do
-  gem 'rails', '7.1.3'
+appraise 'rails-8-0' do
+  gem 'bigdecimal'
+  gem 'rails', '8.0.2.1'
 end
 
-appraise 'rails-7-2' do
-  gem 'rails', '7.2.2.1'
+appraise 'rails-8-1' do
+  gem 'rails', '8.1.1'
 end

data/CHANGELOG.md

@@ -4,7 +4,21 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 Please follow the format in [Keep a Changelog](http://keepachangelog.com/)
 
-## [Unreleased]
+## [NEXT]
+
+## [8.0.0] - 2025-11-24
+
+- Bump [appraisal to 2.5.0](https://github.com/departurerb/departure/pull/129)
+- Add support for [Rails 8.1](https://github.com/departurerb/departure/pull/128)
+- Skinnify Departure [to remove most non pt-online-schema-change](https://github.com/departurerb/departure/pull/131) responsibility from departure
+- Inherit from [Mysql2 Adapter instead of AbstractMysqlAdapter](https://github.com/departurerb/departure/pull/130)
+- Remove Support for [Rails 7.0 and Rails 7.1](https://github.com/departurerb/departure/pull/135)
+  
+## [7.0.0] - 2025-08-21
+
+- Drop Ruby 3.1 support.  Add >= 3.2 ruby support in gemspec.  EOL for 3.1.0 was 2025-03-31
+- Drop Rails 6.1 support.  Add >= 6.2 rails support in gemspec.  EOL for 6.1.0 was 2024-10-01
+- Add Rails 8.0 support
 
 ## [6.8.0] - 2025-03-31
 

data/Dockerfile

@@ -1,4 +1,4 @@
-FROM ruby:3.0
+FROM ruby:3.4
 MAINTAINER muffinista@gmail.com
 
 # Install apt based dependencies required to run Rails as
@@ -14,17 +14,10 @@ RUN apt-get update && apt-get install -y \
 RUN mkdir -p /app /app/lib/departure
 WORKDIR /app
 
-# Copy the Gemfile as well as the Gemfile.lock and install
-# the RubyGems. This is a separate step so the dependencies
-# will be cached unless changes to one of those two files
-# are made.
-COPY departure.gemspec Gemfile ./
-COPY lib/departure/version.rb ./lib/departure/
+# Install bundler - dependencies will be installed via volume mount
+RUN gem install bundler
 
-RUN gem install bundler && bundle install --jobs 20 --retry 5
-
-# Copy the main application.
-COPY . ./
+# Project root will be mounted as volume for live development
 
 # The main command to run when the container starts. Also
 # tell the Rails dev server to bind to all interfaces by

data/Gemfile

@@ -9,3 +9,4 @@ gem 'logger'
 gem 'mutex_m', require: false
 gem 'rubocop', '~> 1.74.0', require: false
 gem 'rubocop-performance', '~> 1.20.2', require: false
+gem 'zeitwerk', '< 2.7.0'

data/Gemfile.lock

@@ -1,149 +1,161 @@
 PATH
   remote: .
   specs:
-    departure (6.8.0)
-      activerecord (>= 6.0.0, < 7.3.0, != 7.0.0)
+    departure (8.0.0)
+      activerecord (>= 7.2.0)
       mysql2 (>= 0.4.0, < 0.6.0)
-      railties (>= 6.0.0, < 7.3.0, != 7.0.0)
+      railties (>= 7.2.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    actionpack (7.1.3)
-      actionview (= 7.1.3)
-      activesupport (= 7.1.3)
+    actionpack (8.0.2.1)
+      actionview (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
       nokogiri (>= 1.8.5)
-      racc
       rack (>= 2.2.4)
       rack-session (>= 1.0.1)
       rack-test (>= 0.6.3)
       rails-dom-testing (~> 2.2)
       rails-html-sanitizer (~> 1.6)
-    actionview (7.1.3)
-      activesupport (= 7.1.3)
+      useragent (~> 0.16)
+    actionview (8.0.2.1)
+      activesupport (= 8.0.2.1)
       builder (~> 3.1)
       erubi (~> 1.11)
       rails-dom-testing (~> 2.2)
       rails-html-sanitizer (~> 1.6)
-    activemodel (7.1.3)
-      activesupport (= 7.1.3)
-    activerecord (7.1.3)
-      activemodel (= 7.1.3)
-      activesupport (= 7.1.3)
+    activemodel (8.0.2.1)
+      activesupport (= 8.0.2.1)
+    activerecord (8.0.2.1)
+      activemodel (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
       timeout (>= 0.4.0)
-    activesupport (7.1.3)
+    activesupport (8.0.2.1)
       base64
+      benchmark (>= 0.3)
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
       minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
-    appraisal (2.4.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    appraisal (2.5.0)
       bundler
       rake
       thor (>= 0.14.0)
-    ast (2.4.2)
+    ast (2.4.3)
     base64 (0.2.0)
-    bigdecimal (3.1.6)
-    builder (3.2.4)
-    byebug (11.1.3)
+    benchmark (0.4.0)
+    bigdecimal (3.1.9)
+    builder (3.3.0)
+    byebug (12.0.0)
     climate_control (0.0.4)
       activesupport (>= 3.0)
     codeclimate-test-reporter (1.0.9)
       simplecov (<= 0.13)
     coderay (1.1.3)
-    concurrent-ruby (1.2.3)
-    connection_pool (2.4.1)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.0)
     crass (1.0.6)
-    diff-lcs (1.5.1)
+    date (3.4.1)
+    diff-lcs (1.6.1)
     docile (1.1.5)
-    drb (2.2.0)
-      ruby2_keywords
-    erubi (1.12.0)
-    i18n (1.14.1)
+    drb (2.2.1)
+    erubi (1.13.1)
+    i18n (1.14.7)
       concurrent-ruby (~> 1.0)
-    io-console (0.7.2)
-    irb (1.11.2)
-      rdoc
+    io-console (0.8.0)
+    irb (1.15.1)
+      pp (>= 0.6.0)
+      rdoc (>= 4.0.0)
       reline (>= 0.4.2)
     json (2.10.2)
     language_server-protocol (3.17.0.4)
     lhm (2.2.0)
     lint_roller (1.1.0)
-    logger (1.6.6)
-    loofah (2.22.0)
+    logger (1.7.0)
+    loofah (2.24.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.12.0)
-    method_source (1.0.0)
-    minitest (5.22.2)
-    mutex_m (0.2.0)
+    method_source (1.1.0)
+    minitest (5.25.5)
+    mutex_m (0.3.0)
     mysql2 (0.5.6)
-    nokogiri (1.18.3-arm64-darwin)
+    nokogiri (1.18.7-aarch64-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.18.7-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.18.3-x86_64-linux-gnu)
+    nokogiri (1.18.7-x86_64-linux-gnu)
       racc (~> 1.4)
     parallel (1.26.3)
-    parser (3.3.7.1)
+    parser (3.3.7.4)
       ast (~> 2.4.1)
       racc
-    pry (0.14.2)
+    pp (0.6.2)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.4.0)
+    pry (0.15.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    pry-byebug (3.10.1)
-      byebug (~> 11.0)
-      pry (>= 0.13, < 0.15)
-    psych (5.1.2)
+    pry-byebug (3.11.0)
+      byebug (~> 12.0)
+      pry (>= 0.13, < 0.16)
+    psych (5.2.3)
+      date
       stringio
     racc (1.8.1)
-    rack (3.0.9)
-    rack-session (2.0.0)
+    rack (3.1.12)
+    rack-session (2.1.0)
+      base64 (>= 0.1.0)
       rack (>= 3.0.0)
-    rack-test (2.1.0)
+    rack-test (2.2.0)
       rack (>= 1.3)
-    rackup (2.1.0)
+    rackup (2.2.1)
       rack (>= 3)
-      webrick (~> 1.8)
     rails-dom-testing (2.2.0)
       activesupport (>= 5.0.0)
       minitest
       nokogiri (>= 1.6)
-    rails-html-sanitizer (1.6.0)
+    rails-html-sanitizer (1.6.2)
       loofah (~> 2.21)
-      nokogiri (~> 1.14)
-    railties (7.1.3)
-      actionpack (= 7.1.3)
-      activesupport (= 7.1.3)
-      irb
+      nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
+    railties (8.0.2.1)
+      actionpack (= 8.0.2.1)
+      activesupport (= 8.0.2.1)
+      irb (~> 1.13)
       rackup (>= 1.0.0)
       rake (>= 12.2)
       thor (~> 1.0, >= 1.2.2)
       zeitwerk (~> 2.6)
     rainbow (3.1.1)
-    rake (13.1.0)
-    rdoc (6.6.2)
+    rake (13.2.1)
+    rdoc (6.13.1)
       psych (>= 4.0.0)
     regexp_parser (2.10.0)
-    reline (0.4.2)
+    reline (0.6.0)
       io-console (~> 0.5)
     rspec (3.13.0)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.0)
+    rspec-core (3.13.3)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.0)
+    rspec-expectations (3.13.3)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-its (1.3.0)
+    rspec-its (1.3.1)
       rspec-core (>= 3.0.0)
       rspec-expectations (>= 3.0.0)
-    rspec-mocks (3.13.0)
+    rspec-mocks (3.13.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.0)
+    rspec-support (3.13.2)
     rubocop (1.74.0)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
@@ -155,30 +167,33 @@ GEM
       rubocop-ast (>= 1.38.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.39.0)
-      parser (>= 3.3.1.0)
+    rubocop-ast (1.43.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
     rubocop-performance (1.20.2)
       rubocop (>= 1.48.1, < 2.0)
       rubocop-ast (>= 1.30.0, < 2.0)
     ruby-progressbar (1.13.0)
-    ruby2_keywords (0.0.5)
+    securerandom (0.4.1)
     simplecov (0.13.0)
       docile (~> 1.1.0)
       json (>= 1.8, < 3)
       simplecov-html (~> 0.10.0)
     simplecov-html (0.10.2)
-    stringio (3.1.0)
-    thor (1.3.0)
-    timeout (0.4.1)
+    stringio (3.1.6)
+    thor (1.3.2)
+    timeout (0.4.3)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (3.1.4)
       unicode-emoji (~> 4.0, >= 4.0.4)
     unicode-emoji (4.0.4)
-    webrick (1.8.1)
-    zeitwerk (2.6.13)
+    uri (1.0.3)
+    useragent (0.16.11)
+    zeitwerk (2.6.18)
 
 PLATFORMS
+  aarch64-linux
   arm64-darwin-21
   arm64-darwin-22
   arm64-darwin-23
@@ -186,7 +201,7 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
-  appraisal (~> 2.4.1)
+  appraisal (~> 2.5.0)
   base64
   climate_control (~> 0.0.3)
   codeclimate-test-reporter (~> 1.0.3)
@@ -200,6 +215,7 @@ DEPENDENCIES
   rspec-its (~> 1.2)
   rubocop (~> 1.74.0)
   rubocop-performance (~> 1.20.2)
+  zeitwerk (< 2.7.0)
 
 BUNDLED WITH
-   2.4.22
+   2.6.6

data/README.md

@@ -213,6 +213,70 @@ When any errors occur, an `ActiveRecord::StatementInvalid` exception is
 raised and the migration is aborted, as all other ActiveRecord connection
 adapters.
 
+### Diagram
+
+```mermaid
+ flowchart TB
+      %% User Level
+      subgraph "Rails Application"
+          Migration["Rails Migration<br/>(ActiveRecord::Migration)"]
+          DSL["Migration DSL<br/>(add_column, create_table, etc.)"]
+      end
+
+      %% Core Departure Components
+      subgraph "Departure System"
+          RailsAdapter["RailsAdapter<br/>(Version Detection)"]
+          DepartureAdapter["Rails81DepartureAdapter<br/>(Connection Adapter)"]
+          Runner["Runner<br/>(Query Interceptor)"]
+          Command["Command<br/>(Process Executor)"]
+          CliGenerator["CliGenerator<br/>(Command Builder)"]
+      end
+
+      %% External Components
+      subgraph "External Tools"
+          PTOSC["pt-online-schema-change<br/>(Percona Toolkit)"]
+          MySQL["MySQL Database"]
+      end
+
+      %% LHM Integration
+      subgraph "LHM Integration"
+          LhmAdapter["Lhm::Adapter<br/>(DSL Translator)"]
+          LhmMigration["LHM Migration"]
+      end
+
+      %% Flow connections
+      Migration --> DSL
+      DSL --> DepartureAdapter
+      DepartureAdapter --> Runner
+      Runner --> |"Non-ALTER statements"| MySQL
+      CliGenerator --> Command
+      Command --> PTOSC
+      PTOSC --> MySQL
+
+      %% LHM Flow
+      LhmMigration --> LhmAdapter
+      LhmAdapter --> DSL
+
+      %% Configuration Flow
+      RailsAdapter --> |"Registers"| DepartureAdapter
+
+      %% Decision Points
+      Runner --> |"Check: ALTER TABLE?"| DecisionNode{{"ALTER TABLE<br/>Statement?"}}
+      DecisionNode --> |"Yes"| CliGenerator
+      DecisionNode --> |"No"| MySQL
+
+      %% Styling
+      classDef departure fill:#e1f5fe
+      classDef external fill:#fff3e0
+      classDef rails fill:#e8f5e8
+      classDef lhm fill:#fce4ec
+
+      class RailsAdapter,DepartureAdapter,Runner,Command,CliGenerator departure
+      class PTOSC,MySQL external
+      class Migration,DSL rails
+      class LhmAdapter,LhmMigration lhm
+```
+
 ## Trouleshooting
 
 ### Error creating new table: DBD::mysql::db do failed: Can't write; duplicate key in table (TABLE_NAME)
@@ -221,6 +285,24 @@ that prevents schema changes when a table has constraints. You should upgrade to
 
 ## Development
 
+### Setup
+
+#### Docker Compose
+
+You can bring up the docker-compose setup and bash into rails in order to not install dependencies on your system
+
+Gems are available on your local file system from tmp/local_gems directory.  We need this due to changes in 
+internals of ActiveRecord and needing to run things like pry to debug how they work.
+
+```
+docker compose up
+docker compose exec rails bash
+bundle install
+# off to the races
+```
+
+#### Manual
+
 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 that will allow you to experiment.
@@ -231,6 +313,26 @@ release a new version, update the version number in `version.rb`, and then run
 git commits and tags, and push the `.gem` file to
 [rubygems.org](https://rubygems.org).
 
+### Appraisal
+
+All versions of supported rails are defined in the [Appraisals file](./Appraisals) in project root
+
+#### Usage
+
+Say you want to run a specific test under a version of rails defined in Appraisal `rails-8-0`
+
+```
+bundle exec appraisal rails-8-0 bundle install
+bundle exec appraisal rails-8-0 bundle exec rspec spec/lhm/column_with_sql_spec.rb:50
+```
+
+#### Adding Versions
+
+- Add the version to [Appraisals file](./Appraisals)
+- Run `bundle exec appraisal generate`
+- Run `bundle exec appraisal install`
+- updates ci [test.yml](./.github/workflows/test.yml) in the `gemfile:` section
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at

data/Rakefile

@@ -1,6 +1,7 @@
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 
+require 'logger'
 require './configuration'
 require './test_database'
 

data/config.yml.erb

@@ -1,5 +1,9 @@
 username: <%= ENV['PERCONA_DB_USER'] || 'root' %>
-password: <%= ENV['PERCONA_DB_PASSWORD'] || '' %> 
-database: <%= ENV['PERCONA_DB_NAME'] || 'departure_test' %> 
-hostname: <%= ENV['PERCONA_DB_HOST'] || 'localhost' %>
-socket: <%= ENV['PERCONA_DB_SOCKET'] || '' %>
+password: <%= ENV['PERCONA_DB_PASSWORD'] || '' %>
+database: <%= ENV['PERCONA_DB_NAME'] || 'departure_test' %>
+<% if ENV['PERCONA_DB_SOCKET'] && !ENV['PERCONA_DB_SOCKET'].empty? %>
+socket: <%= ENV['PERCONA_DB_SOCKET'] %>
+<% else %>
+host: <%= ENV['PERCONA_DB_HOST'] || 'localhost' %>
+port: <%= ENV['PERCONA_DB_PORT'] || 3306 %>
+<% end %>

data/departure.gemspec

@@ -19,13 +19,13 @@ Gem::Specification.new do |spec|
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = '>= 2.7.0'
+  spec.required_ruby_version = '>= 3.2.0'
 
-  spec.add_runtime_dependency 'railties', '>= 6.0.0', '!= 7.0.0', '< 7.3.0'
-  spec.add_runtime_dependency 'activerecord', '>= 6.0.0', '!= 7.0.0', '< 7.3.0'
+  spec.add_runtime_dependency 'railties', '>= 7.2.0'
+  spec.add_runtime_dependency 'activerecord', '>= 7.2.0'
   spec.add_runtime_dependency 'mysql2', '>= 0.4.0', '< 0.6.0'
 
-  spec.add_development_dependency 'appraisal', '~> 2.4.1'
+  spec.add_development_dependency 'appraisal', '~> 2.5.0'
   spec.add_development_dependency 'rake', '>= 10.0'
   spec.add_development_dependency 'rspec', '~> 3.4', '>= 3.4.0'
   spec.add_development_dependency 'rspec-its', '~> 1.2'

data/docker-compose.yml

@@ -16,7 +16,11 @@ services:
       - db
     tty: true
     stdin_open: true
+    volumes:
+      - .:/app
+      - ./tmp/local_gems:/app/vendor/bundle
     environment:
+      BUNDLE_PATH: /app/vendor/bundle
       PERCONA_DB_USER: root
       PERCONA_DB_HOST: db
       PERCONA_DB_PASSWORD:

data/gemfiles/rails_7_2.gemfile

@@ -1,10 +1,16 @@
 # This file was generated by Appraisal
 
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
-gem 'codeclimate-test-reporter', '~> 1.0.3', group: :test, require: nil
-gem 'rails', '7.2.2.1'
-gem 'rubocop', '~> 1.74.0', require: false
-gem 'rubocop-performance', '~> 1.20.2', require: false
+gem "base64"
+gem "codeclimate-test-reporter", "~> 1.0.3", group: :test, require: nil
+gem "lhm"
+gem "logger"
+gem "mutex_m", require: false
+gem "rubocop", "~> 1.74.0", require: false
+gem "rubocop-performance", "~> 1.20.2", require: false
+gem "zeitwerk", "< 2.7.0"
+gem "bigdecimal"
+gem "rails", "7.2.2.1"
 
-gemspec path: '../'
+gemspec path: "../"