basho 0.1.0

data/data/prefectures.json

@@ -0,0 +1,472 @@
+[
+  {
+    "code": 1,
+    "name": "北海道",
+    "region": "北海道",
+    "type": "道",
+    "capital_code": "011002",
+    "name_en": "Hokkaido",
+    "name_kana": "ホッカイドウ",
+    "name_hiragana": "ほっかいどう"
+  },
+  {
+    "code": 2,
+    "name": "青森県",
+    "region": "東北",
+    "type": "県",
+    "capital_code": "022012",
+    "name_en": "Aomori",
+    "name_kana": "アオモリケン",
+    "name_hiragana": "あおもりけん"
+  },
+  {
+    "code": 3,
+    "name": "岩手県",
+    "region": "東北",
+    "type": "県",
+    "capital_code": "032018",
+    "name_en": "Iwate",
+    "name_kana": "イワテケン",
+    "name_hiragana": "いわてけん"
+  },
+  {
+    "code": 4,
+    "name": "宮城県",
+    "region": "東北",
+    "type": "県",
+    "capital_code": "041009",
+    "name_en": "Miyagi",
+    "name_kana": "ミヤギケン",
+    "name_hiragana": "みやぎけん"
+  },
+  {
+    "code": 5,
+    "name": "秋田県",
+    "region": "東北",
+    "type": "県",
+    "capital_code": "052019",
+    "name_en": "Akita",
+    "name_kana": "アキタケン",
+    "name_hiragana": "あきたけん"
+  },
+  {
+    "code": 6,
+    "name": "山形県",
+    "region": "東北",
+    "type": "県",
+    "capital_code": "062014",
+    "name_en": "Yamagata",
+    "name_kana": "ヤマガタケン",
+    "name_hiragana": "やまがたけん"
+  },
+  {
+    "code": 7,
+    "name": "福島県",
+    "region": "東北",
+    "type": "県",
+    "capital_code": "072010",
+    "name_en": "Fukushima",
+    "name_kana": "フクシマケン",
+    "name_hiragana": "ふくしまけん"
+  },
+  {
+    "code": 8,
+    "name": "茨城県",
+    "region": "関東",
+    "type": "県",
+    "capital_code": "082015",
+    "name_en": "Ibaraki",
+    "name_kana": "イバラキケン",
+    "name_hiragana": "いばらきけん"
+  },
+  {
+    "code": 9,
+    "name": "栃木県",
+    "region": "関東",
+    "type": "県",
+    "capital_code": "092011",
+    "name_en": "Tochigi",
+    "name_kana": "トチギケン",
+    "name_hiragana": "とちぎけん"
+  },
+  {
+    "code": 10,
+    "name": "群馬県",
+    "region": "関東",
+    "type": "県",
+    "capital_code": "102016",
+    "name_en": "Gunma",
+    "name_kana": "グンマケン",
+    "name_hiragana": "ぐんまけん"
+  },
+  {
+    "code": 11,
+    "name": "埼玉県",
+    "region": "関東",
+    "type": "県",
+    "capital_code": "111007",
+    "name_en": "Saitama",
+    "name_kana": "サイタマケン",
+    "name_hiragana": "さいたまけん"
+  },
+  {
+    "code": 12,
+    "name": "千葉県",
+    "region": "関東",
+    "type": "県",
+    "capital_code": "121002",
+    "name_en": "Chiba",
+    "name_kana": "チバケン",
+    "name_hiragana": "ちばけん"
+  },
+  {
+    "code": 13,
+    "name": "東京都",
+    "region": "関東",
+    "type": "都",
+    "capital_code": "131041",
+    "name_en": "Tokyo",
+    "name_kana": "トウキョウト",
+    "name_hiragana": "とうきょうと"
+  },
+  {
+    "code": 14,
+    "name": "神奈川県",
+    "region": "関東",
+    "type": "県",
+    "capital_code": "141003",
+    "name_en": "Kanagawa",
+    "name_kana": "カナガワケン",
+    "name_hiragana": "かながわけん"
+  },
+  {
+    "code": 15,
+    "name": "新潟県",
+    "region": "中部",
+    "type": "県",
+    "capital_code": "151009",
+    "name_en": "Niigata",
+    "name_kana": "ニイガタケン",
+    "name_hiragana": "にいがたけん"
+  },
+  {
+    "code": 16,
+    "name": "富山県",
+    "region": "中部",
+    "type": "県",
+    "capital_code": "162019",
+    "name_en": "Toyama",
+    "name_kana": "トヤマケン",
+    "name_hiragana": "とやまけん"
+  },
+  {
+    "code": 17,
+    "name": "石川県",
+    "region": "中部",
+    "type": "県",
+    "capital_code": "172014",
+    "name_en": "Ishikawa",
+    "name_kana": "イシカワケン",
+    "name_hiragana": "いしかわけん"
+  },
+  {
+    "code": 18,
+    "name": "福井県",
+    "region": "中部",
+    "type": "県",
+    "capital_code": "182010",
+    "name_en": "Fukui",
+    "name_kana": "フクイケン",
+    "name_hiragana": "ふくいけん"
+  },
+  {
+    "code": 19,
+    "name": "山梨県",
+    "region": "中部",
+    "type": "県",
+    "capital_code": "192015",
+    "name_en": "Yamanashi",
+    "name_kana": "ヤマナシケン",
+    "name_hiragana": "やまなしけん"
+  },
+  {
+    "code": 20,
+    "name": "長野県",
+    "region": "中部",
+    "type": "県",
+    "capital_code": "202011",
+    "name_en": "Nagano",
+    "name_kana": "ナガノケン",
+    "name_hiragana": "ながのけん"
+  },
+  {
+    "code": 21,
+    "name": "岐阜県",
+    "region": "中部",
+    "type": "県",
+    "capital_code": "212016",
+    "name_en": "Gifu",
+    "name_kana": "ギフケン",
+    "name_hiragana": "ぎふけん"
+  },
+  {
+    "code": 22,
+    "name": "静岡県",
+    "region": "中部",
+    "type": "県",
+    "capital_code": "221007",
+    "name_en": "Shizuoka",
+    "name_kana": "シズオカケン",
+    "name_hiragana": "しずおかけん"
+  },
+  {
+    "code": 23,
+    "name": "愛知県",
+    "region": "中部",
+    "type": "県",
+    "capital_code": "231002",
+    "name_en": "Aichi",
+    "name_kana": "アイチケン",
+    "name_hiragana": "あいちけん"
+  },
+  {
+    "code": 24,
+    "name": "三重県",
+    "region": "近畿",
+    "type": "県",
+    "capital_code": "242012",
+    "name_en": "Mie",
+    "name_kana": "ミエケン",
+    "name_hiragana": "みえけん"
+  },
+  {
+    "code": 25,
+    "name": "滋賀県",
+    "region": "近畿",
+    "type": "県",
+    "capital_code": "252018",
+    "name_en": "Shiga",
+    "name_kana": "シガケン",
+    "name_hiragana": "しがけん"
+  },
+  {
+    "code": 26,
+    "name": "京都府",
+    "region": "近畿",
+    "type": "府",
+    "capital_code": "261009",
+    "name_en": "Kyoto",
+    "name_kana": "キョウトフ",
+    "name_hiragana": "きょうとふ"
+  },
+  {
+    "code": 27,
+    "name": "大阪府",
+    "region": "近畿",
+    "type": "府",
+    "capital_code": "271004",
+    "name_en": "Osaka",
+    "name_kana": "オオサカフ",
+    "name_hiragana": "おおさかふ"
+  },
+  {
+    "code": 28,
+    "name": "兵庫県",
+    "region": "近畿",
+    "type": "県",
+    "capital_code": "281000",
+    "name_en": "Hyogo",
+    "name_kana": "ヒョウゴケン",
+    "name_hiragana": "ひょうごけん"
+  },
+  {
+    "code": 29,
+    "name": "奈良県",
+    "region": "近畿",
+    "type": "県",
+    "capital_code": "292010",
+    "name_en": "Nara",
+    "name_kana": "ナラケン",
+    "name_hiragana": "ならけん"
+  },
+  {
+    "code": 30,
+    "name": "和歌山県",
+    "region": "近畿",
+    "type": "県",
+    "capital_code": "302015",
+    "name_en": "Wakayama",
+    "name_kana": "ワカヤマケン",
+    "name_hiragana": "わかやまけん"
+  },
+  {
+    "code": 31,
+    "name": "鳥取県",
+    "region": "中国",
+    "type": "県",
+    "capital_code": "312011",
+    "name_en": "Tottori",
+    "name_kana": "トットリケン",
+    "name_hiragana": "とっとりけん"
+  },
+  {
+    "code": 32,
+    "name": "島根県",
+    "region": "中国",
+    "type": "県",
+    "capital_code": "322016",
+    "name_en": "Shimane",
+    "name_kana": "シマネケン",
+    "name_hiragana": "しまねけん"
+  },
+  {
+    "code": 33,
+    "name": "岡山県",
+    "region": "中国",
+    "type": "県",
+    "capital_code": "331007",
+    "name_en": "Okayama",
+    "name_kana": "オカヤマケン",
+    "name_hiragana": "おかやまけん"
+  },
+  {
+    "code": 34,
+    "name": "広島県",
+    "region": "中国",
+    "type": "県",
+    "capital_code": "341002",
+    "name_en": "Hiroshima",
+    "name_kana": "ヒロシマケン",
+    "name_hiragana": "ひろしまけん"
+  },
+  {
+    "code": 35,
+    "name": "山口県",
+    "region": "中国",
+    "type": "県",
+    "capital_code": "352039",
+    "name_en": "Yamaguchi",
+    "name_kana": "ヤマグチケン",
+    "name_hiragana": "やまぐちけん"
+  },
+  {
+    "code": 36,
+    "name": "徳島県",
+    "region": "四国",
+    "type": "県",
+    "capital_code": "362018",
+    "name_en": "Tokushima",
+    "name_kana": "トクシマケン",
+    "name_hiragana": "とくしまけん"
+  },
+  {
+    "code": 37,
+    "name": "香川県",
+    "region": "四国",
+    "type": "県",
+    "capital_code": "372013",
+    "name_en": "Kagawa",
+    "name_kana": "カガワケン",
+    "name_hiragana": "かがわけん"
+  },
+  {
+    "code": 38,
+    "name": "愛媛県",
+    "region": "四国",
+    "type": "県",
+    "capital_code": "382019",
+    "name_en": "Ehime",
+    "name_kana": "エヒメケン",
+    "name_hiragana": "えひめけん"
+  },
+  {
+    "code": 39,
+    "name": "高知県",
+    "region": "四国",
+    "type": "県",
+    "capital_code": "392014",
+    "name_en": "Kochi",
+    "name_kana": "コウチケン",
+    "name_hiragana": "こうちけん"
+  },
+  {
+    "code": 40,
+    "name": "福岡県",
+    "region": "九州",
+    "type": "県",
+    "capital_code": "401307",
+    "name_en": "Fukuoka",
+    "name_kana": "フクオカケン",
+    "name_hiragana": "ふくおかけん"
+  },
+  {
+    "code": 41,
+    "name": "佐賀県",
+    "region": "九州",
+    "type": "県",
+    "capital_code": "412015",
+    "name_en": "Saga",
+    "name_kana": "サガケン",
+    "name_hiragana": "さがけん"
+  },
+  {
+    "code": 42,
+    "name": "長崎県",
+    "region": "九州",
+    "type": "県",
+    "capital_code": "422011",
+    "name_en": "Nagasaki",
+    "name_kana": "ナガサキケン",
+    "name_hiragana": "ながさきけん"
+  },
+  {
+    "code": 43,
+    "name": "熊本県",
+    "region": "九州",
+    "type": "県",
+    "capital_code": "431001",
+    "name_en": "Kumamoto",
+    "name_kana": "クマモトケン",
+    "name_hiragana": "くまもとけん"
+  },
+  {
+    "code": 44,
+    "name": "大分県",
+    "region": "九州",
+    "type": "県",
+    "capital_code": "442011",
+    "name_en": "Oita",
+    "name_kana": "オオイタケン",
+    "name_hiragana": "おおいたけん"
+  },
+  {
+    "code": 45,
+    "name": "宮崎県",
+    "region": "九州",
+    "type": "県",
+    "capital_code": "452017",
+    "name_en": "Miyazaki",
+    "name_kana": "ミヤザキケン",
+    "name_hiragana": "みやざきけん"
+  },
+  {
+    "code": 46,
+    "name": "鹿児島県",
+    "region": "九州",
+    "type": "県",
+    "capital_code": "462012",
+    "name_en": "Kagoshima",
+    "name_kana": "カゴシマケン",
+    "name_hiragana": "かごしまけん"
+  },
+  {
+    "code": 47,
+    "name": "沖縄県",
+    "region": "九州",
+    "type": "県",
+    "capital_code": "472018",
+    "name_en": "Okinawa",
+    "name_kana": "オキナワケン",
+    "name_hiragana": "おきなわけん"
+  }
+]

