internetdata 2.7.3__tar.gz → 2.7.5__tar.gz

{internetdata-2.7.3 → internetdata-2.7.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: internetdata
-Version: 2.7.3
+Version: 2.7.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.7.3 → internetdata-2.7.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.13
+  version: 2026.10.15
 servers:
   - url: https://internetdata.io
 tags:
@@ -416,7 +416,7 @@ paths:
       summary: Members
       description: |
         Read-only. Adding or removing a member is an invitation flow with email
-        in the middle rather than a POST, and modelling it as one here would
+        in the middle rather than a POST, and modeling it as one here would
         promise something this API does not do.
       security:
         - BearerAuth:
@@ -1365,7 +1365,7 @@ components:
           type: string
         key_prefix:
           type: string
-          description: The leading, non-secret part, so a key is recognisable without storing it.
+          description: The leading, non-secret part, so a key is recognizable without storing it.
         created:
           type: string
           format: date-time
@@ -1405,7 +1405,7 @@ components:
       properties:
         name:
           type: string
-          description: A label you will recognise later. Shown wherever the key is listed.
+          description: A label you will recognize later. Shown wherever the key is listed.
         allowed_scopes:
           type: array
           items:

{internetdata-2.7.3 → internetdata-2.7.5}/src/internetdata/__init__.py

@@ -39,7 +39,7 @@ from .models import (
     TokenResponse,
 )
 
-__version__ = "2.7.3"
+__version__ = "2.7.5"
 
 __all__ = [
     "DATABASE_FORMATS",

{internetdata-2.7.3 → internetdata-2.7.5}/src/internetdata/_core.py

@@ -81,6 +81,11 @@ def build_client(
     the `Authorization` header when it CONSTRUCTS the httpx client itself.
     """
     api_key = check_api_key(api_key)
+    # httpx drops one trailing slash when it joins a path onto the base URL and keeps the
+    # rest, so a second or third reached the API as `//api/v2/database/list`, which prod
+    # answers with a redirect this client does not follow: every call failed (2.7.3,
+    # measured 2026-10-16).
+    base_url = base_url.rstrip("/")
     httpx_args: dict[str, Any] = {}
     if transport is not None:
         httpx_args["transport"] = transport
@@ -135,19 +140,20 @@ def build_async_transfer_client(
 def check_api_key(api_key: str | None) -> str | None:
     """`api_key` without the blanks around it, or None when nothing else is left.
 
-    Refused where it is SET when a control character remains: httpx refuses a header
-    holding a CR, LF or NUL, so every call failed as a retried `network` error with nothing
-    sent, while a tab or DEL inside the key went out on the wire. Untrimmed, a key of blanks
-    was sent as one rather than as no key, and failed every call the same way (2.7.1,
-    measured 2026-10-12).
+    Refused where it is SET when a control character remains, or a character outside
+    ASCII, which httpx cannot put in a header: a CR, LF or NUL failed every call as a
+    retried `network` error with nothing sent, a C1 control or any other non-ASCII
+    character as a raw `UnicodeEncodeError` (2.7.3, measured 2026-10-16), while a tab or
+    DEL went out on the wire. Untrimmed, a key of blanks was sent as one rather than as no
+    key, and failed every call the same way (2.7.1, measured 2026-10-12).
     """
     if api_key is None:
         return None
     if not isinstance(api_key, str):
         raise TypeError(f"api_key must be a string or None, not {type(api_key).__name__}")
     key = api_key.strip()
-    if any(ord(char) < 0x20 or ord(char) == 0x7F for char in key):
-        raise ValueError("api_key holds a control character")
+    if any(ord(char) < 0x20 or ord(char) >= 0x7F for char in key):
+        raise ValueError("api_key holds a control character or one outside ASCII")
     return key or None
 
 

{internetdata-2.7.3 → internetdata-2.7.5}/src/internetdata/_generated/api/organization/account_org_members.py

@@ -61,7 +61,7 @@ def sync_detailed(
     """Members
 
      Read-only. Adding or removing a member is an invitation flow with email
-    in the middle rather than a POST, and modelling it as one here would
+    in the middle rather than a POST, and modeling it as one here would
     promise something this API does not do.
 
     Raises:
@@ -88,7 +88,7 @@ def sync(
     """Members
 
      Read-only. Adding or removing a member is an invitation flow with email
-    in the middle rather than a POST, and modelling it as one here would
+    in the middle rather than a POST, and modeling it as one here would
     promise something this API does not do.
 
     Raises:
@@ -111,7 +111,7 @@ async def asyncio_detailed(
     """Members
 
      Read-only. Adding or removing a member is an invitation flow with email
-    in the middle rather than a POST, and modelling it as one here would
+    in the middle rather than a POST, and modeling it as one here would
     promise something this API does not do.
 
     Raises:
@@ -136,7 +136,7 @@ async def asyncio(
     """Members
 
      Read-only. Adding or removing a member is an invitation flow with email
-    in the middle rather than a POST, and modelling it as one here would
+    in the middle rather than a POST, and modeling it as one here would
     promise something this API does not do.
 
     Raises:

{internetdata-2.7.3 → internetdata-2.7.5}/src/internetdata/_generated/models/account_create_apikey_request.py

@@ -15,7 +15,7 @@ T = TypeVar("T", bound="AccountCreateApikeyRequest")
 class AccountCreateApikeyRequest:
     """
     Attributes:
-        name (str): A label you will recognise later. Shown wherever the key is listed.
+        name (str): A label you will recognize later. Shown wherever the key is listed.
         allowed_scopes (list[str] | Unset): What the new key may do. Omit for a key that carries no named scope, which
             is the safe default.
     """

{internetdata-2.7.3 → internetdata-2.7.5}/src/internetdata/_generated/models/apikey_detail.py

@@ -20,7 +20,7 @@ class ApikeyDetail:
     Attributes:
         id (UUID):
         name (str):
-        key_prefix (str): The leading, non-secret part, so a key is recognisable without storing it.
+        key_prefix (str): The leading, non-secret part, so a key is recognizable without storing it.
         created (datetime.datetime):
         expires (datetime.datetime | None | Unset):
         last_used_at (datetime.datetime | None | Unset):

{internetdata-2.7.3 → internetdata-2.7.5}/src/internetdata/_generated/models/database_metadata.py

@@ -95,9 +95,7 @@ class DatabaseMetadata:
     @classmethod
     def from_dict(cls, src_dict: Mapping[str, Any]) -> Self:
         from ..models.database_metadata_sample import DatabaseMetadataSample
-        from ..models.database_metadata_sample_size import (
-            DatabaseMetadataSampleSize,
-        )
+        from ..models.database_metadata_sample_size import DatabaseMetadataSampleSize
         from ..models.database_metadata_schema import DatabaseMetadataSchema
         from ..models.database_metadata_size import DatabaseMetadataSize
 

{internetdata-2.7.3 → internetdata-2.7.5}/src/internetdata/models.py

@@ -174,85 +174,109 @@ class Download:
 
 def to_database(body: dict[str, Any]) -> Database:
     return Database(
-        base=_present(body, "base"),
-        name=_present(body, "name"),
-        summary=_present(body, "summary"),
-        standing=_present(body, "standing"),
-        license_type=body["license_type"],
+        base=_present(body, "base", str),
+        name=_present(body, "name", str),
+        summary=_present(body, "summary", str),
+        standing=_present(body, "standing", str),
+        license_type=_nullable(body, "license_type", str),
         starts=_datetime(body["starts"]),
         expires=_datetime(body["expires"]),
         renews_at=_datetime(body["renews_at"]),
         notice_due_at=_datetime(body["notice_due_at"]),
-        versions=tuple(to_version(v) for v in _present(body, "versions")),
+        versions=tuple(to_version(v) for v in _present(body, "versions", list)),
         raw=body,
-        open=_present(body, "open"),
+        open=_present(body, "open", bool),
     )
 
 
 def to_version(body: dict[str, Any]) -> DatabaseVersion:
     return DatabaseVersion(
-        id=_present(body, "id"),
-        version=_present(body, "version"),
-        summary=_present(body, "summary"),
-        formats=tuple(_present(body, "formats")),
+        id=_present(body, "id", str),
+        version=_present(body, "version", int),
+        summary=_present(body, "summary", str),
+        formats=_strings(_present(body, "formats", list), "formats"),
         sample_formats=_optional_tuple(body.get("sample_formats")),
     )
 
 
 def to_metadata(body: dict[str, Any]) -> DatabaseMetadata:
     return DatabaseMetadata(
-        id=_present(body, "id"),
+        id=_present(body, "id", str),
         updated=datetime.date.fromisoformat(body["updated"]),
-        entries=_present(body, "entries"),
+        entries=_present(body, "entries", int),
         schema={
             fmt: tuple(to_column(c) for c in columns) for fmt, columns in body["schema"].items()
         },
-        size=dict(body["size"]),
+        size=_sizes(_present(body, "size", dict), "size"),
         update_freq=body.get("update_freq"),
         sample={fmt: tuple(rows) for fmt, rows in body.get("sample", {}).items()},
         raw=body,
-        sample_size=dict(body["sample_size"]) if body.get("sample_size") is not None else None,
-        sample_entries=body.get("sample_entries"),
+        sample_size=_sizes(body["sample_size"], "sample_size")
+        if body.get("sample_size") is not None
+        else None,
+        sample_entries=_nullable(body, "sample_entries", int, absent=True),
     )
 
 
 def to_column(body: dict[str, Any]) -> MetadataColumn:
     return MetadataColumn(
-        name=_present(body, "name"),
-        type=_present(body, "type"),
+        name=_present(body, "name", str),
+        type=_present(body, "type", str),
         description=body.get("description"),
     )
 
 
 def to_download(body: dict[str, Any]) -> Download:
     return Download(
-        dataset_id=_present(body, "dataset_id"),
-        format=_present(body, "format"),
-        outcome=_present(body, "outcome"),
+        dataset_id=_present(body, "dataset_id", str),
+        format=_present(body, "format", str),
+        outcome=_present(body, "outcome", str),
         created=datetime.datetime.fromisoformat(body["created"]),
-        bytes=body["bytes"],
-        http_status=body["http_status"],
+        bytes=_nullable(body, "bytes", int),
+        http_status=_nullable(body, "http_status", int),
         apikey_id=body["apikey_id"],
         client_ip=body["client_ip"],
         user_agent=body["user_agent"],
-        sample=_present(body, "sample"),
-        open=_present(body, "open"),
+        sample=_present(body, "sample", bool),
+        open=_present(body, "open", bool),
     )
 
 
-def _present(body: dict[str, Any], name: str) -> Any:
-    """A member the spec requires and never sends as null.
+def _present(body: dict[str, Any], name: str, kind: type) -> Any:
+    """A member the spec requires and never sends as null, of the type it gives.
 
     A null one is the server's failure, raised for the caller to report as one, rather
     than handed back in the answer: 2.7.1 listed a family whose `base` was null as a
-    family with no base (measured 2026-10-12).
+    family with no base (measured 2026-10-12). So is one of another type: 2.7.4 handed
+    back a version served as `"3"` as that string (measured 2026-10-16).
     """
     value = body[name]
     if value is None:
         raise ValueError(f"{name} is null")
+    return _of_type(value, name, kind)
+
+
+def _nullable(body: dict[str, Any], name: str, kind: type, absent: bool = False) -> Any:
+    """A member that may be null, or with `absent` left out, and is otherwise of `kind`."""
+    value = body.get(name) if absent else body[name]
+    return None if value is None else _of_type(value, name, kind)
+
+
+def _of_type(value: Any, name: str, kind: type) -> Any:
+    # A bool is an int to isinstance, and neither may stand for the other.
+    if isinstance(value, bool) != (kind is bool) or not isinstance(value, kind):
+        raise ValueError(f"{name} is not a {kind.__name__}: {value!r}")
     return value
 
 
+def _strings(values: list[Any], name: str) -> tuple[Any, ...]:
+    return tuple(_of_type(v, name, str) for v in values)
+
+
+def _sizes(sizes: Any, name: str) -> dict[str, int]:
+    return {fmt: _of_type(n, name, int) for fmt, n in _of_type(sizes, name, dict).items()}
+
+
 def _optional_tuple(value: Any) -> tuple[Any, ...] | None:
     return tuple(value) if value is not None else None
 

{internetdata-2.7.3 → internetdata-2.7.5}/tests/test_client.py

@@ -410,6 +410,50 @@ UNREADABLE_MEMBERS: dict[str, tuple[str, dict[str, Any]]] = {
     ),
 }
 
+
+def _with(member: str, value: Any, entry: dict[str, Any]) -> dict[str, Any]:
+    return {**entry, member: value}
+
+
+def _version_with(member: str, value: Any) -> dict[str, Any]:
+    family = database("bogon_ip")
+    return {**family, "versions": [_with(member, value, family["versions"][0])]}
+
+
+_DOWNLOAD = cast(list[dict[str, Any]], DOWNLOADS["downloads"])[0]
+
+# A member of another type than the spec gives it, which 2.7.4 handed back in the answer:
+# a version served as "3" came back as that string (measured 2026-10-16).
+UNREADABLE_MEMBERS.update(
+    {
+        "list version as a numeric string": (
+            LIST_PATH,
+            {"databases": [_version_with("version", "3")]},
+        ),
+        "list version as true": (LIST_PATH, {"databases": [_version_with("version", True)]}),
+        "list format as a number": (LIST_PATH, {"databases": [_version_with("formats", [1])]}),
+        "list base as a number": (
+            LIST_PATH,
+            {"databases": [_with("base", 7, database("bogon_ip"))]},
+        ),
+        "list open as a string": (
+            LIST_PATH,
+            {"databases": [_with("open", "false", database("bogon_ip"))]},
+        ),
+        "list license_type as a number": (
+            LIST_PATH,
+            {"databases": [_with("license_type", 1, database("bogon_ip"))]},
+        ),
+        "metadata entries as a string": (METADATA_PATH, _with("entries", "42", METADATA)),
+        "metadata size as a string": (METADATA_PATH, _with("size", {"csvgz": "760"}, METADATA)),
+        "downloads bytes as a string": (
+            DOWNLOADS_PATH,
+            {"downloads": [_with("bytes", "760", _DOWNLOAD)]},
+        ),
+        "downloads sample as 1": (DOWNLOADS_PATH, {"downloads": [_with("sample", 1, _DOWNLOAD)]}),
+    }
+)
+
 MEMBER_CALLS = {LIST_PATH: "list", METADATA_PATH: "metadata", DOWNLOADS_PATH: "downloads"}
 
 

{internetdata-2.7.3 → internetdata-2.7.5}/tests/test_conformance.py

@@ -274,12 +274,44 @@ def test_the_api_key_is_trimmed(make_client: ClientFactory) -> None:
 
 
 @pytest.mark.parametrize(
-    "api_key", ["key\r\nX-Injected: 1", "ke\ty", "key\x00", "key\x7f", "k\ney"]
+    "api_key", ["key\r\nX-Injected: 1", "ke\ty", "key\x00", "key\x7f", "k\ney", "k\x85ey", "kéy"]
 )
-def test_a_control_character_in_the_api_key_is_refused_where_it_is_set(
+def test_a_control_character_or_one_outside_ascii_is_refused_where_the_key_is_set(
     make_client: ClientFactory, api_key: str
 ) -> None:
     """Accepted, a CR, LF or NUL failed every call as a retried network error with nothing
-    sent, and a tab or DEL went out on the wire inside the header (2.7.1)."""
-    with pytest.raises(ValueError, match="control character"):
+    sent, and a tab or DEL went out on the wire inside the header (2.7.1). A C1 control or
+    any other character outside ASCII failed every call with a raw UnicodeEncodeError and
+    nothing sent, since httpx encodes a header value as ASCII (2.7.3)."""
+    with pytest.raises(ValueError, match="control character or one outside ASCII"):
         make_client(api_key=api_key)
+
+
+@pytest.mark.parametrize("slashes", [1, 2, 3])
+def test_every_trailing_slash_on_the_base_url_is_dropped(
+    make_client: ClientFactory, slashes: int
+) -> None:
+    """httpx drops one when it joins a path on and keeps the rest, so through 2.7.3 a
+    second reached the API as `//api/v2/database/list`, which prod answers with a
+    redirect this client does not follow."""
+    digests = {"md5": "m", "sha1": "s1", "sha256": "s256", "sha512": "s512"}
+    stub = Stub(
+        {
+            LIST_PATH: {"body": {"databases": []}},
+            CHECKSUM_PATH: {"body": {"id": "bogon_ip_v1", "format": "csvgz", "checksums": digests}},
+            "/.well-known/oauth-authorization-server": {
+                "body": {
+                    "issuer": "https://api.example",
+                    "authorization_endpoint": "https://api.example/oauth/authorize",
+                    "token_endpoint": "https://api.example/oauth/token",
+                }
+            },
+        }
+    )
+    client = make_client(transport=stub.transport, base_url="https://api.example" + "/" * slashes)
+
+    client.database.list()
+    client.database.checksums("bogon_ip_v1", "csvgz")
+    client.oauth.metadata()
+
+    assert stub.paths() == [LIST_PATH, CHECKSUM_PATH, "/.well-known/oauth-authorization-server"]