basho 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11901f37562fae58d8b52881acb27f5d12d47de6aa21b156bb36fd2a87e1af28
-  data.tar.gz: f33b54817ef286e36a88daca0384fbb51b0d46c528a0be640949f816011b9c4a
+  metadata.gz: c8f0c054eb9aecbb0c422df1943e73933edb8cbf5d4a8b0ad35bffcfd1601c5f
+  data.tar.gz: 462301f163b2f031e370925d067e5af462f50122def0a7dda17478a881842cab
 SHA512:
-  metadata.gz: ecaa8057ece273aaf1ed46e9d66d56195935b94b55d1bf45667b1da9af9e05e4bfa7d9c6ea772f325f0c82c698440983f731583eca56dbb770cf7e4f836c2d06
-  data.tar.gz: 27260c4b272179a7db0f7fafc8f1b1f5de53b88341fbe1b4399b65d954154a55ce550414ec765280d94acd3ed90d0bec1088a73c01555c94e0e6a3fd5918a981
+  metadata.gz: fac10297c00acc8fd07f31ab59bc1dde3d08064015bc65eb9d69f764a9c98bbfb8636fb450a78f2aa81ee8408b313c90e2c49c8854620d9bdd55bd40399bcde3
+  data.tar.gz: 7e075e4fb1dcf08e295a5390859ed85c7f303ddb3c0e94a221f8e37d03bf408faec74b8c5007b535b299f6ab8346ce1058d67c41bab85dca9a6ad556cba506a4

data/README.ja.md

