zip_to_tz 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0681e9467076100fc6da8cfdc5f163d7cfa47901c374b35398a59d22cc275ed5'
-  data.tar.gz: 7d0c91741d0b2e5bd31804601bed3fae9caaad4c35d13ae44c9267918980fed8
+  metadata.gz: 86e6fb7efeac77565a2831b4905cb4f78b7127542c5c6199f517ddafbc8cd135
+  data.tar.gz: d9babb55f395722700ebf04b6f718ed80d6ff059f7b629fa80734bee12c52e40
 SHA512:
-  metadata.gz: ac0db3eff352bc9ba29a12b4bec7423de3ace46de24b32e81dfa1d2cf57528a6400486cb8faa4a8bffc34da2531070e681b9fff7da77906f7b2ada9378ab6e54
-  data.tar.gz: b47a7273adc93a573e74ef66ea4930d7be75fc332d0378145cd653126ffc83dfa5eaba01c4ab115f6f96f8a527fdf7b63f0fe43ccffd1cd397ecfb8fe45a04a0
+  metadata.gz: ba511e4b2f64d5d15334c19463eb641b684c53024afe6f6e257542b327852a7153ceb60a0468a5a2906f15c7ab262125116d13189882dec869e016cbe7ff5fec
+  data.tar.gz: 85c403cba1f3b91fcc0d4844a7cf1cb76b46ef620cf023c89b8e2fdb7f75ef4706e4a5643c5c2610ba0a9fb0f81c6c24f8529893184d8b1e6f7df060f0aaf307

data/CLAUDE.md

@@ -5,7 +5,7 @@
 - Don't add error handling, validation, or abstractions beyond what's described in AGENTS.md —
   this is a small, deliberately minimal port. Three similar lines beat a premature helper.
 - Default to no comments in code; the one exception already made (`Converter::ABBREVIATIONS`) is
-  there because the reasoning (why these specific 7 zones, why static per-zone) isn't obvious
+  there because the reasoning (why these specific zones, why static per-zone) isn't obvious
   from the code alone.
 - Never regenerate or hand-edit `lib/zip_to_tz/data/timezones_to_zipcodes.yml` without re-running
   the round-trip check described in AGENTS.md's "Data file gotchas" section — a bad edit here

data/README.md

@@ -41,7 +41,7 @@ truncated — `"33487-1234"` raises `InvalidZipCodeError` rather than being trea
 
 ### Supported timezones
 
-Only US zip codes are covered, spanning these seven zones:
+US zip codes and territories are covered, spanning these zones:
 
 | IANA name             | Abbreviation |
 | ---------------------- | ------------ |
@@ -50,13 +50,28 @@ Only US zip codes are covered, spanning these seven zones:
 | `America/Denver`       | `MDT`        |
 | `America/Los_Angeles`  | `PDT`        |
 | `America/Phoenix`      | `MST`        |
-| `America/Anchorage`    | `AKDT`       |
+| `America/Juneau`       | `AKDT`       |
 | `Pacific/Honolulu`     | `HST`        |
+| `America/Puerto_Rico`  | `AST`        |
+| `Pacific/Pago_Pago`    | `SST`        |
+| `Pacific/Guam`         | `ChST`       |
+| `Asia/Tokyo`           | `JST`        |
+| `Pacific/Guadalcanal`  | `+11`        |
+| `Pacific/Majuro`       | `+12`        |
+
+Every zone above is also a value in Rails' `ActiveSupport::TimeZone::MAPPING`, since most
+consumers of this gem resolve the result through Rails. That's why Alaska zips resolve to
+`America/Juneau` rather than `America/Anchorage` (identical in practice today, but only Juneau
+is Rails-mapped), and why Palau, Chuuk/Yap, and Pohnpei/Kosrae resolve to whichever Rails-mapped
+zone shares their real UTC offset and DST behavior (`Asia/Tokyo`, `Pacific/Guam`, and
+`Pacific/Guadalcanal` respectively) instead of their own distinct IANA zone.
 
 `short` always returns the abbreviation above, even in months when the zone is actually on
