maxmind-geoip2 0.5.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f724b0db8ed7f0700617ba0d37cb08e0b1b10a4ed04d2a59bd8538451d503ffb
-  data.tar.gz: 172ce815ec47fc1ea64350c9ae5a14880c77a11f429e5a3a7e2bda649903b634
+  metadata.gz: 2bdd199c61f9c7116b023d420f1fb0763d05abd7711dd7be0f177113028140ff
+  data.tar.gz: 00a081df1adc640dff12ef5fb8670ac9714b9edd1ef3fa65049033a1fa9d385b
 SHA512:
-  metadata.gz: ac670d5d555b89fd01fbc638ba32f25cb884c6d138ff60154661bcd75197a2f583f243a5431ae19d137752a4077d4ff160c0132c293428d9764e55c3aeee2b4b
-  data.tar.gz: add54d450ec8f3d5440fb329bc6cd0299b70eb204fdf8b9d2fdec5338a487efe11f917a5630e5a7b02de498078015746deaa13a835823621c70699d44d5b0321
+  metadata.gz: 85a980183be16fa99909d42db32d295ff68a8c718cb31384aef78db8fb287a970d148d12c112fbb9c3cde0a84d396a438a9faf7c196b3e2bfadce93695ebf8e4
+  data.tar.gz: 3ef1e40dd82bbf1acf3ddb14b1d774c246c78219463a00b87bfa46c14af7b623ccdfb9af5046c3a1d0b0b8b18fbe4f575d88d28d9930f3b10913c0035326a611

data/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 1.1.0 (2021-11-18)
+
+* Exceptions from this gem now inherit from `MaxMind::GeoIP2::Error`. IP
+  address related exceptions now inherit from
+  `MaxMind::GeoIP2::AddressError`, which itself inherits from
+  `MaxMind::GeoIP2::Error`. Pull Request by gr8bit. GitHub #35.
+* Support for mobile country code (MCC) and mobile network codes (MNC) was
+  added for the GeoIP2 ISP and Enterprise databases as well as the GeoIP2
+  City and Insights web services. `mobile_country_code` and
+  `mobile_network_code` attributes were added to
+  `MaxMind::GeoIP2::Model::ISP` for the GeoIP2 ISP database and
+  `MaxMind::GeoIP2::Record::Traits` for the Enterprise database and the
+  GeoIP2 City and Insights web services. We expect this data to be
+  available by late January, 2022.
+
+## 1.0.0 (2021-05-14)
+
+* Ruby 2.4 is no longer supported. If you're using Ruby 2.4, please use
+  version 0.7.0 of this gem.
+* Expand accepted versions of the `http` gem to include 5.0+.
+* Bump version to 1.0.0 since we have been at 0.x for over a year. There is
+  no breaking change.
+
+## 0.7.0 (2021-03-24)
+
+* Ensured defaults are set when creating a `MaxMind::GeoIP2::Client` in the
+  case when args are explicitly passed in as `nil`. Pull Request by Manoj
+  Dayaram. GitHub #31.
+
+## 0.6.0 (2021-03-23)
+
+* Updated the `MaxMind::GeoIP2::Reader` constructor to support being called
+  using keyword arguments. For example, you may now create a `Reader` using
+  `MaxMind::GeoIP2::Reader.new(database: 'GeoIP2-Country.mmdb')` instead of
+  using positional arguments. This is intended to make it easier to pass in
+  optional arguments. Positional argument calling is still supported.
+* Proxy support was fixed. Pull request by Manoj Dayaram. GitHub #30.
+
 ## 0.5.0 (2020-09-25)
 
 * Added the `residential_proxy?` method to

data/README.dev.md

@@ -1,4 +1,4 @@
 # How to release
 
 See
