basho 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d571071cfeea78be4b3afdb28200668b434c582a17382a170e25db60c9e5939
-  data.tar.gz: 61a142f2363cce678572ca3815c5bcf3754a8722afa6437321c5999beab8d454
+  metadata.gz: 4eaf81565f8b05cc3f7de24fddbd5779a53d0cc9a5600d6b59d922c88826af78
+  data.tar.gz: 8d19ac60cbfbef252ccc944ed4a8e801f1efa34b6ce206bf6c27146f34a27e51
 SHA512:
-  metadata.gz: 3ba4b016103fd8d4564080729dd82c20d0da5bdaa01ebc41a05438b94066abb9f7d38d8820b344ce622e426d735623d3f44972d01a4957def4fb3e3af2e8d639
-  data.tar.gz: 590d049ff6bde79407682e06806232841b3d40249588c09dd128cc6cf1b8f06afac66e2bbbe80473142ab6aff4178cf5bef81de6db2b69d7c980f4d4a57d273b
+  metadata.gz: d8c3695ed4ed27116623608683ff08d826673489ca5d4f2d485bbe368c8559dcd6a056f34e3d9e79185b143adc360c29fce5135e2ed37f815dfefd4d5aeb4d11
+  data.tar.gz: edd6ebc2f13d18af12001d5dbecd3d1e1972970559f0e3f016458234c0586dbdfdbbac4909d89c04c2a382e61def79372d4a8ca97a28a4581827c5c515a38517

data/CHANGELOG.md

@@ -5,6 +5,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.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2026-05-06
+
+### Changed (BREAKING)
+
+- `basho_postal` のマッピングオプション指定時の住所自動解決を `before_save` から
+  `before_validation` に変更。validation の前に住所が解決されるため、validation や
+  他の `before_validation` callback から解決済みの住所を参照できる。
+  既存ユーザーで `before_save` のタイミングに依存していた場合は要見直し。
+
 ## [0.5.0] - 2026-02-11
 
 ### Added

data/README.ja.md

@@ -235,7 +235,7 @@ shop.postal_address # => "東京都世田谷区上馬"
 
 ### 郵便番号から住所カラムを自動保存
 
-`basho_postal`にマッピングオプションを渡すと、`before_save`コールバックを登録し、郵便番号カラムの変更時に住所カラムを自動入力します。
+`basho_postal`にマッピングオプションを渡すと、`before_validation`コールバックを登録し、郵便番号カラムの変更時に住所カラムを自動入力します。validation 前に解決されるので、他の `before_validation` callback や validation が解決済みの住所を参照できます。
 
 ```ruby
 class User < ApplicationRecord

data/README.md

@@ -235,7 +235,7 @@ shop.postal_address # => "東京都世田谷区上馬"
 
 ### Auto-save address columns from a postal code
 
-When you pass mapping options to `basho_postal`, it registers a `before_save` callback that auto-fills address columns whenever the postal code column changes.
+When you pass mapping options to `basho_postal`, it registers a `before_validation` callback that auto-fills address columns whenever the postal code column changes. Resolving in `before_validation` lets your other callbacks and validations see the resolved address.
 
 ```ruby
 class User < ApplicationRecord

data/lib/basho/active_record/postal_auto_resolve.rb

@@ -2,9 +2,12 @@
 
 module Basho
   module ActiveRecord
-    # 郵便番号変更時に +before_save+ で住所カラムを自動解決する。
+    # 郵便番号変更時に +before_validation+ で住所カラムを自動解決する。
     # {Base#basho_postal} のマッピングオプション指定時に使用される。
     #
+    # validation の前に住所が解決されるため、validation や他の before_validation
+    # callback が解決済みの住所を参照できる。
+    #
     # @api private
     module PostalAutoResolve
       # サポートするマッピングキーの一覧
@@ -12,21 +15,21 @@ module Basho
 
       module_function
 
-      # モデルに +before_save+ コールバックを登録する。
+      # モデルに +before_validation+ コールバックを登録する。
       #
       # @param model_class [Class] ActiveRecordモデルクラス
       # @param postal_column [String] 郵便番号カラム名
       # @param mappings [Hash] マッピング設定
       # @return [void]
       def install(model_class, postal_column, mappings)
-        unless model_class.respond_to?(:before_save)
-          raise Basho::Error, "#{model_class} does not support before_save callbacks"
+        unless model_class.respond_to?(:before_validation)
+          raise Basho::Error, "#{model_class} does not support before_validation callbacks"
         end
 
         postal_col = postal_column.to_s
         resolved = mappings.slice(*MAPPING_KEYS).transform_values(&:to_s).freeze
 
-        model_class.before_save do
+        model_class.before_validation do
           next unless will_save_change_to_attribute?(postal_col)
 
           postal = Basho::PostalCode.find(send(postal_col))

data/lib/basho/version.rb

@@ -2,5 +2,5 @@
 
 module Basho
   # @return [String] 現在のgemバージョン
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: basho
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Hirotaka Wagai