free_zipcode_data 1.0.6 → 1.1.0

data/spec/free_zipcode_data/zipcode_table_spec.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require 'free_zipcode_data/zipcode_table'
+
+RSpec.describe FreeZipcodeData::ZipcodeTable do
+  let(:db) { create_test_database(line_count: 5) }
+  let(:table) { described_class.new(database: db, tablename: 'zipcodes') }
+
+  before do
+    seed_countries(db)
+    seed_states(db)
+    table.build
+  end
+
+  describe '#build' do
+    it 'creates the zipcodes table' do
+      tables = db.execute("SELECT name FROM sqlite_master WHERE type='table' AND name='zipcodes'")
+      expect(tables.length).to eq(1)
+    end
+
+    it 'creates the unique_zipcode index' do
+      indexes = db.execute("SELECT name FROM sqlite_master WHERE type='index' AND tbl_name='zipcodes'")
+      index_names = indexes.map(&:first)
+      expect(index_names).to include('unique_zipcode')
+    end
+
+    it 'creates columns for code, state_id, city, area_code, lat, lon, accuracy' do
+      columns = db.execute("PRAGMA table_info('zipcodes')").map { |c| c[1] }
+      expect(columns).to include('code', 'state_id', 'city', 'area_code', 'lat', 'lon', 'accuracy')
+    end
+  end
+
+  describe '#write' do
+    let(:row) do
+      {
+        country: 'US',
+        postal_code: '60601',
+        short_state: 'IL',
+        state: 'Illinois',
+        city: 'Chicago',
+        latitude: '41.8819',
+        longitude: '-87.6278',
+        accuracy: '4'
+      }
+    end
+
+    it 'inserts a zipcode row' do
+      table.write(row)
+      rows = db.execute('SELECT code, city FROM zipcodes')
+      expect(rows.length).to eq(1)
+      expect(rows[0]).to eq(%w[60601 Chicago])
+    end
+
+    it 'stores latitude and longitude' do
+      table.write(row)
+      rows = db.execute('SELECT lat, lon FROM zipcodes')
+      expect(rows[0][0].to_s).to start_with('41.88')
+      expect(rows[0][1].to_s).to start_with('-87.62')
+    end
+
+    it 'links the zipcode to its state' do
+      table.write(row)
+      state_id = db.execute("SELECT id FROM states WHERE abbr = 'IL'")[0][0]
+      zipcode_state_id = db.execute('SELECT state_id FROM zipcodes')[0][0]
+      expect(zipcode_state_id.to_i).to eq(state_id)
+    end
+
+    it 'returns nil and skips when postal_code is nil' do
+      result = table.write(row.merge(postal_code: nil))
+      expect(result).to be_nil
+      rows = db.execute('SELECT COUNT(*) FROM zipcodes')
+      expect(rows[0][0]).to eq(0)
+    end
+
+    it 'returns nil and skips when state cannot be found' do
+      result = table.write(row.merge(short_state: 'ZZ', state: 'Nonexistent'))
+      expect(result).to be_nil
+      rows = db.execute('SELECT COUNT(*) FROM zipcodes')
+      expect(rows[0][0]).to eq(0)
+    end
+
+    it 'silently ignores duplicate zipcode entries' do
+      table.write(row)
+      expect { table.write(row) }.not_to raise_error
+      rows = db.execute('SELECT COUNT(*) FROM zipcodes')
+      expect(rows[0][0]).to eq(1)
+    end
+
+    it 'handles city names with single quotes' do
+      table.write(row.merge(city: "Coeur d'Alene", postal_code: '83814'))
+      rows = db.execute('SELECT city FROM zipcodes')
+      expect(rows[0][0]).to eq("Coeur d'Alene")
+    end
+
+    it 'inserts multiple different zipcodes' do
+      table.write(row)
+      table.write(row.merge(postal_code: '10001', city: 'New York', short_state: 'NY', state: 'New York'))
+      rows = db.execute('SELECT COUNT(*) FROM zipcodes')
+      expect(rows[0][0]).to eq(2)
+    end
+  end
+end

data/spec/free_zipcode_data_spec.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+RSpec.describe FreeZipcodeData do
+  describe '.root' do
+    it 'returns a Pathname to the project root' do
+      expect(described_class.root).to be_a(Pathname)
+      expect(described_class.root.join('lib', 'free_zipcode_data.rb')).to exist
+    end
+  end
+
+  describe '.current_environment' do
+    it 'returns "test" when APP_ENV is set to test' do
+      expect(described_class.current_environment).to eq('test')
+    end
+
+    it 'defaults to "development" when APP_ENV is not set' do
+      allow(ENV).to receive(:fetch).with('APP_ENV', 'development').and_return('development')
+      expect(described_class.current_environment).to eq('development')
+    end
+  end
+
+  describe '.config_file' do
+    it 'returns spec/fixtures path in test environment' do
+      path = described_class.config_file
+      expect(path.to_s).to include('spec/fixtures/.free_zipcode_data.yml')
+    end
+  end
+
+  describe '.os' do
+    it 'returns :normal on non-Windows platforms' do
+      expect(described_class.os).to eq(:normal)
+    end
+  end
+
+  it 'has a version number' do
+    expect(FreeZipcodeData::VERSION).to match(/\A\d+\.\d+\.\d+\z/)
+  end
+end

data/spec/spec_helper.rb