@@ -0,0 +1,313 @@
+[English](README.md)
+
+# Basho
+
+日本の住所データ（都道府県・市区町村・郵便番号・地方区分）を統一的に扱うRuby gem。
+
+## なぜ作ったか
+
+日本の住所まわりは扱いが面倒です。
+
+- 郵便番号から住所を引きたいだけなのに、CSVを自前でパースしてDBに入れる必要がある
+- 都道府県・市区町村のマスタデータを持つためにマイグレーションを書かされる
+- 郵便番号の自動入力、都道府県→市区町村の連動セレクトは毎回同じコードを書いている
+- 既存gemはRails依存が強い、データが古い、Hotwire非対応、など
+
+Bashoはこれらをまとめて解決します。
+
+- **DBマイグレーション不要** — 全データをJSON同梱。`gem install`だけで使える
+- **ActiveRecord統合** — `include Basho` + 1行のマクロで郵便番号→住所の自動保存
+- **Hotwire対応** — 郵便番号自動入力・カスケードセレクトをビルトインEngine提供
+- **軽量** — `Data.define`によるイミュータブルモデル、遅延読み込み、外部依存なし
+
+## 対応バージョン
+
+- Ruby 3.2 / 3.3 / 3.4 / 4.0
+
+## インストール
+
+```ruby
+# Gemfile
+gem "basho"
+```
+
+```bash
+bundle install
+```
+
+## クイックスタート
+
+### 郵便番号から住所を引く
+
+```ruby
+postal = Basho::PostalCode.find("154-0011").first
+postal.prefecture_name  # => "東京都"
+postal.city_name        # => "世田谷区"
+postal.town             # => "上馬"
+```
+
+### モデルで郵便番号→住所を自動保存
+
+```ruby
+class User < ApplicationRecord
+  include Basho
+  basho_postal :postal_code,
+    prefecture: :pref_name,
+    city: :city_name,
+    town: :town_name
+end
+
+user = User.new(postal_code: "154-0011")
+user.save
+user.pref_name  # => "東京都"
+user.city_name  # => "世田谷区"
+user.town_name  # => "上馬"
+```
+
+### 都道府県・市区町村を検索
+
+```ruby
+Basho::Prefecture.find(13).name           # => "東京都"
+Basho::Prefecture.where(region: "関東")    # => 7件
+Basho::City.find("131016").name            # => "千代田区"
+```
+
+## 使い方
+
+### Prefecture（都道府県）
+
+```ruby
+Basho::Prefecture.find(13)             # コードで検索
+Basho::Prefecture.find(name: "東京都")  # 名前で検索
+Basho::Prefecture.all                   # 全47件
+Basho::Prefecture.where(region: "関東") # 地方で絞り込み
+
+pref = Basho::Prefecture.find(13)
+pref.code          # => 13
+pref.name          # => "東京都"
+pref.name_en       # => "Tokyo"
+pref.name_kana     # => "トウキョウト"
+pref.name_hiragana # => "とうきょうと"
+pref.type          # => "都"
+pref.region        # => Region
+pref.cities        # => Array<City>
+pref.capital       # => City（県庁所在地）
+```
+
+### City（市区町村）
+
+```ruby
+Basho::City.find("131016")              # 自治体コードで検索
+Basho::City.where(prefecture_code: 13)  # 都道府県で絞り込み
+Basho::City.valid_code?("131016")       # チェックディジット検証
+
+city = Basho::City.find("131016")
+city.code             # => "131016"
+city.prefecture_code  # => 13
+city.name             # => "千代田区"
+city.name_kana        # => "チヨダク"
+city.capital?         # => false
+city.prefecture       # => Prefecture
+```
+
+### PostalCode（郵便番号）
+
+```ruby
+results = Basho::PostalCode.find("154-0011")  # 常にArrayを返す
+results = Basho::PostalCode.find("1540011")    # ハイフンなしも可
+
+postal = results.first
+postal.code              # => "1540011"
+postal.formatted_code    # => "154-0011"
+postal.prefecture_code   # => 13
+postal.prefecture_name   # => "東京都"
+postal.city_name         # => "世田谷区"
+postal.town              # => "上馬"
+postal.prefecture        # => Prefecture
+```
+
+### Region（地方区分）
+
+```ruby
+Basho::Region.all                # 8地方
+Basho::Region.find("関東")       # 名前で検索
+
+region = Basho::Region.find("関東")
+region.name             # => "関東"
+region.name_en          # => "Kanto"
+region.prefectures      # => Array<Prefecture>
+region.prefecture_codes # => [8, 9, 10, 11, 12, 13, 14]
+```
+
+## ActiveRecord統合
+
+### 自治体コードから都道府県・市区町村を引く
+
+```ruby
+class Shop < ApplicationRecord
+  include Basho
+  basho :local_gov_code
+end
+
+shop.prefecture   # => Prefecture
+shop.city         # => City
+shop.full_address # => "東京都千代田区"
+```
+
+### 郵便番号から住所文字列を取得
+
+```ruby
+class Shop < ApplicationRecord
+  include Basho
+  basho_postal :postal_code
+end
+
+shop.postal_address # => "東京都世田谷区上馬"
+```
+
+### 郵便番号から住所カラムを自動保存
+
+`basho_postal`にマッピングオプションを渡すと、`before_save`で郵便番号から住所カラムを自動入力します。
+
+```ruby
+class User < ApplicationRecord
+  include Basho
+  basho_postal :postal_code,
+    prefecture: :pref_name,
+    city: :city_name,
+    town: :town_name
+end
+```
+
+- `postal_code`が変更された時だけ解決を実行
+- マッピングは部分指定可能（`prefecture:`だけでもOK）
+- オプションなしの場合は`postal_address`メソッドのみ定義（後方互換）
+
+## Hotwire Engine
+
+Turbo Frame + Stimulusによる住所自動入力・カスケードセレクトをビルトインで提供するRails Engineです。自前でコントローラーを書かずに使えます。
+
+### セットアップ
+
+```ruby
+# config/application.rb
+require "basho/engine"
+```
+
+```ruby
+# config/routes.rb
+mount Basho::Engine, at: "/basho"
+```
+
+### 郵便番号自動入力
+
+郵便番号を入力すると都道府県・市区町村・町域フィールドを自動入力します。
+
+```erb
+<%= form_with(model: @shop) do |f| %>
+  <div data-controller="basho--auto-fill"
+       data-basho--auto-fill-url-value="<%= basho.postal_code_lookup_path %>">
+
+    <%= f.text_field :postal_code,
+          data: { action: "input->basho--auto-fill#lookup",
+                  "basho--auto-fill-target": "input" } %>
+
+    <turbo-frame id="basho-result"
+                 data-basho--auto-fill-target="frame"></turbo-frame>
+
+    <%= f.text_field :prefecture,
+          data: { "basho--auto-fill-target": "prefecture" } %>
+    <%= f.text_field :city,
+          data: { "basho--auto-fill-target": "city" } %>
+    <%= f.text_field :town,
+          data: { "basho--auto-fill-target": "town" } %>
+  </div>
+<% end %>
+```
+
+1. ユーザーが郵便番号を入力（7桁）
+2. 300msデバウンス後、Turbo Frameでサーバーに問い合わせ
+3. Stimulusが都道府県・市区町村・町域フィールドを自動入力
+
+### 都道府県・市区町村カスケードセレクト
+
+都道府県を選択すると、対応する市区町村がJSON APIで動的に読み込まれます。
+
+```erb
+<%= form_with(model: @shop) do |f| %>
+  <div data-controller="basho--cascade-select"
+       data-basho--cascade-select-prefectures-url-value="<%= basho.prefectures_path %>"
+       data-basho--cascade-select-cities-url-template-value="<%= basho.cities_prefecture_path(':code') %>">
+
+    <select data-basho--cascade-select-target="prefecture"
+            data-action="change->basho--cascade-select#prefectureChanged">
+      <option value="">都道府県を選択</option>
+    </select>
+
+    <select data-basho--cascade-select-target="city">
+      <option value="">市区町村を選択</option>
+    </select>
+  </div>
+<% end %>
+```
+
+`basho_cascade_data`ヘルパーでdata属性を簡潔に書けます。
+
+```erb
+<div <%= tag.attributes(data: basho_cascade_data) %>>
+  ...
+</div>
+```
+
+1. ページ読み込み時、都道府県セレクトが空ならAPIから47件を取得
+2. 都道府県を選択すると、市区町村セレクトをAPIから再構築
+3. 都道府県を変更すると、市区町村セレクトがリセットされ再取得
+
+### JSON APIエンドポイント
+
+Engineをマウントすると以下のエンドポイントが利用可能になります。
+
+```
+GET /basho/prefectures           # => [{"code":1,"name":"北海道"}, ...]
+GET /basho/prefectures/13/cities  # => [{"code":"131016","name":"千代田区"}, ...]
+GET /basho/postal_codes/lookup?code=1540011  # => Turbo Frame HTML
+```
+
+## Engine不要の場合
+
+Engineを使わず、`PostalCode.find`で自由にエンドポイントを作ることもできます。
+
+```ruby
+# JSON API
+class PostalCodesController < ApplicationController
+  def lookup
+    results = Basho::PostalCode.find(params[:code])
+
+    render json: results.map { |r|
+      { prefecture: r.prefecture_name, city: r.city_name, town: r.town }
+    }
+  end
+end
+```
+
+## データソース
+
+| データ | ソース | 更新頻度 |
+|--------|--------|----------|
+| 都道府県 | 総務省 JIS X 0401 | ほぼ変わらない |
+| 市区町村 | 総務省 全国地方公共団体コード | 年に数回 |
+| 郵便番号 | 日本郵便 KEN_ALL.csv | 月次（GitHub Actions自動更新） |
+| 地方区分 | 8地方（ハードコード） | 変わらない |
+
+## 開発
+
+```bash
+git clone https://github.com/wagai/basho.git
+cd basho
+bin/setup
+bundle exec rspec
+```
+
+## ライセンス
+
+MIT License

