maxmind-geoip2 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d6ddb183c97df1041a902a1f2f98dec87e640b5907ae19b080bdd03c87bc03f
-  data.tar.gz: 8f0e58e55e605576bc4214e878c28aaab3bb6c0dbd065bb1281ac5f0db65e69e
+  metadata.gz: f26229b50b6ba4760df9389e76c5e705dc2b5b53e7fc50eb6be25d2af74f6985
+  data.tar.gz: bfcb0fef72edaf05cdfcb1cc55be5ce2d12afbc650912e062ae263649a279736
 SHA512:
-  metadata.gz: 2c6d5e20fd3bef3aacde30acb0c22695c8a903626747db02b58067adcaeafd9d2673f9be8189fad8d6a53869028ff15bf9536ce66a435a2da6e86fb4126cf06b
-  data.tar.gz: 8c79484d19313833856f91deabceed833f2dae00fb1cd4993d57b973b1747541cf83122e07043c1b4925a2f291172195ab024988be39501a922a751c7808cde1
+  metadata.gz: 4d3de90ee7df88d6acbef1af76202af2130e9670ad726bea5f9753581bd5e3ae962f859720458f833731f0822cc08345171ac90cde7b446c784ca7c6ca21215c
+  data.tar.gz: 34b7484739814ecd6de33435310c8cb29840534c4beed8d063c2ed00f2e0eee46338cec95bef1be5acb2ac2947be937842a2edc1f646b46460d70fa656213f6d

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # 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.0 of this gem.
+* A new `anonymizer` object has been added to the `MaxMind::GeoIP2::Model::Insights`
+  model. This object indicates whether the IP address is part of an anonymizing
+  network, including VPN confidence scoring, provider name detection, and network
+  last seen date. This is only available from the GeoIP2 Insights web service.
+* A new `ip_risk_snapshot` method has been added to `MaxMind::GeoIP2::Record::Traits`.
+  This field contains the risk associated with the IP address, ranging from 0.01 to
+  99 (a higher score indicates a higher risk). This is only available from the GeoIP2
+  Insights web service.
+* The `anonymous?`, `anonymous_vpn?`, `hosting_provider?`, `public_proxy?`,
+  `residential_proxy?`, and `tor_exit_node?` methods in
+  `MaxMind::GeoIP2::Record::Traits` have been deprecated. Please use the
+  corresponding methods in the `anonymizer` object from the GeoIP2 Insights
+  response instead.
+
+
 ## 1.3.0 (2025-05-06)
 
 * Support for the GeoIP Anonymous Plus database has been added. To do a

data/CLAUDE.md