data/lib/basho/active_record/base.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative "postal_auto_resolve"
+
+module Basho
+  module ActiveRecord
+    # ActiveRecordモデルにbasho / basho_postalマクロを提供する
+    module Base
+      def basho(column)
+        column_name = column.to_s
+
+        define_method(:city) { (c = send(column_name)) && Basho::City.find(c) }
+        define_method(:prefecture) { city&.prefecture }
+        define_method(:full_address) do
+          pref = prefecture
+          cty = city
+          "#{pref.name}#{cty.name}" if pref && cty
+        end
+      end
+
+      def basho_postal(column, **mappings)
+        column_name = column.to_s
+
+        define_method(:postal_address) do
+          code = send(column_name)
+          return nil unless code
+
+          postal = Basho::PostalCode.find(code).first
+          return nil unless postal
+
+          "#{postal.prefecture_name}#{postal.city_name}#{postal.town}"
+        end
+
+        PostalAutoResolve.install(self, column_name, mappings) if mappings.any?
+      end
+    end
+  end
+end

data/lib/basho/active_record/postal_auto_resolve.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Basho
+  module ActiveRecord
+    # 郵便番号変更時にbefore_saveで住所カラムを自動解決する
+    module PostalAutoResolve
+      MAPPING_KEYS = %i[prefecture city town prefecture_code city_code].freeze
+      RESOLVERS = {
+        prefecture: :prefecture_name,
+        city: :city_name,
+        town: :town,
+        prefecture_code: :prefecture_code,
+        city_code: :resolve_city_code
+      }.freeze
+
+      module_function
+
+      def install(model_class, postal_column, mappings)
+        validate_model!(model_class)
+
+        postal_col = postal_column.to_s
+        resolved = build_mappings(mappings)
+
+        register_callback(model_class, postal_col, resolved)
+      end
+
+      def validate_model!(model_class)
+        return if model_class.respond_to?(:before_save)
+
+        raise Basho::Error, "#{model_class} does not support before_save callbacks"
+      end
+
+      def build_mappings(mappings)
+        mappings.slice(*MAPPING_KEYS).transform_values(&:to_s).freeze
+      end
+
+      def register_callback(model_class, postal_col, resolved_mappings)
+        model_class.before_save do
+          next unless will_save_change_to_attribute?(postal_col)
+
+          postal = PostalAutoResolve.resolve_postal(send(postal_col))
+
+          resolved_mappings.each do |key, target_col|
+            send(:"#{target_col}=", PostalAutoResolve.resolve_value(postal, key))
+          end
+        end
+      end
+
+      def resolve_postal(code)
+        return nil unless code
+
+        normalized = code.to_s.delete("-")
+        return nil unless normalized.match?(/\A\d{7}\z/)
+
+        Basho::PostalCode.find(normalized).first
+      end
+
+      def resolve_value(postal, key)
+        return nil unless postal
+
+        method_name = RESOLVERS[key]
+        return nil unless method_name
+
+        respond_to?(method_name, true) ? send(method_name, postal) : postal.public_send(method_name)
+      end
+
+      def resolve_city_code(postal)
+        City.where(prefecture_code: postal.prefecture_code)
+            .find { |c| c.name == postal.city_name }&.code
+      end
+    end
+  end
+end

