ziptz 6.1.0 → 6.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab5db4fd6e68687e6761f890c37122d5ba3c393f267c2efdf7320f66cdf81b9e
-  data.tar.gz: 153766d2364660656ca42179ce52d649a179c600ea21ea1713d97381af10c874
+  metadata.gz: 8e148a6e535c92aee764520b3741c8c550719d2c430df9c18f84252e233eb17a
+  data.tar.gz: 1d56d7416206c48354f30f0b544639d99e86ed68908a9214ee654cdee7cbf70a
 SHA512:
-  metadata.gz: 5680d6235c68c8d70d8c89b45d23844db662b3dad0a8090bbf9abed9c23be48f835ae6bbb260a55eac74af3bb11ea61a9ae3ab53adb88e7831b0b4292dddf5d5
-  data.tar.gz: 3a04b0ee0c20e672059eef0122279b5cc8f082baab15b910cc547b39cb4af349065804605d83ee3e90c66d1b2e4ddef5077cb63f446ffad9f4ad187d26dad1a0
+  metadata.gz: 69974ccd6732bb9043f9c4c7ab5f77ec9d5cc4991b07170b7ea92630f9910a24df9eb7fdc941930f092c188d480b967dfc3e83a99eb1462fd6c1f2e2a4298fe8
+  data.tar.gz: 1665d43f017697702ed8d3c4d8468d06e33bd46bc6f3e172fb39a4f342f05bd95b9eb7b3a4da93cdfe581a38ba5e610ee71b11f23473302838eee56361fd503d

data/CHANGELOG.md

