google-developer-knowledge 0.1.0__tar.gz → 0.1.1__tar.gz

{google_developer_knowledge-0.1.0/google_developer_knowledge.egg-info → google_developer_knowledge-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-developer-knowledge
-Version: 0.1.0
+Version: 0.1.1
 Summary: Google Developer Knowledge API client library
 Home-page: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-developer-knowledge
 Author: Google LLC
@@ -21,13 +21,12 @@ Classifier: Operating System :: OS Independent
 Classifier: Topic :: Internet
 Requires-Python: >=3.10
 License-File: LICENSE
-Requires-Dist: google-api-core[grpc]<3.0.0,>=2.17.1
+Requires-Dist: google-api-core[grpc]<3.0.0,>=2.25.0
 Requires-Dist: google-auth!=2.24.0,!=2.25.0,<3.0.0,>=2.14.1
 Requires-Dist: grpcio<2.0.0,>=1.59.0
 Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14"
-Requires-Dist: proto-plus<2.0.0,>=1.22.3
-Requires-Dist: proto-plus<2.0.0,>=1.25.0; python_version >= "3.13"
-Requires-Dist: protobuf<8.0.0,>=4.25.8
+Requires-Dist: proto-plus<2.0.0,>=1.26.1
+Requires-Dist: protobuf<8.0.0,>=6.33.5
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier

{google_developer_knowledge-0.1.0 → google_developer_knowledge-0.1.1}/google/developer_knowledge/__init__.py

@@ -25,6 +25,9 @@ from google.developer_knowledge_v1.services.developer_knowledge.client import (
     DeveloperKnowledgeClient,
 )
 from google.developer_knowledge_v1.types.developerknowledge import (
+    Answer,
+    AnswerQueryRequest,
+    AnswerQueryResponse,
     BatchGetDocumentsRequest,
     BatchGetDocumentsResponse,
     Document,
@@ -38,6 +41,9 @@ from google.developer_knowledge_v1.types.developerknowledge import (
 __all__ = (
     "DeveloperKnowledgeClient",
     "DeveloperKnowledgeAsyncClient",
+    "Answer",
+    "AnswerQueryRequest",
+    "AnswerQueryResponse",
     "BatchGetDocumentsRequest",
     "BatchGetDocumentsResponse",
     "Document",

{google_developer_knowledge-0.1.0 → google_developer_knowledge-0.1.1}/google/developer_knowledge/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.1.0"  # {x-release-please-version}
+__version__ = "0.1.1"  # {x-release-please-version}

{google_developer_knowledge-0.1.0 → google_developer_knowledge-0.1.1}/google/developer_knowledge_v1/__init__.py

@@ -23,11 +23,26 @@ __version__ = package_version.__version__
 
 from importlib import metadata
 
+# PEP 0810: Explicit Lazy Imports
+# Python 3.15+ natively intercepts and defers these imports.
+# Developers can disable this behavior and force eager imports.
+# For more information, see:
+# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter
+# Older Python versions safely ignore this variable.
+__lazy_modules__ = {
+    "google.developer_knowledge_v1.services.developer_knowledge",
+    "google.developer_knowledge_v1.types.developerknowledge",
+}
+
+
 from .services.developer_knowledge import (
     DeveloperKnowledgeAsyncClient,
     DeveloperKnowledgeClient,
 )
 from .types.developerknowledge import (
+    Answer,
+    AnswerQueryRequest,
+    AnswerQueryResponse,
     BatchGetDocumentsRequest,
     BatchGetDocumentsResponse,
     Document,
@@ -63,7 +78,7 @@ else:  # pragma: NO COVER
 
         def parse_version_to_tuple(version_string: str):
             """Safely converts a semantic version string to a comparable tuple of integers.
-            Example: "4.25.8" -> (4, 25, 8)
+            Example: "6.33.5" -> (6, 33, 5)
             Ignores non-numeric parts and handles common version formats.
             Args:
                 version_string: Version string in the format "x.y.z" or "x.y.z<suffix>"
@@ -92,9 +107,9 @@ else:  # pragma: NO COVER
                 return (None, "--")
 
         _dependency_package = "google.protobuf"
-        _next_supported_version = "4.25.8"
-        _next_supported_version_tuple = (4, 25, 8)
-        _recommendation = " (we recommend 6.x)"
+        _next_supported_version = "6.33.5"
+        _next_supported_version_tuple = (6, 33, 5)
+        _recommendation = " (we recommend 7.x)"
         (_version_used, _version_used_string) = _get_version(_dependency_package)
         if _version_used and _version_used < _next_supported_version_tuple:
             warnings.warn(
@@ -123,6 +138,9 @@ else:  # pragma: NO COVER
 
 __all__ = (
     "DeveloperKnowledgeAsyncClient",
+    "Answer",
+    "AnswerQueryRequest",
+    "AnswerQueryResponse",
     "BatchGetDocumentsRequest",
     "BatchGetDocumentsResponse",
     "DeveloperKnowledgeClient",

{google_developer_knowledge-0.1.0 → google_developer_knowledge-0.1.1}/google/developer_knowledge_v1/gapic_metadata.json

@@ -10,6 +10,11 @@
         "grpc": {
           "libraryClient": "DeveloperKnowledgeClient",
           "rpcs": {
+            "AnswerQuery": {
+              "methods": [
+                "answer_query"
+              ]
+            },
             "BatchGetDocuments": {
               "methods": [
                 "batch_get_documents"
@@ -30,6 +35,11 @@
         "grpc-async": {
           "libraryClient": "DeveloperKnowledgeAsyncClient",
           "rpcs": {
+            "AnswerQuery": {
+              "methods": [
+                "answer_query"
+              ]
+            },
             "BatchGetDocuments": {
               "methods": [
                 "batch_get_documents"
@@ -50,6 +60,11 @@
         "rest": {
           "libraryClient": "DeveloperKnowledgeClient",
           "rpcs": {
+            "AnswerQuery": {
+              "methods": [
+                "answer_query"
+              ]
+            },
             "BatchGetDocuments": {
               "methods": [
                 "batch_get_documents"

{google_developer_knowledge-0.1.0 → google_developer_knowledge-0.1.1}/google/developer_knowledge_v1/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.1.0"  # {x-release-please-version}
+__version__ = "0.1.1"  # {x-release-please-version}

{google_developer_knowledge-0.1.0 → google_developer_knowledge-0.1.1}/google/developer_knowledge_v1/services/developer_knowledge/async_client.py

@@ -624,6 +624,86 @@ class DeveloperKnowledgeAsyncClient:
         # Done; return the response.
         return response
 
+    async def answer_query(
+        self,
+        request: Optional[Union[developerknowledge.AnswerQueryRequest, dict]] = None,
+        *,
+        retry: OptionalRetry = gapic_v1.method.DEFAULT,
+        timeout: Union[float, object] = gapic_v1.method.DEFAULT,
+        metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
+    ) -> developerknowledge.AnswerQueryResponse:
+        r"""Answers a query using grounded generation.
+
+        .. code-block:: python
+
+            # This snippet has been automatically generated and should be regarded as a
+            # code template only.
+            # It will require modifications to work:
+            # - It may require correct/in-range values for request initialization.
+            # - It may require specifying regional endpoints when creating the service
+            #   client as shown in:
+            #   https://googleapis.dev/python/google-api-core/latest/client_options.html
+            from google import developer_knowledge_v1
+
+            async def sample_answer_query():
+                # Create a client
+                client = developer_knowledge_v1.DeveloperKnowledgeAsyncClient()
+
+                # Initialize request argument(s)
+                request = developer_knowledge_v1.AnswerQueryRequest(
+                    query="query_value",
+                )
+
+                # Make the request
+                response = await client.answer_query(request=request)
+
+                # Handle the response
+                print(response)
+
+        Args:
+            request (Optional[Union[google.developer_knowledge_v1.types.AnswerQueryRequest, dict]]):
+                The request object. Request message for
+                [DeveloperKnowledge.AnswerQuery][google.developers.knowledge.v1.DeveloperKnowledge.AnswerQuery].
+            retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any,
+                should be retried.
+            timeout (float): The timeout for this request.
+            metadata (Sequence[Tuple[str, Union[str, bytes]]]): Key/value pairs which should be
+                sent along with the request as metadata. Normally, each value must be of type `str`,
+                but for metadata keys ending with the suffix `-bin`, the corresponding values must
+                be of type `bytes`.
+
+        Returns:
+            google.developer_knowledge_v1.types.AnswerQueryResponse:
+                Response message for
+                   [DeveloperKnowledge.AnswerQuery][google.developers.knowledge.v1.DeveloperKnowledge.AnswerQuery].
+
+        """
+        # Create or coerce a protobuf request object.
+        # - Use the request object if provided (there's no risk of modifying the input as
+        #   there are no flattened fields), or create one.
+        if not isinstance(request, developerknowledge.AnswerQueryRequest):
+            request = developerknowledge.AnswerQueryRequest(request)
+
+        # Wrap the RPC method; this adds retry and timeout information,
+        # and friendly error handling.
+        rpc = self._client._transport._wrapped_methods[
+            self._client._transport.answer_query
+        ]
+
+        # Validate the universe domain.
+        self._client._validate_universe_domain()
+
+        # Send the request.
+        response = await rpc(
+            request,
+            retry=retry,
+            timeout=timeout,
+            metadata=metadata,
+        )
+
+        # Done; return the response.
+        return response
+
     async def __aenter__(self) -> "DeveloperKnowledgeAsyncClient":
         return self
 
@@ -634,9 +714,7 @@ class DeveloperKnowledgeAsyncClient:
 DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo(
     gapic_version=package_version.__version__
 )
-
-if hasattr(DEFAULT_CLIENT_INFO, "protobuf_runtime_version"):  # pragma: NO COVER
-    DEFAULT_CLIENT_INFO.protobuf_runtime_version = google.protobuf.__version__
+DEFAULT_CLIENT_INFO.protobuf_runtime_version = google.protobuf.__version__
 
 
 __all__ = ("DeveloperKnowledgeAsyncClient",)

{google_developer_knowledge-0.1.0 → google_developer_knowledge-0.1.1}/google/developer_knowledge_v1/services/developer_knowledge/client.py

@@ -1043,6 +1043,84 @@ class DeveloperKnowledgeClient(metaclass=DeveloperKnowledgeClientMeta):
         # Done; return the response.
         return response
 
+    def answer_query(
+        self,
+        request: Optional[Union[developerknowledge.AnswerQueryRequest, dict]] = None,
+        *,
+        retry: OptionalRetry = gapic_v1.method.DEFAULT,
+        timeout: Union[float, object] = gapic_v1.method.DEFAULT,
+        metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
+    ) -> developerknowledge.AnswerQueryResponse:
+        r"""Answers a query using grounded generation.
+
+        .. code-block:: python
+
+            # This snippet has been automatically generated and should be regarded as a
+            # code template only.
+            # It will require modifications to work:
+            # - It may require correct/in-range values for request initialization.
+            # - It may require specifying regional endpoints when creating the service
+            #   client as shown in:
+            #   https://googleapis.dev/python/google-api-core/latest/client_options.html
+            from google import developer_knowledge_v1
+
+            def sample_answer_query():
+                # Create a client
+                client = developer_knowledge_v1.DeveloperKnowledgeClient()
+
+                # Initialize request argument(s)
+                request = developer_knowledge_v1.AnswerQueryRequest(
+                    query="query_value",
+                )
+
+                # Make the request
+                response = client.answer_query(request=request)
+
+                # Handle the response
+                print(response)
+
+        Args:
+            request (Union[google.developer_knowledge_v1.types.AnswerQueryRequest, dict]):
+                The request object. Request message for
+                [DeveloperKnowledge.AnswerQuery][google.developers.knowledge.v1.DeveloperKnowledge.AnswerQuery].
+            retry (google.api_core.retry.Retry): Designation of what errors, if any,
+                should be retried.
+            timeout (float): The timeout for this request.
+            metadata (Sequence[Tuple[str, Union[str, bytes]]]): Key/value pairs which should be
+                sent along with the request as metadata. Normally, each value must be of type `str`,
+                but for metadata keys ending with the suffix `-bin`, the corresponding values must
+                be of type `bytes`.
+
+        Returns:
+            google.developer_knowledge_v1.types.AnswerQueryResponse:
+                Response message for
+                   [DeveloperKnowledge.AnswerQuery][google.developers.knowledge.v1.DeveloperKnowledge.AnswerQuery].
+
+        """
+        # Create or coerce a protobuf request object.
+        # - Use the request object if provided (there's no risk of modifying the input as
+        #   there are no flattened fields), or create one.
+        if not isinstance(request, developerknowledge.AnswerQueryRequest):
+            request = developerknowledge.AnswerQueryRequest(request)
+
+        # Wrap the RPC method; this adds retry and timeout information,
+        # and friendly error handling.
+        rpc = self._transport._wrapped_methods[self._transport.answer_query]
+
+        # Validate the universe domain.
+        self._validate_universe_domain()
+
+        # Send the request.
+        response = rpc(
+            request,
+            retry=retry,
+            timeout=timeout,
+            metadata=metadata,
+        )
+
+        # Done; return the response.
+        return response
+
     def __enter__(self) -> "DeveloperKnowledgeClient":
         return self
 
@@ -1060,8 +1138,6 @@ class DeveloperKnowledgeClient(metaclass=DeveloperKnowledgeClientMeta):
 DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo(
     gapic_version=package_version.__version__
 )
-
-if hasattr(DEFAULT_CLIENT_INFO, "protobuf_runtime_version"):  # pragma: NO COVER
-    DEFAULT_CLIENT_INFO.protobuf_runtime_version = google.protobuf.__version__
+DEFAULT_CLIENT_INFO.protobuf_runtime_version = google.protobuf.__version__
 
 __all__ = ("DeveloperKnowledgeClient",)

{google_developer_knowledge-0.1.0 → google_developer_knowledge-0.1.1}/google/developer_knowledge_v1/services/developer_knowledge/transports/base.py

@@ -31,9 +31,7 @@ from google.developer_knowledge_v1.types import developerknowledge
 DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo(
     gapic_version=package_version.__version__
 )
-
-if hasattr(DEFAULT_CLIENT_INFO, "protobuf_runtime_version"):  # pragma: NO COVER
-    DEFAULT_CLIENT_INFO.protobuf_runtime_version = google.protobuf.__version__
+DEFAULT_CLIENT_INFO.protobuf_runtime_version = google.protobuf.__version__
 
 
 class DeveloperKnowledgeTransport(abc.ABC):
@@ -175,6 +173,11 @@ class DeveloperKnowledgeTransport(abc.ABC):
                 default_timeout=60.0,
                 client_info=client_info,
             ),
+            self.answer_query: gapic_v1.method.wrap_method(
+                self.answer_query,
+                default_timeout=None,
+                client_info=client_info,
+            ),
         }
 
     def close(self):
@@ -219,6 +222,18 @@ class DeveloperKnowledgeTransport(abc.ABC):
     ]:
         raise NotImplementedError()
 
+    @property
+    def answer_query(
+        self,
+    ) -> Callable[
+        [developerknowledge.AnswerQueryRequest],
+        Union[
+            developerknowledge.AnswerQueryResponse,
+            Awaitable[developerknowledge.AnswerQueryResponse],
+        ],
+    ]:
+        raise NotImplementedError()
+
     @property
     def kind(self) -> str:
         raise NotImplementedError()

{google_developer_knowledge-0.1.0 → google_developer_knowledge-0.1.1}/google/developer_knowledge_v1/services/developer_knowledge/transports/grpc.py

@@ -438,6 +438,34 @@ class DeveloperKnowledgeGrpcTransport(DeveloperKnowledgeTransport):
             )
         return self._stubs["batch_get_documents"]
 
+    @property
+    def answer_query(
+        self,
+    ) -> Callable[
+        [developerknowledge.AnswerQueryRequest], developerknowledge.AnswerQueryResponse
+    ]:
+        r"""Return a callable for the answer query method over gRPC.
+
+        Answers a query using grounded generation.
+
+        Returns:
+            Callable[[~.AnswerQueryRequest],
+                    ~.AnswerQueryResponse]:
+                A function that, when called, will call the underlying RPC
+                on the server.
+        """
+        # Generate a "stub function" on-the-fly which will actually make
+        # the request.
+        # gRPC handles serialization and deserialization, so we just need
+        # to pass in the functions for each.
+        if "answer_query" not in self._stubs:
+            self._stubs["answer_query"] = self._logged_channel.unary_unary(
+                "/google.developers.knowledge.v1.DeveloperKnowledge/AnswerQuery",
+                request_serializer=developerknowledge.AnswerQueryRequest.serialize,
+                response_deserializer=developerknowledge.AnswerQueryResponse.deserialize,
+            )
+        return self._stubs["answer_query"]
+
     def close(self):
         self._logged_channel.close()
 

{google_developer_knowledge-0.1.0 → google_developer_knowledge-0.1.1}/google/developer_knowledge_v1/services/developer_knowledge/transports/grpc_asyncio.py

@@ -448,6 +448,35 @@ class DeveloperKnowledgeGrpcAsyncIOTransport(DeveloperKnowledgeTransport):
             )
         return self._stubs["batch_get_documents"]
 
+    @property
+    def answer_query(
+        self,
+    ) -> Callable[
+        [developerknowledge.AnswerQueryRequest],
+        Awaitable[developerknowledge.AnswerQueryResponse],
+    ]:
+        r"""Return a callable for the answer query method over gRPC.
+
+        Answers a query using grounded generation.
+
+        Returns:
+            Callable[[~.AnswerQueryRequest],
+                    Awaitable[~.AnswerQueryResponse]]:
+                A function that, when called, will call the underlying RPC
+                on the server.
+        """
+        # Generate a "stub function" on-the-fly which will actually make
+        # the request.
+        # gRPC handles serialization and deserialization, so we just need
+        # to pass in the functions for each.
+        if "answer_query" not in self._stubs:
+            self._stubs["answer_query"] = self._logged_channel.unary_unary(
+                "/google.developers.knowledge.v1.DeveloperKnowledge/AnswerQuery",
+                request_serializer=developerknowledge.AnswerQueryRequest.serialize,
+                response_deserializer=developerknowledge.AnswerQueryResponse.deserialize,
+            )
+        return self._stubs["answer_query"]
+
     def _prep_wrapped_messages(self, client_info):
         """Precompute the wrapped methods, overriding the base class method to use async wrappers."""
         self._wrapped_methods = {
@@ -484,6 +513,11 @@ class DeveloperKnowledgeGrpcAsyncIOTransport(DeveloperKnowledgeTransport):
                 default_timeout=60.0,
                 client_info=client_info,
             ),
+            self.answer_query: self._wrap_method(
+                self.answer_query,
+                default_timeout=None,
+                client_info=client_info,
+            ),
         }
 
     def _wrap_method(self, func, *args, **kwargs):