super_tools 3.0.1 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e679f4b41ffa1f04baee132e45b854efa2317e03b6300d747968f858caab6a6
-  data.tar.gz: 4e635e119e9dfd2bcf058be7db40418e0874eaef755b3892048ec7c54bda3011
+  metadata.gz: c307e44d3f7362a213998c9c174923bab9771ff144c67d7a3bbe4271c9533cfe
+  data.tar.gz: 5ad16bfd50ada78a6b6931f54b1cabfa57eb403d9172ee6c2dbd39b437bbc4e5
 SHA512:
-  metadata.gz: 32a411a0cd5e85fb222c5d1224e6e67b22fabdc2a3918ff757a4f816ff3c1e705ac79d8d83f753eb6256852f9286e6c7debb20a260e598bdb6ec5719dc5020be
-  data.tar.gz: d7c222e501cd6d8877cadaf6b2524428b5c478d02f61572fc6ec063a0d5243db1b36fee4181050e4dd68628c44447023af68995616b497dca71d35cd72241f84
+  metadata.gz: 04bdb21b6fe4db79fbc9577f3625c5845bc2df314bd798f441c5e3df82928ed75aef392a460a4a576dca7497b078997a41912093ebf79fddada8838db6f0ab8d
+  data.tar.gz: 6de91347858c30e2786ee3e0cc0d4f8425f7be18d2977a7e8aa2bd87841ab456cccf06b9001011692a8d3e5890f865626deb18bfde3737e16ed68680d20f4d9d

data/.github/workflows/test.yml

@@ -6,16 +6,38 @@ on:
       - 'feat-**'
       - develop
       - master
+  pull_request:
 
 jobs:
   test:
     runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # Ruby 2.7.6
+          - ruby: '2.7.6'
+            gemfile: gemfiles/ruby_2.7_rails_6.gemfile
+          - ruby: '2.7.6'
+            gemfile: gemfiles/ruby_2.7_rails_7.gemfile
+          # Ruby 3.0.7
+          - ruby: '3.0.7'
+            gemfile: gemfiles/ruby_3.0_rails_6.gemfile
+          - ruby: '3.0.7'
+            gemfile: gemfiles/ruby_3.0_rails_7.gemfile
+          # Ruby 3.1.7
+          - ruby: '3.1.7'
+            gemfile: gemfiles/ruby_3.1_rails_6.gemfile
+          - ruby: '3.1.7'
+            gemfile: gemfiles/ruby_3.1_rails_7.gemfile
+    env:
+      BUNDLE_GEMFILE: ${{ matrix.gemfile }}
     steps:
       - uses: actions/checkout@v3
         with:
           fetch-depth: 1
       - uses: ruby/setup-ruby@v1
         with:
+          ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
-      - run: bundle
       - run: bundle exec rake t

data/.gitignore

@@ -11,3 +11,4 @@ vendor
 .DS_Store
 db/
 log/
