maxmind-db 1.1.1 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 485d10049eaba35df9d49f7aa4637857a3fe84f38dec3e2a163c675fc8f2e474
-  data.tar.gz: 964008df8d8bc5bc8c558fb004cbb7eda6843295cb3abd5fea3fc193da58981d
+  metadata.gz: 77f9cd0d89c27c78de29dc99fab391f945d9828b4b5fa84f3deffcee524be975
+  data.tar.gz: 8310c429dded70a05039a7e338c59b2d09167ba4d4a68e79233fea67f21abd6e
 SHA512:
-  metadata.gz: 92181b893b438f63a874d915817f4e325aa4a20fb12e8e373e6d6f4885235472353391db4508f313f7d4b5b9ab33e6f09cd05a5b88e718b59dc352dc18f415be
-  data.tar.gz: a03201ffac72cac0228545ce2f1a3a5e3d84ad807d33fac18bfffd3da4a5be69d0bceee96c5c87429b394410ed3e3efc17f20893700b7811558c7a383d4773e4
+  metadata.gz: 20721610296dd6758e18e7c735cb9321a71dcdbce22b30df0203883fd78b6aa02117585bad059a5db86c1f57d22ac4bdb7e2d9bac01391f528f37b27a3103a29
+  data.tar.gz: 1f19868cdd79c85a1a654ea8e84bc5ae02c5fd422724fcd0cc2766cee445bb02b6f761bd2f66518fbe4d4839d0e028cb481a13a9e5ab022dbbcb8e464fa6a028

data/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 1.4.0 (2025-11-20)
+
+* Ruby 3.2+ is now required. If you're using Ruby 3.0 or 3.1, please use
+  version 1.3.2 of this gem.
+
+## 1.3.2 (2025-04-03)
+
+* Re-release to fix a release script problem. There are no code changes.
+
+## 1.3.1 (2025-04-03)
+
+* Re-release to fix a release script problem. There are no code changes.
+
+## 1.3.0 (2025-04-03)
+
+* Ruby 3.0+ is now required. If you're using Ruby 2.5, 2.6, or 2.7, please
+  use version 1.2.0 of this gem.
+
+## 1.2.0 (2023-11-22)
+
+* Ruby 2.4 is no longer supported. If you're using Ruby 2.4, please use
+  version 1.1.1 of this gem.
+* `Object#respond_to?` is no longer called on every read. Pull request by
+  Jean byroot Boussier. GitHub #65.
+* The `get` and `get_prefix_length` methods now accept the IP addresses as
+  `IPAddr` objects. Strings are still accepted too. Pull request by Eddie
+  Lebow. GitHub #69.
+
 ## 1.1.1 (2020-06-23)
 
 * Fixed the memory reader's inspect method to no longer attempt to modify a

data/Gemfile.lock