data/README.md

@@ -1,28 +1,30 @@
+[日本語版はこちら](README.ja.md)
+
 # Basho
 
-日本の住所データ（都道府県・市区町村・郵便番号・地方区分）を統一的に扱うRuby gem。
+A Ruby gem for working with Japanese address data — prefectures, cities, postal codes, and regions — in a unified interface.
 
-## なぜ作ったか
+## Why Basho
 
-日本の住所まわりは扱いが面倒です。
+Dealing with Japanese addresses is tedious.
 
-- 郵便番号から住所を引きたいだけなのに、CSVを自前でパースしてDBに入れる必要がある
-- 都道府県・市区町村のマスタデータを持つためにマイグレーションを書かされる
-- 郵便番号の自動入力、都道府県→市区町村の連動セレクトは毎回同じコードを書いている
-- 既存gemはRails依存が強い、データが古い、Hotwire非対応、など
+- Looking up an address from a postal code requires parsing CSVs and loading them into a database
+- Maintaining master data for prefectures and cities means writing migrations
+- Postal code auto-fill and prefecture-city cascading selects end up being rewritten every project
+- Existing gems are tightly coupled to Rails, have outdated data, or lack Hotwire support
 
-Bashoはこれらをまとめて解決します。
+Basho solves all of these.
 
