hvor 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: dbd8b653c8cf22786cc82ea2d5576a4b9cc1068f3fa464fd24757cd559bda69b
+  data.tar.gz: 86ff53ec10227b1348108d728f0ab747dfd66371eed97a5f4948333888a046ac
+SHA512:
+  metadata.gz: 0016eff6b286c15d0714f647df9e40c2733819ff62c084ce9b353f4f015d27917dd6ad1eedf0574954acc966cd696be524154620faad432c64d82975037445bb
+  data.tar.gz: efd340a860b6653739f19e6d27ed6e1afe3af80bbaadb6e4d9f5eddda79c82b8b2c6faf1119aa87b953a505ff1f98589bddf5214060e86794fd9b9100684e716

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright RobL
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,101 @@
+# Hvor
+
+*Hvor* ("where", in Danish) is a mountable Rails engine that imports
+[IP2Location](https://lite.ip2location.com/) LITE CSV data (IPv4 and IPv6
+ranges mapped to `country_code`) into an `Hvor::IPRange` table, and answers
+"what country is this IP in?" via a cached lookup and a small JSON API.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "hvor"
+```
+
+Then:
+
+```bash
+bundle
+bin/rails generate hvor:install
+bin/rails hvor:install:migrations
+bin/rails db:migrate
+```
+
+The install generator writes `config/initializers/hvor.rb`. At minimum, set an
+IP2Location LITE token there (or via the `IP2LOCATION_TOKEN` env var) — get
+one free at https://lite.ip2location.com/.
+
+## Populating IPRange
+
+Enqueue `Hvor::ImportIpRangesJob` (on a daily/weekly schedule via whatever job
+scheduler your app uses — IP2Location LITE data updates roughly monthly). It
+downloads the IPv4 and IPv6 country CSV zips, and does an atomic
+dump-and-repopulate of `Hvor::IPRange` — the table is only ever replaced once
+both files have downloaded and parsed successfully.
+
+```ruby
+Hvor::ImportIpRangesJob.perform_later
+```
+
+## Looking up an IP
+
+```ruby
+Hvor.lookup("1.0.0.1")        # => "AU"
+Hvor.lookup("::ffff:8.8.8.8") # => "US" (ipv4-mapped ipv6 is unwrapped to plain ipv4)
+```
+
+Results (including misses) are cached via `Rails.cache` for
+`Hvor.configuration.cache_expires_in` (default 24 hours). A `country_code` of
+`"-"` means the IP falls in an unallocated/private/reserved range (this is
+IP2Location's own placeholder — e.g. `Hvor.lookup("127.0.0.1")` will
+typically return `"-"`, not `nil`; `nil` means the IP simply isn't covered by
+any imported range, which shouldn't happen once the table is populated).
+
+## Mounted API
+
+Mount the engine in your host app's routes:
+
+```ruby
+mount Hvor::Engine => "/hvor"
+```
+
+This exposes:
+
+- `GET /hvor/lookup?ip=1.2.3.4` — `{"ip":"1.2.3.4","country_code":"AU"}`
+- `GET /hvor/lookup/me` — same, but for the requesting client's own IP
+  (`request.remote_ip`)
+
+An invalid `ip` param returns `400` with `{"error": "..."}`.
+
+## Configuration
+
+```ruby
+# config/initializers/hvor.rb
+Hvor.configure do |config|
+  config.api_token = ENV["IP2LOCATION_TOKEN"]
+  config.ipv4_product_code = "DB1LITECSV"      # country-only LITE database
+  config.ipv6_product_code = "DB1LITECSVIPV6"
+  config.cache_store = -> { Rails.cache }
+  config.cache_expires_in = 24.hours
+  config.import_batch_size = 5_000
+  config.download_timeout = 60
+  config.queue_name = :hvor
+end
+```
+
+## Database notes
+
+`hvor_ip_ranges` stores IPv4 bounds as `bigint` and IPv6 bounds as a
+zero-padded 32-character lowercase hex string (IPv6's 128-bit range doesn't
+fit in a bigint), so lookups work identically on PostgreSQL, MySQL, and
+SQLite. The migration pins a binary-order collation on the IPv6 columns
+(`C` on Postgres, `ascii_bin` on MySQL) so string comparison matches numeric
+ordering regardless of the database's default locale — if you're running
+CI against a database other than SQLite, make sure that migration path gets
+exercised at least once, since SQLite's default collation is already binary
+and won't catch a regression here.
+
+## License
+
+MIT.

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/setup"
+
+APP_RAKEFILE = File.expand_path("spec/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+load "rails/tasks/statistics.rake"
+
+require "bundler/gem_tasks"

data/app/assets/stylesheets/hvor/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/controllers/hvor/application_controller.rb

@@ -0,0 +1,4 @@
+module Hvor
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/controllers/hvor/lookups_controller.rb

@@ -0,0 +1,19 @@
+module Hvor
+  class LookupsController < ApplicationController
+    def show
+      render_lookup(params[:ip])
+    end
+
+    def me
+      render_lookup(request.remote_ip)
+    end
+
+    private
+
+    def render_lookup(ip)
+      render json: { ip: ip, country_code: Hvor.lookup(ip) }
+    rescue Hvor::InvalidIpError => e
+      render json: { error: e.message }, status: :bad_request
+    end
+  end
+end

data/app/helpers/hvor/application_helper.rb

@@ -0,0 +1,4 @@
+module Hvor
+  module ApplicationHelper
+  end
+end

data/app/jobs/hvor/application_job.rb

@@ -0,0 +1,4 @@
+module Hvor
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/jobs/hvor/import_ip_ranges_job.rb

@@ -0,0 +1,20 @@
+module Hvor
+  class ImportIpRangesJob < ApplicationJob
+    queue_as { Hvor.configuration.queue_name }
+
+    LOCK_KEY = "hvor/import_ip_ranges_job/lock"
+
+    def perform
+      acquired_lock = Hvor.configuration.cache.write(LOCK_KEY, true, unless_exist: true)
+      return unless acquired_lock
+
+      ipv4_zip = Hvor::Downloader.new(Hvor.configuration.ipv4_product_code).call
+      ipv6_zip = Hvor::Downloader.new(Hvor.configuration.ipv6_product_code).call
+
+      Hvor::Importer.new.import(ipv4_zip: ipv4_zip, ipv6_zip: ipv6_zip)
+    ensure
+      [ ipv4_zip, ipv6_zip ].each { |file| file&.close! }
+      Hvor.configuration.cache.delete(LOCK_KEY) if acquired_lock
+    end
+  end
+end

data/app/mailers/hvor/application_mailer.rb

@@ -0,0 +1,6 @@
+module Hvor
+  class ApplicationMailer < ActionMailer::Base
+    default from: "from@example.com"
+    layout "mailer"
+  end
+end

data/app/models/hvor/application_record.rb

@@ -0,0 +1,5 @@
+module Hvor
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/hvor/ip_range.rb

@@ -0,0 +1,21 @@
+module Hvor
+  class IPRange < ApplicationRecord
+    enum :ip_version, { ipv4: 0, ipv6: 1 }
+
+    def self.lookup_country_code(ip)
+      find_containing(ip)&.country_code
+    end
+
+    def self.find_containing(ip)
+      normalized = Hvor::IpNormalizer.normalize(ip)
+      from_column, to_column = normalized.version == :ipv4 ? %w[ipv4_from ipv4_to] : %w[ipv6_from ipv6_to]
+
+      range = where(ip_version: normalized.version)
+        .where("#{from_column} <= ?", normalized.value)
+        .order(from_column => :desc)
+        .first
+
+      range if range && range[to_column] && range[to_column] >= normalized.value
+    end
+  end
+end

data/app/services/hvor/downloader.rb

@@ -0,0 +1,57 @@
+require "net/http"
+require "uri"
+require "tempfile"
+
+module Hvor
+  class DownloadError < StandardError; end
+
+  # Downloads an IP2Location LITE CSV zip archive for the given product code
+  # (e.g. "DB1LITECSV", "DB1LITECSVIPV6") and returns it as a Tempfile. The
+  # caller is responsible for closing/unlinking the Tempfile.
+  class Downloader
+    MAX_REDIRECTS = 5
+
+    def initialize(product_code, timeout: Hvor.configuration.download_timeout)
+      @product_code = product_code
+      @timeout = timeout
+    end
+
+    def call
+      fetch(download_uri, MAX_REDIRECTS)
+    end
+
+    private
+
+    attr_reader :product_code, :timeout
+
+    def download_uri
+      URI("https://www.ip2location.com/download?token=#{Hvor.configuration.api_token}&file=#{product_code}")
+    end
+
+    def fetch(uri, redirects_left)
+      raise DownloadError, "too many redirects downloading #{uri}" if redirects_left < 0
+
+      Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https",
+                      open_timeout: timeout, read_timeout: timeout) do |http|
+        http.request(Net::HTTP::Get.new(uri)) do |response|
+          case response
+          when Net::HTTPRedirection
+            return fetch(uri + response["location"], redirects_left - 1)
+          when Net::HTTPSuccess
+            return stream_to_tempfile(response)
+          else
+            raise DownloadError, "failed to download #{uri}: #{response.code} #{response.message}"
+          end
+        end
+      end
+    end
+
+    def stream_to_tempfile(response)
+      file = Tempfile.new([ product_code, ".zip" ], binmode: true)
+      response.read_body { |chunk| file.write(chunk) }
+      file.flush
+      file.rewind
+      file
+    end
+  end
+end

data/app/services/hvor/importer.rb

@@ -0,0 +1,70 @@
+require "zip"
+require "csv"
+
+module Hvor
+  class ImportError < StandardError; end
+
+  # Streams IP2Location LITE CSV rows out of a downloaded zip archive and
+  # performs an atomic dump-and-repopulate of Hvor::IPRange.
+  #
+  # Both files are fully parsed into batches *before* the database is
+  # touched, so a failure downloading/parsing the second file never leaves
+  # the table half-populated, and the transaction itself holds no network
+  # I/O (just delete_all + insert_all).
+  class Importer
+    def initialize(batch_size: Hvor.configuration.import_batch_size)
+      @batch_size = batch_size
+    end
+
+    def import(ipv4_zip:, ipv6_zip:)
+      timestamp = Time.current
+      ipv4_batches = read_batches(ipv4_zip, ip_version: 0, timestamp: timestamp) { |row| ipv4_attributes(row) }
+      ipv6_batches = read_batches(ipv6_zip, ip_version: 1, timestamp: timestamp) { |row| ipv6_attributes(row) }
+
+      Hvor::IPRange.transaction do
+        Hvor::IPRange.delete_all
+        ipv4_batches.each { |batch| Hvor::IPRange.insert_all(batch) }
+        ipv6_batches.each { |batch| Hvor::IPRange.insert_all(batch) }
+      end
+    end
+
+    private
+
+    attr_reader :batch_size
+
+    def read_batches(zip_file, ip_version:, timestamp:)
+      batches = []
+
+      each_csv_row(zip_file) do |slice|
+        batches << slice.map do |row|
+          yield(row).merge(ip_version: ip_version, created_at: timestamp, updated_at: timestamp)
+        end
+      end
+
+      batches
+    end
+
+    def each_csv_row(zip_file)
+      Zip::File.open(zip_file.path) do |zip|
+        entry = zip.entries.find { |e| e.name.downcase.end_with?(".csv") } || zip.entries.first
+        raise ImportError, "#{zip_file.path} does not contain a CSV entry" unless entry
+
+        entry.get_input_stream do |io|
+          CSV.new(io, headers: false).each_slice(batch_size) { |slice| yield slice }
+        end
+      end
+    end
+
+    def ipv4_attributes(row)
+      { ipv4_from: Integer(row[0], 10), ipv4_to: Integer(row[1], 10), country_code: row[2] }
+    end
+
+    def ipv6_attributes(row)
+      { ipv6_from: hex(row[0]), ipv6_to: hex(row[1]), country_code: row[2] }
+    end
+
+    def hex(decimal_string)
+      Integer(decimal_string, 10).to_s(16).rjust(32, "0")
+    end
+  end
+end

data/app/services/hvor/ip_normalizer.rb

@@ -0,0 +1,46 @@
+require "ipaddr"
+
+module Hvor
+  class InvalidIpError < StandardError; end
+
+  module IpNormalizer
+    Result = Struct.new(:version, :value)
+
+    IPV6_HEX_WIDTH = 32
+
+    module_function
+
+    # Returns a Result with:
+    #   version: :ipv4 or :ipv6
+    #   value:   Integer (0..2**32-1) for ipv4, zero-padded 32-char lowercase
+    #            hex String for ipv6 -- the same representation IPRange uses
+    #            for its ipv4_from/to and ipv6_from/to columns, so callers can
+    #            compare/query directly against it.
+    def normalize(ip)
+      raise InvalidIpError, "ip is blank" if ip.nil? || ip.to_s.strip.empty?
+
+      address = parse(strip_zone_id(ip.to_s.strip))
+      address = address.native if address.ipv4_mapped?
+
+      if address.ipv4?
+        Result.new(:ipv4, address.to_i)
+      else
+        Result.new(:ipv6, address.to_i.to_s(16).rjust(IPV6_HEX_WIDTH, "0"))
+      end
+    end
+
+    def parse(ip)
+      IPAddr.new(ip)
+    rescue IPAddr::Error => e
+      raise InvalidIpError, "#{ip.inspect} is not a valid IP address (#{e.message})"
+    end
+
+    # A zone ID (e.g. "fe80::1%eth0") is only meaningful for scoping a link-local
+    # address to a network interface -- IPAddr#to_i folds it into the integer
+    # value in a way that no longer represents the plain 128-bit address, so it
+    # must be dropped before converting to our lookup representation.
+    def strip_zone_id(ip)
+      ip.sub(/%.*\z/, "")
+    end
+  end
+end

data/app/views/layouts/hvor/application.html.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Hvor</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= yield :head %>
+
+  <%= stylesheet_link_tag    "hvor/application", media: "all" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/config/routes.rb

@@ -0,0 +1,4 @@
+Hvor::Engine.routes.draw do
+  get "lookup", to: "lookups#show"
+  get "lookup/me", to: "lookups#me"
+end

data/db/migrate/20260727225339_create_hvor_ip_ranges.rb

@@ -0,0 +1,30 @@
+class CreateHvorIpRanges < ActiveRecord::Migration[8.0]
+  def change
+    create_table :hvor_ip_ranges do |t|
+      t.integer :ip_version, null: false
+      t.bigint :ipv4_from
+      t.bigint :ipv4_to
+      t.string :ipv6_from, limit: 32, collation: ipv6_collation
+      t.string :ipv6_to, limit: 32, collation: ipv6_collation
+      t.string :country_code, limit: 2, null: false
+
+      t.timestamps
+    end
+
+    add_index :hvor_ip_ranges, [ :ip_version, :ipv4_from ]
+    add_index :hvor_ip_ranges, [ :ip_version, :ipv6_from ]
+  end
+
+  private
+
+  # IPv6 bounds are stored as zero-padded lowercase hex strings so plain
+  # string comparison matches numeric ordering. That only holds if the
+  # column collates by byte value, so pin a binary-order collation on
+  # adapters whose default collation could reorder alphanumerics.
+  def ipv6_collation
+    case connection.adapter_name.downcase
+    when /postg/ then "C"
+    when /mysql/ then "ascii_bin"
+    end
+  end
+end

data/lib/generators/hvor/install/install_generator.rb

@@ -0,0 +1,27 @@
+module Hvor
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Creates a Hvor initializer and prints setup instructions."
+
+      def copy_initializer
+        template "initializer.rb", "config/initializers/hvor.rb"
+      end
+
+      def show_readme
+        say ""
+        say "Hvor is installed. Next steps:", :green
+        say "  1. Mount the engine, e.g. in config/routes.rb:"
+        say '       mount Hvor::Engine => "/hvor"'
+        say "  2. Install and run its migration:"
+        say "       bin/rails hvor:install:migrations"
+        say "       bin/rails db:migrate"
+        say "  3. Set an IP2Location LITE token in config/initializers/hvor.rb"
+        say "     (or the IP2LOCATION_TOKEN env var), then enqueue"
+        say "     Hvor::ImportIpRangesJob to populate Hvor::IPRange."
+        say ""
+      end
+    end
+  end
+end

data/lib/generators/hvor/install/templates/initializer.rb

@@ -0,0 +1,17 @@
+Hvor.configure do |config|
+  # Token from your IP2Location LITE account: https://lite.ip2location.com/
+  config.api_token = Rails.application.credentials.dig(:hvor, :ip2location_token) || ENV["IP2LOCATION_TOKEN"]
+
+  # LITE product codes for the country-only database (DB1). See
+  # https://lite.ip2location.com/database/db1-ip-country for other databases.
+  # config.ipv4_product_code = "DB1LITECSV"
+  # config.ipv6_product_code = "DB1LITECSVIPV6"
+
+  # Hvor.lookup(ip) caches results here.
+  # config.cache_store = -> { Rails.cache }
+  # config.cache_expires_in = 24.hours
+
+  # config.import_batch_size = 5_000
+  # config.download_timeout = 60
+  # config.queue_name = :hvor
+end

data/lib/hvor/configuration.rb

@@ -0,0 +1,22 @@
+module Hvor
+  class Configuration
+    attr_accessor :api_token, :ipv4_product_code, :ipv6_product_code,
+                  :cache_store, :cache_expires_in, :import_batch_size,
+                  :download_timeout, :queue_name
+
+    def initialize
+      @api_token = nil
+      @ipv4_product_code = "DB1LITECSV"
+      @ipv6_product_code = "DB1LITECSVIPV6"
+      @cache_store = -> { Rails.cache }
+      @cache_expires_in = 24.hours
+      @import_batch_size = 5_000
+      @download_timeout = 60
+      @queue_name = :hvor
+    end
+
+    def cache
+      cache_store.call
+    end
+  end
+end

data/lib/hvor/engine.rb

@@ -0,0 +1,13 @@
+module Hvor
+  class Engine < ::Rails::Engine
+    isolate_namespace Hvor
+
+    # "ip_range.rb" would otherwise camelize to "IpRange" -- register the
+    # acronym so Zeitwerk resolves it to the IPRange model.
+    initializer "hvor.inflections", before: :set_autoload_paths do
+      Rails.autoloaders.each do |autoloader|
+        autoloader.inflector.inflect("ip_range" => "IPRange")
+      end
+    end
+  end
+end

data/lib/hvor/version.rb

@@ -0,0 +1,3 @@
+module Hvor
+  VERSION = "0.1.1"
+end

data/lib/hvor.rb

@@ -0,0 +1,21 @@
+require "hvor/version"
+require "hvor/configuration"
+require "hvor/engine"
+
+module Hvor
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield configuration
+    end
+
+    def lookup(ip)
+      configuration.cache.fetch("hvor/lookup/#{ip}", expires_in: configuration.cache_expires_in) do
+        Hvor::IPRange.lookup_country_code(ip)
+      end
+    end
+  end
+end

data/lib/tasks/hvor_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :hvor do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification
+name: hvor
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- RobL
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.0.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.0.4
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.19'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Hvor is a mountable Rails engine providing an ActiveJob that downloads
+  and imports IP2Location LITE CSV zip archives (IPv4 + IPv6 ranges mapped to country_code)
+  into an IPRange model, a cached Hvor.lookup(ip) API, and a lightweight mounted JSON
+  API for looking up an arbitrary IP or the requesting client's own IP.
+email:
+- contact@robl.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/stylesheets/hvor/application.css
+- app/controllers/hvor/application_controller.rb
+- app/controllers/hvor/lookups_controller.rb
+- app/helpers/hvor/application_helper.rb
+- app/jobs/hvor/application_job.rb
+- app/jobs/hvor/import_ip_ranges_job.rb
+- app/mailers/hvor/application_mailer.rb
+- app/models/hvor/application_record.rb
+- app/models/hvor/ip_range.rb
+- app/services/hvor/downloader.rb
+- app/services/hvor/importer.rb
+- app/services/hvor/ip_normalizer.rb
+- app/views/layouts/hvor/application.html.erb
+- config/routes.rb
+- db/migrate/20260727225339_create_hvor_ip_ranges.rb
+- lib/generators/hvor/install/install_generator.rb
+- lib/generators/hvor/install/templates/initializer.rb
+- lib/hvor.rb
+- lib/hvor/configuration.rb
+- lib/hvor/engine.rb
+- lib/hvor/version.rb
+- lib/tasks/hvor_tasks.rake
+homepage: https://github.com/braindeaf/hvor
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/braindeaf/hvor
+  source_code_uri: https://github.com/braindeaf/hvor
+  changelog_uri: https://github.com/braindeaf/hvor/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Rails engine that imports IP2Location LITE CSV data and answers IP -> country_code
+  lookups.
+test_files: []