blitz-api-py 0.1.0__tar.gz → 0.3.0__tar.gz

{blitz_api_py-0.1.0 → blitz_api_py-0.3.0}/.gitignore

@@ -25,6 +25,11 @@ coverage.xml
 # uv
 # (uv.lock IS committed; only ignore caches)
 
+# Environment variables
+.env
+.env.*
+!.env.example
+
 # Editors / OS
 .idea/
 .vscode/

blitz_api_py-0.3.0/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+## [0.3.0](https://github.com/api-blitz/blitz-api-py/compare/v0.2.0...v0.3.0) (2026-06-04)
+
+
+### Features
+
+* generate enums from the live OpenAPI spec with offline drift guard ([#9](https://github.com/api-blitz/blitz-api-py/issues/9)) ([fee865c](https://github.com/api-blitz/blitz-api-py/commit/fee865c4d8f7c685330794fa79921dccd7556e37))
+
+## [0.2.0](https://github.com/api-blitz/blitz-api-py/compare/v0.1.0...v0.2.0) (2026-06-02)
+
+
+### Features
+
+* cursor guard, page.collect(), and typed waterfall-icp fields ([#7](https://github.com/api-blitz/blitz-api-py/issues/7)) ([b77cdff](https://github.com/api-blitz/blitz-api-py/commit/b77cdffc99c680c2a37d36c8d22ee4c5381e8c68))
+
+## [0.1.0](https://github.com/api-blitz/blitz-api-py/compare/v0.1.0...v0.1.0) (2026-06-02)
+
+
+### Features
+
+* typed Python SDK for the Blitz API with automated releases ([5641a51](https://github.com/api-blitz/blitz-api-py/commit/5641a51b405108029bc701988e08d6210a1255f6))
+
+## Changelog
+
+All notable changes to this project are documented in this file.
+
+This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
+and the changelog is maintained automatically by
+[release-please](https://github.com/googleapis/release-please) from
+[Conventional Commits](https://www.conventionalcommits.org/).

{blitz_api_py-0.1.0 → blitz_api_py-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blitz-api-py
-Version: 0.1.0
+Version: 0.3.0
 Summary: Typed Python SDK for the Blitz API — B2B data, search, and enrichment.
 Project-URL: Homepage, https://blitz-api.ai
 Project-URL: Documentation, https://docs.blitz-api.ai

{blitz_api_py-0.1.0 → blitz_api_py-0.3.0}/src/blitz_api/_pagination_async.py

@@ -17,6 +17,7 @@ from typing import Any, Generic, TypeVar, cast
 
 from typing_extensions import Self
 
+from ._exceptions import BlitzError
 from ._pagination_base import BasePage
 
 ItemT = TypeVar("ItemT")
@@ -49,6 +50,17 @@ class AsyncPaginator(BasePage, Generic[ItemT]):
         """Iterate every item across all pages, optionally stopping after ``max_items``."""
         return self._auto_paging_items(max_items)
 
+    async def collect(self, *, max_items: int | None = None) -> list[ItemT]:
+        """Drain every item across all pages into a list, optionally capped at ``max_items``.
+
+        Convenience over a manual iteration loop; pair with ``max_items`` so an unbounded result
+        set can't exhaust memory — or credits, since the API bills per result returned.
+        """
+        items: list[ItemT] = []
+        async for item in self._auto_paging_items(max_items):
+            items.append(item)
+        return items
+
     async def iter_pages(self, *, max_pages: int | None = None) -> AsyncIterator[Self]:
         """Iterate page objects across the result set, optionally capped at ``max_pages``."""
         page = self
@@ -97,6 +109,15 @@ class AsyncCursorPage(AsyncPaginator[ItemT], Generic[ItemT]):
         return bool(self.cursor)
 
     def _next_body(self) -> dict[str, Any]:
+        # Guard against a non-advancing cursor: if the API hands back the same cursor it was
+        # given, paging again would re-fetch (and re-bill) the same page forever. ``_body``
+        # holds the cursor that fetched THIS page (bound after the request), so a cheap equality
+        # check breaks the loop instead of spinning. Mirrors the JS SDK's CursorPage guard.
+        if self.cursor is not None and self.cursor == self._body.get("cursor"):
+            raise BlitzError(
+                "Cursor did not advance: the API returned the same cursor it was given. "
+                "Aborting to avoid an infinite pagination loop."
+            )
         return {**self._body, "cursor": self.cursor}
 
 

{blitz_api_py-0.1.0 → blitz_api_py-0.3.0}/src/blitz_api/_pagination_sync.py

@@ -19,6 +19,7 @@ from typing import Any, Generic, TypeVar, cast
 
 from typing_extensions import Self
 
+from ._exceptions import BlitzError
 from ._pagination_base import BasePage
 
 ItemT = TypeVar("ItemT")
@@ -51,6 +52,17 @@ class Paginator(BasePage, Generic[ItemT]):
         """Iterate every item across all pages, optionally stopping after ``max_items``."""
         return self._auto_paging_items(max_items)
 
+    def collect(self, *, max_items: int | None = None) -> list[ItemT]:
+        """Drain every item across all pages into a list, optionally capped at ``max_items``.
+
+        Convenience over a manual iteration loop; pair with ``max_items`` so an unbounded result
+        set can't exhaust memory — or credits, since the API bills per result returned.
+        """
+        items: list[ItemT] = []
+        for item in self._auto_paging_items(max_items):
+            items.append(item)
+        return items
+
     def iter_pages(self, *, max_pages: int | None = None) -> Iterator[Self]:
         """Iterate page objects across the result set, optionally capped at ``max_pages``."""
         page = self
@@ -99,6 +111,15 @@ class CursorPage(Paginator[ItemT], Generic[ItemT]):
         return bool(self.cursor)
 
     def _next_body(self) -> dict[str, Any]:
+        # Guard against a non-advancing cursor: if the API hands back the same cursor it was
+        # given, paging again would re-fetch (and re-bill) the same page forever. ``_body``
+        # holds the cursor that fetched THIS page (bound after the request), so a cheap equality
+        # check breaks the loop instead of spinning. Mirrors the JS SDK's CursorPage guard.
+        if self.cursor is not None and self.cursor == self._body.get("cursor"):
+            raise BlitzError(
+                "Cursor did not advance: the API returned the same cursor it was given. "
+                "Aborting to avoid an infinite pagination loop."
+            )
         return {**self._body, "cursor": self.cursor}
 
 

blitz_api_py-0.3.0/src/blitz_api/_version.py

@@ -0,0 +1 @@
+__version__ = "0.3.0"  # x-release-please-version

{blitz_api_py-0.1.0 → blitz_api_py-0.3.0}/src/blitz_api/types/search.py

@@ -33,4 +33,7 @@ class WaterfallIcpMatch(BlitzModel):
 class WaterfallIcpResponse(BlitzModel):
     """Result of ``search.waterfall_icp``."""
 
+    company_linkedin_url: str | None = None
+    max_results: int | None = None
+    results_length: int | None = None
     results: list[WaterfallIcpMatch] = []

blitz_api_py-0.1.0/CHANGELOG.md

@@ -1,17 +0,0 @@
-# Changelog
-
-## [0.1.0](https://github.com/api-blitz/blitz-api-py/compare/v0.1.0...v0.1.0) (2026-06-02)
-
-
-### Features
-
-* typed Python SDK for the Blitz API with automated releases ([5641a51](https://github.com/api-blitz/blitz-api-py/commit/5641a51b405108029bc701988e08d6210a1255f6))
-
-## Changelog
-
-All notable changes to this project are documented in this file.
-
-This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
-and the changelog is maintained automatically by
-[release-please](https://github.com/googleapis/release-please) from
-[Conventional Commits](https://www.conventionalcommits.org/).

blitz_api_py-0.1.0/src/blitz_api/_version.py

@@ -1 +0,0 @@
-__version__ = "0.1.0"  # x-release-please-version