-- **DBマイグレーション不要** — 全データをJSON同梱。`gem install`だけで使える
-- **ActiveRecord統合** — `include Basho` + 1行のマクロで郵便番号→住所の自動保存
-- **Hotwire対応** — 郵便番号自動入力・カスケードセレクトをビルトインEngine提供
-- **軽量** — `Data.define`によるイミュータブルモデル、遅延読み込み、外部依存なし
+- **No DB migrations** — All data is bundled as JSON. Just `gem install` and go
+- **ActiveRecord integration** — `include Basho` + a one-line macro for automatic postal code to address resolution on save
+- **Hotwire-ready** — Built-in Rails Engine with postal code auto-fill and cascade select
+- **Lightweight** — Immutable models via `Data.define`, lazy loading, zero external dependencies
 
-## 対応バージョン
+## Supported Versions
 
 - Ruby 3.2 / 3.3 / 3.4 / 4.0
 
-## インストール
+## Installation
 
 ```ruby
 # Gemfile
@@ -33,9 +35,9 @@ gem "basho"
 bundle install
 ```
 
-## クイックスタート
+## Quick Start
 
-### 郵便番号から住所を引く
+### Look up an address from a postal code
 
 ```ruby
 postal = Basho::PostalCode.find("154-0011").first
@@ -44,7 +46,7 @@ postal.city_name        # => "世田谷区"
 postal.town             # => "上馬"
 ```
 
-### モデルで郵便番号→住所を自動保存
+### Auto-save address columns from a postal code
 
 ```ruby
 class User < ApplicationRecord
@@ -62,23 +64,23 @@ user.city_name  # => "世田谷区"
 user.town_name  # => "上馬"
 ```
 
-### 都道府県・市区町村を検索
+### Search prefectures and cities
 
 ```ruby
 Basho::Prefecture.find(13).name           # => "東京都"
-Basho::Prefecture.where(region: "関東")    # => 7件
+Basho::Prefecture.where(region: "関東")    # => 7 results
 Basho::City.find("131016").name            # => "千代田区"
 ```
 
-## 使い方
+## Usage
 
-### Prefecture（都道府県）
+### Prefecture
 
 ```ruby
-Basho::Prefecture.find(13)             # コードで検索
-Basho::Prefecture.find(name: "東京都")  # 名前で検索
-Basho::Prefecture.all                   # 全47件
-Basho::Prefecture.where(region: "関東") # 地方で絞り込み
+Basho::Prefecture.find(13)             # Find by code
+Basho::Prefecture.find(name: "東京都")  # Find by name
+Basho::Prefecture.all                   # All 47 prefectures
+Basho::Prefecture.where(region: "関東") # Filter by region
 
 pref = Basho::Prefecture.find(13)
 pref.code          # => 13
@@ -89,15 +91,15 @@ pref.name_hiragana # => "とうきょうと"
 pref.type          # => "都"
 pref.region        # => Region
 pref.cities        # => Array<City>
-pref.capital       # => City（県庁所在地）
+pref.capital       # => City (prefectural capital)
 ```
 
-### City（市区町村）
+### City
 
 ```ruby
-Basho::City.find("131016")              # 自治体コードで検索
-Basho::City.where(prefecture_code: 13)  # 都道府県で絞り込み
-Basho::City.valid_code?("131016")       # チェックディジット検証
+Basho::City.find("131016")              # Find by municipality code
+Basho::City.where(prefecture_code: 13)  # Filter by prefecture
+Basho::City.valid_code?("131016")       # Validate check digit
 
 city = Basho::City.find("131016")
 city.code             # => "131016"
@@ -108,11 +110,11 @@ city.capital?         # => false
 city.prefecture       # => Prefecture
 ```
 