+/gemfiles/*.lock

data/.ruby-version

@@ -1 +1 @@
-3.0.4
+2.7.6

data/Appraisals

@@ -0,0 +1,29 @@
+# Ruby 2.7.6 with Rails 6
+appraise "ruby-2.7-rails-6" do
+  gem "rails", "~> 6.1.0"
+end
+
+# Ruby 2.7.6 with Rails 7
+appraise "ruby-2.7-rails-7" do
+  gem "rails", "~> 7.0.0"
+end
+
+# Ruby 3.0.7 with Rails 6
+appraise "ruby-3.0-rails-6" do
+  gem "rails", "~> 6.1.0"
+end
+
+# Ruby 3.0.7 with Rails 7
+appraise "ruby-3.0-rails-7" do
+  gem "rails", "~> 7.0.0"
+end
+
+# Ruby 3.1.7 with Rails 6
+appraise "ruby-3.1-rails-6" do
+  gem "rails", "~> 6.1.0"
+end
+
+# Ruby 3.1.7 with Rails 7
+appraise "ruby-3.1-rails-7" do
+  gem "rails", "~> 7.0.0"
+end

data/Gemfile

@@ -5,4 +5,4 @@ git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
 # Specify your gem's dependencies in super_tools.gemspec
 gemspec
 
-gem "reform-rails", github: "superlanding/reform-rails", branch: "fix-infinite-parent-loop"
+gem "reform-rails", github: "superlanding/reform-rails", tag: "v0.2.6.f"

data/Gemfile.lock

@@ -1,9 +1,9 @@
 GIT
   remote: https://github.com/superlanding/reform-rails
-  revision: 66240539260e6969dc01a77cf181b39109ebb941
-  branch: fix-infinite-parent-loop
+  revision: 9309677a20293133167fe992e9795f367732b08f
+  tag: v0.2.6.f
   specs:
-    reform-rails (0.2.2)
+    reform-rails (0.2.6)
       activemodel (>= 5.0)
       reform (>= 2.3.1, < 3.0.0)
 
@@ -16,7 +16,7 @@ PATH
       fast_excel
       forwardable
       nokogiri (>= 1.6)
-      rails (> 6, < 7)
+      rails (>= 6.1, < 8)
       reform (= 2.6.2)
       reform-rails
       roo
@@ -88,6 +88,10 @@ GEM
       minitest (>= 5.1)
       tzinfo (~> 2.0)
       zeitwerk (~> 2.3)
+    appraisal (2.5.0)
+      bundler
+      rake
+      thor (>= 0.14.0)
     axiom-types (0.1.1)
       descendants_tracker (~> 0.0.4)
       ice_nine (~> 0.11.0)
@@ -95,7 +99,7 @@ GEM
     builder (3.2.4)
     coercible (1.0.0)
       descendants_tracker (~> 0.0.1)
-    concurrent-ruby (1.1.10)
+    concurrent-ruby (1.3.6)
     crass (1.0.6)
     declarative (0.0.20)
     descendants_tracker (0.0.4)
@@ -130,7 +134,7 @@ GEM
     globalid (1.0.0)
       activesupport (>= 5.0)
     hashie (5.0.0)
-    i18n (1.10.0)
+    i18n (1.14.8)
       concurrent-ruby (~> 1.0)
     ice_nine (0.11.2)
     loofah (2.18.0)
@@ -141,7 +145,7 @@ GEM
     marcel (1.0.2)
     method_source (1.0.0)
     mini_mime (1.1.2)
-    minitest (5.16.2)
+    minitest (5.26.1)
     nio4r (2.5.8)
     nokogiri (1.13.6-arm64-darwin)
       racc (~> 1.4)
@@ -212,7 +216,7 @@ GEM
     thor (1.2.1)
     thread_safe (0.3.6)
     trailblazer-option (0.1.2)
-    tzinfo (2.0.4)
+    tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     uber (0.1.0)
     virtus (1.0.5)
@@ -226,13 +230,14 @@ GEM
     websocket-driver (0.7.5)
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
-    zeitwerk (2.6.0)
+    zeitwerk (2.6.18)
 
 PLATFORMS
   arm64-darwin-21
   x86_64-linux
 
 DEPENDENCIES
+  appraisal
   bundler (>= 2, < 3)
   minitest (~> 5.0)
   rake (>= 12.2)
@@ -243,4 +248,4 @@ DEPENDENCIES
   warning
 
 BUNDLED WITH
-   2.3.16
+   2.3.14

data/MULTI_RUBY_TESTING.md

@@ -0,0 +1,170 @@
+# Multi-Ruby Version Testing Guide
+
+本專案已設定支援多個 Ruby 版本（2.7.6, 3.0.7, 3.1.7）與 Rails 版本（6.x, 7.x）的測試環境。
+
+## 支援的版本組合
+
+### Ruby 版本
+- **Ruby 2.7.6**
+- **Ruby 3.0.7**
+- **Ruby 3.1.7**
+
+### Rails 版本
+- **Rails 6.1.x**
+- **Rails 7.0.x**
+
+### 測試矩陣（共 6 個組合）
+1. Ruby 2.7.6 + Rails 6.1
+2. Ruby 2.7.6 + Rails 7.0
+3. Ruby 3.0.7 + Rails 6.1
+4. Ruby 3.0.7 + Rails 7.0
+5. Ruby 3.1.7 + Rails 6.1
+6. Ruby 3.1.7 + Rails 7.0
+
+## 專案結構
+
+```
+.
+├── Appraisals                           # Appraisal 設定檔
+├── gemfiles/                            # 各版本組合的 Gemfile
+│   ├── ruby_2.7_rails_6.gemfile
+│   ├── ruby_2.7_rails_7.gemfile
+│   ├── ruby_3.0_rails_6.gemfile
+│   ├── ruby_3.0_rails_7.gemfile
+│   ├── ruby_3.1_rails_6.gemfile
+│   └── ruby_3.1_rails_7.gemfile
+├── bin/test_all                         # 本地測試所有版本的腳本
+└── .github/workflows/test.yml           # GitHub Actions 設定
+```
+
+## 本地測試
+
+### 測試所有組合
+
+```bash
+bin/test_all
+```
+
+此腳本會依序測試所有 6 個 Ruby + Rails 版本組合。
+
+### 測試特定組合
+
+```bash
+# Ruby 2.7.6 + Rails 6
+bundle exec appraisal ruby-2.7-rails-6 rake t
+
+# Ruby 2.7.6 + Rails 7
+bundle exec appraisal ruby-2.7-rails-7 rake t
+
+# Ruby 3.0.7 + Rails 6
+bundle exec appraisal ruby-3.0-rails-6 rake t
+
+# Ruby 3.0.7 + Rails 7
+bundle exec appraisal ruby-3.0-rails-7 rake t
+
+# Ruby 3.1.7 + Rails 6
+bundle exec appraisal ruby-3.1-rails-6 rake t
+
+# Ruby 3.1.7 + Rails 7
+bundle exec appraisal ruby-3.1-rails-7 rake t
+```
+
+### 安裝所有版本的依賴
+
+```bash
+bundle install
+bundle exec appraisal install
+```
+
+## GitHub Actions
+
+當你推送程式碼到以下分支時，GitHub Actions 會自動測試所有版本組合：
+- `fix-**`
+- `feat-**`
+- `develop`
+- `master`
+- Pull Requests
+
+測試矩陣會執行所有 6 個 Ruby + Rails 版本組合測試。
+
+### CI 配置
+
+GitHub Actions 使用明確的版本號：
+- Ruby: `2.7.6`, `3.0.7`, `3.1.7`
+- Rails: `~> 6.1.0`, `~> 7.0.0`
+
+## 依賴套件相容性
+
+所有主要依賴套件都支援 Ruby 2.7+ 和 Rails 6/7：
+
+### 核心依賴
+- **Rails** - 支援 6.1.x 和 7.0.x
+- **nokogiri** >= 1.6 - 支援 Ruby 2.7+
+- **fast_excel** - 支援 Ruby 2.5+
+- **roo** - 支援 Ruby 2.5+
+- **dry-types** 1.5.1 - 支援 Ruby 2.7+
+- **dry-logic** 1.2.0 - 支援 Ruby 2.7+
+- **reform** 2.6.2 - 支援 Ruby 2.5+
+- **reform-rails** - 支援 Rails 6/7
+- **searchkick** - 支援 Ruby 2.6+
+- **virtus** ~> 1.0.5 - 支援 Ruby 2.7+
+
+### Rails 7 特定依賴
+Rails 7 會自動引入以下額外依賴：
+- `benchmark`
+- `drb`
+- `mutex_m`
+- `securerandom`
+
+## 更新依賴
+
+當你需要更新 gemfiles 時：
+
+```bash
+# 編輯 Appraisals 檔案
+# 然後重新生成 gemfiles
+bundle exec appraisal install
+```
+
+如需更新某個特定組合的依賴：
+
+```bash
+bundle exec appraisal ruby-3.1-rails-7 bundle update
+```
+
+## 開發建議
+
+1. **本地開發環境**：建議使用 Ruby 2.7.6 作為預設開發版本（見 `.ruby-version`）
+
+2. **提交前測試**：在提交 PR 前，建議至少測試以下組合：
+   - 最低版本：Ruby 2.7.6 + Rails 6.1
+   - 最高版本：Ruby 3.1.7 + Rails 7.0
+
+3. **新增依賴**：確保新增的依賴套件都支援：
+   - Ruby >= 2.7.0
+   - Rails >= 6.1, < 8
+
+## 注意事項
+
+- `gemfiles/*.lock` 檔案已加入 `.gitignore`，不會被 commit
+- `gemfiles/*.gemfile` 檔案會被 commit，確保 CI/CD 環境一致性
+- gemspec 中 Rails 版本範圍設定為 `">= 6.1", "< 8"`，支援 Rails 6 和 7
+- 確保新增的依賴套件都支援 Ruby 2.7+ 和 Rails 6/7
+
+## 疑難排解
+
+### 問題：bundle install 失敗
+
+```bash
+# 清理並重新安裝
+rm -rf gemfiles/.bundle
+bundle exec appraisal install
+```
+
+### 問題：某個組合測試失敗
+
+```bash
+# 重新安裝該組合的依賴
+bundle exec appraisal ruby-3.1-rails-7 bundle install
+bundle exec appraisal ruby-3.1-rails-7 rake t
+```

data/bin/test_all

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+
+set -e
+
+echo "=== Testing all Ruby versions with Rails 6 & 7 ==="
+echo ""
+
+# Check if appraisal is installed
+if ! bundle exec appraisal -h > /dev/null 2>&1; then
+  echo "Error: appraisal gem not found. Please run 'bundle install' first."
+  exit 1
+fi
+
+# Test each combination
+combinations=(
+  "ruby-2.7-rails-6:Ruby 2.7.6 + Rails 6"
+  "ruby-2.7-rails-7:Ruby 2.7.6 + Rails 7"
+  "ruby-3.0-rails-6:Ruby 3.0.7 + Rails 6"
+  "ruby-3.0-rails-7:Ruby 3.0.7 + Rails 7"
+  "ruby-3.1-rails-6:Ruby 3.1.7 + Rails 6"
+  "ruby-3.1-rails-7:Ruby 3.1.7 + Rails 7"
+)
+
+for combo in "${combinations[@]}"; do
+  IFS=':' read -r appraisal_name display_name <<< "$combo"
+  echo "===================================="
+  echo "Testing: $display_name"
+  echo "===================================="
+  bundle exec appraisal $appraisal_name rake t
+  echo ""
+done
+
+echo "===================================="
+echo "All tests completed!"
+echo "===================================="

data/gemfiles/.bundle/config

@@ -0,0 +1,2 @@
+---
+BUNDLE_RETRY: "1"

data/gemfiles/ruby_2.7_rails_6.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "reform-rails", tag: "v0.2.6.f", git: "https://github.com/superlanding/reform-rails"
+gem "rails", "~> 6.1.0"
+
+gemspec path: "../"

data/gemfiles/ruby_2.7_rails_7.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "reform-rails", tag: "v0.2.6.f", git: "https://github.com/superlanding/reform-rails"
+gem "rails", "~> 7.0.0"
+
+gemspec path: "../"

data/gemfiles/ruby_3.0_rails_6.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "reform-rails", tag: "v0.2.6.f", git: "https://github.com/superlanding/reform-rails"
+gem "rails", "~> 6.1.0"
+
+gemspec path: "../"

data/gemfiles/ruby_3.0_rails_7.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "reform-rails", tag: "v0.2.6.f", git: "https://github.com/superlanding/reform-rails"
+gem "rails", "~> 7.0.0"
+
+gemspec path: "../"

data/gemfiles/ruby_3.1_rails_6.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "reform-rails", tag: "v0.2.6.f", git: "https://github.com/superlanding/reform-rails"
+gem "rails", "~> 6.1.0"
+
+gemspec path: "../"

data/gemfiles/ruby_3.1_rails_7.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "reform-rails", tag: "v0.2.6.f", git: "https://github.com/superlanding/reform-rails"
+gem "rails", "~> 7.0.0"
+
+gemspec path: "../"

data/lib/super_tools/version.rb

@@ -1,3 +1,3 @@
 module SuperTools
-  VERSION = "3.0.1"
+  VERSION = "4.0.0"
 end

data/super_tools.gemspec

@@ -12,6 +12,7 @@ Gem::Specification.new do |spec|
   spec.description   = %q{Rails 開發環境常用工具 Forms/Process/Spreadsheet}
   spec.homepage      = "https://github.com/superlanding/super_tools"
   spec.license       = "MIT"
+  spec.required_ruby_version = ">= 2.7.0"
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
@@ -28,8 +29,9 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "shoulda-context"
   spec.add_development_dependency "warning"
   spec.add_development_dependency "sqlite3", "1.4.4"
+  spec.add_development_dependency "appraisal"
 
-  spec.add_dependency "rails", "> 6", "< 7"
+  spec.add_dependency "rails", ">= 6.1", "< 8"
   spec.add_dependency "nokogiri", ">= 1.6"
   spec.add_dependency "fast_excel"
   spec.add_dependency "roo"
@@ -37,7 +39,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "spreadsheet"
   spec.add_dependency "virtus", "~> 1.0.5"
   spec.add_dependency "forwardable"
-  spec.add_dependency "warehouse_items", "~> 1.0.0"
+  spec.add_dependency "warehouse_items", "~> 0.3.0"
   spec.add_dependency "searchkick"
 
   spec.add_dependency "reform", "2.6.2"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: super_tools
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 4.0.0
 platform: ruby
 authors:
 - eddie
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-08-08 00:00:00.000000000 Z
+date: 2026-01-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -100,26 +100,40 @@ dependencies:
     - - '='
       - !ruby/object:Gem::Version
         version: 1.4.4
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '6'
+        version: '6.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7'
+        version: '8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '6'
+        version: '6.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7'
+        version: '8'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -224,14 +238,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 0.3.0
 - !ruby/object:Gem::Dependency
   name: searchkick
   requirement: !ruby/object:Gem::Requirement
@@ -313,14 +327,24 @@ files:
 - ".gitignore"
 - ".ruby-version"
 - ".travis.yml"
+- Appraisals
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
+- MULTI_RUBY_TESTING.md
 - README.md
 - Rakefile
 - bin/console
 - bin/setup
+- bin/test_all
 - dependabot.yml
+- gemfiles/.bundle/config
+- gemfiles/ruby_2.7_rails_6.gemfile
+- gemfiles/ruby_2.7_rails_7.gemfile
+- gemfiles/ruby_3.0_rails_6.gemfile
+- gemfiles/ruby_3.0_rails_7.gemfile
+- gemfiles/ruby_3.1_rails_6.gemfile
+- gemfiles/ruby_3.1_rails_7.gemfile
 - lib/super_form/basic.rb
 - lib/super_form/concerns/atomic_save.rb
 - lib/super_form/reform.rb
@@ -374,14 +398,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
+rubygems_version: 3.1.6
 signing_key:
 specification_version: 4
 summary: Rails 開發環境常用工具 Forms/Process/Spreadsheet