@@ -2,11 +2,32 @@
 
 ENV['APP_ENV'] = 'test'
 
-require 'pry'
+begin
+  require 'pry'
+rescue NameError, LoadError
+  # pry may not be compatible with current Ruby version
+end
+
+require 'ostruct'
+require 'free_zipcode_data'
+require 'free_zipcode_data/runner'
 
-Dir[Pathname.new(File.dirname(__FILE__)).parent.join('spec/support/**/*.rb')].sort.each { |f| require f }
+Dir[Pathname.new(File.dirname(__FILE__)).parent.join('spec/support/**/*.rb')].each { |f| require f }
 
 RSpec.configure do |config|
+  config.include DatabaseHelpers
+
+  # Silence progress bar and logger output during tests
+  config.before do
+    allow(ProgressBar).to receive(:create).and_wrap_original do |method, **args|
+      method.call(**args, output: StringIO.new)
+    end
+    FreeZipcodeData::Logger.instance.log_provider = Logger.new(StringIO.new)
+    FreeZipcodeData::Options.instance.initialize_hash(
+      OpenStruct.new(verbose: false)
+    )
+  end
+
   config.expect_with :rspec do |expectations|
     expectations.include_chain_clauses_in_custom_matcher_descriptions = true
   end

data/spec/support/database_helpers.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'sqlite3'
+
+module DatabaseHelpers
+  def create_test_database(line_count: 5)
+    db = SQLite3::Database.new(':memory:')
+    db.execute_batch(<<-SQL)
+      CREATE TABLE meta (
+        id integer not null primary key,
+        name varchar(255),
+        value varchar(255)
+      )
+    SQL
+    db.execute("INSERT INTO meta (name, value) VALUES ('line_count', #{line_count})")
+    db
+  end
+
+  def seed_countries(db, tablename: 'countries')
+    table = FreeZipcodeData::CountryTable.new(database: db, tablename: tablename)
+    table.build
+    [
+      { country: 'US' },
+      { country: 'CA' },
+      { country: 'GB' }
+    ].each { |row| table.write(row) }
+  end
+
+  def seed_states(db, tablename: 'states')
+    table = FreeZipcodeData::StateTable.new(database: db, tablename: tablename)
+    table.build
+    [
+      { country: 'US', short_state: 'NY', state: 'New York' },
+      { country: 'US', short_state: 'CA', state: 'California' },
+      { country: 'US', short_state: 'IL', state: 'Illinois' }
+    ].each { |row| table.write(row) }
+  end
+
+  def seed_counties(db, tablename: 'counties')
+    table = FreeZipcodeData::CountyTable.new(database: db, tablename: tablename)
+    table.build
+    [
+      { country: 'US', county: 'New York', short_county: '061', short_state: 'NY', state: 'New York' },
+      { country: 'US', county: 'Los Angeles', short_county: '037', short_state: 'CA', state: 'California' },
+      { country: 'US', county: 'Cook', short_county: '031', short_state: 'IL', state: 'Illinois' }
+    ].each { |row| table.write(row) }
+  end
+end

metadata

@@ -1,80 +1,37 @@
 --- !ruby/object:Gem::Specification
 name: free_zipcode_data
 version: !ruby/object:Gem::Version
-  version: 1.0.6
+  version: 1.1.0
 platform: ruby
 authors:
 - Chris Blackburn
 - Chris McKnight
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-09-30 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: pry-nav
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
+  name: colored
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
-  type: :development
+        version: '1.2'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: '1.2'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: csv
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -82,61 +39,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: ruby-prof
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.17'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.17'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.16'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.16'
-- !ruby/object:Gem::Dependency
-  name: colored
+  name: kiba
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
-  name: kiba
+  name: logger
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: optimist
   requirement: !ruby/object:Gem::Requirement
@@ -209,6 +138,7 @@ files:
 - ".rubocop.yml"
 - ".ruby-version"
 - CHANGELOG
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - CONTRIBUTING.md
 - Gemfile
@@ -242,13 +172,31 @@ files:
 - lib/free_zipcode_data/version.rb
 - lib/free_zipcode_data/zipcode_table.rb
 - lib/tasks/version.rake
+- spec/etl/csv_source_spec.rb
+- spec/etl/free_zipcode_data_job_spec.rb
+- spec/fixtures/.free_zipcode_data.yml
+- spec/fixtures/US.txt
+- spec/fixtures/US.zip
+- spec/fixtures/test_data.csv
+- spec/fixtures/test_data.txt
+- spec/free_zipcode_data/country_table_spec.rb
+- spec/free_zipcode_data/county_table_spec.rb
+- spec/free_zipcode_data/data_source_spec.rb
+- spec/free_zipcode_data/db_table_spec.rb
+- spec/free_zipcode_data/logger_spec.rb
+- spec/free_zipcode_data/options_spec.rb
+- spec/free_zipcode_data/runner_spec.rb
+- spec/free_zipcode_data/sqlite_ram_spec.rb
+- spec/free_zipcode_data/state_table_spec.rb
+- spec/free_zipcode_data/zipcode_table_spec.rb
+- spec/free_zipcode_data_spec.rb
 - spec/spec_helper.rb
+- spec/support/database_helpers.rb
 homepage: https://github.com/midwire/free_zipcode_data
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -256,15 +204,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.2
+      version: 3.4.8
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Free US and world-wide postal codes in SQLite and CSV format
 test_files: []