data/lib/basho/city.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Basho
+  City = ::Data.define(:code, :prefecture_code, :name, :name_kana, :capital) do
+    def initialize(capital: false, **)
+      super
+    end
+
+    def capital? = capital
+
+    def prefecture
+      Prefecture.find(prefecture_code)
+    end
+
+    class << self
+      def find(code)
+        return nil unless code.is_a?(String) && code.size == 6
+
+        prefecture_code = code[0..1].to_i
+        where(prefecture_code: prefecture_code).find { |city| city.code == code }
+      end
+
+      def where(prefecture_code:)
+        cities_cache[prefecture_code] ||=
+          Data::Loader.cities(prefecture_code).map { |data| new(**data) }.freeze
+      end
+
+      def valid_code?(code)
+        CodeValidator.valid?(code)
+      end
+
+      def reset!
+        @cities_cache = nil
+      end
+
+      private
+
+      def cities_cache
+        @cities_cache ||= {}
+      end
+    end
+  end
+end

data/lib/basho/code_validator.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Basho
+  # JIS X 0401 チェックディジットによる自治体コード検証
+  module CodeValidator
+    CHECK_DIGITS_INDEX = 5
+    CHECK_BASE = 11
+    PREFECTURE_RANGE = (1..47)
+
+    module_function
+
+    def valid?(code)
+      return false unless code.is_a?(String) && code.match?(/\A\d{6}\z/)
+      return false unless PREFECTURE_RANGE.cover?(code[0..1].to_i)
+
+      code[CHECK_DIGITS_INDEX].to_i == compute_check_digit(code)
+    end
+
+    def compute_check_digit(code)
+      sub_total = code.chars
+                      .take(CHECK_DIGITS_INDEX)
+                      .map.with_index { |digit, i| digit.to_i * (CHECK_DIGITS_INDEX - i + 1) }
+                      .sum
+
+      candidate = (CHECK_BASE - (sub_total % CHECK_BASE)) % 10
+      sub_total >= CHECK_BASE ? candidate : CHECK_BASE - sub_total
+    end
+  end
+end

data/lib/basho/data/loader.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Basho
+  module Data
+    # 組み込みJSONデータの遅延読み込みとキャッシュ
+    class Loader
+      DATA_DIR = File.expand_path("../../../data", __dir__)
+
+      class << self
+        def prefectures
+          @prefectures ||= load_json("prefectures.json")
+        end
+
+        def cities(prefecture_code)
+          cities_cache[prefecture_code] ||= load_json("cities/#{format("%02d", prefecture_code)}.json")
+        end
+
+        def postal_codes(prefix)
+          postal_cache[prefix] ||= load_json("postal_codes/#{prefix}.json")
+        end
+
+        def reset!
+          instance_variables.each { |var| remove_instance_variable(var) }
+        end
+
+        private
+
+        def cities_cache
+          @cities_cache ||= {}
+        end
+
+        def postal_cache
+          @postal_cache ||= {}
+        end
+
+        def load_json(relative_path)
+          path = File.join(DATA_DIR, relative_path)
+          return [] unless File.exist?(path)
+
+          JSON.parse(File.read(path), symbolize_names: true)
+        end
+      end
+    end
+  end
+end