internetdata 2.9.4__tar.gz → 2.9.5__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: internetdata
-Version: 2.9.4
+Version: 2.9.5
 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.5}/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.5}/src/internetdata/__init__.py

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

{internetdata-2.9.4 → internetdata-2.9.5}/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.5}/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",