internetdata 2.6.2__tar.gz → 2.7.1__tar.gz

{internetdata-2.6.2 → internetdata-2.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: internetdata
-Version: 2.6.2
+Version: 2.7.1
 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.6.2 → internetdata-2.7.1}/spec/openapi.yaml

@@ -12,7 +12,7 @@ info:
     email: support@internetdata.io
     url: https://internetdata.io
   termsOfService: https://internetdata.io/terms
-  version: 2026.10.03
+  version: 2026.10.09
 servers:
   - url: https://internetdata.io
 tags:
@@ -28,7 +28,9 @@ tags:
       database is usually fetched.
 
       Access is granted by CONTRACT, one dataset family at a time: there is no
-      self-service purchase and no subscription behind it.
+      self-service purchase and no subscription behind it. The Open databases
+      are the exception: any organization downloads one with its key, licensed
+      or not, under CC BY-SA 4.0. `list` marks them `open`.
 
       A successful download answers `302` with a time-limited URL pointing
       straight at object storage. Follow the redirect (`curl -L`); the link
@@ -58,6 +60,7 @@ paths:
         The whole published catalog, with your organization's license beside
         each entry, so `standing` says whether a database is yours today
         (`licensed`), was (`expired`), or has never been bought (`unlicensed`).
+        An `open` database downloads whatever its `standing`.
       security:
         - ApiKeyQueryAuth: []
         - ApiKeyHeaderAuth: []
@@ -498,10 +501,13 @@ paths:
       summary: Rotate
       description: |
         Replaces the secret behind a key, keeping its id, name and settings.
-        The previous secret stops working immediately.
+        The previous secret stops working immediately. The new secret comes
+        back in the answer, so this needs `apikeys.reveal` as well as
+        `apikeys.manage`.
       security:
         - BearerAuth:
             - apikeys.manage
+            - apikeys.reveal
       parameters:
         - $ref: '#/components/parameters/ApikeyIdParam'
       responses:
@@ -896,7 +902,8 @@ components:
       description: |
         Where your license for a database family stands today. `licensed` is a
         live grant, `expired` one whose term has ended, and `unlicensed` a
-        database published but never bought.
+        database published but never bought. An Open database (`open`)
+        downloads whatever this says.
       enum:
         - licensed
         - expired
@@ -912,6 +919,7 @@ components:
         - name
         - summary
         - standing
+        - open
         - license_type
         - starts
         - expires
@@ -931,6 +939,14 @@ components:
           description: One line on what the newest version contains.
         standing:
           $ref: '#/components/schemas/Standing'
+        open:
+          type: boolean
+          description: |
+            An Open database: any organization downloads it, and fetches its
+            checksums, with no license, under CC BY-SA 4.0 (credit
+            InternetData, https://internetdata.io, and share what you build
+            from it under the same license). `standing` still reports your
+            own license, which grants more where you hold one.
         license_type:
           type: string
           nullable: true
@@ -1013,6 +1029,7 @@ components:
         - format
         - outcome
         - sample
+        - open
         - bytes
         - http_status
         - apikey_id
@@ -1036,6 +1053,12 @@ components:
         sample:
           type: boolean
           description: The evaluation sample rather than the database itself.
+        open:
+          type: boolean
+          description: |
+            Taken under the Open license rather than one of your licenses: an
+            Open database downloaded while your organization held no license
+            in term for it.
         bytes:
           type: integer
           format: int64
@@ -1624,7 +1647,7 @@ components:
     V2NotLicensed:
       description: |
         Your organization holds no license for this database, or its term has
-        ended.
+        ended. Never for an Open database.
         `rc`: `NOT_LICENSED`, `LICENSE_EXPIRED`.
       content:
         application/json:

{internetdata-2.6.2 → internetdata-2.7.1}/src/internetdata/__init__.py

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

{internetdata-2.6.2 → internetdata-2.7.1}/src/internetdata/_generated/api/api_keys/account_rotate_apikey.py