@@ -0,0 +1,390 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+**GeoIP2-ruby** is MaxMind's official Ruby client library for:
+- **GeoIP2/GeoLite2 Web Services**: Country, City, and Insights endpoints
+- **GeoIP2/GeoLite2 Databases**: Local MMDB file reading for various database types (City, Country, ASN, Anonymous IP, Anonymous Plus, ISP, etc.)
+
+The library provides both web service clients and database readers that return strongly-typed model objects containing geographic, ISP, anonymizer, and other IP-related data.
+
+**Key Technologies:**
+- Ruby 3.2+ (uses frozen string literals and modern Ruby features)
+- MaxMind DB Reader for binary database files
+- HTTP gem for web service client functionality
+- Minitest for testing
+- RuboCop with multiple plugins for code quality
+
+## Code Architecture
+
+### Package Structure
+
+```
+lib/maxmind/geoip2/
+├── model/              # Response models (City, Insights, AnonymousIP, etc.)
+├── record/             # Data records (City, Location, Traits, etc.)
+├── client.rb           # HTTP client for MaxMind web services
+├── reader.rb           # Local MMDB file reader
+├── errors.rb           # Custom exceptions for error handling
+└── version.rb          # Version constant
+```
+
+### Key Design Patterns
+
+#### 1. **Attr Reader Pattern for Immutable Data**
+
+Models expose data through `attr_reader` attributes that are initialized in the constructor. Unlike PHP's readonly properties, Ruby uses instance variables with attr_reader:
+
+```ruby
+class City < Country
+  attr_reader :city
+  attr_reader :location
+  attr_reader :postal
+  attr_reader :subdivisions
+
+  def initialize(record, locales)
+    super
+    @city = MaxMind::GeoIP2::Record::City.new(record['city'], locales)
+    @location = MaxMind::GeoIP2::Record::Location.new(record['location'])
+    @postal = MaxMind::GeoIP2::Record::Postal.new(record['postal'])
+    @subdivisions = create_subdivisions(record['subdivisions'], locales)
+  end
+end
+```
+
+**Key Points:**
+- Instance variables are set in the constructor
+- Use `attr_reader` to expose them
+- Models and records are initialized from hash data (from JSON/DB)
+- Records are composed objects (City contains City record, Location record, etc.)
+
+#### 2. **Inheritance Hierarchies**
+
+Models follow clear inheritance patterns:
+- `Country` → base model with country/continent data
+- `City` extends `Country` → adds city, location, postal, subdivisions
+- `Insights` extends `City` → adds additional web service fields (web service only)
+- `Enterprise` extends `City` → adds enterprise-specific fields
+
+Records have similar patterns:
+- `Abstract` → base with `get` method for accessing hash data
+- `Place` extends `Abstract` → adds names/locales handling
+- Specific records (`City`, `Country`, etc.) extend `Place` or `Abstract`
+
+#### 3. **Get Method Pattern for Data Access**
+
+Both models and records use a protected `get` method to safely access hash data:
+
+```ruby
+def get(key)
+  if @record.nil? || !@record.key?(key)
+    return false if key.start_with?('is_')
+    return nil
+  end
+
+  @record[key]
+end
+```
+
+- Returns `false` for missing boolean fields (starting with `is_`)
+- Returns `nil` for missing optional fields
+- Records store the raw hash in `@record` instance variable
+
+Public methods expose data through the `get` method:
+
+```ruby
+def anonymizer_confidence
+  get('anonymizer_confidence')
+end
+
+def provider_name
+  get('provider_name')
+end
+```
+
+#### 4. **Lazy Parsing for Special Types**
+
+Some fields require parsing and are computed lazily:
+
+```ruby
+def network_last_seen
+  return @network_last_seen if defined?(@network_last_seen)
+
+  date_string = get('network_last_seen')
+
+  if !date_string
+    return nil
+  end
+
+  @network_last_seen = Date.parse(date_string)
+end
+```
+
+- Use `defined?(@variable)` to check if already parsed
+- Parse only once and cache in instance variable
+- Handle nil cases before parsing
+
+#### 5. **Web Service Only vs Database Models**
+
+Some models are only used by web services and do **not** need MaxMind DB support:
+
+**Web Service Only Models**:
+- Models that are exclusive to web service responses
+- Simpler implementation, just inherit and define in model hierarchy
+- Example: `Insights` (extends City but used only for web service)
+
+**Database-Supported Models**:
+- Models used by both web services and database files
+- Reader has specific methods (e.g., `anonymous_ip`, `anonymous_plus`, `city`)
+- Must handle MaxMind DB format data structures
+- Example: `City`, `Country`, `AnonymousIP`, `AnonymousPlus`
+
+## Testing Conventions
+
+### Running Tests
+
+```bash
+# Install dependencies
+bundle install
+
+# Run all tests
+bundle exec rake test
+
+# Run tests and RuboCop
+bundle exec rake  # default task
+
+# Run RuboCop only
+bundle exec rake rubocop
+
+# Run specific test file
+ruby -Ilib:test test/test_reader.rb
+```
+
+### Test Structure
+
+Tests are organized by functionality:
+- `test/test_reader.rb` - Database reader tests
+- `test/test_client.rb` - Web service client tests
+- `test/test_model_*.rb` - Model-specific tests
+- `test/data/` - Test fixtures and sample database files
+
+### Test Patterns
+
+Tests use Minitest with a constant for test data:
+
+```ruby
+class CountryModelTest < Minitest::Test
+  RAW = {
+    'continent' => {
+      'code' => 'NA',
+      'geoname_id' => 42,
+      'names' => { 'en' => 'North America' },
+    },
+    'country' => {
+      'geoname_id' => 1,
+      'iso_code' => 'US',
+      'names' => { 'en' => 'United States of America' },
+    },
+    'traits' => {
+      'ip_address' => '1.2.3.4',
+      'prefix_length' => 24,
+    },
+  }.freeze
+
+  def test_values
+    model = MaxMind::GeoIP2::Model::Country.new(RAW, ['en'])
+
+    assert_equal(42, model.continent.geoname_id)
+    assert_equal('NA', model.continent.code)
+    assert_equal('United States of America', model.country.name)
+  end
+end
+```
+
+When adding new fields to models:
+1. Update the `RAW` constant to include the new field
+2. Add assertions to verify the field is properly populated
+3. Test both presence and absence of the field (nil handling)
+4. Test with different values if applicable
+
+## Working with This Codebase
+
+### Adding New Fields to Existing Models
+
+For database models (like AnonymousPlus):
+
+1. **Add a public method** that calls `get`:
+   ```ruby
+   # A description of the field.
+   #
+   # @return [Type, nil]
+   def field_name
+     get('field_name')
+   end
+   ```
+
+2. **For fields requiring parsing** (dates, complex types), use lazy loading:
+   ```ruby
+   def network_last_seen
+     return @network_last_seen if defined?(@network_last_seen)
+
+     date_string = get('network_last_seen')
+
+     if !date_string
+       return nil
+     end
+
+     @network_last_seen = Date.parse(date_string)
+   end
+   ```
+
+For composed models (like City, Country):
+
+1. **Add `attr_reader`** for the new record/field:
+   ```ruby
+   attr_reader :new_field
+   ```
+
+2. **Initialize in constructor**:
+   ```ruby
+   def initialize(record, locales)
+     super
+     @new_field = record['new_field']
+   end
+   ```
+
+3. **Provide comprehensive YARD documentation** (`@return` tags)
+4. **Update tests** to include the new field in test data and assertions
+5. **Update CHANGELOG.md** with the change
+
+### Adding New Models
+
+When creating a new model class:
+
+1. **Determine if web service only or database-supported**
+2. **Follow the pattern** from existing similar models
+3. **Extend the appropriate base class** (e.g., `Country`, `City`, or standalone)
+4. **Use `attr_reader`** for composed record objects
+5. **Provide comprehensive YARD documentation** for all public methods
+6. **Add corresponding tests** with full coverage
+7. **If database-supported**, add a method to `Reader` class
+
+### Deprecation Guidelines
+
+When deprecating fields:
+
+1. **Use `@deprecated` in YARD doc** with version and alternative:
+   ```ruby
+   # This field is deprecated as of version 2.0.0.
+   # Use the anonymizer object from the Insights response instead.
+   #
+   # @return [Boolean]
+   # @deprecated since 2.0.0
+   def is_anonymous
+     get('is_anonymous')
+   end
+   ```
+
+2. **Keep deprecated fields functional** - don't break existing code
+3. **Update CHANGELOG.md** with deprecation notices
+4. **Document alternatives** in the deprecation message
+
+### CHANGELOG.md Format
+
+Always update `CHANGELOG.md` for user-facing changes.
+
+**Important**: Do not add a date to changelog entries until release time.
+
+- If there's an existing version entry without a date (e.g., `1.5.0`), add your changes there
+- If creating a new version entry, don't include a date - it will be added at release time
+- Use past tense for descriptions
+
+```markdown
+## 1.5.0
+
+* A new `field_name` method has been added to `MaxMind::GeoIP2::Model::ModelName`.
+  This method provides information about...
+* The `old_field` method in `MaxMind::GeoIP2::Model::ModelName` has been deprecated.
+  Please use `new_field` instead.
+```
+
+## Common Pitfalls and Solutions
+
+### Problem: Incorrect Nil Handling
+
+Using the wrong nil check can cause unexpected behavior.
+
+**Solution**: Follow these patterns:
+- Use `if !variable` or `if variable.nil?` to check for nil
+- The `get` method returns `nil` for missing keys (except `is_*` keys which return `false`)
+- Use `defined?(@variable)` to check if an instance variable has been set (for lazy loading)
+
+### Problem: Missing YARD Documentation
+
+New methods without documentation make the API harder to use.
+
+**Solution**: Always add YARD documentation:
+- Use `@return [Type, nil]` for the return type
+- Add a description of what the method returns
+- Use `@deprecated since X.Y.Z` for deprecated methods
+- Include examples in model class documentation if helpful
+
+### Problem: Test Failures After Adding Fields
+
+Tests fail because fixtures don't include new fields.
+
+**Solution**: Update all related tests:
+1. Add field to test `RAW` constant or test data hash
+2. Add assertions for the new field
+3. Test nil case if field is optional
+4. Test different data types if applicable
+
+## Code Style Requirements
+
+- **RuboCop enforced** with multiple plugins (minitest, performance, rake, thread_safety)
+- **Frozen string literals** (`# frozen_string_literal: true`) in all files
+- **Target Ruby 3.2+**
+- **No metrics cops** - AbcSize, ClassLength, MethodLength disabled
+- **Trailing commas allowed** in arrays, hashes, and arguments
+- **Use `if !condition`** instead of `unless condition` (NegatedIf disabled)
+
+Key RuboCop configurations:
+- Line length not enforced
+- Format string token checks disabled
+- Numeric predicates allowed in any style
+- Multiple assertions allowed in tests
+
+## Development Workflow
+
+### Setup
+```bash
+bundle install
+```
+
+### Before Committing
+```bash
+# Run tests and linting
+bundle exec rake
+
+# Or run separately
+bundle exec rake test
+bundle exec rake rubocop
+```
+
+### Running Single Test
+```bash
+ruby -Ilib:test test/test_reader.rb
+```
+
+### Version Requirements
+- **Ruby 3.2+** required
+- Target compatibility should match current supported Ruby versions (3.2-3.4)
+
+## Additional Resources
+
+- [API Documentation](https://www.rubydoc.info/gems/maxmind-geoip2)
+- [GeoIP2 Web Services Docs](https://dev.maxmind.com/geoip/docs/web-services)
+- [MaxMind DB Format](https://maxmind.github.io/MaxMind-DB/)
+- GitHub Issues: https://github.com/maxmind/GeoIP2-ruby/issues

data/Gemfile.lock

@@ -1,10 +1,10 @@
 PATH
   remote: .
   specs:
-    maxmind-geoip2 (1.3.0)
+    maxmind-geoip2 (1.4.0)
       connection_pool (~> 2.2)
       http (>= 4.3, < 6.0)
-      maxmind-db (~> 1.2)
+      maxmind-db (~> 1.4)
 
 GEM
   remote: https://rubygems.org/
@@ -12,10 +12,9 @@ GEM
     addressable (2.8.7)
       public_suffix (>= 2.0.2, < 7.0)
     ast (2.4.3)
-    base64 (0.2.0)
-    bigdecimal (3.1.9)
-    connection_pool (2.5.3)
-    crack (1.0.0)
+    bigdecimal (3.3.1)
+    connection_pool (2.5.4)
+    crack (1.0.1)
       bigdecimal
       rexml
     domain_name (0.6.20240107)
@@ -33,36 +32,35 @@ GEM
     ffi-compiler (1.3.2)
       ffi (>= 1.15.5)
       rake
-    hashdiff (1.1.2)
-    http (5.2.0)
+    hashdiff (1.2.1)
+    http (5.3.1)
       addressable (~> 2.8)
-      base64 (~> 0.1)
       http-cookie (~> 1.0)
       http-form_data (~> 2.2)
       llhttp-ffi (~> 0.5.0)
-    http-cookie (1.0.8)
+    http-cookie (1.1.0)
       domain_name (~> 0.5)
     http-form_data (2.3.0)
-    json (2.11.3)
-    language_server-protocol (3.17.0.4)
+    json (2.16.0)
+    language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     llhttp-ffi (0.5.1)
       ffi-compiler (~> 1.0)
       rake (~> 13.0)
-    maxmind-db (1.3.2)
-    minitest (5.25.5)
+    maxmind-db (1.4.0)
+    minitest (5.26.2)
     parallel (1.27.0)
-    parser (3.3.8.0)
+    parser (3.3.10.0)
       ast (~> 2.4.1)
       racc
-    prism (1.4.0)
+    prism (1.6.0)
     public_suffix (6.0.2)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.2.1)
-    regexp_parser (2.10.0)
-    rexml (3.4.1)
-    rubocop (1.75.5)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    rexml (3.4.4)
+    rubocop (1.81.7)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -70,21 +68,32 @@ GEM
       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)
+      rubocop-ast (>= 1.47.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.44.1)
+    rubocop-ast (1.48.0)
       parser (>= 3.3.7.2)
       prism (~> 1.4)
-    rubocop-performance (1.25.0)
+    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.1.4)
-      unicode-emoji (~> 4.0, >= 4.0.4)
-    unicode-emoji (4.0.4)
-    webmock (3.25.1)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
+    webmock (3.26.1)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
@@ -107,8 +116,11 @@ DEPENDENCIES
   minitest
   rake
   rubocop