-standard time — e.g. `ZipToTz.short("33487")` returns `EDT` year-round, never `EST`. Arizona and
-Hawaii don't observe daylight saving, so their zones use a standard-time abbreviation instead.
-This is a known simplification inherited from upstream, not a date-aware lookup.
+standard time — e.g. `ZipToTz.short("33487")` returns `EDT` year-round, never `EST`. None of the
+zones below `Pacific/Honolulu` observe daylight saving, so they keep a fixed abbreviation
+year-round; `Pacific/Guadalcanal` has no named abbreviation in IANA's tzdata, so it uses its
+numeric UTC offset instead. This is a known simplification inherited from upstream, not a
+date-aware lookup.
 
 ### Errors
 

data/lib/zip_to_tz/converter.rb

@@ -12,9 +12,18 @@ module ZipToTz
     DATA_FILE = File.expand_path("data/timezones_to_zipcodes.yml", __dir__)
     ZIP_FORMAT = /\A\d{5}\z/
 
-    # The upstream zip list only spans the timezones below, each pinned to a
-    # single abbreviation (Arizona and Hawaii don't observe daylight saving,
-    # so their zones keep a standard-time abbreviation year-round).
+    # The zip list spans the timezones below, each pinned to a single
+    # abbreviation (Arizona, Hawaii, and the territories/nations below don't
+    # observe daylight saving, so their zones keep a standard-time
+    # abbreviation year-round). Every zone here is also a value in Rails'
+    # ActiveSupport::TimeZone::MAPPING, since that's the curated subset most
+    # consumers of this gem can actually resolve. Palau, Chuuk/Yap, and
+    # Pohnpei/Kosrae have no Rails-mapped zone of their own, so each is
+    # pinned to whichever mapped zone shares its real UTC offset and DST
+    # behavior (Asia/Tokyo, Pacific/Guam, and Pacific/Guadalcanal
+    # respectively) rather than its own distinct IANA identifier; likewise
+    # Alaska uses America/Juneau, not America/Anchorage, since that's the
+    # identifier Rails maps to (both are identical in practice today).
     ABBREVIATIONS = {
       "America/New_York" => "EDT",
       "America/Chicago" => "CDT",
@@ -22,7 +31,13 @@ module ZipToTz
       "America/Los_Angeles" => "PDT",
       "America/Phoenix" => "MST",
       "Pacific/Honolulu" => "HST",
-      "America/Anchorage" => "AKDT"
+      "America/Juneau" => "AKDT",
+      "America/Puerto_Rico" => "AST",
+      "Pacific/Pago_Pago" => "SST",
+      "Pacific/Guam" => "ChST",
+      "Asia/Tokyo" => "JST",
+      "Pacific/Guadalcanal" => "+11",
+      "Pacific/Majuro" => "+12"
     }.freeze
 
     def full(zip)

data/lib/zip_to_tz/data/timezones_to_zipcodes.yml

@@ -200,406 +200,6 @@ America/New_York:
 - 00597
 - 00598
 - 00599