-### PostalCode（郵便番号）
+### PostalCode
 
 ```ruby
-results = Basho::PostalCode.find("154-0011")  # 常にArrayを返す
-results = Basho::PostalCode.find("1540011")    # ハイフンなしも可
+results = Basho::PostalCode.find("154-0011")  # Always returns an Array
+results = Basho::PostalCode.find("1540011")    # Hyphenless format also works
 
 postal = results.first
 postal.code              # => "1540011"
@@ -124,11 +126,11 @@ postal.town              # => "上馬"
 postal.prefecture        # => Prefecture
 ```
 
-### Region（地方区分）
+### Region
 
 ```ruby
-Basho::Region.all                # 8地方
-Basho::Region.find("関東")       # 名前で検索
+Basho::Region.all                # 8 regions
+Basho::Region.find("関東")       # Find by name
 
 region = Basho::Region.find("関東")
 region.name             # => "関東"
@@ -137,9 +139,9 @@ region.prefectures      # => Array<Prefecture>
 region.prefecture_codes # => [8, 9, 10, 11, 12, 13, 14]
 ```
 
-## ActiveRecord統合
+## ActiveRecord Integration
 
-### 自治体コードから都道府県・市区町村を引く
+### Look up prefecture and city from a municipality code
 
 ```ruby
 class Shop < ApplicationRecord
@@ -152,7 +154,7 @@ shop.city         # => City
 shop.full_address # => "東京都千代田区"
 ```
 
-### 郵便番号から住所文字列を取得
+### Get an address string from a postal code
 
 ```ruby
 class Shop < ApplicationRecord
@@ -163,9 +165,9 @@ end
 shop.postal_address # => "東京都世田谷区上馬"
 ```
 
-### 郵便番号から住所カラムを自動保存
+### Auto-save address columns from a postal code
 
-`basho_postal`にマッピングオプションを渡すと、`before_save`で郵便番号から住所カラムを自動入力します。
+When you pass mapping options to `basho_postal`, it registers a `before_save` callback that auto-fills address columns from the postal code.
 
 ```ruby
 class User < ApplicationRecord
@@ -177,15 +179,15 @@ class User < ApplicationRecord
 end
 ```
 
-- `postal_code`が変更された時だけ解決を実行
-- マッピングは部分指定可能（`prefecture:`だけでもOK）
-- オプションなしの場合は`postal_address`メソッドのみ定義（後方互換）
+- Resolution runs only when `postal_code` changes
+- Partial mappings are supported (e.g. `prefecture:` only)
+- Without options, only the `postal_address` method is defined (backward compatible)
 
 ## Hotwire Engine
 
-Turbo Frame + Stimulusによる住所自動入力・カスケードセレクトをビルトインで提供するRails Engineです。自前でコントローラーを書かずに使えます。
+A built-in Rails Engine providing postal code auto-fill and prefecture-city cascade select via Turbo Frame + Stimulus. No custom controllers needed.
 
-### セットアップ
+### Setup
 
 ```ruby
 # config/application.rb
@@ -197,9 +199,9 @@ require "basho/engine"
 mount Basho::Engine, at: "/basho"
 ```
 
-### 郵便番号自動入力
+### Postal Code Auto-fill
 
-郵便番号を入力すると都道府県・市区町村・町域フィールドを自動入力します。
+Automatically fills in prefecture, city, and town fields when a postal code is entered.
 
 ```erb
 <%= form_with(model: @shop) do |f| %>
@@ -223,13 +225,13 @@ mount Basho::Engine, at: "/basho"
 <% end %>
 ```
 
-1. ユーザーが郵便番号を入力（7桁）
-2. 300msデバウンス後、Turbo Frameでサーバーに問い合わせ
-3. Stimulusが都道府県・市区町村・町域フィールドを自動入力
+1. User enters a 7-digit postal code
+2. After a 300ms debounce, a Turbo Frame request is sent to the server
+3. Stimulus auto-fills the prefecture, city, and town fields
 
-### 都道府県・市区町村カスケードセレクト
+### Prefecture-City Cascade Select
 