+  rubocop-minitest
   rubocop-performance
+  rubocop-rake
+  rubocop-thread_safety
   webmock
 
 BUNDLED WITH
-   2.6.7
+   2.6.9

data/README.md

@@ -347,7 +347,7 @@ client API, please see [our support page](https://www.maxmind.com/en/support).
 
 ## Requirements
 
-This code requires Ruby version 3.0 or higher.
+This code requires Ruby version 3.2 or higher.
 
 ## Contributing
 

data/Rakefile

@@ -11,5 +11,4 @@ end
 RuboCop::RakeTask.new
 
 desc 'Run tests and RuboCop'
-task default: :test
-task default: :rubocop
+task default: %i[test rubocop]

data/lib/maxmind/geoip2/model/insights.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'maxmind/geoip2/model/city'
+require 'maxmind/geoip2/record/anonymizer'
 
 module MaxMind
   module GeoIP2
@@ -10,6 +11,19 @@ module MaxMind
       # See https://dev.maxmind.com/geoip/docs/web-services?lang=en for more
       # details.
       class Insights < City
+        # Data indicating whether the IP address is part of an anonymizing
+        # network.
+        #
+        # @return [MaxMind::GeoIP2::Record::Anonymizer]
+        attr_reader :anonymizer
+
+        # @!visibility private
+        def initialize(record, locales)
+          super
+          @anonymizer = MaxMind::GeoIP2::Record::Anonymizer.new(
+            record['anonymizer'],
+          )
+        end
       end
     end
   end

data/lib/maxmind/geoip2/record/anonymizer.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+require 'date'
+require 'maxmind/geoip2/record/abstract'
+
+module MaxMind
+  module GeoIP2
+    module Record
+      # Contains data indicating whether an IP address is part of an
+      # anonymizing network.
+      #
+      # This record is returned by the Insights web service.
+      class Anonymizer < Abstract
+        # A score ranging from 1 to 99 that represents our percent confidence
+        # that the network is currently part of an actively used VPN service.
+        # This property is only available from Insights.
+        #
+        # @return [Integer, nil]
+        def confidence
+          get('confidence')
+        end
+
+        # This is true if the IP address belongs to any sort of anonymous
+        # network. This property is only available from Insights.
+        #
+        # @return [Boolean]
+        def anonymous?
+          get('is_anonymous')
+        end
+
+        # This is true if the IP address is registered to an anonymous VPN
+        # provider. If a VPN provider does not register subnets under names
+        # associated with them, we will likely only flag their IP ranges using
+        # the hosting_provider? property. This property is only available from
+        # Insights.
+        #
+        # @return [Boolean]
+        def anonymous_vpn?
+          get('is_anonymous_vpn')
+        end
+
+        # This is true if the IP address belongs to a hosting or VPN provider
+        # (see description of the anonymous_vpn? property). This property is
+        # only available from Insights.
+        #
+        # @return [Boolean]
+        def hosting_provider?
+          get('is_hosting_provider')
+        end
+
+        # This is true if the IP address belongs to a public proxy. This
+        # property is only available from Insights.
+        #
+        # @return [Boolean]
+        def public_proxy?
+          get('is_public_proxy')
+        end
+
+        # This is true if the IP address is on a suspected anonymizing network
+        # and belongs to a residential ISP. This property is only available from
+        # Insights.
+        #
+        # @return [Boolean]
+        def residential_proxy?
+          get('is_residential_proxy')
+        end
+
+        # This is true if the IP address is a Tor exit node. This property is
+        # only available from Insights.
+        #
+        # @return [Boolean]
+        def tor_exit_node?
+          get('is_tor_exit_node')
+        end
+
+        # The last day that the network was sighted in our analysis of
+        # anonymized networks. This value is parsed lazily. This property is
+        # only available from Insights.
+        #
+        # @return [Date, nil] A Date object representing the last seen date,
+        #   or nil if the date is not available.
+        def network_last_seen
+          return @network_last_seen if defined?(@network_last_seen)
+
+          date_string = get('network_last_seen')
+
+          if !date_string
+            return nil
+          end
+
+          @network_last_seen = Date.parse(date_string)
+        end
+
+        # The name of the VPN provider (e.g., NordVPN, SurfShark, etc.)
+        # associated with the network. This property is only available from
+        # Insights.
+        #
+        # @return [String, nil]
+        def provider_name
+          get('provider_name')
+        end
+      end
+    end
+  end
+end

data/lib/maxmind/geoip2/record/traits.rb

@@ -76,7 +76,11 @@ module MaxMind
         # This is true if the IP address belongs to any sort of anonymous network.
         # This property is only available from Insights.
         #
+        # This method is deprecated as of version 1.4.0. Use the anonymizer object
+        # from the Insights response instead.
+        #
         # @return [Boolean]
+        # @deprecated since 1.4.0
         def anonymous?
           get('is_anonymous')
         end
@@ -86,7 +90,11 @@ module MaxMind
         # associated with them, we will likely only flag their IP ranges using the
         # hosting_provider? property. This property is only available from Insights.
         #
+        # This method is deprecated as of version 1.4.0. Use the anonymizer object
+        # from the Insights response instead.
+        #
         # @return [Boolean]
+        # @deprecated since 1.4.0
         def anonymous_vpn?
           get('is_anonymous_vpn')
         end
@@ -107,7 +115,11 @@ module MaxMind
         # description of the anonymous_vpn? property). This property is only
         # available from Insights.
         #
+        # This method is deprecated as of version 1.4.0. Use the anonymizer object
+        # from the Insights response instead.
+        #
         # @return [Boolean]
+        # @deprecated since 1.4.0
         def hosting_provider?
           get('is_hosting_provider')
         end
@@ -146,7 +158,11 @@ module MaxMind
         # This is true if the IP address belongs to a public proxy. This property
         # is only available from Insights.
         #
+        # This method is deprecated as of version 1.4.0. Use the anonymizer object
+        # from the Insights response instead.
+        #
         # @return [Boolean]
+        # @deprecated since 1.4.0
         def public_proxy?
           get('is_public_proxy')
         end
@@ -155,7 +171,11 @@ module MaxMind
         # and belongs to a residential ISP. This property is only available
         # from Insights.
         #
+        # This method is deprecated as of version 1.4.0. Use the anonymizer object
+        # from the Insights response instead.
+        #
         # @return [Boolean]
+        # @deprecated since 1.4.0
         def residential_proxy?
           get('is_residential_proxy')
         end
@@ -163,7 +183,11 @@ module MaxMind
         # This is true if the IP address is a Tor exit node. This property is only
         # available from Insights.
         #
+        # This method is deprecated as of version 1.4.0. Use the anonymizer object
+        # from the Insights response instead.
+        #
         # @return [Boolean]
+        # @deprecated since 1.4.0
         def tor_exit_node?
           get('is_tor_exit_node')
         end
@@ -212,6 +236,19 @@ module MaxMind
           get('user_count')
         end
 
+        # This field contains the risk associated with the IP address. The value
+        # ranges from 0.01 to 99. A higher score indicates a higher risk.
+        # Please note that the IP risk score provided in GeoIP products and
+        # services is more static than the IP risk score provided in minFraud
+        # and is not responsive to traffic on your network. If you need realtime
+        # IP risk scoring based on behavioral signals on your own network, please
+        # use minFraud. This property is only available from Insights.
+        #
+        # @return [Float, nil]
+        def ip_risk_snapshot
+          get('ip_risk_snapshot')
+        end
+
         # The user type associated with the IP address. This can be one of the
         # following values:
         #

data/lib/maxmind/geoip2/version.rb

@@ -3,6 +3,6 @@
 module MaxMind
   module GeoIP2
     # The Gem version.
-    VERSION = '1.3.0'
+    VERSION = '1.4.0'
   end
 end

data/maxmind-geoip2.gemspec

@@ -24,15 +24,18 @@ Gem::Specification.new do |s|
     'rubygems_mfa_required' => 'true',
     'source_code_uri' => 'https://github.com/maxmind/GeoIP2-ruby',
   }