-- '00600'
-- '00601'
-- '00602'
-- '00603'
-- '00604'
-- '00605'
-- '00606'
-- '00607'
-- 00608
-- 00609
-- '00610'
-- '00611'
-- '00612'
-- '00613'
-- '00614'
-- '00615'
-- '00616'
-- '00617'
-- 00618
-- 00619
-- '00620'
-- '00621'
-- '00622'
-- '00623'
-- '00624'
-- '00625'
-- '00626'
-- '00627'
-- 00628
-- 00629
-- '00630'
-- '00631'
-- '00632'
-- '00633'
-- '00634'
-- '00635'
-- '00636'
-- '00637'
-- 00638
-- 00639
-- '00640'
-- '00641'
-- '00642'
-- '00643'
-- '00644'
-- '00645'
-- '00646'
-- '00647'
-- 00648
-- 00649
-- '00650'
-- '00651'
-- '00652'
-- '00653'
-- '00654'
-- '00655'
-- '00656'
-- '00657'
-- 00658
-- 00659
-- '00660'
-- '00661'
-- '00662'
-- '00663'
-- '00664'
-- '00665'
-- '00666'
-- '00667'
-- 00668
-- 00669
-- '00670'
-- '00671'
-- '00672'
-- '00673'
-- '00674'
-- '00675'
-- '00676'
-- '00677'
-- 00678
-- 00679
-- 00680
-- 00681
-- 00682
-- 00683
-- 00684
-- 00685
-- 00686
-- 00687
-- 00688
-- 00689
-- 00690
-- 00691
-- 00692
-- 00693
-- 00694
-- 00695
-- 00696
-- 00697
-- 00698
-- 00699
-- '00700'
-- '00701'
-- '00702'
-- '00703'
-- '00704'
-- '00705'
-- '00706'
-- '00707'
-- 00708
-- 00709
-- '00710'
-- '00711'
-- '00712'
-- '00713'
-- '00714'
-- '00715'
-- '00716'
-- '00717'
-- 00718
-- 00719
-- '00720'
-- '00721'
-- '00722'
-- '00723'
-- '00724'
-- '00725'
-- '00726'
-- '00727'
-- 00728
-- 00729
-- '00730'
-- '00731'
-- '00732'
-- '00733'
-- '00734'
-- '00735'
-- '00736'
-- '00737'
-- 00738
-- 00739
-- '00740'
-- '00741'
-- '00742'
-- '00743'
-- '00744'
-- '00745'
-- '00746'
-- '00747'
-- 00748
-- 00749
-- '00750'
-- '00751'
-- '00752'
-- '00753'
-- '00754'
-- '00755'
-- '00756'
-- '00757'
-- 00758
-- 00759
-- '00760'
-- '00761'
-- '00762'
-- '00763'
-- '00764'
-- '00765'
-- '00766'
-- '00767'
-- 00768
-- 00769
-- '00770'
-- '00771'
-- '00772'
-- '00773'
-- '00774'
-- '00775'
-- '00776'
-- '00777'
-- 00778
-- 00779
-- 00780
-- 00781
-- 00782
-- 00783
-- 00784
-- 00785
-- 00786
-- 00787
-- 00788
-- 00789
-- 00790
-- 00791
-- 00792
-- 00793
-- 00794
-- 00795
-- 00796
-- 00797
-- 00798
-- 00799
-- 00800
-- 00801
-- 00802
-- 00803
-- 00804
-- 00805
-- 00806
-- 00807
-- 00808
-- 00809
-- 00810
-- 00811
-- 00812
-- 00813
-- 00814
-- 00815
-- 00816
-- 00817
-- 00818
-- 00819
-- 00820
-- 00821
-- 00822
-- 00823
-- 00824
-- 00825
-- 00826
-- 00827
-- 00828
-- 00829
-- 00830
-- 00831
-- 00832
-- 00833
-- 00834
-- 00835
-- 00836
-- 00837
-- 00838
-- 00839
-- 00840
-- 00841
-- 00842
-- 00843
-- 00844
-- 00845
-- 00846
-- 00847
-- 00848
-- 00849
-- 00850
-- 00851
-- 00852
-- 00853
-- 00854
-- 00855
-- 00856
-- 00857
-- 00858
-- 00859
-- 00860
-- 00861
-- 00862
-- 00863
-- 00864
-- 00865
-- 00866
-- 00867
-- 00868
-- 00869
-- 00870
-- 00871
-- 00872
-- 00873
-- 00874
-- 00875
-- 00876
-- 00877
-- 00878
-- 00879
-- 00880
-- 00881
-- 00882
-- 00883
-- 00884
-- 00885
-- 00886
-- 00887
-- 00888
-- 00889
-- 00890
-- 00891
-- 00892
-- 00893
-- 00894
-- 00895
-- 00896
-- 00897
-- 00898
-- 00899
-- 00900
-- 00901
-- 00902
-- 00903
-- 00904
-- 00905
-- 00906
-- 00907
-- 00908
-- 00909
-- 00910
-- 00911
-- 00912
-- 00913
-- 00914
-- 00915
-- 00916
-- 00917
-- 00918
-- 00919
-- 00920
-- 00921
-- 00922
-- 00923
-- 00924
-- 00925
-- 00926
-- 00927
-- 00928
-- 00929
-- 00930
-- 00931
-- 00932
-- 00933
-- 00934
-- 00935
-- 00936
-- 00937
-- 00938
-- 00939
-- 00940
-- 00941
-- 00942
-- 00943
-- 00944
-- 00945
-- 00946
-- 00947
-- 00948
-- 00949
-- 00950
-- 00951
-- 00952
-- 00953
-- 00954
-- 00955
-- 00956
-- 00957
-- 00958
-- 00959
-- 00960
-- 00961
-- 00962
-- 00963
-- 00964
-- 00965
-- 00966
-- 00967
-- 00968
-- 00969
-- 00970
-- 00971
-- 00972
-- 00973
-- 00974
-- 00975
-- 00976
-- 00977
-- 00978
-- 00979
-- 00980
-- 00981
-- 00982
-- 00983
-- 00984
-- 00985
-- 00986
-- 00987
-- 00988
-- 00989
-- 00990
-- 00991
-- 00992
-- 00993
-- 00994
-- 00995
-- 00996
-- 00997
-- 00998
-- 00999
 - '01000'
 - '01001'
 - '01002'