-都道府県を選択すると、対応する市区町村がJSON APIで動的に読み込まれます。
+Selecting a prefecture dynamically loads the corresponding cities via JSON API.
 
 ```erb
 <%= form_with(model: @shop) do |f| %>
@@ -239,17 +241,17 @@ mount Basho::Engine, at: "/basho"
 
     <select data-basho--cascade-select-target="prefecture"
             data-action="change->basho--cascade-select#prefectureChanged">
-      <option value="">都道府県を選択</option>
+      <option value="">Select prefecture</option>
     </select>
 
     <select data-basho--cascade-select-target="city">
-      <option value="">市区町村を選択</option>
+      <option value="">Select city</option>
     </select>
   </div>
 <% end %>
 ```
 
-`basho_cascade_data`ヘルパーでdata属性を簡潔に書けます。
+Use the `basho_cascade_data` helper for concise data attributes.
 
 ```erb
 <div <%= tag.attributes(data: basho_cascade_data) %>>
@@ -257,13 +259,13 @@ mount Basho::Engine, at: "/basho"
 </div>
 ```
 
-1. ページ読み込み時、都道府県セレクトが空ならAPIから47件を取得
-2. 都道府県を選択すると、市区町村セレクトをAPIから再構築
-3. 都道府県を変更すると、市区町村セレクトがリセットされ再取得
+1. On page load, if the prefecture select is empty, all 47 prefectures are fetched from the API
+2. Selecting a prefecture rebuilds the city select from the API
+3. Changing the prefecture resets and re-fetches the city select
 
-### JSON APIエンドポイント
+### JSON API Endpoints
 
-Engineをマウントすると以下のエンドポイントが利用可能になります。
+Mounting the Engine exposes the following endpoints.
 
 ```
 GET /basho/prefectures           # => [{"code":1,"name":"北海道"}, ...]
@@ -271,9 +273,9 @@ GET /basho/prefectures/13/cities  # => [{"code":"131016","name":"千代田区"},
 GET /basho/postal_codes/lookup?code=1540011  # => Turbo Frame HTML
 ```
 
-## Engine不要の場合
+## Without the Engine
 
-Engineを使わず、`PostalCode.find`で自由にエンドポイントを作ることもできます。
+You can skip the Engine and build your own endpoints using `PostalCode.find`.
 
 ```ruby
 # JSON API
@@ -288,16 +290,16 @@ class PostalCodesController < ApplicationController
 end
 ```
 
-## データソース
+## Data Sources
 
-| データ | ソース | 更新頻度 |
-|--------|--------|----------|
-| 都道府県 | 総務省 JIS X 0401 | ほぼ変わらない |
-| 市区町村 | 総務省 全国地方公共団体コード | 年に数回 |
-| 郵便番号 | 日本郵便 KEN_ALL.csv | 月次（GitHub Actions自動更新） |
-| 地方区分 | 8地方（ハードコード） | 変わらない |
+| Data | Source | Update Frequency |
+|------|--------|-----------------|
+| Prefectures | Ministry of Internal Affairs, JIS X 0401 | Rarely changes |
+| Cities | Ministry of Internal Affairs, Local Government Codes | A few times per year |
+| Postal codes | Japan Post KEN_ALL.csv | Monthly (auto-updated via GitHub Actions) |
+| Regions | 8 regions (hardcoded) | Never changes |
 
-## 開発
+## Development
 
 ```bash
 git clone https://github.com/wagai/basho.git
@@ -306,6 +308,6 @@ bin/setup
 bundle exec rspec
 ```
 
-## ライセンス
+## License
 
 MIT License

data/lib/basho/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Basho
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: basho
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Hirotaka Wagai
@@ -9,7 +9,8 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: 都道府県・市区町村・郵便番号・地方区分をJSON同梱で提供。ActiveRecord統合あり。
+description: Provides prefectures, cities, postal codes, and regions as bundled JSON.
+  Includes ActiveRecord integration.
 email:
 - hirotaka.wagai@gmail.com
 executables: []
@@ -18,6 +19,7 @@ extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - LICENSE.txt
+- README.ja.md
 - README.md
 - Rakefile
 - app/assets/javascripts/controllers/basho/auto_fill_controller.js
@@ -1060,5 +1062,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.4
 specification_version: 4
-summary: 日本の住所データ（都道府県・市区町村・郵便番号・地方区分）を統一的に扱うgem
+summary: Japanese address data (prefectures, cities, postal codes, regions) in a single
+  gem
 test_files: []