@@ -74,7 +74,9 @@ def sync_detailed(
     """Rotate
 
      Replaces the secret behind a key, keeping its id, name and settings.
-    The previous secret stops working immediately.
+    The previous secret stops working immediately. The new secret comes
+    back in the answer, so this needs `apikeys.reveal` as well as
+    `apikeys.manage`.
 
     Args:
         id (UUID):
@@ -106,7 +108,9 @@ def sync(
     """Rotate
 
      Replaces the secret behind a key, keeping its id, name and settings.
-    The previous secret stops working immediately.
+    The previous secret stops working immediately. The new secret comes
+    back in the answer, so this needs `apikeys.reveal` as well as
+    `apikeys.manage`.
 
     Args:
         id (UUID):
@@ -133,7 +137,9 @@ async def asyncio_detailed(
     """Rotate
 
      Replaces the secret behind a key, keeping its id, name and settings.
-    The previous secret stops working immediately.
+    The previous secret stops working immediately. The new secret comes
+    back in the answer, so this needs `apikeys.reveal` as well as
+    `apikeys.manage`.
 
     Args:
         id (UUID):
@@ -163,7 +169,9 @@ async def asyncio(
     """Rotate
 
      Replaces the secret behind a key, keeping its id, name and settings.
-    The previous secret stops working immediately.
+    The previous secret stops working immediately. The new secret comes
+    back in the answer, so this needs `apikeys.reveal` as well as
+    `apikeys.manage`.
 
     Args:
         id (UUID):

{internetdata-2.6.2 → internetdata-2.7.1}/src/internetdata/_generated/api/database_v_2/list_databases.py

@@ -59,6 +59,7 @@ def sync_detailed(
      The whole published catalog, with your organization's license beside
     each entry, so `standing` says whether a database is yours today
     (`licensed`), was (`expired`), or has never been bought (`unlicensed`).
+    An `open` database downloads whatever its `standing`.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -86,6 +87,7 @@ def sync(
      The whole published catalog, with your organization's license beside
     each entry, so `standing` says whether a database is yours today
     (`licensed`), was (`expired`), or has never been bought (`unlicensed`).
+    An `open` database downloads whatever its `standing`.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -109,6 +111,7 @@ async def asyncio_detailed(
      The whole published catalog, with your organization's license beside
     each entry, so `standing` says whether a database is yours today
     (`licensed`), was (`expired`), or has never been bought (`unlicensed`).
+    An `open` database downloads whatever its `standing`.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -134,6 +137,7 @@ async def asyncio(
      The whole published catalog, with your organization's license beside
     each entry, so `standing` says whether a database is yours today
     (`licensed`), was (`expired`), or has never been bought (`unlicensed`).
+    An `open` database downloads whatever its `standing`.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

{internetdata-2.6.2 → internetdata-2.7.1}/src/internetdata/_generated/models/database.py

@@ -31,7 +31,13 @@ class Database:
             summary (str): One line on what the newest version contains.
             standing (Standing): Where your license for a database family stands today. `licensed` is a
                 live grant, `expired` one whose term has ended, and `unlicensed` a
-                database published but never bought.
+                database published but never bought. An Open database (`open`)
+                downloads whatever this says.
+            open_ (bool): An Open database: any organization downloads it, and fetches its
+                checksums, with no license, under CC BY-SA 4.0 (credit
+                InternetData, https://internetdata.io, and share what you build
+                from it under the same license). `standing` still reports your
+                own license, which grants more where you hold one.
             license_type (DatabaseLicenseTypeType1 | DatabaseLicenseTypeType2Type1 | DatabaseLicenseTypeType3Type1 | None):
                 What your license permits you to do with the data. Null when there
                 is no license, which is every family with standing `unlicensed`.
@@ -51,6 +57,7 @@ class Database:
     name: str
     summary: str
     standing: Standing
+    open_: bool
     license_type: (
         DatabaseLicenseTypeType1
         | DatabaseLicenseTypeType2Type1
@@ -73,6 +80,8 @@ class Database:
 
         standing = self.standing.value
 
+        open_ = self.open_
+
         license_type: None | str
         if (
             isinstance(self.license_type, DatabaseLicenseTypeType1)
@@ -120,6 +129,7 @@ class Database:
                 "name": name,
                 "summary": summary,
                 "standing": standing,
+                "open": open_,
                 "license_type": license_type,
                 "starts": starts,
                 "expires": expires,
@@ -144,6 +154,8 @@ class Database:
 
         standing = Standing(d.pop("standing"))
 
+        open_ = d.pop("open")
+
         def _parse_license_type(
             data: object,
         ) -> (
@@ -260,6 +272,7 @@ class Database:
             name=name,
             summary=summary,
             standing=standing,
+            open_=open_,
             license_type=license_type,
             starts=starts,
             expires=expires,

{internetdata-2.6.2 → internetdata-2.7.1}/src/internetdata/_generated/models/download.py

@@ -21,6 +21,9 @@ class Download:
         format_ (str):
         outcome (DownloadOutcome):
         sample (bool): The evaluation sample rather than the database itself.
+        open_ (bool): Taken under the Open license rather than one of your licenses: an
+            Open database downloaded while your organization held no license
+            in term for it.
         bytes_ (int | None): Object size at redirect time, NOT bytes delivered: the transfer is a
             presigned redirect straight to object storage, so we never observe
             how much of it was taken.
@@ -35,6 +38,7 @@ class Download:
     format_: str
     outcome: DownloadOutcome
     sample: bool
+    open_: bool
     bytes_: int | None
     http_status: int | None
     apikey_id: None | str
@@ -52,6 +56,8 @@ class Download:
 
         sample = self.sample
 
+        open_ = self.open_
+
         bytes_: int | None
         bytes_ = self.bytes_
 
@@ -77,6 +83,7 @@ class Download:
                 "format": format_,
                 "outcome": outcome,
                 "sample": sample,
+                "open": open_,
                 "bytes": bytes_,
                 "http_status": http_status,
                 "apikey_id": apikey_id,
@@ -99,6 +106,8 @@ class Download:
 
         sample = d.pop("sample")
 
+        open_ = d.pop("open")
+
         def _parse_bytes_(data: object) -> int | None:
             if data is None:
                 return data
@@ -141,6 +150,7 @@ class Download:
             format_=format_,
             outcome=outcome,
             sample=sample,
+            open_=open_,
             bytes_=bytes_,
             http_status=http_status,
             apikey_id=apikey_id,

{internetdata-2.6.2 → internetdata-2.7.1}/src/internetdata/models.py

@@ -86,7 +86,9 @@ class Database:
     """One database FAMILY, with your organization's license beside it.
 
     A family your organization has never licensed is still listed, with `standing` set to
-    `unlicensed`, so you can see what else exists.
+    `unlicensed`, so you can see what else exists. One that is `open` downloads with no
+    license at all, under CC BY-SA 4.0, whatever its `standing`, which still reports your
+    own license.
 
     A rolling license carries `renews_at`, when it next renews, and `notice_due_at`, the
     last day notice of non-renewal can be given for the term ending then. Both are None
@@ -107,6 +109,9 @@ class Database:
     notice_due_at: datetime.datetime | None = field(default=None, kw_only=True)
     versions: tuple[DatabaseVersion, ...]
     raw: dict[str, Any] = field(default_factory=dict)
+    # Keyword-only with a default, so a Database built by hand before 2.7.0 still builds;
+    # the parser always sets it.
+    open: bool = field(default=False, kw_only=True)
 
 
 @dataclass(frozen=True, slots=True)
@@ -162,6 +167,10 @@ class Download:
     # with a default, so a Download built by hand before 2.5.0 still builds; the parser
     # always sets it.
     sample: bool = field(default=False, kw_only=True)
+    # Taken under the Open license rather than one of your licenses: an Open database
+    # downloaded while your organization held no license in term for it. Keyword-only
+    # with a default, so a Download built by hand before 2.7.0 still builds.
+    open: bool = field(default=False, kw_only=True)
 
 
 def to_database(body: dict[str, Any]) -> Database:
@@ -177,6 +186,7 @@ def to_database(body: dict[str, Any]) -> Database:
         notice_due_at=_datetime(body["notice_due_at"]),
         versions=tuple(to_version(v) for v in body["versions"]),
         raw=body,
+        open=body["open"],
     )
 
 
@@ -223,6 +233,7 @@ def to_download(body: dict[str, Any]) -> Download:
         client_ip=body["client_ip"],
         user_agent=body["user_agent"],
         sample=body["sample"],
+        open=body["open"],
     )
 
 

{internetdata-2.6.2 → internetdata-2.7.1}/tests/helpers.py

@@ -441,6 +441,7 @@ def database(base: str, **overrides: Any) -> dict[str, Any]:
         "name": base.replace("_", " ").title(),
         "summary": f"{base} rows",
         "standing": "licensed",
+        "open": False,
         "license_type": "standard",
         "starts": "2026-01-01T00:00:00.000Z",
         "expires": None,

{internetdata-2.6.2 → internetdata-2.7.1}/tests/test_client.py

@@ -88,6 +88,7 @@ DOWNLOADS = {
             "client_ip": "203.0.113.4",
             "user_agent": "curl/8.5.0",
             "sample": False,
+            "open": True,
             "created": "2026-09-04T10:00:00.000Z",
         },
         {
@@ -100,6 +101,7 @@ DOWNLOADS = {
             "client_ip": None,
             "user_agent": None,
             "sample": True,
+            "open": False,
             "created": "2026-09-04T09:00:00.000Z",
         },
     ]
@@ -202,6 +204,7 @@ def test_a_refusal_is_listed_beside_a_success(make_client: ClientFactory) -> Non
     assert denied.http_status == 403
     assert denied.apikey_id is None and denied.client_ip is None
     assert [a.sample for a in attempts] == [False, True]
+    assert [a.open for a in attempts] == [True, False]
 
 
 def test_the_downloads_limit_reaches_the_wire(make_client: ClientFactory) -> None:
@@ -225,6 +228,19 @@ def test_a_licence_with_no_end_date_reads_as_none(make_client: ClientFactory) ->
     assert family.notice_due_at is None
 
 
+def test_an_open_family_is_read_beside_its_standing(make_client: ClientFactory) -> None:
+    served = [
+        database("asn", standing="unlicensed", open=True, license_type=None, starts=None),
+        database("vpn_ip"),
+    ]
+    stub = Stub({LIST_PATH: {"body": {"databases": served}}})
+    client = make_client(transport=stub.transport)
+
+    families = client.database.list()
+
+    assert [(f.open, f.standing) for f in families] == [(True, "unlicensed"), (False, "licensed")]
+
+
 def test_a_rolling_license_carries_its_renewal_dates(make_client: ClientFactory) -> None:
     served = database(
         "bogon_ip",