-  s.required_ruby_version = '>= 3.0'
+  s.required_ruby_version = '>= 3.2'
 
   s.add_dependency 'connection_pool', ['~> 2.2']
   s.add_dependency 'http', '>= 4.3', '< 6.0'
-  s.add_dependency 'maxmind-db', ['~> 1.2']
+  s.add_dependency 'maxmind-db', ['~> 1.4']
 
   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'
   s.add_development_dependency 'webmock'
 end

data/test/test_client.rb

@@ -28,6 +28,17 @@ class ClientTest < Minitest::Test
   }.freeze
 
   INSIGHTS = {
+    'anonymizer' => {
+      'confidence' => 85,
+      'is_anonymous' => true,
+      'is_anonymous_vpn' => true,
+      'is_hosting_provider' => false,
+      'is_public_proxy' => false,
+      'is_residential_proxy' => true,
+      'is_tor_exit_node' => false,
+      'network_last_seen' => '2025-10-15',
+      'provider_name' => 'NordVPN',
+    },
     'continent' => {
       'code' => 'NA',
       'geoname_id' => 42,
@@ -43,6 +54,7 @@ class ClientTest < Minitest::Test
     },
     'traits' => {
       'ip_address' => '1.2.3.40',
+      'ip_risk_snapshot' => 45.5,
       'is_anycast' => true,
       'is_residential_proxy' => true,
       'network' => '1.2.3.0/24',
@@ -66,16 +78,16 @@ class ClientTest < Minitest::Test
     assert_equal('North America', record.continent.name)
 
     assert_equal(1, record.country.geoname_id)
-    assert_equal(false, record.country.in_european_union?)
+    refute(record.country.in_european_union?)
     assert_equal('US', record.country.iso_code)
     assert_equal({ 'en' => 'United States of America' }, record.country.names)
     assert_equal('United States of America', record.country.name)
 
     assert_equal(11, record.maxmind.queries_remaining)
 
-    assert_equal(false, record.registered_country.in_european_union?)
+    refute(record.registered_country.in_european_union?)
 
-    assert_equal(true, record.traits.anycast?)
+    assert(record.traits.anycast?)
     assert_equal('1.2.3.0/24', record.traits.network)
   end
 
@@ -86,11 +98,24 @@ class ClientTest < Minitest::Test
 
     assert_equal(42, record.continent.geoname_id)
 
-    assert_equal(true, record.traits.anycast?)
-    assert_equal(true, record.traits.residential_proxy?)
+    # Test anonymizer object
+    assert_equal(85, record.anonymizer.confidence)
+    assert(record.anonymizer.anonymous?)
+    assert(record.anonymizer.anonymous_vpn?)
+    refute(record.anonymizer.hosting_provider?)
+    refute(record.anonymizer.public_proxy?)
+    assert(record.anonymizer.residential_proxy?)
+    refute(record.anonymizer.tor_exit_node?)
+    assert_equal(Date.parse('2025-10-15'), record.anonymizer.network_last_seen)
+    assert_equal('NordVPN', record.anonymizer.provider_name)
+
+    # Test traits
+    assert(record.traits.anycast?)
+    assert(record.traits.residential_proxy?)
     assert_equal('1.2.3.0/24', record.traits.network)
-    assert_equal(1.3, record.traits.static_ip_score)
+    assert_in_delta(1.3, record.traits.static_ip_score)
     assert_equal(2, record.traits.user_count)
+    assert_in_delta(45.5, record.traits.ip_risk_snapshot)
   end
 
   def test_city

data/test/test_model_country.rb

@@ -29,20 +29,18 @@ class CountryModelTest < Minitest::Test
 
   def test_objects
     model = MaxMind::GeoIP2::Model::Country.new(RAW, ['en'])
-    assert_equal(MaxMind::GeoIP2::Model::Country, model.class)
-    assert_equal(MaxMind::GeoIP2::Record::Continent, model.continent.class)
-    assert_equal(MaxMind::GeoIP2::Record::Country, model.country.class)
-    assert_equal(
-      MaxMind::GeoIP2::Record::Country,
-      model.registered_country.class,
+
+    assert_instance_of(MaxMind::GeoIP2::Model::Country, model)
+    assert_instance_of(MaxMind::GeoIP2::Record::Continent, model.continent)
+    assert_instance_of(MaxMind::GeoIP2::Record::Country, model.country)
+    assert_instance_of(
+      MaxMind::GeoIP2::Record::Country, model.registered_country,
     )
-    assert_equal(
-      MaxMind::GeoIP2::Record::RepresentedCountry,
-      model.represented_country.class,
+    assert_instance_of(
+      MaxMind::GeoIP2::Record::RepresentedCountry, model.represented_country,
     )
-    assert_equal(
-      MaxMind::GeoIP2::Record::Traits,
-      model.traits.class,
+    assert_instance_of(
+      MaxMind::GeoIP2::Record::Traits, model.traits,
     )
   end
 
@@ -55,14 +53,14 @@ class CountryModelTest < Minitest::Test
     assert_equal('North America', model.continent.name)
 
     assert_equal(1, model.country.geoname_id)
-    assert_equal(false, model.country.in_european_union?)
+    refute(model.country.in_european_union?)
     assert_equal('US', model.country.iso_code)
     assert_equal({ 'en' => 'United States of America' }, model.country.names)
     assert_equal('United States of America', model.country.name)
     assert_nil(model.country.confidence)
 
     assert_equal(2, model.registered_country.geoname_id)
-    assert_equal(true, model.registered_country.in_european_union?)
+    assert(model.registered_country.in_european_union?)
     assert_equal('DE', model.registered_country.iso_code)
     assert_equal({ 'en' => 'Germany' }, model.registered_country.names)
     assert_equal('Germany', model.registered_country.name)
@@ -91,6 +89,7 @@ class CountryModelTest < Minitest::Test
       },
       ['en'],
     )
+
     assert_equal(42, model.continent.geoname_id)
   end
 end

data/test/test_model_names.rb

@@ -29,18 +29,21 @@ class ModelNameTest < Minitest::Test
 
   def test_fallback
     model = MaxMind::GeoIP2::Model::Country.new(RAW, %w[ru zh-CN en])
+
     assert_equal('北美洲', model.continent.name)
     assert_equal('объединяет государства', model.country.name)
   end
 
   def test_two_fallbacks
     model = MaxMind::GeoIP2::Model::Country.new(RAW, %w[ru jp])
+
     assert_nil(model.continent.name)
     assert_equal('объединяет государства', model.country.name)
   end
 
   def test_no_fallbacks
     model = MaxMind::GeoIP2::Model::Country.new(RAW, %w[jp])
+
     assert_nil(model.continent.name)
     assert_nil(model.country.name)
   end

data/test/test_reader.rb

@@ -13,12 +13,12 @@ class ReaderTest < Minitest::Test
     ip = '1.2.0.1'
     record = reader.anonymous_ip(ip)
 
-    assert_equal(true, record.anonymous?)
-    assert_equal(true, record.anonymous_vpn?)
-    assert_equal(false, record.hosting_provider?)
-    assert_equal(false, record.public_proxy?)
-    assert_equal(false, record.residential_proxy?)
-    assert_equal(false, record.tor_exit_node?)
+    assert(record.anonymous?)
+    assert(record.anonymous_vpn?)
+    refute(record.hosting_provider?)
+    refute(record.public_proxy?)
+    refute(record.residential_proxy?)
+    refute(record.tor_exit_node?)
     assert_equal(ip, record.ip_address)
     assert_equal('1.2.0.0/16', record.network)
 
@@ -32,7 +32,7 @@ class ReaderTest < Minitest::Test
     ip = '81.2.69.1'
     record = reader.anonymous_ip(ip)
 
-    assert_equal(true, record.residential_proxy?)
+    assert(record.residential_proxy?)
 
     reader.close
   end
@@ -45,14 +45,14 @@ class ReaderTest < Minitest::Test
     record = reader.anonymous_plus(ip)
 
     assert_equal(30, record.anonymizer_confidence)
-    assert_equal(true, record.anonymous?)
-    assert_equal(true, record.anonymous_vpn?)
-    assert_equal(false, record.hosting_provider?)
+    assert(record.anonymous?)
+    assert(record.anonymous_vpn?)
+    refute(record.hosting_provider?)
     assert_equal(Date.new(2025, 4, 14), record.network_last_seen)
     assert_equal('foo', record.provider_name)
-    assert_equal(false, record.public_proxy?)
-    assert_equal(false, record.residential_proxy?)
-    assert_equal(false, record.tor_exit_node?)
+    refute(record.public_proxy?)
+    refute(record.residential_proxy?)
+    refute(record.tor_exit_node?)
 
     assert_equal(ip, record.ip_address)
     assert_equal('1.2.0.1/32', record.network)
@@ -89,8 +89,8 @@ class ReaderTest < Minitest::Test
     assert_nil(record.city.confidence)
 
     assert_equal(100, record.location.accuracy_radius)
-    assert_equal(51.75, record.location.latitude)
-    assert_equal(-1.25, record.location.longitude)
+    assert_in_delta(51.75, record.location.latitude)
+    assert_in_delta(-1.25, record.location.longitude)
     assert_equal('Europe/London', record.location.time_zone)
 
     assert_equal(2, record.subdivisions.size)
@@ -117,14 +117,16 @@ class ReaderTest < Minitest::Test
         'zh-CN' => '华盛顿州',
       },
       record.subdivisions[0].names,
-      assert_equal('WA', record.most_specific_subdivision.iso_code)
     )
 
+    assert_equal('WA', record.most_specific_subdivision.iso_code)
+
     # This IP has is_anycast.
 
     ip_address = '214.1.1.0'
     record = reader.city(ip_address)
-    assert_equal(true, record.traits.anycast?)
+
+    assert(record.traits.anycast?)
 
     reader.close
   end
@@ -135,7 +137,7 @@ class ReaderTest < Minitest::Test
     )
     record = reader.city('2001:218::')
 
