Merge pull request #396 from Shopify/add-has-provinces

Add has_provinces? method to Region

Author: gabypancu

CHANGELOG.md

@@ -27,6 +27,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
+- Add has_provinces? method to Region [#396](https://github.com/Shopify/worldwide/pull/396)
+
 ---
 
 ## [1.19.0] - 2025-10-15

lib/worldwide/region.rb

@@ -401,6 +401,11 @@ def has_cities?
       !!format["show"]&.include?("{city}")
     end
 
+    # Does this region have provinces in their addresses?
+    def has_provinces?
+      !!format["show"]&.include?("{province}")
+    end
+
     # Is this Region considered a "province" (political subdivision of a "country")?
     def province?
       @province

test/worldwide/region_test.rb

@@ -589,5 +589,17 @@ class RegionTest < ActiveSupport::TestCase
       refute_predicate Worldwide.region(code: "AR"), :has_zip_prefixes? # zones but no prefixes
       assert_predicate Worldwide.region(code: "US"), :has_zip_prefixes? # zones and prefixes
     end
+
+    test "#has_provinces? returns true when region has provinces and they are not hidden from addresses" do
+      assert_predicate Worldwide.region(code: "CA"), :has_provinces?
+    end
+
+    test "#has_provinces? returns false when region has provinces but they are hidden from addresses" do
+      refute_predicate Worldwide.region(code: "GB"), :has_provinces?
+    end
+
+    test "#has_provinces? returns false when region has no provinces" do
+      refute_predicate Worldwide.region(code: "AD"), :has_provinces?
+    end
   end
 end