google-cloud-securesourcemanager 0.1.14__tar.gz → 0.1.16__tar.gz

google_cloud_securesourcemanager-0.1.16/MANIFEST.in

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+include README.rst LICENSE
+recursive-include google *.py *.pyi *.json *.proto py.typed
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__

{google_cloud_securesourcemanager-0.1.14/google_cloud_securesourcemanager.egg-info → google_cloud_securesourcemanager-0.1.16}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: google-cloud-securesourcemanager
-Version: 0.1.14
+Version: 0.1.16
 Summary: Google Cloud Securesourcemanager API client library
 Home-page: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-securesourcemanager
 Author: Google LLC
@@ -23,12 +23,23 @@ Classifier: Operating System :: OS Independent
 Classifier: Topic :: Internet
 Requires-Python: >=3.7
 License-File: LICENSE
-Requires-Dist: google-api-core[grpc]!=2.0.*,!=2.1.*,!=2.10.*,!=2.2.*,!=2.3.*,!=2.4.*,!=2.5.*,!=2.6.*,!=2.7.*,!=2.8.*,!=2.9.*,<3.0.0dev,>=1.34.1
-Requires-Dist: google-auth!=2.24.0,!=2.25.0,<3.0.0dev,>=2.14.1
-Requires-Dist: proto-plus<2.0.0dev,>=1.22.3
-Requires-Dist: proto-plus<2.0.0dev,>=1.25.0; python_version >= "3.13"
-Requires-Dist: protobuf!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5,<6.0.0dev,>=3.20.2
-Requires-Dist: grpc-google-iam-v1<1.0.0dev,>=0.14.0
+Requires-Dist: google-api-core[grpc]!=2.0.*,!=2.1.*,!=2.10.*,!=2.2.*,!=2.3.*,!=2.4.*,!=2.5.*,!=2.6.*,!=2.7.*,!=2.8.*,!=2.9.*,<3.0.0,>=1.34.1
+Requires-Dist: google-auth!=2.24.0,!=2.25.0,<3.0.0,>=2.14.1
+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!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5,<7.0.0,>=3.20.2
+Requires-Dist: grpc-google-iam-v1<1.0.0,>=0.14.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: platform
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 Python Client for Secure Source Manager API
 ===========================================
@@ -138,3 +149,92 @@ Next Steps
 
 .. _Secure Source Manager API Product documentation:  https://cloud.google.com/secure-source-manager/docs/overview
 .. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
+
+Logging
+-------
+
+This library uses the standard Python :code:`logging` functionality to log some RPC events that could be of interest for debugging and monitoring purposes.
+Note the following:
+
+#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or on Google Cloud Logging.
+#. Google may refine the occurrence, level, and content of various log messages in this library without flagging such changes as breaking. **Do not depend on immutability of the logging events**.
+#. By default, the logging events from this library are not handled. You must **explicitly configure log handling** using one of the mechanisms below.
+
+Simple, environment-based configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To enable logging for this library without any changes in your code, set the :code:`GOOGLE_SDK_PYTHON_LOGGING_SCOPE` environment variable to a valid Google
+logging scope. This configures handling of logging events (at level :code:`logging.DEBUG` or higher) from this library in a default manner, emitting the logged
+messages in a structured format. It does not currently allow customizing the logging levels captured nor the handlers, formatters, etc. used for any logging
+event.
+
+A logging scope is a period-separated namespace that begins with :code:`google`, identifying the Python module or package to log.
+
+- Valid logging scopes: :code:`google`, :code:`google.cloud.asset.v1`, :code:`google.api`, :code:`google.auth`, etc.
+- Invalid logging scopes: :code:`foo`, :code:`123`, etc.
+
+**NOTE**: If the logging scope is invalid, the library does not set up any logging handlers.
+
+Environment-Based Examples
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+- Enabling the default handler for all Google-based loggers
+
+.. code-block:: console
+
+    export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
+
+- Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
+
+.. code-block:: console
+
+    export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google.cloud.library_v1
+
+
+Advanced, code-based configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can also configure a valid logging scope using Python's standard `logging` mechanism.
+
+Code-Based Examples
+^^^^^^^^^^^^^^^^^^^
+
+- Configuring a handler for all Google-based loggers
+
+.. code-block:: python
+
+    import logging
+    
+    from google.cloud import library_v1
+    
+    base_logger = logging.getLogger("google")
+    base_logger.addHandler(logging.StreamHandler())
+    base_logger.setLevel(logging.DEBUG)
+
+- Configuring a handler for a specific Google module (for a client library called :code:`library_v1`):
+
+.. code-block:: python
+
+    import logging
+    
+    from google.cloud import library_v1
+    
+    base_logger = logging.getLogger("google.cloud.library_v1")
+    base_logger.addHandler(logging.StreamHandler())
+    base_logger.setLevel(logging.DEBUG)
+
+Logging details
+~~~~~~~~~~~~~~~
+
+#. Regardless of which of the mechanisms above you use to configure logging for this library, by default logging events are not propagated up to the root
+   logger from the `google`-level logger. If you need the events to be propagated to the root logger, you must explicitly set
+   :code:`logging.getLogger("google").propagate = True` in your code.
+#. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
+   one library, but decide you need to also set up environment-based logging configuration for another library.
+
+   #. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
+      if the code -based configuration gets applied first.
+
+#. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
+   executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.
+   (This is the reason for 2.i. above.)

