maxmind
diff --git a/‎README.rst
Lines changed: 25 additions & 0 deletions b/‎README.rst
Lines changed: 25 additions & 0 deletions
diff --git a/‎geoip2/database.py
Lines changed: 2 additions & 0 deletions b/‎geoip2/database.py
Lines changed: 2 additions & 0 deletions
diff --git a/‎geoip2/errors.py
Lines changed: 36 additions & 2 deletions b/‎geoip2/errors.py
Lines changed: 36 additions & 2 deletions
@@ -400,6 +400,31 @@ or there is a bug in the reader, a ``maxminddb.InvalidDatabaseError`` will be
 raised with a description of the problem. If an IP address is not in the
 database, a ``AddressNotFoundError`` will be raised.
 
+``AddressNotFoundError`` references the largest subnet where no address would be
+found. This can be used to efficiently enumerate entire subnets:
+
+.. code-block:: python
+
+    import geoip2.database
+    import geoip2.errors
+    import ipaddress
+
+    # This creates a Reader object. You should use the same object
+    # across multiple requests as creation of it is expensive.
+    with geoip2.database.Reader('/path/to/GeoLite2-ASN.mmdb') as reader:
+        network = ipaddress.ip_network("192.128.0.0/15")
+
+        ip_address = network[0]
+        while ip_address in network:
+            try:
+                response = reader.asn(ip_address)
+                response_network = response.network
+            except geoip2.errors.AddressNotFoundError as e:
+                response = None
+                response_network = e.network
+            print(f"{response_network}: {response!r}")
+            ip_address = response_network[-1] + 1  # move to next subnet
+
 Values to use for Database or Dictionary Keys
 ---------------------------------------------
 
 
@@ -239,6 +239,8 @@ def _get(self, database_type: str, ip_address: IPAddress) -> Any:
         if record is None:
             raise geoip2.errors.AddressNotFoundError(
                 f"The address {ip_address} is not in the database.",
+                str(ip_address),
+                prefix_len,
             )
         return record, prefix_len
 
 
@@ -4,7 +4,9 @@
 
 """
 
-from typing import Optional
+import ipaddress
+
+from typing import Optional, Union
 
 
 class GeoIP2Error(RuntimeError):
@@ -17,7 +19,39 @@ class GeoIP2Error(RuntimeError):
 
 
 class AddressNotFoundError(GeoIP2Error):
-    """The address you were looking up was not found."""
+    """The address you were looking up was not found.
+
+    .. attribute:: ip_address
+
+      The IP address used in the lookup.
+
+      :type: str
+
+    .. attribute:: network
+
+      The network associated with the error. In particular, this is the
+      largest network where no address would be found.
+
+    """
+
+    def __init__(
+        self,
+        message: str,
+        ip_address: Optional[str] = None,
+        prefix_len: Optional[int] = None,
+    ) -> None:
+        super().__init__(message)
+        self.ip_address = ip_address
+        self.prefix_len = prefix_len
+
+    @property
+    def network(self) -> Optional[Union[ipaddress.IPv4Network, ipaddress.IPv6Network]]:
+        """The network for the error"""
+
+        if self.ip_address is None or self.prefix_len is None:
+            return None
+        network = ipaddress.ip_network(f"{self.ip_address}/{self.prefix_len}", False)
+        return network
 
 
 class AuthenticationError(GeoIP2Error):
Original file line number	Diff line number	Diff line change
`@@ -239,6 +239,8 @@ def _get(self, database_type: str, ip_address: IPAddress) -> Any:`
`239`	`239`	`if record is None:`
`240`	`240`	`raise geoip2.errors.AddressNotFoundError(`
`241`	`241`	`f"The address {ip_address} is not in the database.",`
	`242`	`+ str(ip_address),`
	`243`	`+ prefix_len,`
`242`	`244`	`)`
`243`	`245`	`return record, prefix_len`
`244`	`246`