@@ -79063,49 +78663,28 @@ America/Los_Angeles:
 - '96907'
 - '96908'
 - '96909'
-- '96910'
 - '96911'
-- '96912'
-- '96913'
 - '96914'
-- '96915'
-- '96916'
-- '96917'
 - '96918'
 - '96919'
 - '96920'
-- '96921'
 - '96922'
-- '96923'
 - '96924'
 - '96925'
 - '96926'
 - '96927'
-- '96928'
-- '96929'
 - '96930'
-- '96931'
-- '96932'
 - '96933'
 - '96934'
 - '96935'
 - '96936'
 - '96937'
 - '96938'
-- '96939'
-- '96940'
-- '96941'
-- '96942'
-- '96943'
-- '96944'
 - '96945'
 - '96946'
 - '96947'
 - '96948'
 - '96949'
-- '96950'
-- '96951'
-- '96952'
 - '96953'
 - '96954'
 - '96955'
@@ -79113,7 +78692,6 @@ America/Los_Angeles:
 - '96957'
 - '96958'
 - '96959'
-- '96960'
 - '96961'
 - '96962'
 - '96963'
@@ -79123,7 +78701,6 @@ America/Los_Angeles:
 - '96967'
 - '96968'
 - '96969'
-- '96970'
 - '96971'
 - '96972'
 - '96973'
@@ -82445,7 +82022,6 @@ Pacific/Honolulu:
 - '96796'
 - '96797'
 - '96798'
-- '96799'
 - '96800'
 - '96801'
 - '96802'
@@ -82546,7 +82122,7 @@ Pacific/Honolulu:
 - '96897'
 - '96898'
 - '96899'
-America/Anchorage:
+America/Juneau:
 - '99500'
 - '99501'
 - '99502'
@@ -83047,3 +82623,433 @@ America/Anchorage:
 - '99997'
 - '99998'
 - '99999'