google_cloud_securesourcemanager-0.1.16/README.rst

@@ -0,0 +1,197 @@
+Python Client for Secure Source Manager API
+===========================================
+
+|preview| |pypi| |versions|
+
+`Secure Source Manager API`_: Regionally deployed, single-tenant managed source code repository hosted on Google Cloud.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |preview| image:: https://img.shields.io/badge/support-preview-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#stability-levels
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-securesourcemanager.svg
+   :target: https://pypi.org/project/google-cloud-securesourcemanager/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-securesourcemanager.svg
+   :target: https://pypi.org/project/google-cloud-securesourcemanager/
+.. _Secure Source Manager API: https://cloud.google.com/secure-source-manager/docs/overview
+.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/securesourcemanager/latest/summary_overview
+.. _Product Documentation:  https://cloud.google.com/secure-source-manager/docs/overview
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Secure Source Manager API.`_
+4. `Set up Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Secure Source Manager API.:  https://cloud.google.com/secure-source-manager/docs/overview
+.. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a virtual environment using `venv`_. `venv`_ is a tool that
+creates isolated Python environments. These isolated environments can have separate
+versions of Python packages, which allows you to isolate one project's dependencies
+from the dependencies of other projects.
+
+With `venv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`venv`: https://docs.python.org/3/library/venv.html
+
+
+Code samples and snippets
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Code samples and snippets live in the `samples/`_ folder.
+
+.. _samples/: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-securesourcemanager/samples
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
+Python.
+
+Python >= 3.7
+
+.. _active: https://devguide.python.org/devcycle/#in-development-main-branch
+.. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
+
+Unsupported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python <= 3.6
+
+If you are using an `end-of-life`_
+version of Python, we recommend that you update as soon as possible to an actively supported version.
+
+.. _end-of-life: https://devguide.python.org/devcycle/#end-of-life-branches
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    python3 -m venv <your-env>
+    source <your-env>/bin/activate
+    pip install google-cloud-securesourcemanager
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    py -m venv <your-env>
+    .\<your-env>\Scripts\activate
+    pip install google-cloud-securesourcemanager
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Secure Source Manager API
+   to see other available methods on the client.
+-  Read the `Secure Source Manager API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _Secure Source Manager API Product documentation:  https://cloud.google.com/secure-source-manager/docs/overview
+.. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
+
+Logging
+-------
+
+This library uses the standard Python :code:`logging` functionality to log some RPC events that could be of interest for debugging and monitoring purposes.
+Note the following:
+
+#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or on Google Cloud Logging.
+#. Google may refine the occurrence, level, and content of various log messages in this library without flagging such changes as breaking. **Do not depend on immutability of the logging events**.
+#. By default, the logging events from this library are not handled. You must **explicitly configure log handling** using one of the mechanisms below.
+
+Simple, environment-based configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To enable logging for this library without any changes in your code, set the :code:`GOOGLE_SDK_PYTHON_LOGGING_SCOPE` environment variable to a valid Google
+logging scope. This configures handling of logging events (at level :code:`logging.DEBUG` or higher) from this library in a default manner, emitting the logged
+messages in a structured format. It does not currently allow customizing the logging levels captured nor the handlers, formatters, etc. used for any logging
+event.
+
+A logging scope is a period-separated namespace that begins with :code:`google`, identifying the Python module or package to log.
+
+- Valid logging scopes: :code:`google`, :code:`google.cloud.asset.v1`, :code:`google.api`, :code:`google.auth`, etc.
+- Invalid logging scopes: :code:`foo`, :code:`123`, etc.
+
+**NOTE**: If the logging scope is invalid, the library does not set up any logging handlers.
+
+Environment-Based Examples
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+- Enabling the default handler for all Google-based loggers
+
+.. code-block:: console
+
+    export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
+
+- Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
+
+.. code-block:: console
+
+    export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google.cloud.library_v1
+
+
+Advanced, code-based configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can also configure a valid logging scope using Python's standard `logging` mechanism.
+
+Code-Based Examples
+^^^^^^^^^^^^^^^^^^^
+
+- Configuring a handler for all Google-based loggers
+
+.. code-block:: python
+
+    import logging
+    
+    from google.cloud import library_v1
+    
+    base_logger = logging.getLogger("google")
+    base_logger.addHandler(logging.StreamHandler())
+    base_logger.setLevel(logging.DEBUG)
+
+- Configuring a handler for a specific Google module (for a client library called :code:`library_v1`):
+
+.. code-block:: python
+
+    import logging
+    
+    from google.cloud import library_v1
+    
+    base_logger = logging.getLogger("google.cloud.library_v1")
+    base_logger.addHandler(logging.StreamHandler())
+    base_logger.setLevel(logging.DEBUG)
+
+Logging details
+~~~~~~~~~~~~~~~
+
+#. Regardless of which of the mechanisms above you use to configure logging for this library, by default logging events are not propagated up to the root
+   logger from the `google`-level logger. If you need the events to be propagated to the root logger, you must explicitly set
+   :code:`logging.getLogger("google").propagate = True` in your code.
+#. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
+   one library, but decide you need to also set up environment-based logging configuration for another library.
+
+   #. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
+      if the code -based configuration gets applied first.
+
+#. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
+   executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.
+   (This is the reason for 2.i. above.)

