internetdata 2.9.3__tar.gz → 2.9.5__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: internetdata
-Version: 2.9.3
+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
@@ -72,7 +72,7 @@ with InternetData(api_key) as client:
 
 ### The catalog
 
-`list` answers database FAMILIES. A license is held against a family, while a download names a specific version, so the ids the other calls take come from each family's `versions`:
+`list` answers database FAMILIES. A license is held against a family, while a download names a specific version, so the IDs the other calls take come from each family's `versions`:
 
 ```python
 for family in client.database.list():

{internetdata-2.9.3 → internetdata-2.9.5}/README.md

@@ -38,7 +38,7 @@ with InternetData(api_key) as client:
 
 ### The catalog
 
-`list` answers database FAMILIES. A license is held against a family, while a download names a specific version, so the ids the other calls take come from each family's `versions`:
+`list` answers database FAMILIES. A license is held against a family, while a download names a specific version, so the IDs the other calls take come from each family's `versions`:
 
 ```python
 for family in client.database.list():

{internetdata-2.9.3 → 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.10.21
+  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:
@@ -506,7 +517,7 @@ paths:
         - API keys
       summary: Rotate
       description: |
-        Replaces the secret behind a key, keeping its id, name and settings.
+        Replaces the secret behind a key, keeping its ID, name and settings.
         The previous secret stops working immediately. The new secret comes
         back in the answer, so this needs `apikeys.reveal` as well as
         `apikeys.manage`.
@@ -890,7 +901,7 @@ components:
       name: apikey
       description: |
         UUID-format API key issued to the customer. Each key is authorized for a
-        specific set of database ids; requesting any other id returns 403.
+        specific set of database IDs; requesting any other ID returns 403.
 
         v1 only. The v2 endpoints take a console-issued key as a bearer token.
     BearerAuth:
@@ -932,11 +943,23 @@ 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
       required: true
-      description: The key's id, as returned by the list endpoint. Never the key itself.
+      description: The key's ID, as returned by the list endpoint. Never the key itself.
       schema:
         type: string
         format: uuid
@@ -973,7 +996,7 @@ components:
       description: |
         One database FAMILY, with your organization's license beside it. A
         license covers the family, while a download names a specific version,
-        so the ids passed to `download` and `checksum` come from `versions`.
+        so the IDs passed to `download` and `checksum` come from `versions`.
       required:
         - base
         - name
@@ -1061,7 +1084,7 @@ components:
       properties:
         id:
           type: string
-          description: The versioned id. Pass this to `download`, `checksum` and `metadata`.
+          description: The versioned ID. Pass this to `download`, `checksum` and `metadata`.
           example: vpn_ip_v1
         version:
           type: integer
@@ -1072,7 +1095,7 @@ components:
           type: array
           description: |
             The formats this version is BUILT in. Asking for another is a 400,
-            not a gap - the `_provider` catalogs are keyed by provider id, so no
+            not a gap - the `_provider` catalogs are keyed by provider ID, so no
             MMDB exists for them.
           items:
             $ref: '#/components/schemas/DatabaseFormat'
@@ -1826,7 +1849,7 @@ components:
           schema:
             $ref: '#/components/schemas/DbInvalidApiKeyError'
     Forbidden:
-      description: The `apikey` is valid but is not authorized for the requested database id.
+      description: The `apikey` is valid but is not authorized for the requested database ID.
       content:
         application/json:
           schema:

{internetdata-2.9.3 → internetdata-2.9.5}/src/internetdata/__init__.py

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

{internetdata-2.9.3 → internetdata-2.9.5}/src/internetdata/_generated/api/api_keys/account_rotate_apikey.py

@@ -73,7 +73,7 @@ def sync_detailed(
 ) -> Response[AccountCreatedApikey | AccountRc]:
     """Rotate
 
-     Replaces the secret behind a key, keeping its id, name and settings.
+     Replaces the secret behind a key, keeping its ID, name and settings.
     The previous secret stops working immediately. The new secret comes
     back in the answer, so this needs `apikeys.reveal` as well as
     `apikeys.manage`.
@@ -107,7 +107,7 @@ def sync(
 ) -> AccountCreatedApikey | AccountRc | None:
     """Rotate
 
-     Replaces the secret behind a key, keeping its id, name and settings.
+     Replaces the secret behind a key, keeping its ID, name and settings.
     The previous secret stops working immediately. The new secret comes
     back in the answer, so this needs `apikeys.reveal` as well as
     `apikeys.manage`.
@@ -136,7 +136,7 @@ async def asyncio_detailed(
 ) -> Response[AccountCreatedApikey | AccountRc]:
     """Rotate
 
-     Replaces the secret behind a key, keeping its id, name and settings.
+     Replaces the secret behind a key, keeping its ID, name and settings.
     The previous secret stops working immediately. The new secret comes
     back in the answer, so this needs `apikeys.reveal` as well as
     `apikeys.manage`.
@@ -168,7 +168,7 @@ async def asyncio(
 ) -> AccountCreatedApikey | AccountRc | None:
     """Rotate
 
-     Replaces the secret behind a key, keeping its id, name and settings.
+     Replaces the secret behind a key, keeping its ID, name and settings.
     The previous secret stops working immediately. The new secret comes
     back in the answer, so this needs `apikeys.reveal` as well as
     `apikeys.manage`.

{internetdata-2.9.3 → 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.3 → internetdata-2.9.5}/src/internetdata/_generated/models/database.py

@@ -23,7 +23,7 @@ T = TypeVar("T", bound="Database")
 class Database:
     """One database FAMILY, with your organization's license beside it. A
     license covers the family, while a download names a specific version,
-    so the ids passed to `download` and `checksum` come from `versions`.
+    so the IDs passed to `download` and `checksum` come from `versions`.
 
         Attributes:
             base (str): The family, e.g. `vpn_ip`. What a license is held against. Example: vpn_ip.

{internetdata-2.9.3 → internetdata-2.9.5}/src/internetdata/_generated/models/database_version.py

@@ -16,11 +16,11 @@ T = TypeVar("T", bound="DatabaseVersion")
 class DatabaseVersion:
     """
     Attributes:
-        id (str): The versioned id. Pass this to `download`, `checksum` and `metadata`. Example: vpn_ip_v1.
+        id (str): The versioned ID. Pass this to `download`, `checksum` and `metadata`. Example: vpn_ip_v1.
         version (int):  Example: 1.
         summary (str):
         formats (list[DatabaseFormat]): The formats this version is BUILT in. Asking for another is a 400,
-            not a gap - the `_provider` catalogs are keyed by provider id, so no
+            not a gap - the `_provider` catalogs are keyed by provider ID, so no
             MMDB exists for them.
         sample_formats (list[DatabaseFormat] | Unset): The formats an evaluation sample is published in, if any.
     """

{internetdata-2.9.3 → internetdata-2.9.5}/src/internetdata/client.py

@@ -184,7 +184,7 @@ class DatabaseApi:
         for the key you are holding, so a listing held from one key is not an answer for
         another.
 
-        A license covers a FAMILY, while a download names a version, so the ids for the
+        A license covers a FAMILY, while a download names a version, so the IDs for the
         other calls come from each entry's `versions`.
 
         `timeout` bounds each attempt at this call alone, in place of the client's.

{internetdata-2.9.3 → internetdata-2.9.5}/src/internetdata/errors.py

@@ -128,7 +128,7 @@ def error_from_response(status: int, headers: httpx.Headers, body: Any) -> Inter
     """Classify a failed response.
 
     Everything outside the four named statuses is decided by its RANGE rather than by an
-    enumerated list, which is the whole point: a 404 from a database id that does not
+    enumerated list, which is the whole point: a 404 from a database ID that does not
     exist has to land on a client error, and mapping 400/401/403/429 and letting the rest
     fall through to `server_error` retries it twice before failing. Three of the four
     first SDKs shipped exactly that bug, so the shared corpus pins both 404 shapes.

{internetdata-2.9.3 → internetdata-2.9.5}/src/internetdata/models.py

@@ -39,7 +39,7 @@ Format = Literal["csvgz", "mmdb"]
 
 Which of them a given version HAS is `DatabaseVersion.formats`; asking for another is a
 `bad_request` rather than a gap, because the `_provider` catalogs are keyed by provider
-id and no MMDB exists for them.
+ID and no MMDB exists for them.
 """
 
 Standing = Literal["licensed", "expired", "unlicensed"]

{internetdata-2.9.3 → 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",

{internetdata-2.9.3 → internetdata-2.9.5}/tests/test_conformance.py

@@ -168,7 +168,7 @@ def test_the_listing_is_returned_exactly_as_served(make_client: ClientFactory) -
 def test_no_catalog_is_compiled_into_the_client(make_client: ClientFactory) -> None:
     """An empty listing must stay empty.
 
-    This is the mistake worth guarding: a client that knows the published database ids -
+    This is the mistake worth guarding: a client that knows the published database IDs -
     from a bundled table, an enum, or a merge with anything - would hand back a family the
     server deliberately withheld, and the leak answers 200 while moving no bytes.
     """