nimble_python 0.9.0__tar.gz → 0.10.0__tar.gz

nimble_python-0.10.0/.release-please-manifest.json

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

{nimble_python-0.9.0 → nimble_python-0.10.0}/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.10.0 (2026-02-25)
+
+Full Changelog: [v0.9.1...v0.10.0](https://github.com/Nimbleway/nimble-python/compare/v0.9.1...v0.10.0)
+
+### Features
+
+* **api:** api update ([65920db](https://github.com/Nimbleway/nimble-python/commit/65920dbd45b01c4e1df31d4961c290a9a885d768))
+
+
+### Chores
+
+* **internal:** add request options to SSE classes ([4c227e5](https://github.com/Nimbleway/nimble-python/commit/4c227e566299f0e680c96d929582b929b04a7b6a))
+* **internal:** make `test_proxy_environment_variables` more resilient ([812a0bc](https://github.com/Nimbleway/nimble-python/commit/812a0bc7beee87efd2d4aadb7b6c9d2848bfc12b))
+* **internal:** make `test_proxy_environment_variables` more resilient to env ([87829ce](https://github.com/Nimbleway/nimble-python/commit/87829ce5f3c87c5d1385755034c9b5b48174e8c7))
+
+## 0.9.1 (2026-02-22)
+
+Full Changelog: [v0.9.0...v0.9.1](https://github.com/Nimbleway/nimble-python/compare/v0.9.0...v0.9.1)
+
+### Chores
+
+* remove custom code ([1ddc742](https://github.com/Nimbleway/nimble-python/commit/1ddc74209b4d8032cf13955cec400f5a6ab84a97))
+
 ## 0.9.0 (2026-02-22)
 
 Full Changelog: [v0.8.0...v0.9.0](https://github.com/Nimbleway/nimble-python/compare/v0.8.0...v0.9.0)

{nimble_python-0.9.0 → nimble_python-0.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nimble_python
-Version: 0.9.0
+Version: 0.10.0
 Summary: The official Python library for the nimble API
 Project-URL: Homepage, https://github.com/Nimbleway/nimble-python
 Project-URL: Repository, https://github.com/Nimbleway/nimble-python

{nimble_python-0.9.0 → nimble_python-0.10.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nimble_python"
-version = "0.9.0"
+version = "0.10.0"
 description = "The official Python library for the nimble API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{nimble_python-0.9.0 → nimble_python-0.10.0}/src/nimble_python/_client.py

@@ -3075,16 +3075,15 @@ class Nimble(SyncAPIClient):
         deep_search: bool | Omit = omit,
         end_date: Optional[str] | Omit = omit,
         exclude_domains: Optional[SequenceNotStr[str]] | Omit = omit,
+        focus: Union[str, SequenceNotStr[str]] | Omit = omit,
         include_answer: bool | Omit = omit,
         include_domains: Optional[SequenceNotStr[str]] | Omit = omit,
         locale: str | Omit = omit,
+        max_results: int | Omit = omit,
         max_subagents: int | Omit = omit,
-        num_results: int | Omit = omit,
-        parsing_type: Literal["plain_text", "markdown", "simplified_html"] | Omit = omit,
-        search_engine: Optional[Literal["google_search", "google_sge", "bing_search", "yandex_search"]] | Omit = omit,
+        output_format: Literal["plain_text", "markdown", "simplified_html"] | Omit = omit,
         start_date: Optional[str] | Omit = omit,
         time_range: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
-        topic: Union[str, SequenceNotStr[str]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -3102,37 +3101,37 @@ class Nimble(SyncAPIClient):
               groups ('documents', 'spreadsheets', 'presentations') and specific formats
               ('pdf', 'docx', 'xlsx', etc.)
 
-          deep_search: If True, fetches and extracts full page content for each search result. If
-              False, returns only metadata (title, snippet, URL)
+          country: Country code for geo-targeted results (e.g., 'US', 'GB', 'IL')
+
+          deep_search: Deep Mode (true, default): fetches full-page content for deeper analysis. Fast
+              Mode (false): returns metadata only (title, snippet, URL) for quick,
+              token-efficient results.
 
           end_date: Filter results before this date (format: YYYY-MM-DD or YYYY)
 
           exclude_domains: List of domains to exclude from search results. Maximum 50 domains.
 
-          include_answer: Generate LLM answer summary based on search result snippets (works with both
-              deep_search=True and False)
+          focus: Search focus mode (e.g., 'general', 'news', 'shopping') or a list of explicit
+              subagent names (e.g., ['amazon_serp', 'target_serp'])
+
+          include_answer: Generate an LLM-powered answer summary based on search result snippets.
 
           include_domains: List of domains to include in search results. Maximum 50 domains.
 
-          max_subagents: Maximum number of subagents to execute in parallel for WSA focus modes
-              (shopping, social, geo). Ignored for traditional SERP focus modes. Default: 3,
-              Range: 1-10.
+          locale: Language/locale code (e.g., 'en', 'fr', 'de')
 
-          num_results: Maximum number of results to return (actual count may be less)
+          max_results: Maximum number of results to return. Actual count may be lower depending on
+              availability.
 
-          parsing_type: Output format: plain_text, markdown, or simplified_html
+          max_subagents: Maximum number of subagents to execute in parallel for WSA focus modes
+              (shopping, social, geo). Ignored for SERP focus modes.
 
-          search_engine: Enum representing the search engines supported by Nimble ⚠️ DEPRECATED: This
-              parameter is ignored. Use 'focus' parameter instead.
+          output_format: Output format: plain_text, markdown, or simplified_html
 
           start_date: Filter results after this date (format: YYYY-MM-DD or YYYY)
 
           time_range: Time range filters passed to Webit SERP API as 'time' parameter.
 
-          topic: Search focus/specialization. Can be a single focus mode (e.g., 'shopping',
-              'social') or a list of explicit subagent names (e.g., ['amazon_serp',
-              'target_serp'])
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -3151,16 +3150,15 @@ class Nimble(SyncAPIClient):
                     "deep_search": deep_search,
                     "end_date": end_date,
                     "exclude_domains": exclude_domains,
+                    "focus": focus,
                     "include_answer": include_answer,
                     "include_domains": include_domains,
                     "locale": locale,
+                    "max_results": max_results,
                     "max_subagents": max_subagents,
-                    "num_results": num_results,
-                    "parsing_type": parsing_type,
-                    "search_engine": search_engine,
+                    "output_format": output_format,
                     "start_date": start_date,
                     "time_range": time_range,
-                    "topic": topic,
                 },
                 client_search_params.ClientSearchParams,
             ),
@@ -6218,16 +6216,15 @@ class AsyncNimble(AsyncAPIClient):
         deep_search: bool | Omit = omit,
         end_date: Optional[str] | Omit = omit,
         exclude_domains: Optional[SequenceNotStr[str]] | Omit = omit,
+        focus: Union[str, SequenceNotStr[str]] | Omit = omit,
         include_answer: bool | Omit = omit,
         include_domains: Optional[SequenceNotStr[str]] | Omit = omit,
         locale: str | Omit = omit,
+        max_results: int | Omit = omit,
         max_subagents: int | Omit = omit,
-        num_results: int | Omit = omit,
-        parsing_type: Literal["plain_text", "markdown", "simplified_html"] | Omit = omit,
-        search_engine: Optional[Literal["google_search", "google_sge", "bing_search", "yandex_search"]] | Omit = omit,
+        output_format: Literal["plain_text", "markdown", "simplified_html"] | Omit = omit,
         start_date: Optional[str] | Omit = omit,
         time_range: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
-        topic: Union[str, SequenceNotStr[str]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -6245,37 +6242,37 @@ class AsyncNimble(AsyncAPIClient):
               groups ('documents', 'spreadsheets', 'presentations') and specific formats
               ('pdf', 'docx', 'xlsx', etc.)
 
-          deep_search: If True, fetches and extracts full page content for each search result. If
-              False, returns only metadata (title, snippet, URL)
+          country: Country code for geo-targeted results (e.g., 'US', 'GB', 'IL')
+
+          deep_search: Deep Mode (true, default): fetches full-page content for deeper analysis. Fast
+              Mode (false): returns metadata only (title, snippet, URL) for quick,
+              token-efficient results.
 
           end_date: Filter results before this date (format: YYYY-MM-DD or YYYY)
 
           exclude_domains: List of domains to exclude from search results. Maximum 50 domains.
 
-          include_answer: Generate LLM answer summary based on search result snippets (works with both
-              deep_search=True and False)
+          focus: Search focus mode (e.g., 'general', 'news', 'shopping') or a list of explicit
+              subagent names (e.g., ['amazon_serp', 'target_serp'])
+
+          include_answer: Generate an LLM-powered answer summary based on search result snippets.
 
           include_domains: List of domains to include in search results. Maximum 50 domains.
 
-          max_subagents: Maximum number of subagents to execute in parallel for WSA focus modes
-              (shopping, social, geo). Ignored for traditional SERP focus modes. Default: 3,
-              Range: 1-10.
+          locale: Language/locale code (e.g., 'en', 'fr', 'de')
 
-          num_results: Maximum number of results to return (actual count may be less)
+          max_results: Maximum number of results to return. Actual count may be lower depending on
+              availability.
 
-          parsing_type: Output format: plain_text, markdown, or simplified_html
+          max_subagents: Maximum number of subagents to execute in parallel for WSA focus modes
+              (shopping, social, geo). Ignored for SERP focus modes.
 
-          search_engine: Enum representing the search engines supported by Nimble ⚠️ DEPRECATED: This
-              parameter is ignored. Use 'focus' parameter instead.
+          output_format: Output format: plain_text, markdown, or simplified_html
 
           start_date: Filter results after this date (format: YYYY-MM-DD or YYYY)
 
           time_range: Time range filters passed to Webit SERP API as 'time' parameter.
 
-          topic: Search focus/specialization. Can be a single focus mode (e.g., 'shopping',
-              'social') or a list of explicit subagent names (e.g., ['amazon_serp',
-              'target_serp'])
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -6294,16 +6291,15 @@ class AsyncNimble(AsyncAPIClient):
                     "deep_search": deep_search,
                     "end_date": end_date,
                     "exclude_domains": exclude_domains,
+                    "focus": focus,
                     "include_answer": include_answer,
                     "include_domains": include_domains,
                     "locale": locale,
+                    "max_results": max_results,
                     "max_subagents": max_subagents,
-                    "num_results": num_results,
-                    "parsing_type": parsing_type,
-                    "search_engine": search_engine,
+                    "output_format": output_format,
                     "start_date": start_date,
                     "time_range": time_range,
-                    "topic": topic,
                 },
                 client_search_params.ClientSearchParams,
             ),

{nimble_python-0.9.0 → nimble_python-0.10.0}/src/nimble_python/_response.py

@@ -152,6 +152,7 @@ class BaseAPIResponse(Generic[R]):
                         ),
                         response=self.http_response,
                         client=cast(Any, self._client),
+                        options=self._options,
                     ),
                 )
 
@@ -162,6 +163,7 @@ class BaseAPIResponse(Generic[R]):
                         cast_to=extract_stream_chunk_type(self._stream_cls),
                         response=self.http_response,
                         client=cast(Any, self._client),
+                        options=self._options,
                     ),
                 )
 
@@ -175,6 +177,7 @@ class BaseAPIResponse(Generic[R]):
                     cast_to=cast_to,
                     response=self.http_response,
                     client=cast(Any, self._client),
+                    options=self._options,
                 ),
             )
 

{nimble_python-0.9.0 → nimble_python-0.10.0}/src/nimble_python/_streaming.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 import json
 import inspect
 from types import TracebackType
-from typing import TYPE_CHECKING, Any, Generic, TypeVar, Iterator, AsyncIterator, cast
+from typing import TYPE_CHECKING, Any, Generic, TypeVar, Iterator, Optional, AsyncIterator, cast
 from typing_extensions import Self, Protocol, TypeGuard, override, get_origin, runtime_checkable
 
 import httpx
@@ -13,6 +13,7 @@ from ._utils import extract_type_var_from_base
 
 if TYPE_CHECKING:
     from ._client import Nimble, AsyncNimble
+    from ._models import FinalRequestOptions
 
 
 _T = TypeVar("_T")
@@ -22,7 +23,7 @@ class Stream(Generic[_T]):
     """Provides the core interface to iterate over a synchronous stream response."""
 
     response: httpx.Response
-
+    _options: Optional[FinalRequestOptions] = None
     _decoder: SSEBytesDecoder
 
     def __init__(
@@ -31,10 +32,12 @@ class Stream(Generic[_T]):
         cast_to: type[_T],
         response: httpx.Response,
         client: Nimble,
+        options: Optional[FinalRequestOptions] = None,
     ) -> None:
         self.response = response
         self._cast_to = cast_to
         self._client = client
+        self._options = options
         self._decoder = client._make_sse_decoder()
         self._iterator = self.__stream__()
 
@@ -85,7 +88,7 @@ class AsyncStream(Generic[_T]):
     """Provides the core interface to iterate over an asynchronous stream response."""
 
     response: httpx.Response
-
+    _options: Optional[FinalRequestOptions] = None
     _decoder: SSEDecoder | SSEBytesDecoder
 
     def __init__(
@@ -94,10 +97,12 @@ class AsyncStream(Generic[_T]):
         cast_to: type[_T],
         response: httpx.Response,
         client: AsyncNimble,
+        options: Optional[FinalRequestOptions] = None,
     ) -> None:
         self.response = response
         self._cast_to = cast_to
         self._client = client
+        self._options = options
         self._decoder = client._make_sse_decoder()
         self._iterator = self.__stream__()
 

{nimble_python-0.9.0 → nimble_python-0.10.0}/src/nimble_python/_version.py

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