google_cloud_securesourcemanager-0.1.16/google/cloud/securesourcemanager/__init__.py

@@ -0,0 +1,181 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+from google.cloud.securesourcemanager import gapic_version as package_version
+
+__version__ = package_version.__version__
+
+
+from google.cloud.securesourcemanager_v1.services.secure_source_manager.async_client import (
+    SecureSourceManagerAsyncClient,
+)
+from google.cloud.securesourcemanager_v1.services.secure_source_manager.client import (
+    SecureSourceManagerClient,
+)
+from google.cloud.securesourcemanager_v1.types.secure_source_manager import (
+    BatchCreatePullRequestCommentsRequest,
+    BatchCreatePullRequestCommentsResponse,
+    BranchRule,
+    CloseIssueRequest,
+    ClosePullRequestRequest,
+    CreateBranchRuleRequest,
+    CreateHookRequest,
+    CreateInstanceRequest,
+    CreateIssueCommentRequest,
+    CreateIssueRequest,
+    CreatePullRequestCommentRequest,
+    CreatePullRequestRequest,
+    CreateRepositoryRequest,
+    DeleteBranchRuleRequest,
+    DeleteHookRequest,
+    DeleteInstanceRequest,
+    DeleteIssueCommentRequest,
+    DeleteIssueRequest,
+    DeletePullRequestCommentRequest,
+    DeleteRepositoryRequest,
+    FetchBlobRequest,
+    FetchBlobResponse,
+    FetchTreeRequest,
+    FetchTreeResponse,
+    FileDiff,
+    GetBranchRuleRequest,
+    GetHookRequest,
+    GetInstanceRequest,
+    GetIssueCommentRequest,
+    GetIssueRequest,
+    GetPullRequestCommentRequest,
+    GetPullRequestRequest,
+    GetRepositoryRequest,
+    Hook,
+    Instance,
+    Issue,
+    IssueComment,
+    ListBranchRulesRequest,
+    ListBranchRulesResponse,
+    ListHooksRequest,
+    ListHooksResponse,
+    ListInstancesRequest,
+    ListInstancesResponse,
+    ListIssueCommentsRequest,
+    ListIssueCommentsResponse,
+    ListIssuesRequest,
+    ListIssuesResponse,
+    ListPullRequestCommentsRequest,
+    ListPullRequestCommentsResponse,
+    ListPullRequestFileDiffsRequest,
+    ListPullRequestFileDiffsResponse,
+    ListPullRequestsRequest,
+    ListPullRequestsResponse,
+    ListRepositoriesRequest,
+    ListRepositoriesResponse,
+    MergePullRequestRequest,
+    OpenIssueRequest,
+    OpenPullRequestRequest,
+    OperationMetadata,
+    PullRequest,
+    PullRequestComment,
+    Repository,
+    ResolvePullRequestCommentsRequest,
+    ResolvePullRequestCommentsResponse,
+    TreeEntry,
+    UnresolvePullRequestCommentsRequest,
+    UnresolvePullRequestCommentsResponse,
+    UpdateBranchRuleRequest,
+    UpdateHookRequest,
+    UpdateIssueCommentRequest,
+    UpdateIssueRequest,
+    UpdatePullRequestCommentRequest,
+    UpdatePullRequestRequest,
+    UpdateRepositoryRequest,
+)
+
+__all__ = (
+    "SecureSourceManagerClient",
+    "SecureSourceManagerAsyncClient",
+    "BatchCreatePullRequestCommentsRequest",
+    "BatchCreatePullRequestCommentsResponse",
+    "BranchRule",
+    "CloseIssueRequest",
+    "ClosePullRequestRequest",
+    "CreateBranchRuleRequest",
+    "CreateHookRequest",
+    "CreateInstanceRequest",
+    "CreateIssueCommentRequest",
+    "CreateIssueRequest",
+    "CreatePullRequestCommentRequest",
+    "CreatePullRequestRequest",
+    "CreateRepositoryRequest",
+    "DeleteBranchRuleRequest",
+    "DeleteHookRequest",
+    "DeleteInstanceRequest",
+    "DeleteIssueCommentRequest",
+    "DeleteIssueRequest",
+    "DeletePullRequestCommentRequest",
+    "DeleteRepositoryRequest",
+    "FetchBlobRequest",
+    "FetchBlobResponse",
+    "FetchTreeRequest",
+    "FetchTreeResponse",
+    "FileDiff",
+    "GetBranchRuleRequest",
+    "GetHookRequest",
+    "GetInstanceRequest",
+    "GetIssueCommentRequest",
+    "GetIssueRequest",
+    "GetPullRequestCommentRequest",
+    "GetPullRequestRequest",
+    "GetRepositoryRequest",
+    "Hook",
+    "Instance",
+    "Issue",
+    "IssueComment",
+    "ListBranchRulesRequest",
+    "ListBranchRulesResponse",
+    "ListHooksRequest",
+    "ListHooksResponse",
+    "ListInstancesRequest",
+    "ListInstancesResponse",
+    "ListIssueCommentsRequest",
+    "ListIssueCommentsResponse",
+    "ListIssuesRequest",
+    "ListIssuesResponse",
+    "ListPullRequestCommentsRequest",
+    "ListPullRequestCommentsResponse",
+    "ListPullRequestFileDiffsRequest",
+    "ListPullRequestFileDiffsResponse",
+    "ListPullRequestsRequest",
+    "ListPullRequestsResponse",
+    "ListRepositoriesRequest",
+    "ListRepositoriesResponse",
+    "MergePullRequestRequest",
+    "OpenIssueRequest",
+    "OpenPullRequestRequest",
+    "OperationMetadata",
+    "PullRequest",
+    "PullRequestComment",
+    "Repository",
+    "ResolvePullRequestCommentsRequest",
+    "ResolvePullRequestCommentsResponse",
+    "TreeEntry",
+    "UnresolvePullRequestCommentsRequest",
+    "UnresolvePullRequestCommentsResponse",
+    "UpdateBranchRuleRequest",
+    "UpdateHookRequest",
+    "UpdateIssueCommentRequest",
+    "UpdateIssueRequest",
+    "UpdatePullRequestCommentRequest",
+    "UpdatePullRequestRequest",
+    "UpdateRepositoryRequest",
+)

{google_cloud_securesourcemanager-0.1.14 → google_cloud_securesourcemanager-0.1.16}/google/cloud/securesourcemanager/gapic_version.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2024 Google LLC
+# Copyright 2025 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.1.14"  # {x-release-please-version}
+__version__ = "0.1.16"  # {x-release-please-version}