-    assert_equal([], record.subdivisions)
+    assert_empty(record.subdivisions)
     assert_nil(record.most_specific_subdivision)
 
     reader.close
@@ -179,7 +181,7 @@ class ReaderTest < Minitest::Test
     assert_equal('Europe', record.continent.name)
 
     assert_equal(2_635_167, record.country.geoname_id)
-    assert_equal(false, record.country.in_european_union?)
+    refute(record.country.in_european_union?)
     assert_equal('GB', record.country.iso_code)
     assert_equal(
       {
@@ -197,7 +199,7 @@ class ReaderTest < Minitest::Test
     assert_equal('United Kingdom', record.country.name)
 
     assert_equal(3_017_382, record.registered_country.geoname_id)
-    assert_equal(true, record.registered_country.in_european_union?)
+    assert(record.registered_country.in_european_union?)
     assert_equal('FR', record.registered_country.iso_code)
     assert_equal(
       {
@@ -235,6 +237,7 @@ class ReaderTest < Minitest::Test
     assert_equal('military', record.represented_country.type)
 
     record = reader.country('81.2.69.163')
+
     assert_equal('81.2.69.163', record.traits.ip_address)
     assert_equal('81.2.69.160/27', record.traits.network)
 
@@ -242,7 +245,8 @@ class ReaderTest < Minitest::Test
 
     ip_address = '214.1.1.0'
     record = reader.country(ip_address)
-    assert_equal(true, record.traits.anycast?)
+
+    assert(record.traits.anycast?)
 
     assert_raises(NoMethodError) { record.foo }
     reader.close
@@ -253,7 +257,8 @@ class ReaderTest < Minitest::Test
       'test/data/test-data/GeoIP2-Country-Test.mmdb',
     )
     record = reader.country('74.209.24.0')
-    assert_equal(false, record.country.in_european_union?)
+
+    refute(record.country.in_european_union?)
 
     reader.close
   end
@@ -289,14 +294,14 @@ class ReaderTest < Minitest::Test
     assert_equal(11, record.city.confidence)
     assert_equal(99, record.country.confidence)
     assert_equal(6_252_001, record.country.geoname_id)
-    assert_equal(false, record.country.in_european_union?)
+    refute(record.country.in_european_union?)
 
     assert_equal(27, record.location.accuracy_radius)
 
-    assert_equal(false, record.registered_country.in_european_union?)
+    refute(record.registered_country.in_european_union?)
 
     assert_equal('Cable/DSL', record.traits.connection_type)
-    assert_equal(true, record.traits.legitimate_proxy?)
+    assert(record.traits.legitimate_proxy?)
 
     assert_equal(ip_address, record.traits.ip_address)
     assert_equal('74.209.16.0/20', record.traits.network)
@@ -313,7 +318,8 @@ class ReaderTest < Minitest::Test
 
     ip_address = '214.1.1.0'
     record = reader.enterprise(ip_address)
-    assert_equal(true, record.traits.anycast?)
+
+    assert(record.traits.anycast?)
 
     reader.close
   end
@@ -352,7 +358,7 @@ class ReaderTest < Minitest::Test
     assert_equal('2.125.160.216', record.traits.ip_address)
     assert_equal('2.125.160.216/29', record.traits.network)
     assert_nil(record.traits.autonomous_system_number)
-    assert_equal(false, record.traits.anonymous?)
+    refute(record.traits.anonymous?)
 
     reader.close
   end
@@ -438,6 +444,7 @@ class ReaderTest < Minitest::Test
         "test/data/test-data/GeoIP2-#{t['file']}-Test.mmdb",
       )
       record = reader.send(t['method'], '81.2.69.160')
+
       assert_equal('United Kingdom', record.country.name)
       reader.close
     end
@@ -450,6 +457,7 @@ class ReaderTest < Minitest::Test
         %w[xx ru pt-BR es en],
       )
       record = reader.send(t['method'], '81.2.69.160')
+
       assert_equal('Великобритания', record.country.name)
       reader.close
     end
@@ -461,6 +469,7 @@ class ReaderTest < Minitest::Test
         "test/data/test-data/GeoIP2-#{t['file']}-Test.mmdb",
       )
       record = reader.send(t['method'], '81.2.69.163')
