parallel-web 0.3.0__tar.gz → 0.3.2__tar.gz

parallel_web-0.3.2/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.3.2"
+}

{parallel_web-0.3.0 → parallel_web-0.3.2}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.3.2 (2025-10-22)
+
+Full Changelog: [v0.3.1...v0.3.2](https://github.com/parallel-web/parallel-sdk-python/compare/v0.3.1...v0.3.2)
+
+### Bug Fixes
+
+* **api:** default beta headers for v1beta/search and v1beta/extract ([9f8d8dd](https://github.com/parallel-web/parallel-sdk-python/commit/9f8d8dd6e40f77fb0d1eaf6cc300cb853e734cdf))
+
+## 0.3.1 (2025-10-21)
+
+Full Changelog: [v0.3.0...v0.3.1](https://github.com/parallel-web/parallel-sdk-python/compare/v0.3.0...v0.3.1)
+
+### Features
+
+* **api:** manual updates ([0acbe77](https://github.com/parallel-web/parallel-sdk-python/commit/0acbe77da0148029c21e6b3c541e0b1ca163038d))
+
 ## 0.3.0 (2025-10-21)
 
 Full Changelog: [v0.2.2...v0.3.0](https://github.com/parallel-web/parallel-sdk-python/compare/v0.2.2...v0.3.0)

{parallel_web-0.3.0 → parallel_web-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: parallel-web
-Version: 0.3.0
+Version: 0.3.2
 Summary: The official Python library for the Parallel API
 Project-URL: Homepage, https://github.com/parallel-web/parallel-sdk-python
 Project-URL: Repository, https://github.com/parallel-web/parallel-sdk-python

{parallel_web-0.3.0 → parallel_web-0.3.2}/api.md

@@ -45,6 +45,7 @@ from parallel.types.beta import (
     ExtractError,
     ExtractResponse,
     ExtractResult,
+    FetchPolicy,
     SearchResult,
     WebSearchResult,
 )

{parallel_web-0.3.0 → parallel_web-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "parallel-web"
-version = "0.3.0"
+version = "0.3.2"
 description = "The official Python library for the Parallel API"
 dynamic = ["readme"]
 license = "MIT"

{parallel_web-0.3.0 → parallel_web-0.3.2}/src/parallel/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "parallel"
-__version__ = "0.3.0"  # x-release-please-version
+__version__ = "0.3.2"  # x-release-please-version

{parallel_web-0.3.0 → parallel_web-0.3.2}/src/parallel/resources/beta/beta.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from typing import List, Optional
+from itertools import chain
 from typing_extensions import Literal
 
 import httpx
@@ -37,6 +38,7 @@ from ...types.beta import beta_search_params, beta_extract_params
 from ..._base_client import make_request_options
 from ...types.beta.search_result import SearchResult
 from ...types.beta.extract_response import ExtractResponse
+from ...types.beta.fetch_policy_param import FetchPolicyParam
 from ...types.beta.parallel_beta_param import ParallelBetaParam
 from ...types.shared_params.source_policy import SourcePolicy
 
@@ -76,7 +78,7 @@ class BetaResource(SyncAPIResource):
         *,
         urls: SequenceNotStr[str],
         excerpts: beta_extract_params.Excerpts | Omit = omit,
-        fetch_policy: Optional[beta_extract_params.FetchPolicy] | Omit = omit,
+        fetch_policy: Optional[FetchPolicyParam] | Omit = omit,
         full_content: beta_extract_params.FullContent | Omit = omit,
         objective: Optional[str] | Omit = omit,
         search_queries: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -122,9 +124,16 @@ class BetaResource(SyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         extra_headers = {
-            **strip_not_given({"parallel-beta": ",".join(str(e) for e in betas) if is_given(betas) else not_given}),
+            **strip_not_given(
+                {
+                    "parallel-beta": ",".join(chain((str(e) for e in betas), ["search-extract-2025-10-10"]))
+                    if is_given(betas)
+                    else not_given
+                }
+            ),
             **(extra_headers or {}),
         }
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return self._post(
             "/v1beta/extract",
             body=maybe_transform(
@@ -196,9 +205,16 @@ class BetaResource(SyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         extra_headers = {
-            **strip_not_given({"parallel-beta": ",".join(str(e) for e in betas) if is_given(betas) else not_given}),
+            **strip_not_given(
+                {
+                    "parallel-beta": ",".join(chain((str(e) for e in betas), ["search-extract-2025-10-10"]))
+                    if is_given(betas)
+                    else not_given
+                }
+            ),
             **(extra_headers or {}),
         }
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return self._post(
             "/v1beta/search",
             body=maybe_transform(
@@ -252,7 +268,7 @@ class AsyncBetaResource(AsyncAPIResource):
         *,
         urls: SequenceNotStr[str],
         excerpts: beta_extract_params.Excerpts | Omit = omit,
-        fetch_policy: Optional[beta_extract_params.FetchPolicy] | Omit = omit,
+        fetch_policy: Optional[FetchPolicyParam] | Omit = omit,
         full_content: beta_extract_params.FullContent | Omit = omit,
         objective: Optional[str] | Omit = omit,
         search_queries: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -298,9 +314,16 @@ class AsyncBetaResource(AsyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         extra_headers = {
-            **strip_not_given({"parallel-beta": ",".join(str(e) for e in betas) if is_given(betas) else not_given}),
+            **strip_not_given(
+                {
+                    "parallel-beta": ",".join(chain((str(e) for e in betas), ["search-extract-2025-10-10"]))
+                    if is_given(betas)
+                    else not_given
+                }
+            ),
             **(extra_headers or {}),
         }
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return await self._post(
             "/v1beta/extract",
             body=await async_maybe_transform(
@@ -372,9 +395,16 @@ class AsyncBetaResource(AsyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         extra_headers = {
-            **strip_not_given({"parallel-beta": ",".join(str(e) for e in betas) if is_given(betas) else not_given}),
+            **strip_not_given(
+                {
+                    "parallel-beta": ",".join(chain((str(e) for e in betas), ["search-extract-2025-10-10"]))
+                    if is_given(betas)
+                    else not_given
+                }
+            ),
             **(extra_headers or {}),
         }
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return await self._post(
             "/v1beta/search",
             body=await async_maybe_transform(

{parallel_web-0.3.0 → parallel_web-0.3.2}/src/parallel/resources/beta/task_group.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from typing import Any, Dict, List, Union, Iterable, Optional, cast
+from itertools import chain
 from typing_extensions import Literal
 
 import httpx
@@ -81,6 +82,7 @@ class TaskGroupResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return self._post(
             "/v1beta/tasks/groups",
             body=maybe_transform({"metadata": metadata}, task_group_create_params.TaskGroupCreateParams),
@@ -115,6 +117,7 @@ class TaskGroupResource(SyncAPIResource):
         """
         if not task_group_id:
             raise ValueError(f"Expected a non-empty value for `task_group_id` but received {task_group_id!r}")
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return self._get(
             f"/v1beta/tasks/groups/{task_group_id}",
             options=make_request_options(
@@ -163,9 +166,16 @@ class TaskGroupResource(SyncAPIResource):
         if not task_group_id:
             raise ValueError(f"Expected a non-empty value for `task_group_id` but received {task_group_id!r}")
         extra_headers = {
-            **strip_not_given({"parallel-beta": ",".join(str(e) for e in betas) if is_given(betas) else not_given}),
+            **strip_not_given(
+                {
+                    "parallel-beta": ",".join(chain((str(e) for e in betas), ["search-extract-2025-10-10"]))
+                    if is_given(betas)
+                    else not_given
+                }
+            ),
             **(extra_headers or {}),
         }
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return self._post(
             f"/v1beta/tasks/groups/{task_group_id}/runs",
             body=maybe_transform(
@@ -212,6 +222,7 @@ class TaskGroupResource(SyncAPIResource):
         if not task_group_id:
             raise ValueError(f"Expected a non-empty value for `task_group_id` but received {task_group_id!r}")
         extra_headers = {"Accept": "text/event-stream", **(extra_headers or {})}
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return self._get(
             f"/v1beta/tasks/groups/{task_group_id}/events",
             options=make_request_options(
@@ -276,6 +287,7 @@ class TaskGroupResource(SyncAPIResource):
         if not task_group_id:
             raise ValueError(f"Expected a non-empty value for `task_group_id` but received {task_group_id!r}")
         extra_headers = {"Accept": "text/event-stream", **(extra_headers or {})}
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return self._get(
             f"/v1beta/tasks/groups/{task_group_id}/runs",
             options=make_request_options(
@@ -346,6 +358,7 @@ class AsyncTaskGroupResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return await self._post(
             "/v1beta/tasks/groups",
             body=await async_maybe_transform({"metadata": metadata}, task_group_create_params.TaskGroupCreateParams),
@@ -380,6 +393,7 @@ class AsyncTaskGroupResource(AsyncAPIResource):
         """
         if not task_group_id:
             raise ValueError(f"Expected a non-empty value for `task_group_id` but received {task_group_id!r}")
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return await self._get(
             f"/v1beta/tasks/groups/{task_group_id}",
             options=make_request_options(
@@ -428,9 +442,16 @@ class AsyncTaskGroupResource(AsyncAPIResource):
         if not task_group_id:
             raise ValueError(f"Expected a non-empty value for `task_group_id` but received {task_group_id!r}")
         extra_headers = {
-            **strip_not_given({"parallel-beta": ",".join(str(e) for e in betas) if is_given(betas) else not_given}),
+            **strip_not_given(
+                {
+                    "parallel-beta": ",".join(chain((str(e) for e in betas), ["search-extract-2025-10-10"]))
+                    if is_given(betas)
+                    else not_given
+                }
+            ),
             **(extra_headers or {}),
         }
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return await self._post(
             f"/v1beta/tasks/groups/{task_group_id}/runs",
             body=await async_maybe_transform(
@@ -477,6 +498,7 @@ class AsyncTaskGroupResource(AsyncAPIResource):
         if not task_group_id:
             raise ValueError(f"Expected a non-empty value for `task_group_id` but received {task_group_id!r}")
         extra_headers = {"Accept": "text/event-stream", **(extra_headers or {})}
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return await self._get(
             f"/v1beta/tasks/groups/{task_group_id}/events",
             options=make_request_options(
@@ -541,6 +563,7 @@ class AsyncTaskGroupResource(AsyncAPIResource):
         if not task_group_id:
             raise ValueError(f"Expected a non-empty value for `task_group_id` but received {task_group_id!r}")
         extra_headers = {"Accept": "text/event-stream", **(extra_headers or {})}
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return await self._get(
             f"/v1beta/tasks/groups/{task_group_id}/runs",
             options=make_request_options(

{parallel_web-0.3.0 → parallel_web-0.3.2}/src/parallel/resources/beta/task_run.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from typing import Any, Dict, List, Union, Iterable, Optional, cast
+from itertools import chain
 
 import httpx
 
@@ -122,9 +123,16 @@ class TaskRunResource(SyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         extra_headers = {
-            **strip_not_given({"parallel-beta": ",".join(str(e) for e in betas) if is_given(betas) else not_given}),
+            **strip_not_given(
+                {
+                    "parallel-beta": ",".join(chain((str(e) for e in betas), ["search-extract-2025-10-10"]))
+                    if is_given(betas)
+                    else not_given
+                }
+            ),
             **(extra_headers or {}),
         }
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return self._post(
             "/v1/tasks/runs?beta=true",
             body=maybe_transform(
@@ -178,6 +186,7 @@ class TaskRunResource(SyncAPIResource):
         if not run_id:
             raise ValueError(f"Expected a non-empty value for `run_id` but received {run_id!r}")
         extra_headers = {"Accept": "text/event-stream", **(extra_headers or {})}
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return self._get(
             f"/v1beta/tasks/runs/{run_id}/events",
             options=make_request_options(
@@ -218,9 +227,16 @@ class TaskRunResource(SyncAPIResource):
         if not run_id:
             raise ValueError(f"Expected a non-empty value for `run_id` but received {run_id!r}")
         extra_headers = {
-            **strip_not_given({"parallel-beta": ",".join(str(e) for e in betas) if is_given(betas) else not_given}),
+            **strip_not_given(
+                {
+                    "parallel-beta": ",".join(chain((str(e) for e in betas), ["search-extract-2025-10-10"]))
+                    if is_given(betas)
+                    else not_given
+                }
+            ),
             **(extra_headers or {}),
         }
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return self._get(
             f"/v1/tasks/runs/{run_id}/result?beta=true",
             options=make_request_options(
@@ -325,9 +341,16 @@ class AsyncTaskRunResource(AsyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         extra_headers = {
-            **strip_not_given({"parallel-beta": ",".join(str(e) for e in betas) if is_given(betas) else not_given}),
+            **strip_not_given(
+                {
+                    "parallel-beta": ",".join(chain((str(e) for e in betas), ["search-extract-2025-10-10"]))
+                    if is_given(betas)
+                    else not_given
+                }
+            ),
             **(extra_headers or {}),
         }
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return await self._post(
             "/v1/tasks/runs?beta=true",
             body=await async_maybe_transform(
@@ -381,6 +404,7 @@ class AsyncTaskRunResource(AsyncAPIResource):
         if not run_id:
             raise ValueError(f"Expected a non-empty value for `run_id` but received {run_id!r}")
         extra_headers = {"Accept": "text/event-stream", **(extra_headers or {})}
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return await self._get(
             f"/v1beta/tasks/runs/{run_id}/events",
             options=make_request_options(
@@ -421,9 +445,16 @@ class AsyncTaskRunResource(AsyncAPIResource):
         if not run_id:
             raise ValueError(f"Expected a non-empty value for `run_id` but received {run_id!r}")
         extra_headers = {
-            **strip_not_given({"parallel-beta": ",".join(str(e) for e in betas) if is_given(betas) else not_given}),
+            **strip_not_given(
+                {
+                    "parallel-beta": ",".join(chain((str(e) for e in betas), ["search-extract-2025-10-10"]))
+                    if is_given(betas)
+                    else not_given
+                }
+            ),
             **(extra_headers or {}),
         }
+        extra_headers = {"parallel-beta": "search-extract-2025-10-10", **(extra_headers or {})}
         return await self._get(
             f"/v1/tasks/runs/{run_id}/result?beta=true",
             options=make_request_options(

{parallel_web-0.3.0 → parallel_web-0.3.2}/src/parallel/types/beta/__init__.py

@@ -18,6 +18,7 @@ from .mcp_server_param import McpServerParam as McpServerParam
 from .task_group_status import TaskGroupStatus as TaskGroupStatus
 from .web_search_result import WebSearchResult as WebSearchResult
 from .beta_search_params import BetaSearchParams as BetaSearchParams
+from .fetch_policy_param import FetchPolicyParam as FetchPolicyParam
 from .beta_extract_params import BetaExtractParams as BetaExtractParams
 from .parallel_beta_param import ParallelBetaParam as ParallelBetaParam
 from .beta_run_input_param import BetaRunInputParam as BetaRunInputParam

{parallel_web-0.3.0 → parallel_web-0.3.2}/src/parallel/types/beta/beta_extract_params.py

@@ -7,10 +7,11 @@ from typing_extensions import Required, Annotated, TypeAlias, TypedDict
 
 from ..._types import SequenceNotStr
 from ..._utils import PropertyInfo
+from .fetch_policy_param import FetchPolicyParam
 from .parallel_beta_param import ParallelBetaParam
 from .excerpt_settings_param import ExcerptSettingsParam
 
-__all__ = ["BetaExtractParams", "Excerpts", "FetchPolicy", "FullContent", "FullContentFullContentSettings"]
+__all__ = ["BetaExtractParams", "Excerpts", "FullContent", "FullContentFullContentSettings"]
 
 
 class BetaExtractParams(TypedDict, total=False):
@@ -23,7 +24,7 @@ class BetaExtractParams(TypedDict, total=False):
     redundant with full content.
     """
 
-    fetch_policy: Optional[FetchPolicy]
+    fetch_policy: Optional[FetchPolicyParam]
     """Fetch policy.
 
     Determines when to return content from the cache (faster) vs fetching live
@@ -50,29 +51,6 @@ class BetaExtractParams(TypedDict, total=False):
 Excerpts: TypeAlias = Union[bool, ExcerptSettingsParam]
 
 
-class FetchPolicy(TypedDict, total=False):
-    disable_cache_fallback: bool
-    """
-    If false, fallback to cached content older than max-age if live fetch fails or
-    times out. If true, returns an error instead.
-    """
-
-    max_age_seconds: Optional[int]
-    """Maximum age of cached content in seconds to trigger a live fetch.
-
-    Minimum value 600 seconds (10 minutes). If not provided, a dynamic age policy
-    will be used based on the search objective and url.
-    """
-
-    timeout_seconds: Optional[float]
-    """Timeout in seconds for fetching live content if unavailable in cache.
-
-    If unspecified a dynamic timeout will be used based on the url, generally 15
-    seconds for simple pages and up to 60 seconds for complex pages requiring
-    javascript or PDF rendering.
-    """
-
-
 class FullContentFullContentSettings(TypedDict, total=False):
     max_chars_per_result: Optional[int]
     """

parallel_web-0.3.2/src/parallel/types/beta/fetch_policy_param.py

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+__all__ = ["FetchPolicyParam"]
+
+
+class FetchPolicyParam(TypedDict, total=False):
+    disable_cache_fallback: bool
+    """
+    If false, fallback to cached content older than max-age if live fetch fails or
+    times out. If true, returns an error instead.
+    """
+
+    max_age_seconds: Optional[int]
+    """Maximum age of cached content in seconds to trigger a live fetch.
+
+    Minimum value 600 seconds (10 minutes). If not provided, a dynamic age policy
+    will be used based on the search objective and url.
+    """
+
+    timeout_seconds: Optional[float]
+    """Timeout in seconds for fetching live content if unavailable in cache.
+
+    If unspecified a dynamic timeout will be used based on the url, generally 15
+    seconds for simple pages and up to 60 seconds for complex pages requiring
+    javascript or PDF rendering.
+    """

parallel_web-0.3.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.3.0"
-}