internetdata 2.9.4__tar.gz → 2.9.6__tar.gz

{internetdata-2.9.4 → internetdata-2.9.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: internetdata
-Version: 2.9.4
+Version: 2.9.6
 Summary: Official Python client library for the InternetData API. Download and verify licensed IP datasets.
 Project-URL: Homepage, https://internetdata.io
 Project-URL: Documentation, https://docs.internetdata.io

{internetdata-2.9.4 → internetdata-2.9.6}/spec/openapi.yaml

@@ -12,7 +12,7 @@ info:
     email: support@internetdata.io
     url: https://internetdata.io
   termsOfService: https://internetdata.io/terms
-  version: 2026.11.02
+  version: 2026.11.05
 servers:
   - url: https://internetdata.io
 tags:
@@ -99,6 +99,7 @@ paths:
       parameters:
         - $ref: '#/components/parameters/DbId'
         - $ref: '#/components/parameters/DbFormat'
+        - $ref: '#/components/parameters/DbBuild'
       responses:
         '302':
           description: Follow the Location header to object storage.
@@ -107,7 +108,9 @@ paths:
               schema:
                 type: string
         '400':
-          description: The database is not built in the requested format.
+          description: |
+            The database is not built in the requested format (`INVALID_FORMAT`),
+            or `build` is not a build's name (`INVALID_BUILD`).
           content:
             application/json:
               schema:
@@ -118,6 +121,14 @@ paths:
           $ref: '#/components/responses/V2Forbidden'
         '404':
           $ref: '#/components/responses/V2UnknownDatabase'
+        '410':
+          description: |
+            The build named in `build` is no longer kept (`BUILD_GONE`): builds are
+            kept 7 days. Download without `build` for the live one.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
         '503':
           $ref: '#/components/responses/V2NotAvailable'
   /api/v2/database/metadata:
@@ -932,6 +943,18 @@ components:
       description: Database file format.
       schema:
         $ref: '#/components/schemas/DatabaseFormat'
+    DbBuild:
+      name: build
+      in: query
+      required: false
+      description: |
+        One build of the database, by the name a `database.updated` webhook gives
+        it, so the file is the one whose `sha256` the webhook carries. Without
+        it, the build that is live.
+      schema:
+        type: string
+        pattern: ^[0-9]{8}\.[a-z0-9]{6}$
+        example: 20261105.0t53s5
     ApikeyIdParam:
       name: id
       in: path

{internetdata-2.9.4 → internetdata-2.9.6}/src/internetdata/__init__.py

@@ -40,7 +40,7 @@ from .models import (
     TokenResponse,
 )
 
-__version__ = "2.9.4"
+__version__ = "2.9.6"
 
 __all__ = [
     "DATABASE_FORMATS",

{internetdata-2.9.4 → internetdata-2.9.6}/src/internetdata/_generated/api/database_v_2/download_database_v2.py

@@ -7,13 +7,14 @@ from ... import errors
 from ...client import AuthenticatedClient, Client
 from ...models.database_format import DatabaseFormat
 from ...models.error import Error
-from ...types import UNSET, Response
+from ...types import UNSET, Response, Unset
 
 
 def _get_kwargs(
     *,
     id: str,
     format_: DatabaseFormat,
+    build: str | Unset = UNSET,
 ) -> dict[str, Any]:
 
     params: dict[str, Any] = {}
@@ -23,6 +24,8 @@ def _get_kwargs(
     json_format_ = format_.value
     params["format"] = json_format_
 
+    params["build"] = build
+
     params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
 
     _kwargs: dict[str, Any] = {
@@ -61,6 +64,11 @@ def _parse_response(
 
         return response_404
 
+    if response.status_code == 410:
+        response_410 = Error.from_dict(response.json())
+
+        return response_410
+
     if response.status_code == 503:
         response_503 = Error.from_dict(response.json())
 
@@ -88,6 +96,7 @@ def sync_detailed(
     client: AuthenticatedClient,
     id: str,
     format_: DatabaseFormat,
+    build: str | Unset = UNSET,
 ) -> Response[Any | Error]:
     """Download
 
@@ -97,6 +106,7 @@ def sync_detailed(
     Args:
         id (str):  Example: vpn_ip_v1.
         format_ (DatabaseFormat): A file format a database version is published in. Example: mmdb.
+        build (str | Unset):  Example: 20261105.0t53s5.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -109,6 +119,7 @@ def sync_detailed(
     kwargs = _get_kwargs(
         id=id,
         format_=format_,
+        build=build,
     )
 
     response = client.get_httpx_client().request(
@@ -123,6 +134,7 @@ def sync(
     client: AuthenticatedClient,
     id: str,
     format_: DatabaseFormat,
+    build: str | Unset = UNSET,
 ) -> Any | Error | None:
     """Download
 
@@ -132,6 +144,7 @@ def sync(
     Args:
         id (str):  Example: vpn_ip_v1.
         format_ (DatabaseFormat): A file format a database version is published in. Example: mmdb.
+        build (str | Unset):  Example: 20261105.0t53s5.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -145,6 +158,7 @@ def sync(
         client=client,
         id=id,
         format_=format_,
+        build=build,
     ).parsed
 
 
@@ -153,6 +167,7 @@ async def asyncio_detailed(
     client: AuthenticatedClient,
     id: str,
     format_: DatabaseFormat,
+    build: str | Unset = UNSET,
 ) -> Response[Any | Error]:
     """Download
 
@@ -162,6 +177,7 @@ async def asyncio_detailed(
     Args:
         id (str):  Example: vpn_ip_v1.
         format_ (DatabaseFormat): A file format a database version is published in. Example: mmdb.
+        build (str | Unset):  Example: 20261105.0t53s5.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -174,6 +190,7 @@ async def asyncio_detailed(
     kwargs = _get_kwargs(
         id=id,
         format_=format_,
+        build=build,
     )
 
     response = await client.get_async_httpx_client().request(**kwargs)
@@ -186,6 +203,7 @@ async def asyncio(
     client: AuthenticatedClient,
     id: str,
     format_: DatabaseFormat,
+    build: str | Unset = UNSET,
 ) -> Any | Error | None:
     """Download
 
@@ -195,6 +213,7 @@ async def asyncio(
     Args:
         id (str):  Example: vpn_ip_v1.
         format_ (DatabaseFormat): A file format a database version is published in. Example: mmdb.
+        build (str | Unset):  Example: 20261105.0t53s5.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -209,5 +228,6 @@ async def asyncio(
             client=client,
             id=id,
             format_=format_,
+            build=build,
         )
     ).parsed

{internetdata-2.9.4 → internetdata-2.9.6}/src/internetdata/aio.py

@@ -478,9 +478,17 @@ class AsyncOauthApi:
         while True:
             # No wait runs past the deadline: an interval ending after it waits only the
             # time left, and the expiry follows with nothing sent. In full, an interval of
-            # 2147483647 held a poll with 2 s left for 68 years (2.6.0).
-            await self._clock.sleep(min(interval, max(deadline - self._clock.now(), 0)))
-            if self._clock.now() >= deadline:
+            # 2147483647 held a poll with 2 s left for 68 years (2.6.0). A remainder not
+            # above 0 is none left: a hand-built `expires_in` of NaN, which compares false
+            # with everything, polled every interval for good (2.9.5). `max(0, ...)` is 0
+            # for NaN only in that order; `max(nan, 0)` is NaN.
+            left = max(0, deadline - self._clock.now())
+            to_deadline = left <= interval
+            await self._clock.sleep(left if to_deadline else interval)
+            # A wait that ran to the deadline ends the poll without reading the clock again:
+            # a timer may wake before the clock has moved the whole wait, and the deadline
+            # would then read as not yet reached, so one more request would go out at it.
+            if to_deadline or self._clock.now() >= deadline:
                 raise OauthExpiredTokenError()
             try:
                 return await self.exchange_device_code(

{internetdata-2.9.4 → internetdata-2.9.6}/src/internetdata/client.py

@@ -537,9 +537,17 @@ class OauthApi:
         while True:
             # No wait runs past the deadline: an interval ending after it waits only the
             # time left, and the expiry follows with nothing sent. In full, an interval of
-            # 2147483647 held a poll with 2 s left for 68 years (2.6.0).
-            self._clock.sleep(min(interval, max(deadline - self._clock.now(), 0)))
-            if self._clock.now() >= deadline:
+            # 2147483647 held a poll with 2 s left for 68 years (2.6.0). A remainder not
+            # above 0 is none left: a hand-built `expires_in` of NaN, which compares false
+            # with everything, polled every interval for good (2.9.5). `max(0, ...)` is 0
+            # for NaN only in that order; `max(nan, 0)` is NaN.
+            left = max(0, deadline - self._clock.now())
+            to_deadline = left <= interval
+            self._clock.sleep(left if to_deadline else interval)
+            # A wait that ran to the deadline ends the poll without reading the clock again:
+            # a timer may wake before the clock has moved the whole wait, and the deadline
+            # would then read as not yet reached, so one more request would go out at it.
+            if to_deadline or self._clock.now() >= deadline:
                 raise OauthExpiredTokenError()
             try:
                 return self.exchange_device_code(client_id, device.device_code, timeout=timeout)

{internetdata-2.9.4 → internetdata-2.9.6}/testdata/testdata.json

@@ -150,7 +150,7 @@
     "mmdb"
   ],
   "visibility": {
-    "why": "A private family is one built for a single customer. It must be ABSENT from a listing for an org that does not license it, not present with standing 'unlicensed' - the standing field is the discovery surface for public datasets only. The server enforces this; an SDK must not reconstruct a catalog from any other source and must not assume the listing is the same for every key. The private ids are deliberately NOT named here: this corpus is committed into twelve PUBLIC repositories, so naming them would publish the customer relationship the rule exists to keep private.",
+    "why": "A private family is one built for a single customer. It must be ABSENT from a listing for an org that does not license it, not present with standing 'unlicensed' - the standing field is the discovery surface for public datasets only. The server enforces this; an SDK must not reconstruct a catalog from any other source and must not assume the listing is the same for every key. The private IDs are deliberately NOT named here: this corpus is committed into twelve PUBLIC repositories, so naming them would publish the customer relationship the rule exists to keep private.",
     "clientRules": [
       "listing-is-returned-as-served",
       "no-catalog-is-compiled-into-the-client",

{internetdata-2.9.4 → internetdata-2.9.6}/tests/helpers.py

@@ -222,11 +222,14 @@ class FakeClock(Clock):
     """A poll's sleep and monotonic clock, replaced together, recording every wait in
     seconds. Past LOOP_BOUND waits, or twice that many clock reads, it trips `bound`."""
 
-    def __init__(self, bound: LoopBound) -> None:
+    def __init__(self, bound: LoopBound, short: float = 0.0) -> None:
         self.waits: list[float] = []
         self._elapsed = 0.0
         self._reads = 0
         self._bound = bound
+        # Each wait of at least 1 ms wakes this many seconds before the clock has moved
+        # its delay, as a runtime timer may.
+        self._short = short
 
     def now(self) -> float:
         self._reads += 1
@@ -238,7 +241,7 @@ class FakeClock(Clock):
         if len(self.waits) == LOOP_BOUND:
             self._bound.trip(f"waited more than {LOOP_BOUND} times")
         self.waits.append(seconds)
-        self._elapsed += seconds
+        self._elapsed += seconds - self._short if seconds >= 0.001 else seconds
 
 
 class AsyncFakeClock(AsyncClock):

{internetdata-2.9.4 → internetdata-2.9.6}/tests/test_oauth.py

@@ -9,6 +9,7 @@ from __future__ import annotations
 
 import asyncio
 import json
+import math
 import re
 import time
 import urllib.parse
@@ -389,6 +390,49 @@ def test_an_expires_in_past_any_float_still_polls(make_client: ClientFactory) ->
     assert clock.waits == [1]
 
 
+@pytest.mark.parametrize("interval", [5, 3])
+def test_a_wait_that_ran_to_the_deadline_ends_the_poll_however_early_the_timer_woke(
+    make_client: ClientFactory, interval: int
+) -> None:
+    """A timer that wakes before the clock has moved its delay leaves the deadline reading as
+    not yet reached, so a poll that read the clock again would ask once more at it. A wait
+    cut to the deadline, or ending at it, ends the poll."""
+    bound = LoopBound()
+    stub = OauthStub([{"status": 400, "body": {"error": "authorization_pending"}}], bound)
+    client = make_client(base_url=BASE_URL, transport=stub.transport)
+    clock = FakeClock(bound, short=0.0005)
+    client.oauth.use_clock(clock)
+    device = DeviceAuthorization(**{**_device_fields(), "expires_in": 3, "interval": interval})
+
+    outcome = settle(lambda: client.oauth.poll_device_token("internetdata-cli", device), bound)
+
+    assert isinstance(outcome, OauthExpiredTokenError), f"settled with {outcome!r}"
+    assert outcome.status is None, "the local deadline, not the server's"
+    assert stub.requests == []
+    assert clock.waits == [3]
+
+
+@pytest.mark.parametrize("expires_in", [math.nan, -math.nan, math.inf - math.inf])
+def test_a_lifetime_that_is_not_a_number_ends_the_poll_at_once(
+    make_client: ClientFactory, expires_in: float
+) -> None:
+    """A hand-built device can carry NaN, which compares false with everything, so the
+    deadline was never reached and the poll asked every interval for good."""
+    bound = LoopBound()
+    stub = OauthStub([{"status": 400, "body": {"error": "authorization_pending"}}], bound)
+    client = make_client(base_url=BASE_URL, transport=stub.transport)
+    clock = FakeClock(bound)
+    client.oauth.use_clock(clock)
+    device = DeviceAuthorization(**{**_device_fields(), "expires_in": expires_in, "interval": 1})
+
+    outcome = settle(lambda: client.oauth.poll_device_token("internetdata-cli", device), bound)
+
+    assert isinstance(outcome, OauthExpiredTokenError), f"settled with {outcome!r}"
+    assert outcome.status is None, "the local deadline, not the server's"
+    assert stub.requests == []
+    assert clock.waits == [0]
+
+
 def _device_fields() -> dict[str, Any]:
     return {
         "device_code": "mo_dc_x",