usa 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1138a018f777ee544ffaae4b4f0957bf583760a830bbb63f740143a1cff6552d
-  data.tar.gz: 3279df99a0c654797aea3803142650dad7ef2f94f1521eb6d7617c959ec38b7b
+  metadata.gz: baafe271decb488334f07d38d4312f97c37a031cbfe8d142fc91d0c6b9de0f9a
+  data.tar.gz: 17800009d94fccacc4f14845549909084552018624996963fed80d72630a79d6
 SHA512:
-  metadata.gz: e072a57248277ea92c26cd41d1d85a99f5a36d7abcb2d6dee8f36f1796564ec012bb2ef37cbd7309f73fbcd2542bbdffa9686c3b6b27e97f3f1a713e37eaf071
-  data.tar.gz: a84c4a5ed0b32d98820b7df2521034a92a1da067753b82cf82b9a32b60366261d1841636919d1b761edf2d4c49071dba2961224c1ceee6da366b8ce76964b4a6
+  metadata.gz: 91179ce7f344c77569bcee54f8b15a4c0afd2781f7658a8d225ea353a4b44d43ddca5c9d1efbbdcfacf1eb8ec062c455730364bc99893571b9962961ea7a4284
+  data.tar.gz: bdac914175b069d651ea61be39d48896cee8401506a415f7a399d7607226f9a7175f30fd7b8f3c09d243253dcfae958be3b41941b52cc9ffafc87c9e6327a17e

data/CHANGELOG.md

@@ -7,6 +7,14 @@ For more information about changelogs, check [Keep a Changelog](http://keepachan
 
 ## [Unreleased]
 
+## 0.3.0 - 2026-09-14
+
+* [Feature] Every model answers by the word a host means rather than by the table under it:
+  `zips_path`, `zip[...]`, `zips/_row`, and the i18n key `zip`, while the table stays
+  `usa_zips`. Same for a state, a county and a city. A host that lists these records writes
+  what it would have written for a model of its own, and a gem that resolves a model from a
+  route -- recourse does -- finds it without being told
+
 ## 0.2.0 - 2026-09-14
 
 * [Feature] `google_place_id` filled for every state and ZIP, and for the twenty counties that

data/README.md

@@ -12,7 +12,7 @@ To install on your system, run
 
 To use inside a bundled Ruby project, add this line to the `Gemfile`:
 
-    gem 'usa', '~> 0.2.0'
+    gem 'usa', '~> 0.3.0'
 
 Below 1.0 the pin stops at the next minor rather than the next major, because that is where a
 breaking change may still land. It becomes `~> 1.0` once the API is settled on purpose.
@@ -88,6 +88,11 @@ nothing about:
 ActiveSupport.on_load(:usa_record) { connects_to database: { writing: :primary, reading: :reader } }
 ```
 
+Each model answers by the word you mean rather than by the table under it, so a page listing
+ZIPs writes `zips_path`, a form posts `zip[...]`, a partial lives at `zips/_row` and a locale
+key reads `zip` -- while the table stays `usa_zips`. A gem that resolves a model from a route
+finds it without being told.
+
 Columns of your own go on these tables in a migration of your own. They survive every seed: this
 gem writes only the columns it ships.
 

data/app/models/usa/city.rb

@@ -14,6 +14,9 @@ class USA::City < USA::Record
   # @return [String] the default representation (used in views).
   def to_s = "#{name} (#{state.code})"
 
+  # The name Rails reads off this model: its route, its param key, its partial, its key.
+  def self.model_name = ActiveModel::Name.new(self, nil, 'City')
+
   class << self
   private
 

data/app/models/usa/county.rb

@@ -24,6 +24,9 @@ class USA::County < USA::Record
   # @return [String] the default representation (used in views).
   def to_s = "#{name} (#{state.code})"
 
+  # The name Rails reads off this model: its route, its param key, its partial, its key.
+  def self.model_name = ActiveModel::Name.new(self, nil, 'County')
+
   class << self
   private
 

data/app/models/usa/state.rb

@@ -22,6 +22,9 @@ class USA::State < USA::Record
   # @return [String] the default representation (used in views).
   def to_s = name
 
+  # The name Rails reads off this model: its route, its param key, its partial, its key.
+  def self.model_name = ActiveModel::Name.new(self, nil, 'State')
+
   class << self
   private
 

data/app/models/usa/zip.rb

@@ -11,6 +11,9 @@ class USA::ZIP < USA::Record
   # @return [String] the default representation (used in views).
   def to_s = code
 
+  # The name Rails reads off this model: its route, its param key, its partial, its key.
+  def self.model_name = ActiveModel::Name.new(self, nil, 'ZIP')
+
   class << self
   private
 

data/lib/usa/version.rb

@@ -1,4 +1,4 @@
 module USA
   # The version of this gem, as RubyGems knows it.
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: usa
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Claudio Baccigalupo