@@ -0,0 +1,72 @@
+PATH
+  remote: .
+  specs:
+    maxmind-db (1.4.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    json (2.16.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    minitest (5.26.2)
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.6.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    rubocop (1.81.7)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.48.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-minitest (0.38.2)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    rubocop-thread_safety (0.7.3)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+      rubocop-ast (>= 1.44.0, < 2.0)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  maxmind-db!
+  minitest
+  rake
+  rubocop
+  rubocop-minitest
+  rubocop-performance
+  rubocop-rake
+  rubocop-thread_safety
+
+BUNDLED WITH
+   2.6.9

data/README.dev.md

@@ -1,37 +1,4 @@
 # How to release
-* Ensure tests pass: `rake`
-* Update changelog: Set version and release date
-* Set version in `maxmind-db.gemspec`
-* Add them: `git add -p`
-* Commit: `git commit -m v1.0.0`
-* Tag: `git tag -a v1.0.0 -m v1.0.0`
-* Clean up to be sure nothing stray gets into gem: `git clean -dxff`
-* Create `.gem` file: `gem build maxmind-db.gemspec`
-* Complete prerequisites (see below)
-  * You only need to do this if `~/.gem/credentials` is missing
-    `:rubygems_api_key`.
-* Upload to rubygems.org: `gem push maxmind-db-1.0.0.gem`
-* Push: `git push`
-* Push tag: `git push --tags`
-* Double check it looks okay at https://rubygems.org/gems/maxmind-db and
-  https://www.rubydoc.info/gems/maxmind-db
 
-
-# Prerequisites
-
-## Step 1
-Sign up for an account at rubygems.org if you don't have one.
-
-Enable multi factor authentication.
-
-
-## Step 2
-Ask someone who is an owner of the gem to add you as one.
-
-They do this by using the `gem owner` command
-([docs](https://guides.rubygems.org/command-reference/#gem-owner)).
-
-
-## Step 3
-Go to your rubygems.org profile and find the curl command to run to
-download your API key.
+See
+[here](https://github.com/maxmind/minfraud-api-ruby/blob/main/README.dev.md).

data/README.md

@@ -6,7 +6,6 @@ This is the Ruby API for reading [MaxMind
 DB](https://maxmind.github.io/MaxMind-DB/) files. MaxMind DB is a binary
 file format that stores data indexed by IP address subnets (IPv4 or IPv6).
 
-
 ## Installation
 
 ```
@@ -36,7 +35,7 @@ For more information see the
 
 ## Requirements
 
-This code requires Ruby version 2.4 or higher.
+This code requires Ruby version 3.2 or higher.
 
 ## Contributing
 
@@ -57,7 +56,7 @@ This library uses [Semantic Versioning](https://semver.org/).
 
 ## Copyright and License
 
-This software is Copyright (c) 2018 - 2020 by MaxMind, Inc.
+This software is Copyright (c) 2018 - 2025 by MaxMind, Inc.
 
 This is free software, licensed under the [Apache License, Version
 2.0](LICENSE-APACHE) or the [MIT License](LICENSE-MIT), at your option.

data/Rakefile

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'bundler/gem_tasks'
 require 'rake/testtask'
 require 'rubocop/rake_task'
 
@@ -10,5 +11,4 @@ end
 RuboCop::RakeTask.new
 
 desc 'Run tests and RuboCop'
-task default: :test
-task default: :rubocop
+task default: %i[test rubocop]

data/bin/mmdb-benchmark.rb

@@ -29,9 +29,9 @@ end
 
 def print_usage
   # rubocop:disable Style/StderrPuts
-  STDERR.puts "Usage: #{$PROGRAM_NAME} <MMDB file> <IP file>"
-  STDERR.puts
-  STDERR.puts 'Benchmark by reading IPs from the IP file and looking up each one in the MMDB file.'
+  $stderr.puts "Usage: #{$PROGRAM_NAME} <MMDB file> <IP file>"
+  $stderr.puts
+  $stderr.puts 'Benchmark by reading IPs from the IP file and looking up each one in the MMDB file.'
   # rubocop:enable Style/StderrPuts
 end
 

data/lib/maxmind/db/decoder.rb

@@ -12,6 +12,8 @@ module MaxMind
     #
     # @!visibility private
     class Decoder
+      # rubocop:disable Style/OptionalBooleanParameter
+
       # Create a +Decoder+.
       #
       # +io+ is the DB. It must provide a +read+ method. It must be opened in
@@ -28,6 +30,7 @@ module MaxMind
         @pointer_base = pointer_base
         @pointer_test = pointer_test
       end
+      # rubocop:enable Style/OptionalBooleanParameter
 
       private
 

data/lib/maxmind/db/file_reader.rb

@@ -6,10 +6,36 @@ module MaxMind
   class DB
     # @!visibility private
     class FileReader
+      if ::File.method_defined?(:pread)
+        PReadFile = ::File
+      else
+        # For Windows support
+        class PReadFile
+          def initialize(filename, mode)
+            @mutex = Mutex.new
+            @file = File.new(filename, mode)
+          end
+
+          def size
+            @file.size
+          end
+
+          def close
+            @file.close
+          end
+
+          def pread(size, offset)
+            @mutex.synchronize do
+              @file.seek(offset, IO::SEEK_SET)
+              @file.read(size)
+            end
+          end
+        end
+      end
+
       def initialize(filename)
-        @fh = File.new(filename, 'rb')
+        @fh = PReadFile.new(filename, 'rb')
         @size = @fh.size
-        @mutex = Mutex.new
       end
 
       attr_reader :size
@@ -21,15 +47,7 @@ module MaxMind
       def read(offset, size)
         return ''.b if size == 0
 
-        # When we support only Ruby 2.5+, remove this and require pread.
-        if @fh.respond_to?(:pread)
-          buf = @fh.pread(size, offset)
-        else
-          @mutex.synchronize do
-            @fh.seek(offset, IO::SEEK_SET)
-            buf = @fh.read(size)
-          end
-        end
+        buf = @fh.pread(size, offset)
 
         raise InvalidDatabaseError, 'The MaxMind DB file contains bad data' if buf.nil? || buf.length != size
 

data/lib/maxmind/db.rb

@@ -3,9 +3,9 @@
 require 'ipaddr'
 require 'maxmind/db/decoder'
 require 'maxmind/db/errors'
-require 'maxmind/db/file_reader.rb'
-require 'maxmind/db/memory_reader.rb'
-require 'maxmind/db/metadata.rb'
+require 'maxmind/db/file_reader'
+require 'maxmind/db/memory_reader'
+require 'maxmind/db/metadata'
 
 module MaxMind
   # DB provides a way to read {MaxMind DB
@@ -130,8 +130,7 @@ module MaxMind
     #
     # If no record is found for the IP address, +get+ returns +nil+.
     #
-    # @param ip_address [String] a string in the standard notation. It may be
-    #   IPv4 or IPv6.
+    # @param ip_address [String, IPAddr] IPv4 or IPv6 address.
     #
     # @raise [ArgumentError] if you attempt to look up an IPv6 address in an
     #   IPv4-only database.
@@ -153,8 +152,7 @@ module MaxMind
     # If no record is found for the IP address, the record will be +nil+ and
     # the prefix length will be the value for the missing network.
     #
-    # @param ip_address [String] a string in the standard notation. It may be
-    #   IPv4 or IPv6.
+    # @param ip_address [String, IPAddr] IPv4 or IPv6 address.
     #
     # @raise [ArgumentError] if you attempt to look up an IPv6 address in an
     #   IPv4-only database.
@@ -163,7 +161,8 @@ module MaxMind
     #
     # @return [Array<(Object, Integer)>]
     def get_with_prefix_length(ip_address)
-      ip = IPAddr.new(ip_address)
+      ip = ip_address.is_a?(IPAddr) ? ip_address : IPAddr.new(ip_address)
+
       # We could check the IP has the correct prefix (32 or 128) but I do not
       # for performance reasons.
 
@@ -200,7 +199,7 @@ module MaxMind
         break if depth >= bit_count || node >= node_count
 
         c = packed[depth >> 3].ord
-        bit = 1 & (c >> 7 - (depth % 8))
+        bit = 1 & (c >> (7 - (depth % 8)))
         node = read_node(node, bit)
         depth += 1
       end
@@ -273,7 +272,7 @@ module MaxMind
     end
 
     def find_metadata_start
-      metadata_max_size = @size < METADATA_MAX_SIZE ? @size : METADATA_MAX_SIZE
+      metadata_max_size = [@size, METADATA_MAX_SIZE].min
 
       stop_index = @size - metadata_max_size
       index = @size - METADATA_START_MARKER_LENGTH

data/maxmind-db.gemspec

@@ -2,10 +2,10 @@
 
 Gem::Specification.new do |s|
   s.authors     = ['William Storey']
-  s.files       = Dir['**/*']
+  s.files       = Dir['**/*'].difference(Dir['.github/**/*', 'dev-bin/**/*', 'test/**/*'])
   s.name        = 'maxmind-db'
   s.summary     = 'A gem for reading MaxMind DB files.'
-  s.version     = '1.1.1'
+  s.version     = '1.4.0'
 
   s.description = 'A gem for reading MaxMind DB files. MaxMind DB is a binary file format that stores data indexed by IP address subnets (IPv4 or IPv6).'
   s.email       = 'support@maxmind.com'
@@ -13,15 +13,19 @@ Gem::Specification.new do |s|
   s.licenses    = ['Apache-2.0', 'MIT']
   s.metadata = {
     'bug_tracker_uri' => 'https://github.com/maxmind/MaxMind-DB-Reader-ruby/issues',
-    'changelog_uri' => 'https://github.com/maxmind/MaxMind-DB-Reader-ruby/blob/master/CHANGELOG.md',
+    'changelog_uri' => 'https://github.com/maxmind/MaxMind-DB-Reader-ruby/blob/main/CHANGELOG.md',
     'documentation_uri' => 'https://www.rubydoc.info/gems/maxmind-db',
     'homepage_uri' => 'https://github.com/maxmind/MaxMind-DB-Reader-ruby',
     'source_code_uri' => 'https://github.com/maxmind/MaxMind-DB-Reader-ruby',
+    'rubygems_mfa_required' => 'true',
   }
-  s.required_ruby_version = '>= 2.4.0'
+  s.required_ruby_version = '>= 3.2'
 
   s.add_development_dependency 'minitest'
   s.add_development_dependency 'rake'
   s.add_development_dependency 'rubocop'
+  s.add_development_dependency 'rubocop-minitest'
   s.add_development_dependency 'rubocop-performance'
+  s.add_development_dependency 'rubocop-rake'
+  s.add_development_dependency 'rubocop-thread_safety'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: maxmind-db
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.4.0
 platform: ruby
 authors:
 - William Storey
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-23 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -52,6 +51,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-minitest
+  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: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
@@ -66,6 +79,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  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: rubocop-thread_safety
+  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'
 description: A gem for reading MaxMind DB files. MaxMind DB is a binary file format
   that stores data indexed by IP address subnets (IPv4 or IPv6).
 email: support@maxmind.com
@@ -75,6 +116,7 @@ extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - Gemfile
+- Gemfile.lock
 - LICENSE-APACHE
 - LICENSE-MIT
 - README.dev.md
@@ -88,81 +130,17 @@ files:
 - lib/maxmind/db/memory_reader.rb
 - lib/maxmind/db/metadata.rb
 - maxmind-db.gemspec
-- test/data/LICENSE
-- test/data/MaxMind-DB-spec.md
-- test/data/MaxMind-DB-test-metadata-pointers.mmdb
-- test/data/README.md
-- test/data/bad-data/README.md
-- test/data/bad-data/libmaxminddb/libmaxminddb-offset-integer-overflow.mmdb
-- test/data/bad-data/maxminddb-golang/cyclic-data-structure.mmdb
-- test/data/bad-data/maxminddb-golang/invalid-bytes-length.mmdb
-- test/data/bad-data/maxminddb-golang/invalid-data-record-offset.mmdb
-- test/data/bad-data/maxminddb-golang/invalid-map-key-length.mmdb
-- test/data/bad-data/maxminddb-golang/invalid-string-length.mmdb
-- test/data/bad-data/maxminddb-golang/metadata-is-an-uint128.mmdb
-- test/data/bad-data/maxminddb-golang/unexpected-bytes.mmdb
-- test/data/perltidyrc
-- test/data/source-data/GeoIP2-Anonymous-IP-Test.json
-- test/data/source-data/GeoIP2-City-Test.json
-- test/data/source-data/GeoIP2-Connection-Type-Test.json
-- test/data/source-data/GeoIP2-Country-Test.json
-- test/data/source-data/GeoIP2-DensityIncome-Test.json
-- test/data/source-data/GeoIP2-Domain-Test.json
-- test/data/source-data/GeoIP2-Enterprise-Test.json
-- test/data/source-data/GeoIP2-ISP-Test.json
-- test/data/source-data/GeoIP2-Precision-Enterprise-Test.json
-- test/data/source-data/GeoIP2-Static-IP-Score-Test.json
-- test/data/source-data/GeoIP2-User-Count-Test.json
-- test/data/source-data/GeoLite2-ASN-Test.json
-- test/data/source-data/README
-- test/data/test-data/GeoIP2-Anonymous-IP-Test.mmdb
-- test/data/test-data/GeoIP2-City-Test-Broken-Double-Format.mmdb
-- test/data/test-data/GeoIP2-City-Test-Invalid-Node-Count.mmdb
-- test/data/test-data/GeoIP2-City-Test.mmdb
-- test/data/test-data/GeoIP2-Connection-Type-Test.mmdb
-- test/data/test-data/GeoIP2-Country-Test.mmdb
-- test/data/test-data/GeoIP2-DensityIncome-Test.mmdb
-- test/data/test-data/GeoIP2-Domain-Test.mmdb
-- test/data/test-data/GeoIP2-Enterprise-Test.mmdb
-- test/data/test-data/GeoIP2-ISP-Test.mmdb
-- test/data/test-data/GeoIP2-Precision-Enterprise-Test.mmdb
-- test/data/test-data/GeoIP2-Static-IP-Score-Test.mmdb
-- test/data/test-data/GeoIP2-User-Count-Test.mmdb
-- test/data/test-data/GeoLite2-ASN-Test.mmdb
-- test/data/test-data/MaxMind-DB-no-ipv4-search-tree.mmdb
-- test/data/test-data/MaxMind-DB-string-value-entries.mmdb
-- test/data/test-data/MaxMind-DB-test-broken-pointers-24.mmdb
-- test/data/test-data/MaxMind-DB-test-broken-search-tree-24.mmdb
-- test/data/test-data/MaxMind-DB-test-decoder.mmdb
-- test/data/test-data/MaxMind-DB-test-ipv4-24.mmdb
-- test/data/test-data/MaxMind-DB-test-ipv4-28.mmdb
-- test/data/test-data/MaxMind-DB-test-ipv4-32.mmdb
-- test/data/test-data/MaxMind-DB-test-ipv6-24.mmdb
-- test/data/test-data/MaxMind-DB-test-ipv6-28.mmdb
-- test/data/test-data/MaxMind-DB-test-ipv6-32.mmdb
-- test/data/test-data/MaxMind-DB-test-metadata-pointers.mmdb
-- test/data/test-data/MaxMind-DB-test-mixed-24.mmdb
-- test/data/test-data/MaxMind-DB-test-mixed-28.mmdb
-- test/data/test-data/MaxMind-DB-test-mixed-32.mmdb
-- test/data/test-data/MaxMind-DB-test-nested.mmdb
-- test/data/test-data/README.md
-- test/data/test-data/maps-with-pointers.raw
-- test/data/test-data/write-test-data.pl
-- test/data/tidyall.ini
-- test/mmdb_util.rb
-- test/test_decoder.rb
-- test/test_reader.rb
 homepage: https://github.com/maxmind/MaxMind-DB-Reader-ruby
 licenses:
 - Apache-2.0
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/maxmind/MaxMind-DB-Reader-ruby/issues
-  changelog_uri: https://github.com/maxmind/MaxMind-DB-Reader-ruby/blob/master/CHANGELOG.md
+  changelog_uri: https://github.com/maxmind/MaxMind-DB-Reader-ruby/blob/main/CHANGELOG.md
   documentation_uri: https://www.rubydoc.info/gems/maxmind-db
   homepage_uri: https://github.com/maxmind/MaxMind-DB-Reader-ruby
   source_code_uri: https://github.com/maxmind/MaxMind-DB-Reader-ruby
-post_install_message: 
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -170,16 +148,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6.2
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A gem for reading MaxMind DB files.
 test_files: []

data/test/data/LICENSE

@@ -1,4 +0,0 @@
-This work is licensed under the Creative Commons Attribution-ShareAlike 3.0
-Unported License. To view a copy of this license, visit
-http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Creative
-Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA.