free_zipcode_data 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ec6a6653ed5f1da585ef025e5150b5595b6600db3acdb4aa1aea4274213fee4
-  data.tar.gz: 72c8b8636e2b7cd3cfe927d6f0cd3a27d22ae33c94ebc063fb6bb1b7acf22dcb
+  metadata.gz: 5a29b38bacdbf91fb1aad6732c0378eac3588a8bc9efd05c09b48470427da87e
+  data.tar.gz: 3b309917f7e87235ddc201f0db852d81b6f1310b85a32c18bc027600eceb34a3
 SHA512:
-  metadata.gz: 0307eb9d96805a1ff9510f9b8ccc8d64c14c7d1acd9a47199304d65d403f9c39d27656547fe93f5f1be7615fbb31c2ed0f50762d88801e0bbf00239dbdbce22a
-  data.tar.gz: 4bfc6e97652ee64d75d2b68b1c1dd84824658bf7abe9bf6611b7b2b2446febd16ea9439d3da682ae762bf5d77659b83ac9349d0e5ae537448a0679829b240147
+  metadata.gz: 7d8e5b4a3b22359d46f3def15e4801d6ba39d70a8ec019bb1e302c6f98510b5fe6d0166bb7f9c2d8e35a3fda66572b4f4dbd6bc78a87874819864ea6225f8727
+  data.tar.gz: e26f46c2be8dfbb7f69c85a494de27a9607276e6958c56e58b4e63d20a2c9baca9da9fe95a35d4b3cb083f00f24bf0064e1be8aa815b1c6e417ed3cf32b48edd

data/.dockerignore

@@ -0,0 +1,10 @@
+.git
+vendor/bundle
+pkg
+stubs
+spec
+data
+build
+.claude
+docs
+*.sqlite3

data/.gitignore

@@ -6,3 +6,4 @@
 /vendor/bundle/
 /pkg
 .claude/
+docs/plans

data/CHANGELOG

@@ -1,3 +1,9 @@
+*1.2.0* (February 17, 2026)
+
+* Add Dockerfile for containerized data generation without requiring a local Ruby installation
+* Add docker-entrypoint.sh with COUNTRY environment variable support and input validation
+* Add .dockerignore to keep Docker build context lean
+
 *1.1.0* (February 14, 2026)
 
 * Fix state abbreviation uniqueness: state lookups are now scoped by country, allowing the same abbreviation (e.g., "NY") in different countries

data/Dockerfile

@@ -0,0 +1,21 @@
+FROM ruby:3.4-slim
+
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends build-essential git pkg-config && \
+    rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+COPY Gemfile Gemfile.lock free_zipcode_data.gemspec .ruby-version ./
+COPY lib/free_zipcode_data/version.rb lib/free_zipcode_data/version.rb
+RUN git init && git add . && \
+    bundle config set --local without development && \
+    bundle install
+
+COPY . .
+RUN git add .
+
+ENV COUNTRY=""
+VOLUME /output
+
+ENTRYPOINT ["./docker-entrypoint.sh"]

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    free_zipcode_data (1.1.0)
+    free_zipcode_data (1.2.0)
       colored (~> 1.2)
       csv
       kiba (~> 4.0)

data/README.md

@@ -105,6 +105,41 @@ create table zipcodes (
 
 Both `lat` and `lon`, geocodes, are populated for each zipcode record.
 
+## Docker
+
+If you prefer not to install Ruby locally, you can use Docker to generate the database. You only need [Docker](https://docs.docker.com/get-docker/) installed.
+
+### Build the image
+
+```bash
+$ git clone https://github.com/midwire/free_zipcode_data.git
+$ cd free_zipcode_data
+$ docker build -t free_zipcode_data .
+```
+
+### Generate data
+
+Use the `COUNTRY` environment variable to specify a 2-letter country code. Omit it to process all available countries.
+
+**Single country (e.g., US):**
+
+```bash
+$ docker run --rm -v $(pwd)/output:/output -e COUNTRY=US free_zipcode_data
+```
+
+**All countries:**
+
+```bash
+$ docker run --rm -v $(pwd)/output:/output free_zipcode_data
+```
+
+The following files will be written to the `./output/` directory on your host:
+
+* `free_zipcode_data.sqlite3` - SQLite database with countries, states, counties, and zipcodes tables
+* `countries.csv`, `states.csv`, `counties.csv`, `zipcodes.csv` - CSV exports of each table
+
+Look up supported country codes at [GeoNames](http://download.geonames.org/export/zip/).
+
 ## Data License
 
 The zipcode data is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>, carried forward from [GeoNames](http://www.geonames.org).<br />

data/docker-entrypoint.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+args=(--work-dir /output --generate-files --clobber)
+
+if [ -n "${COUNTRY:-}" ]; then
+  if [[ ! "$COUNTRY" =~ ^[A-Z]{2}$ ]]; then
+    echo "Error: COUNTRY must be a 2-letter uppercase code (e.g., US, AD)" >&2
+    exit 1
+  fi
+  args+=(--country "$COUNTRY")
+fi
+
+exec bundle exec ruby bin/free_zipcode_data "${args[@]}"

data/lib/free_zipcode_data/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FreeZipcodeData
-  VERSION = '1.1.0'
+  VERSION = '1.2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: free_zipcode_data
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Chris Blackburn
@@ -133,6 +133,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".dockerignore"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
@@ -141,6 +142,7 @@ files:
 - CLAUDE.md
 - CODE_OF_CONDUCT.md
 - CONTRIBUTING.md
+- Dockerfile
 - Gemfile
 - Gemfile.lock
 - ISSUE_TEMPLATE.md
@@ -155,6 +157,7 @@ files:
 - bin/free_zipcode_data
 - counties_states_zipcodes.sql
 - country_lookup_table.yml
+- docker-entrypoint.sh
 - free_zipcode_data.gemspec
 - lib/etl/common.rb
 - lib/etl/csv_source.rb