maxmind-db 1.1.1 → 1.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 485d10049eaba35df9d49f7aa4637857a3fe84f38dec3e2a163c675fc8f2e474
-  data.tar.gz: 964008df8d8bc5bc8c558fb004cbb7eda6843295cb3abd5fea3fc193da58981d
+  metadata.gz: 9b642dbfca79a5abf8c5c5ab4a2ceb07051affb7148dd005514d0bc1a9950c3b
+  data.tar.gz: 6cb14299dec849aef6f054ca39cbf139d3e552ed593960ebfbd72a09a6ce5f27
 SHA512:
-  metadata.gz: 92181b893b438f63a874d915817f4e325aa4a20fb12e8e373e6d6f4885235472353391db4508f313f7d4b5b9ab33e6f09cd05a5b88e718b59dc352dc18f415be
-  data.tar.gz: a03201ffac72cac0228545ce2f1a3a5e3d84ad807d33fac18bfffd3da4a5be69d0bceee96c5c87429b394410ed3e3efc17f20893700b7811558c7a383d4773e4
+  metadata.gz: 232d60717fed7da9d7253edc041316eec8f71782b9fca2e72cdbd5ad5414e7253504d423b3bab105cd87c5fd1c62e6df2fe7b8a2d70ea19f97a5fc5fc493a572
+  data.tar.gz: c40ce6eec502c4f2f45d8b5036b179b9f498e680771571430228845f0a588a564e3a4adf66193f56440bb8c21940793cba5ee073f3eb444dbe9f303db9f6fe21

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 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,58 @@
+PATH
+  remote: .
+  specs:
+    maxmind-db (1.3.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    json (2.10.2)
+    language_server-protocol (3.17.0.4)
+    lint_roller (1.1.0)
+    minitest (5.25.5)
+    parallel (1.26.3)
+    parser (3.3.7.4)
+      ast (~> 2.4.1)
+      racc
+    prism (1.4.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.2.1)
+    regexp_parser (2.10.0)
+    rubocop (1.75.2)
+      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.44.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.44.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.25.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  maxmind-db!
+  minitest
+  rake
+  rubocop
+  rubocop-performance
+
+BUNDLED WITH
+   2.6.2

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.0 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 - 2024 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'
 

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/**/*'])
   s.name        = 'maxmind-db'
   s.summary     = 'A gem for reading MaxMind DB files.'
-  s.version     = '1.1.1'
+  s.version     = '1.3.2'
 
   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,12 +13,13 @@ 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.0'
 
   s.add_development_dependency 'minitest'
   s.add_development_dependency 'rake'

data/test/data/MaxMind-DB-spec.md

@@ -26,9 +26,10 @@ not be broken by minor version changes to the format.
 The binary database is split into three parts:
 
 1. The binary search tree. Each level of the tree corresponds to a single bit
-in the 128 bit representation of an IPv6 address.
-2. The data section. These are the values returned to the client for a
-specific IP address, e.g. "US", "New York", or a more complex map type made up
+in the prefix of the network the IP address belongs to.
+2. The data section with the values for the networks in the binary search
+tree. These values may be comprised of a single data type, e.g., the string
+"US" or "New York", or they may be a more complex map or array type made up
 of multiple fields.
 3. Database metadata. Information about the database itself.
 
@@ -48,15 +49,15 @@ of this sequence.
 The maximum allowable size for the metadata section, including the marker that
 starts the metadata, is 128KiB.
 
-The metadata is stored as a map data structure. This structure is described
-later in the spec. Changing a key's data type or removing a key would
-constitute a major version change for this spec.
+The metadata is stored as a separate data section comprised of a map data
+structure starting at the beginning of that section. This structure is
+described later in the spec.
 
 Except where otherwise specified, each key listed is required for the database
 to be considered valid.
 
-Adding a key constitutes a minor version change. Removing a key or changing
-its type constitutes a major version change.
+Changing a key's data type or removing a key would constitute a major version
+change for this spec. Adding a key constitutes a minor version change.
 
 The list of known keys for the current version of the format is as follows:
 
@@ -304,7 +305,8 @@ will point to the beginning of a field. It is illegal for a pointer to point
 to another pointer.
 
 Pointer values start from the beginning of the data section, *not* the
-beginning of the file.
+beginning of the file. Pointers in the metadata start from the beginning of
+the metadata section.
 
 ### UTF-8 string - 2
 
@@ -337,8 +339,10 @@ by the length specifier in the control byte. See below for details.
 
 A length of zero always indicates the number 0.
 
-When storing a signed integer, the left-most bit is the sign. A 1 is negative
-and a 0 is positive.
+When storing a signed integer, fields shorter than the maximum byte length
+are always positive. When the field is the maximum length, e.g., 4 bytes for
+32-bit integers, the left-most bit is the sign. A 1 is negative and a 0 is
+positive.
 
 The type numbers for our integer types are:
 

data/test/data/source-data/GeoIP2-Anonymous-IP-Test.json

@@ -18,6 +18,7 @@
          "is_anonymous_vpn" : true,
          "is_hosting_provider" : true,
          "is_public_proxy" : true,
+         "is_residential_proxy" : true,
          "is_tor_exit_node" : true
       }
    },