-[here](https://github.com/maxmind/MaxMind-DB-Reader-ruby/blob/master/README.dev.md).
+[here](https://github.com/maxmind/MaxMind-DB-Reader-ruby/blob/main/README.dev.md).

data/README.md

@@ -2,11 +2,9 @@
 
 ## Description
 
-This is the Ruby API for the GeoIP2
-[webservices](https://dev.maxmind.com/geoip/geoip2/web-services) and
-[databases](https://dev.maxmind.com/geoip/geoip2/geolite2/). This API also
-works with the free [GeoLite2
-databases](https://dev.maxmind.com/geoip/geoip2/geolite2/).
+This is the Ruby API for the GeoIP2 and GeoLite2
+[webservices](https://dev.maxmind.com/geoip/docs/web-services?lang=en)
+and [databases](https://dev.maxmind.com/geoip/docs/databases?lang=en).
 
 ## Installation
 
@@ -47,7 +45,9 @@ for more details.
 require 'maxmind/geoip2'
 
 # This creates the Reader object which should be reused across lookups.
-reader = MaxMind::GeoIP2::Reader.new('/usr/share/GeoIP/GeoIP2-City.mmdb')
+reader = MaxMind::GeoIP2::Reader.new(
+  database: '/usr/share/GeoIP/GeoIP2-City.mmdb',
+)
 
 record = reader.city('128.101.101.101')
 
@@ -74,7 +74,9 @@ puts record.traits.network # 128.101.101.101/32
 require 'maxmind/geoip2'
 
 # This creates the Reader object which should be reused across lookups.
-reader = MaxMind::GeoIP2::Reader.new('/usr/share/GeoIP/GeoIP2-Country.mmdb')
+reader = MaxMind::GeoIP2::Reader.new(
+  database: '/usr/share/GeoIP/GeoIP2-Country.mmdb',
+)
 
 record = reader.country('128.101.101.101')
 
@@ -89,7 +91,9 @@ puts record.country.names['zh-CN'] # '美国'
 require 'maxmind/geoip2'
 
 # This creates the Reader object which should be reused across lookups.
-reader = MaxMind::GeoIP2::Reader.new('/usr/share/GeoIP/GeoIP2-Enterprise.mmdb')
+reader = MaxMind::GeoIP2::Reader.new(
+  database: '/usr/share/GeoIP/GeoIP2-Enterprise.mmdb',
+)
 
 record = reader.enterprise('128.101.101.101')
 
@@ -120,7 +124,9 @@ puts record.traits.network # 128.101.101.101/32
 require 'maxmind/geoip2'
 
 # This creates the Reader object which should be reused across lookups.
-reader = MaxMind::GeoIP2::Reader.new('/usr/share/GeoIP/GeoIP2-Anonymous-IP.mmdb')
+reader = MaxMind::GeoIP2::Reader.new(
+  database: '/usr/share/GeoIP/GeoIP2-Anonymous-IP.mmdb',
+)
 
 record = reader.anonymous_ip('128.101.101.101')
 
@@ -133,7 +139,9 @@ puts "Anonymous" if record.is_anonymous
 require 'maxmind/geoip2'
 
 # This creates the Reader object which should be reused across lookups.
-reader = MaxMind::GeoIP2::Reader.new('/usr/share/GeoIP/GeoLite2-ASN.mmdb')
+reader = MaxMind::GeoIP2::Reader.new(
+  database: '/usr/share/GeoIP/GeoLite2-ASN.mmdb',
+)
 
 record = reader.asn('128.101.101.101')
 
@@ -147,7 +155,9 @@ puts record.autonomous_system_organization # Example Ltd
 require 'maxmind/geoip2'
 
 # This creates the Reader object which should be reused across lookups.
-reader = MaxMind::GeoIP2::Reader.new('/usr/share/GeoIP/GeoIP2-Connection-Type.mmdb')
+reader = MaxMind::GeoIP2::Reader.new(
+  database: '/usr/share/GeoIP/GeoIP2-Connection-Type.mmdb',
+)
 
 record = reader.connection_type('128.101.101.101')
 
@@ -160,7 +170,9 @@ puts record.connection_type # Cable/DSL
 require 'maxmind/geoip2'
 
 # This creates the Reader object which should be reused across lookups.
-reader = MaxMind::GeoIP2::Reader.new('/usr/share/GeoIP/GeoIP2-Domain.mmdb')
+reader = MaxMind::GeoIP2::Reader.new(
+  database: '/usr/share/GeoIP/GeoIP2-Domain.mmdb',
+)
 
 record = reader.domain('128.101.101.101')
 
@@ -173,7 +185,9 @@ puts record.domain # example.com
 require 'maxmind/geoip2'
 
 # This creates the Reader object which should be reused across lookups.
-reader = MaxMind::GeoIP2::Reader.new('/usr/share/GeoIP/GeoIP2-ISP.mmdb')
+reader = MaxMind::GeoIP2::Reader.new(
+  database: '/usr/share/GeoIP/GeoIP2-ISP.mmdb',
+)
 
 record = reader.isp('128.101.101.101')
 
@@ -188,9 +202,10 @@ puts record.organization # University of Minnesota
 ### Usage
 
 To use this API, you must create a new `MaxMind::GeoIP2::Client` object
-with your account ID and license key, then you call the method
-corresponding to a specific end point, passing it the IP address you want
-to look up.
+with your account ID and license key. To use the GeoLite2 web service, you
+may also set the `host` parameter to `geolite.info`. You may then you call
+the method corresponding to a specific end point, passing it the IP address
+you want to look up.
 
 If the request succeeds, the method call will return a model class for the end
 point you called. This model in turn contains multiple record classes, each of
@@ -212,13 +227,18 @@ require 'maxmind/geoip2'
 client = MaxMind::GeoIP2::Client.new(
   account_id: 42,
   license_key: 'license_key',
+
+  # To use the GeoLite2 web service instead of GeoIP2 Precision, set
+  # the host parameter to "geolite.info":
+  # host: 'geolite.info',
 )
 
 # Replace "city" with the method corresponding to the web service that
-# you are using, e.g., "country", "insights".
+# you are using, e.g., "country", "insights". Please note that Insights
+# is only supported by GeoIP2 Precision and not the GeoLite2 web service.
 record = client.city('128.101.101.101')
 
-puts record.country.isoCode # US
+puts record.country.iso_code # US
 puts record.country.name # United States
 puts record.country.names['zh-CN'] # 美国
 
@@ -260,7 +280,7 @@ point may offer a particular piece of data, MaxMind does not always have
 every piece of data for any given IP address.
 
 See the [GeoIP2 Precision web service
-docs](https://dev.maxmind.com/geoip/geoip2/web-services) for details on
+docs](https://dev.maxmind.com/geoip/docs/web-services?lang=en) for details on
 what data each end point may return.
 
 The only piece of data which is always returned is the `ip_address`
@@ -307,7 +327,7 @@ client API, please see [our support page](https://www.maxmind.com/en/support).
 
 ## Requirements
 
-This code requires Ruby version 2.4 or higher.
+This code requires Ruby version 2.5 or higher.
 
 ## Contributing
 
@@ -320,7 +340,7 @@ This library uses [Semantic Versioning](https://semver.org/).
 
 ## Copyright and License
 
-This software is Copyright (c) 2020 by MaxMind, Inc.
+This software is Copyright (c) 2020-2021 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/lib/maxmind/geoip2/client.rb

@@ -11,7 +11,7 @@ require 'maxmind/geoip2/model/insights'
 module MaxMind
   module GeoIP2
     # This class provides a client API for all the
-    # {https://dev.maxmind.com/geoip/geoip2/web-services/ GeoIP2 Precision web
+    # {https://dev.maxmind.com/geoip/docs/web-services?lang=en GeoIP2 Precision web
     # services}. The services are Country, City, and Insights. Each service
     # returns a different set of data about an IP address, with Country returning
     # the least data and Insights the most.
@@ -55,6 +55,8 @@ module MaxMind
     #   puts record.country.iso_code
     class Client
       # rubocop:disable Metrics/ParameterLists
+      # rubocop:disable Metrics/CyclomaticComplexity
+      # rubocop:disable Metrics/PerceivedComplexity
 
       # Create a Client that may be used to query a GeoIP2 Precision web service.
       #
@@ -68,7 +70,9 @@ module MaxMind
       # @param locales [Array<String>] a list of locale codes to use in the name
       #   property from most preferred to least preferred.
       #
-      # @param host [String] the host to use when querying the web service.
+      # @param host [String] the host to use when querying the web service. Set
+      #   this to "geolite.info" to use the GeoLite2 web service instead of
+      #   GeoIP2 Precision.
       #
       # @param timeout [Integer] the number of seconds to wait for a request
       #   before timing out. If 0, no timeout is set.
@@ -96,22 +100,24 @@ module MaxMind
       )
         @account_id = account_id
         @license_key = license_key
-        @locales = locales
-        @host = host
-        @timeout = timeout
-        @proxy_address = proxy_address
-        @proxy_port = proxy_port
-        @proxy_username = proxy_username
-        @proxy_password = proxy_password
-        @pool_size = pool_size
+        @locales = locales || ['en']
+        @host = host || 'geoip.maxmind.com'
+        @timeout = timeout || 0
+        @proxy_address = proxy_address || ''
+        @proxy_port = proxy_port || 0
+        @proxy_username = proxy_username || ''
+        @proxy_password = proxy_password || ''
+        @pool_size = pool_size || 5
 
         @connection_pool = ConnectionPool.new(size: @pool_size) do
           make_http_client.persistent("https://#{@host}")
         end
       end
+      # rubocop:enable Metrics/PerceivedComplexity
+      # rubocop:enable Metrics/CyclomaticComplexity
       # rubocop:enable Metrics/ParameterLists
 
-      # This method calls the GeoIP2 Precision City web service.
+      # This method calls the City web service.
       #
       # @param ip_address [String] IPv4 or IPv6 address as a string. If no
       #   address is provided, the address that the web service is called from is
@@ -148,7 +154,7 @@ module MaxMind
         response_for('city', MaxMind::GeoIP2::Model::City, ip_address)
       end
 
-      # This method calls the GeoIP2 Precision Country web service.
+      # This method calls the Country web service.
       #
       # @param ip_address [String] IPv4 or IPv6 address as a string. If no
       #   address is provided, the address that the web service is called from is
@@ -185,7 +191,10 @@ module MaxMind
         response_for('country', MaxMind::GeoIP2::Model::Country, ip_address)
       end
 
-      # This method calls the GeoIP2 Precision Insights web service.
+      # This method calls the Insights web service.
+      #
+      # Insights is only supported by the GeoIP2 Precision web service. The
+      # GeoLite2 web service does not support it.
       #
       # @param ip_address [String] IPv4 or IPv6 address as a string. If no
       #   address is provided, the address that the web service is called from is
@@ -240,11 +249,11 @@ module MaxMind
 
         proxy = timeout
         if @proxy_address != ''
-          opts = {}
-          opts[:proxy_port] = @proxy_port if @proxy_port != 0
-          opts[:proxy_username] = @proxy_username if @proxy_username != ''
-          opts[:proxy_password] = @proxy_password if @proxy_password != ''
-          proxy = timeout.via(@proxy_address, opts)
+          proxy_params = [@proxy_address]
+          proxy_params << (@proxy_port == 0 ? nil : @proxy_port)
+          proxy_params << (@proxy_username == '' ? nil : @proxy_username)
+          proxy_params << (@proxy_password == '' ? nil : @proxy_password)
+          proxy = timeout.via(*proxy_params)
         end
 
         proxy

data/lib/maxmind/geoip2/errors.rb

@@ -2,40 +2,49 @@
 
 module MaxMind
   module GeoIP2
+    # Module's base error class
+    class Error < StandardError
+    end
+
+    # Base error class for all errors that originate from the IP address
+    # itself and will not change when retried.
+    class AddressError < Error
+    end
+
     # An AddressNotFoundError means the IP address was not found in the
     # database or the web service said the IP address was not found.
-    class AddressNotFoundError < RuntimeError
+    class AddressNotFoundError < AddressError
     end
 
     # An HTTPError means there was an unexpected HTTP status or response.
-    class HTTPError < RuntimeError
+    class HTTPError < Error
     end
 
     # An AddressInvalidError means the IP address was invalid.
-    class AddressInvalidError < RuntimeError
+    class AddressInvalidError < AddressError
     end
 
     # An AddressReservedError means the IP address is reserved.
-    class AddressReservedError < RuntimeError
+    class AddressReservedError < AddressError
     end
 
     # An AuthenticationError means there was a problem authenticating to the
     # web service.
-    class AuthenticationError < RuntimeError
+    class AuthenticationError < Error
     end
 
     # An InsufficientFundsError means the account is out of credits.
-    class InsufficientFundsError < RuntimeError
+    class InsufficientFundsError < Error
     end
 
     # A PermissionRequiredError means the account does not have permission to
     # use the requested service.
-    class PermissionRequiredError < RuntimeError
+    class PermissionRequiredError < Error
     end
 
     # An InvalidRequestError means the web service returned an error and there
     # is no more specific error class.
-    class InvalidRequestError < RuntimeError
+    class InvalidRequestError < Error
     end
   end
 end

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

@@ -14,7 +14,7 @@ module MaxMind
       #
       # The only difference between the City and Insights model classes is which
       # fields in each record may be populated. See
-      # https://dev.maxmind.com/geoip/geoip2/web-services for more details.
+      # https://dev.maxmind.com/geoip/docs/web-services?lang=en for more details.
       #
       # See {MaxMind::GeoIP2::Model::Country} for inherited methods.
       class City < Country

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

@@ -9,7 +9,7 @@ module MaxMind
       #
       # The only difference between the City and Insights model classes is which
       # fields in each record may be populated. See
-      # https://dev.maxmind.com/geoip/geoip2/web-services for more details.
+      # https://dev.maxmind.com/geoip/docs/web-services?lang=en for more details.
       #
       # See {MaxMind::GeoIP2::Model::City} for inherited methods.
       class Enterprise < City

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

@@ -10,7 +10,7 @@ module MaxMind
       #
       # The only difference between the City and Insights model classes is which
       # fields in each record may be populated. See
-      # https://dev.maxmind.com/geoip/geoip2/web-services for more details.
+      # https://dev.maxmind.com/geoip/docs/web-services?lang=en for more details.
       class Insights < City
       end
     end

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

@@ -36,6 +36,22 @@ module MaxMind
           get('isp')
         end
 
+        # The {https://en.wikipedia.org/wiki/Mobile_country_code mobile country
+        # code (MCC)} associated with the IP address and ISP.
+        #
+        # @return [String, nil]
+        def mobile_country_code
+          get('mobile_country_code')
+        end
+
+        # The {https://en.wikipedia.org/wiki/Mobile_country_code mobile network
+        # code (MNC)} associated with the IP address and ISP.
+        #
+        # @return [String, nil]
+        def mobile_network_code
+          get('mobile_network_code')
+        end
+
         # The network in CIDR notation associated with the record. In particular,
         # this is the largest network where all of the fields besides ip_address
         # have the same value.

data/lib/maxmind/geoip2/reader.rb

@@ -20,13 +20,16 @@ module MaxMind
     #
     #   require 'maxmind/geoip2'
     #
-    #   reader = MaxMind::GeoIP2::Reader.new('GeoIP2-Country.mmdb')
+    #   reader = MaxMind::GeoIP2::Reader.new(database: 'GeoIP2-Country.mmdb')
     #
     #   record = reader.country('1.2.3.4')
     #   puts record.country.iso_code
     #
     #   reader.close
     class Reader
+      # rubocop:disable Metrics/CyclomaticComplexity
+      # rubocop:disable Metrics/PerceivedComplexity
+
       # Create a Reader for looking up IP addresses in a GeoIP2/GeoLite2 database
       # file.
       #
@@ -34,33 +37,54 @@ module MaxMind
       # Reader and reuse it.
       #
       # Once created, the Reader is safe to use for lookups from multiple
-      # threads. It is safe to use after forking only if you use
-      # MaxMind::DB::MODE_MEMORY or if your version of Ruby supports IO#pread.
-      #
-      # @param database [String] a path to a GeoIP2/GeoLite2 database file.
-      #
-      # @param locales [Array<String>] a list of locale codes to use in the name
-      #   property from most preferred to least preferred.
+      # threads. It is safe to use after forking.
       #
-      # @param options [Hash<Symbol, Symbol>] options controlling the behavior of
-      #   the Reader.
+      # @overload initialize(database:, locales: ['en'], mode: MaxMind::DB::MODE_AUTO)
+      #   @param database [String] a path to a GeoIP2/GeoLite2 database file.
+      #   @param locales [Array<String>] a list of locale codes to use in the name
+      #     property from most preferred to least preferred.
+      #   @param mode [Symbol] Defines how to open the database. It may be one of
+      #     MaxMind::DB::MODE_AUTO, MaxMind::DB::MODE_FILE, or
+      #     MaxMind::DB::MODE_MEMORY. If you don't provide one, the Reader uses
+      #     MaxMind::DB::MODE_AUTO. Refer to the definition of those constants in
+      #     MaxMind::DB for an explanation of their meaning.
       #
-      # @option options [Symbol] :mode Defines how to open the database. It may
-      #   be one of MaxMind::DB::MODE_AUTO, MaxMind::DB::MODE_FILE, or
-      #   MaxMind::DB::MODE_MEMORY. If you don't provide one, the Reader uses
-      #   MaxMind::DB::MODE_AUTO. Refer to the definition of those constants in
-      #   MaxMind::DB for an explanation of their meaning.
-      #
-      # @raise [MaxMind::DB::InvalidDatabaseError] if the database is corrupt or
-      #   invalid.
+      # @raise [MaxMind::DB::InvalidDatabaseError] if the database is corrupt
+      #   or invalid.
       #
       # @raise [ArgumentError] if the mode is invalid.
-      def initialize(database, locales = ['en'], options = {})
+      def initialize(*args)
+        # This if statement is to let us support calling as though we are using
+        # Ruby 2.0 keyword arguments. We can't use keyword argument syntax as
+        # we want to be backwards compatible with the old way we accepted
+        # parameters, which looked like:
+        # def initialize(database, locales = ['en'], options = {})
+        if args.length == 1 && args[0].instance_of?(Hash)
+          database = args[0][:database]
+          locales = args[0][:locales]
+          mode = args[0][:mode]
+        else
+          database = args[0]
+          locales = args[1]
+          mode = args[2].instance_of?(Hash) ? args[2][:mode] : nil
+        end
+
+        if !database.instance_of?(String)
+          raise ArgumentError, 'Invalid database parameter'
+        end
+
+        locales = ['en'] if locales.nil? || locales.empty?
+
+        options = {}
+        options[:mode] = mode if !mode.nil?
         @reader = MaxMind::DB.new(database, options)
+
         @type = @reader.metadata.database_type
-        locales = ['en'] if locales.empty?
+
         @locales = locales
       end
+      # rubocop:enable Metrics/CyclomaticComplexity
+      # rubocop:enable Metrics/PerceivedComplexity
 
       # Look up the IP address in the database.
       #

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

@@ -13,12 +13,10 @@ module MaxMind
         # @!visibility private
         def initialize(record)
           super(record)
-          if !record.key?('network') && record.key?('ip_address') &&
+          if record && !record.key?('network') && record.key?('ip_address') &&
              record.key?('prefix_length')
             ip = IPAddr.new(record['ip_address']).mask(record['prefix_length'])
-            # We could use ip.prefix instead of record['prefix_length'], but that
-            # method only becomes available in Ruby 2.5+.
-            record['network'] = format('%s/%d', ip.to_s, record['prefix_length'])
+            record['network'] = format('%s/%d', ip.to_s, ip.prefix)
           end
         end
 
@@ -69,7 +67,7 @@ module MaxMind
         # NAT, this may differ from the IP address locally assigned to it. This
         # attribute is returned by all end points.
         #
-        # @return [String]
+        # @return [String, nil]
         def ip_address
           get('ip_address')
         end
@@ -111,6 +109,28 @@ module MaxMind
           get('is_legitimate_proxy')
         end
 
+        # The {https://en.wikipedia.org/wiki/Mobile_country_code mobile country
+        # code (MCC)} associated with the IP address and ISP.
+        #
+        # This attribute is only available from the City and Insights web service
+        # and the GeoIP2 Enterprise database.
+        #
+        # @return [String, nil]
+        def mobile_country_code
+          get('mobile_country_code')
+        end
+
+        # The {https://en.wikipedia.org/wiki/Mobile_country_code mobile network
+        # code (MNC)} associated with the IP address and ISP.
+        #
+        # This attribute is only available from the City and Insights web service
+        # and the GeoIP2 Enterprise database.
+        #
+        # @return [String, nil]
+        def mobile_network_code
+          get('mobile_network_code')
+        end
+
         # This is true if the IP address belongs to a public proxy. This property
         # is only available from GeoIP2 Precision Insights.
         #
@@ -149,7 +169,7 @@ module MaxMind
         # this is the largest network where all of the fields besides ip_address
         # have the same value.
         #
-        # @return [String]
+        # @return [String, nil]
         def network
           get('network')
         end

data/maxmind-geoip2.gemspec

@@ -5,7 +5,7 @@ Gem::Specification.new do |s|
   s.files       = Dir['**/*']
   s.name        = 'maxmind-geoip2'
   s.summary     = 'A gem for interacting with the GeoIP2 webservices and databases.'
-  s.version     = '0.5.0'
+  s.version     = '1.1.0'
 
   s.description = 'A gem for interacting with the GeoIP2 webservices and databases. MaxMind provides geolocation data as downloadable databases as well as through a webservice.'
   s.email = 'support@maxmind.com'
@@ -13,15 +13,16 @@ Gem::Specification.new do |s|
   s.licenses    = ['Apache-2.0', 'MIT']
   s.metadata = {
     'bug_tracker_uri' => 'https://github.com/maxmind/GeoIP2-ruby/issues',
-    'changelog_uri' => 'https://github.com/maxmind/GeoIP2-ruby/blob/master/CHANGELOG.md',
+    'changelog_uri' => 'https://github.com/maxmind/GeoIP2-ruby/blob/main/CHANGELOG.md',
     'documentation_uri' => 'https://www.rubydoc.info/gems/maxmind-geoip2',
     'homepage_uri' => 'https://github.com/maxmind/GeoIP2-ruby',
+    'rubygems_mfa_required' => 'true',
     'source_code_uri' => 'https://github.com/maxmind/GeoIP2-ruby',
   }
-  s.required_ruby_version = '>= 2.4.0'
+  s.required_ruby_version = '>= 2.5.0'
 
   s.add_runtime_dependency 'connection_pool', ['~> 2.2']
-  s.add_runtime_dependency 'http', ['~> 4.3']
+  s.add_runtime_dependency 'http', '>= 4.3', '< 6.0'
   s.add_runtime_dependency 'maxmind-db', ['~> 1.1']
 
   s.add_development_dependency 'minitest'