+America/Puerto_Rico:
+- '00600'
+- '00601'
+- '00602'
+- '00603'
+- '00604'
+- '00605'
+- '00606'
+- '00607'
+- '00608'
+- '00609'
+- '00610'
+- '00611'
+- '00612'
+- '00613'
+- '00614'
+- '00615'
+- '00616'
+- '00617'
+- '00618'
+- '00619'
+- '00620'
+- '00621'
+- '00622'
+- '00623'
+- '00624'
+- '00625'
+- '00626'
+- '00627'
+- '00628'
+- '00629'
+- '00630'
+- '00631'
+- '00632'
+- '00633'
+- '00634'
+- '00635'
+- '00636'
+- '00637'
+- '00638'
+- '00639'
+- '00640'
+- '00641'
+- '00642'
+- '00643'
+- '00644'
+- '00645'
+- '00646'
+- '00647'
+- '00648'
+- '00649'
+- '00650'
+- '00651'
+- '00652'
+- '00653'
+- '00654'
+- '00655'
+- '00656'
+- '00657'
+- '00658'
+- '00659'
+- '00660'
+- '00661'
+- '00662'
+- '00663'
+- '00664'
+- '00665'
+- '00666'
+- '00667'
+- '00668'
+- '00669'
+- '00670'
+- '00671'
+- '00672'
+- '00673'
+- '00674'
+- '00675'
+- '00676'
+- '00677'
+- '00678'
+- '00679'
+- '00680'
+- '00681'
+- '00682'
+- '00683'
+- '00684'
+- '00685'
+- '00686'
+- '00687'
+- '00688'
+- '00689'
+- '00690'
+- '00691'
+- '00692'
+- '00693'
+- '00694'
+- '00695'
+- '00696'
+- '00697'
+- '00698'
+- '00699'
+- '00700'
+- '00701'
+- '00702'
+- '00703'
+- '00704'
+- '00705'
+- '00706'
+- '00707'
+- '00708'
+- '00709'
+- '00710'
+- '00711'
+- '00712'
+- '00713'
+- '00714'
+- '00715'
+- '00716'
+- '00717'
+- '00718'
+- '00719'
+- '00720'
+- '00721'
+- '00722'
+- '00723'
+- '00724'
+- '00725'
+- '00726'
+- '00727'
+- '00728'
+- '00729'
+- '00730'
+- '00731'
+- '00732'
+- '00733'
+- '00734'
+- '00735'
+- '00736'
+- '00737'
+- '00738'
+- '00739'
+- '00740'
+- '00741'
+- '00742'
+- '00743'
+- '00744'
+- '00745'
+- '00746'
+- '00747'
+- '00748'
+- '00749'
+- '00750'
+- '00751'
+- '00752'
+- '00753'
+- '00754'
+- '00755'
+- '00756'
+- '00757'
+- '00758'
+- '00759'
+- '00760'
+- '00761'
+- '00762'
+- '00763'
+- '00764'
+- '00765'
+- '00766'
+- '00767'
+- '00768'
+- '00769'
+- '00770'
+- '00771'
+- '00772'
+- '00773'
+- '00774'
+- '00775'
+- '00776'
+- '00777'
+- '00778'
+- '00779'
+- '00780'
+- '00781'
+- '00782'
+- '00783'
+- '00784'
+- '00785'
+- '00786'
+- '00787'
+- '00788'
+- '00789'
+- '00790'
+- '00791'
+- '00792'
+- '00793'
+- '00794'
+- '00795'
+- '00796'
+- '00797'
+- '00798'
+- '00799'
+- '00800'
+- '00801'
+- '00802'
+- '00803'
+- '00804'
+- '00805'
+- '00806'
+- '00807'
+- '00808'
+- '00809'
+- '00810'
+- '00811'
+- '00812'
+- '00813'
+- '00814'
+- '00815'
+- '00816'
+- '00817'
+- '00818'
+- '00819'
+- '00820'
+- '00821'
+- '00822'
+- '00823'
+- '00824'
+- '00825'
+- '00826'
+- '00827'
+- '00828'
+- '00829'
+- '00830'
+- '00831'
+- '00832'
+- '00833'
+- '00834'
+- '00835'
+- '00836'
+- '00837'
+- '00838'
+- '00839'
+- '00840'
+- '00841'
+- '00842'
+- '00843'
+- '00844'
+- '00845'
+- '00846'
+- '00847'
+- '00848'
+- '00849'
+- '00850'
+- '00851'
+- '00852'
+- '00853'
+- '00854'
+- '00855'
+- '00856'
+- '00857'
+- '00858'
+- '00859'
+- '00860'
+- '00861'
+- '00862'
+- '00863'
+- '00864'
+- '00865'
+- '00866'
+- '00867'
+- '00868'
+- '00869'
+- '00870'
+- '00871'
+- '00872'
+- '00873'
+- '00874'
+- '00875'
+- '00876'
+- '00877'
+- '00878'
+- '00879'
+- '00880'
+- '00881'
+- '00882'
+- '00883'
+- '00884'
+- '00885'
+- '00886'
+- '00887'
+- '00888'
+- '00889'
+- '00890'
+- '00891'
+- '00892'
+- '00893'
+- '00894'
+- '00895'
+- '00896'
+- '00897'
+- '00898'
+- '00899'
+- '00900'
+- '00901'
+- '00902'
+- '00903'
+- '00904'
+- '00905'
+- '00906'
+- '00907'
+- '00908'
+- '00909'
+- '00910'
+- '00911'
+- '00912'
+- '00913'
+- '00914'
+- '00915'
+- '00916'
+- '00917'
+- '00918'
+- '00919'
+- '00920'
+- '00921'
+- '00922'
+- '00923'
+- '00924'
+- '00925'
+- '00926'
+- '00927'
+- '00928'
+- '00929'
+- '00930'
+- '00931'
+- '00932'
+- '00933'
+- '00934'
+- '00935'
+- '00936'
+- '00937'
+- '00938'
+- '00939'
+- '00940'
+- '00941'
+- '00942'
+- '00943'
+- '00944'
+- '00945'
+- '00946'
+- '00947'
+- '00948'
+- '00949'
+- '00950'
+- '00951'
+- '00952'
+- '00953'
+- '00954'
+- '00955'
+- '00956'
+- '00957'
+- '00958'
+- '00959'
+- '00960'
+- '00961'
+- '00962'
+- '00963'
+- '00964'
+- '00965'
+- '00966'
+- '00967'
+- '00968'
+- '00969'
+- '00970'
+- '00971'
+- '00972'
+- '00973'
+- '00974'
+- '00975'
+- '00976'
+- '00977'
+- '00978'
+- '00979'
+- '00980'
+- '00981'
+- '00982'
+- '00983'
+- '00984'
+- '00985'
+- '00986'
+- '00987'
+- '00988'
+- '00989'
+- '00990'
+- '00991'
+- '00992'
+- '00993'
+- '00994'
+- '00995'
+- '00996'
+- '00997'
+- '00998'
+- '00999'
+Pacific/Pago_Pago:
+- '96799'
+Pacific/Guam:
+- '96910'
+- '96912'
+- '96913'
+- '96915'
+- '96916'
+- '96917'
+- '96921'
+- '96923'
+- '96928'
+- '96929'
+- '96931'
+- '96932'
+- '96950'
+- '96951'
+- '96952'
+- '96942'
+- '96943'
+Asia/Tokyo:
+- '96939'
+- '96940'
+Pacific/Guadalcanal:
+- '96941'
+- '96944'
+Pacific/Majuro:
+- '96960'
+- '96970'

data/lib/zip_to_tz/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zip_to_tz
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Jeff Miller
@@ -12,7 +12,7 @@ dependencies: []
 description: A Ruby port of the zipToTz Node.js library. Looks up the IANA timezone
   name or abbreviation for a US zip code.
 email:
-- jeff@salmahealth.com
+- jeff@humani.se
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -34,7 +34,8 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/ibanez270dx/ziptotz
-  changelog_uri: https://github.com/ibanez270dx/ziptotz/commits/main
+  changelog_uri: https://github.com/ibanez270dx/ziptotz/releases
+  source_code_uri: https://github.com/ibanez270dx/ziptotz
 rdoc_options: []
 require_paths:
 - lib
@@ -42,7 +43,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="