+
       assert_equal('81.2.69.163', record.traits.ip_address)
       assert_equal('81.2.69.160/27', record.traits.network)
       reader.close
@@ -473,8 +482,9 @@ class ReaderTest < Minitest::Test
         "test/data/test-data/GeoIP2-#{t['file']}-Test.mmdb",
       )
       record = reader.send(t['method'], '81.2.69.160')
-      assert_equal(false, record.country.in_european_union?)
-      assert_equal(false, record.registered_country.in_european_union?)
+
+      refute(record.country.in_european_union?)
+      refute(record.registered_country.in_european_union?)
       reader.close
     end
   end
@@ -524,6 +534,7 @@ class ReaderTest < Minitest::Test
     reader = MaxMind::GeoIP2::Reader.new(
       'test/data/test-data/GeoIP2-City-Test.mmdb',
     )
+
     assert_equal('GeoIP2-City', reader.metadata.database_type)
     reader.close
   end
@@ -533,6 +544,7 @@ class ReaderTest < Minitest::Test
       database: 'test/data/test-data/GeoIP2-Country-Test.mmdb',
     )
     record = reader.country('81.2.69.160')
+
     assert_equal('United Kingdom', record.country.name)
     reader.close
   end
@@ -544,6 +556,7 @@ class ReaderTest < Minitest::Test
       mode: MaxMind::DB::MODE_MEMORY,
     )
     record = reader.country('81.2.69.160')
+
     assert_equal('Великобритания', record.country.name)
     reader.close
   end
@@ -569,6 +582,7 @@ class ReaderTest < Minitest::Test
       mode: MaxMind::DB::MODE_MEMORY,
     )
     record = reader.country('81.2.69.160')
+
     assert_equal('Великобритания', record.country.name)
     reader.close
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: maxmind-geoip2
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - William Storey
@@ -49,14 +49,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.4'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -99,6 +99,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
@@ -113,6 +127,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'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
@@ -135,6 +177,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
+- CLAUDE.md
 - Gemfile
 - Gemfile.lock
 - LICENSE-APACHE
@@ -158,6 +201,7 @@ files:
 - lib/maxmind/geoip2/model/isp.rb
 - lib/maxmind/geoip2/reader.rb
 - lib/maxmind/geoip2/record/abstract.rb
+- lib/maxmind/geoip2/record/anonymizer.rb
 - lib/maxmind/geoip2/record/city.rb
 - lib/maxmind/geoip2/record/continent.rb
 - lib/maxmind/geoip2/record/country.rb
@@ -270,14 +314,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A gem for interacting with the GeoIP2 webservices and databases.
 test_files: []