@@ -0,0 +1,78 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 6.2.0 - 2026-08-14
+
+### Added
+
+- Automated gem publication via
+  [RubyGems trusted publishing](https://guides.rubygems.org/trusted-publishing/):
+  pushing a `v*` tag builds and publishes the gem from GitHub Actions.
+- Gemspec metadata links (`source_code_uri`, `changelog_uri`,
+  `bug_tracker_uri`) and this changelog.
+- Zip codes may now be passed as Integers; they are zero-padded to 5 digits
+  (`z.time_zone_name(601)` looks up `00601`). Previously an Integer raised
+  `NoMethodError`.
+- `Ziptz#close` closes the cached SQLite connection for the instance's
+  database on the current thread. Closing is idempotent and a new connection
+  is opened automatically on the next query.
+
+### Fixed
+
+- Database connections are cached per database path, so multiple `Ziptz`
+  instances pointing at different databases no longer share a connection.
+- The packaged gem no longer includes the spec suite and its 2.7 MB fixture
+  database, shrinking the gem from ~2.7 MB to a few KB.
+
+### Changed
+
+- CI now enforces RuboCop and runs tests against Ruby 3.3, 3.4, and 4.0.
+- `Ziptz::VERSION` moved from `lib/version.rb` to the conventional
+  `lib/ziptz/version.rb`.
+- README documents the supported Rubies (3.3/3.4/4.0); copyright years
+  updated through 2026.
+
+### Removed
+
+- Leftover development dependencies from the long-removed data-import
+  pipeline (activerecord, mysql2, tty-spinner).
+
+## 6.1.0 - 2026-04-09
+
+### Changed
+
+- Unknown, invalid, and nil zip codes now raise `Ziptz::ZipNotFound` instead
+  of returning nil.
+
+### Removed
+
+- Dropped support for Ruby 3.1 and 3.2; Ruby >= 3.3 is now required.
+
+## 6.0.0 - 2024-12-27
+
+### Changed
+
+- **Breaking:** the gem no longer bundles zip code time zone data. Supply
+  your own SQLite database and pass its path to `Ziptz.new`. See the
+  [ZIP Code Time Zones Dataset](https://www.infused-data.com/zip-code-time-zones/).
+- Database connections are cached per thread for thread safety.
+
+### Removed
+
+- The `Ziptz.instance` class method.
+
+## 5.1.0 - 2024-04-28
+
+### Changed
+
+- sqlite3 dependency updated from `~> 1.6` to `~> 2.0` (#11).
+
+## 5.0.0 - 2023-12-28
+
+### Removed
+
+- Dropped support for Rubies older than 3.1.

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2015-2024 Keith Morrison <keithm@infused.org>
+Copyright (c) 2015-2026 Keith Morrison <keithm@infused.org>
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -12,7 +12,7 @@ Get time zone, daylight saving time, and base offset for any US ZIP code.
 
 Ziptz is tested to work with the following versions of Ruby:
 
-* Ruby 3.1.x, 3.2.x, 3.3.x
+* Ruby 3.3.x, 3.4.x, 4.0.x
 
 ## Installation
 
@@ -37,6 +37,12 @@ Get the time zone name for any ZIP code:
 
     z.time_zone_name('97213') #=> "America/Los_Angeles"
 
+ZIP codes may be passed as strings or integers. Integers are zero-padded
+to 5 digits, and 9-digit ZIP+4 strings are truncated to their first 5 digits:
+
+    z.time_zone_name(601)          #=> "America/Puerto_Rico" (looks up 00601)
+    z.time_zone_name('97213-4704') #=> "America/Los_Angeles"
+
 Get the time zone offset for any ZIP code:
 
     z.time_zone_offset('97213') #=> -28800
@@ -51,6 +57,17 @@ Get all the zip codes in a time zone:
 
     z.zips('Pacific/Chuuk') #=> ["96942", "96943"]
 
+Lookups for unknown, invalid, or nil ZIP codes raise `Ziptz::ZipNotFound`
+(since version 6.1.0; earlier versions returned nil):
+
+    z.time_zone_name('00000') #=> raises Ziptz::ZipNotFound
+
+Database connections are opened lazily and cached per thread. Call `close`
+to close the current thread's connection; the next lookup reopens it
+automatically:
+
+    z.close
+
 
 ## Supported Time Zones
 
@@ -169,7 +186,7 @@ Time zone names now reflect standard tz-database names.
 
 ## License
 
-  Copyright (c) 2015-2024 Keith Morrison <<keithm@infused.org>>
+  Copyright (c) 2015-2026 Keith Morrison <<keithm@infused.org>>
 
   Permission is hereby granted, free of charge, to any person
   obtaining a copy of this software and associated documentation

data/lib/{version.rb → ziptz/version.rb}

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Ziptz
-  VERSION = '6.1.0'
+  VERSION = '6.2.0'
 end

data/lib/ziptz.rb

@@ -1,31 +1,37 @@
 # frozen_string_literal: true
 
 require 'sqlite3'
-require 'version'
+require_relative 'ziptz/version'
 
 class Ziptz
   class ZipNotFound < StandardError; end
 
-  def initialize(*args, db: nil)
-    @db_path = args[0] || db
+  def initialize(path = nil, db: nil)
+    @db_path = path || db
     raise ArgumentError, 'Database path is required' if @db_path.nil? || @db_path.empty?
     raise ArgumentError, 'Database file does not exist' unless File.exist?(@db_path)
   end
 
   def db
-    Thread.current[:ziptz_db] ||= begin
+    connections = Thread.current[:ziptz_db] ||= {}
+    connections[@db_path] ||= begin
       db = SQLite3::Database.open(@db_path)
       db.results_as_hash = true
       db
     end
   end
 
+  def close
+    Thread.current[:ziptz_db]&.delete(@db_path)&.close
+    nil
+  end
+
   def time_zone_name(zip)
-    time_zone_info(zip).dig('time_zone')
+    time_zone_info(zip)['time_zone']
   end
 
   def time_zone_offset(zip)
-    time_zone_info(zip).dig('offset')
+    time_zone_info(zip)['offset']
   end
 
   def time_zone_uses_dst?(zip)
@@ -46,12 +52,13 @@ class Ziptz
     "#<#{self.class}:#{object_id}>"
   end
 
-  protected
+  private
 
   def time_zone_info(zip)
     raise ZipNotFound, "Zip code not found: #{zip.inspect}" if zip.nil?
 
-    result = db.get_first_row('select * from zip_codes where zip_code = ? limit 1', zip[0, 5])
+    zip_code = zip.is_a?(Integer) ? format('%05d', zip) : zip.to_s[0, 5]
+    result = db.get_first_row('select * from zip_codes where zip_code = ? limit 1', zip_code)
     raise ZipNotFound, "Zip code not found: #{zip}" unless result
 
     result

data/ziptz.gemspec

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
-lib = File.expand_path('lib', __dir__)
-$LOAD_PATH.unshift lib unless $LOAD_PATH.include?(lib)
-require 'version'
+require_relative 'lib/ziptz/version'
 
 Gem::Specification.new do |s|
   s.name = 'ziptz'
@@ -10,16 +8,21 @@ Gem::Specification.new do |s|
   s.platform = Gem::Platform::RUBY
   s.authors = ['Keith Morrison']
   s.email = 'keithm@infused.org'
-  s.homepage = 'http://github.com/infused/ziptz'
+  s.homepage = 'https://github.com/infused/ziptz'
   s.summary = 'TimeZone info for any 5-digit US zip code'
   s.description = 'Get timezone info for all 5-digit US zip codes'
   s.license = 'MIT'
 
   s.rdoc_options = ['--charset=UTF-8']
   s.extra_rdoc_files = ['README.md', 'LICENSE']
-  s.files = Dir['README.md', 'LICENSE', '{data,lib,spec}/**/*', 'ziptz.gemspec']
+  s.files = Dir['README.md', 'CHANGELOG.md', 'LICENSE', 'lib/**/*', 'ziptz.gemspec']
   s.require_paths = ['lib']
   s.required_ruby_version = '>= 3.3.0'
-  s.metadata['rubygems_mfa_required'] = 'true'
+  s.metadata = {
+    'source_code_uri' => 'https://github.com/infused/ziptz',
+    'changelog_uri' => 'https://github.com/infused/ziptz/blob/main/CHANGELOG.md',
+    'bug_tracker_uri' => 'https://github.com/infused/ziptz/issues',
+    'rubygems_mfa_required' => 'true'
+  }
   s.add_dependency 'sqlite3', '~> 2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ziptz
 version: !ruby/object:Gem::Version
-  version: 6.1.0
+  version: 6.2.0
 platform: ruby
 authors:
 - Keith Morrison
@@ -31,18 +31,19 @@ extra_rdoc_files:
 - LICENSE
 - README.md
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
-- lib/version.rb
 - lib/ziptz.rb
-- spec/fixtures/tz.db
-- spec/spec_helper.rb
-- spec/ziptz_spec.rb
+- lib/ziptz/version.rb
 - ziptz.gemspec
-homepage: http://github.com/infused/ziptz
+homepage: https://github.com/infused/ziptz
 licenses:
 - MIT
 metadata:
+  source_code_uri: https://github.com/infused/ziptz
+  changelog_uri: https://github.com/infused/ziptz/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/infused/ziptz/issues
   rubygems_mfa_required: 'true'
 rdoc_options:
 - "--charset=UTF-8"
@@ -59,7 +60,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.16
 specification_version: 4
 summary: TimeZone info for any 5-digit US zip code
 test_files: []

data/spec/spec_helper.rb

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-require 'ziptz'
-require 'yaml'
-require 'rspec'
-
-RSpec.configure do |config|
-  config.order = :random
-  config.disable_monkey_patching!
-end

data/spec/ziptz_spec.rb

@@ -1,133 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-
-RSpec.describe Ziptz do
-  let(:db_path) { File.join(File.dirname(__FILE__), 'fixtures', 'tz.db') }
-  let(:ziptz) { described_class.new(db_path) }
-
-  describe 'when inspected' do
-    it 'does not show internal instance variables' do
-      expect(ziptz.inspect).to match(/#<Ziptz:\d+>/)
-    end
-  end
-
-  describe '#time_zone_name' do
-    context 'when given a 5-digit zipcode' do
-      it 'returns the time zone number' do
-        expect(ziptz.time_zone_name('97034')).to eq 'America/Los_Angeles'
-      end
-    end
-
-    context 'when given a 9-digit zipcode' do
-      it 'returns the time zone number' do
-        expect(ziptz.time_zone_name('97034-1234')).to eq 'America/Los_Angeles'
-      end
-    end
-
-    context 'when there is no matching zipcode' do
-      it 'raises ZipNotFound' do
-        expect { ziptz.time_zone_name('xyz') }.to raise_error(Ziptz::ZipNotFound)
-      end
-    end
-
-    context 'when nil is passed' do
-      it 'raises ZipNotFound' do
-        expect { ziptz.time_zone_name(nil) }.to raise_error(Ziptz::ZipNotFound)
-      end
-    end
-  end
-
-  describe '#time_zone_uses_dst?' do
-    context 'when given a valid 5-digit zipcode' do
-      it 'returns true' do
-        expect(ziptz.time_zone_uses_dst?('97034')).to be true
-      end
-    end
-
-    context 'when given an invalid 5-digit zipcode' do
-      it 'returns false' do
-        expect(ziptz.time_zone_uses_dst?('85004')).to be false
-      end
-    end
-
-    context 'when given a valid 9-digit zipcode' do
-      it 'returns a true' do
-        expect(ziptz.time_zone_uses_dst?('97034-1234')).to be true
-      end
-    end
-
-    context 'when given an invalid 9-digit zipcode' do
-      it 'returns false' do
-        expect(ziptz.time_zone_uses_dst?('85004-1234')).to be false
-      end
-    end
-
-    context 'when there is no matching zipcode' do
-      it 'raises ZipNotFound' do
-        expect { ziptz.time_zone_uses_dst?('xyz') }.to raise_error(Ziptz::ZipNotFound)
-      end
-    end
-  end
-
-  describe '#time_zone_offset' do
-    context 'when given a 5-digit zipcode' do
-      it 'returns the time zone number' do
-        expect(ziptz.time_zone_offset('97034')).to eq(-28_800)
-      end
-    end
-
-    context 'when given a 9-digit zipcode' do
-      it 'returns the time zone number' do
-        expect(ziptz.time_zone_offset('97034-1234')).to eq(-28_800)
-      end
-    end
-
-    context 'when there is no matching zipcode' do
-      it 'raises ZipNotFound' do
-        expect { ziptz.time_zone_offset('xyz') }.to raise_error(Ziptz::ZipNotFound)
-      end
-    end
-  end
-
-  describe '#zips' do
-    context 'when given a time zone' do
-      it 'returns an array of zip codes' do
-        expect(ziptz.zips('Pacific/Pago_Pago')).to eq %w[96799]
-      end
-
-      it 'is case-insensitive' do
-        expect(ziptz.zips('pacific/pago_pago')).to eq %w[96799]
-      end
-
-      it 'returns empty array for unknown time zones' do
-        expect(ziptz.zips('Glark')).to be_empty
-      end
-    end
-  end
-
-  describe 'initialization' do
-    it 'accepts database path as first argument' do
-      expect { described_class.new(db_path) }.to_not raise_error
-    end
-
-    it 'accepts database path as keyword argument' do
-      expect { described_class.new(db: db_path) }.to_not raise_error
-    end
-
-    it 'raises an error when database path is nil' do
-      expect { described_class.new }.to raise_error(ArgumentError, 'Database path is required')
-      expect { described_class.new(db: nil) }.to raise_error(ArgumentError, 'Database path is required')
-    end
-
-    it 'raises an error when database path is empty' do
-      expect { described_class.new('') }.to raise_error(ArgumentError, 'Database path is required')
-      expect { described_class.new(db: '') }.to raise_error(ArgumentError, 'Database path is required')
-    end
-
-    it 'raises an error when database file does not exist' do
-      expect { described_class.new('nonexistent.db') }.to raise_error(ArgumentError, 'Database file does not exist')
-      expect { described_class.new(db: 'nonexistent.db') }.to raise_error(ArgumentError, 'Database file does not exist')
-    end
-  end
-end