diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index cb40bd1..7ae6f44 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -13,8 +13,6 @@ # See the License for the specific language governing permissions and # limitations under the License. -#!/bin/bash - set -eo pipefail # Disable buffering, so that the logs stream through. diff --git a/docs/index.rst b/docs/index.rst index 81e561c..378b403 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,5 +1,7 @@ .. include:: README.rst +.. include:: multiprocessing.rst + Api Reference ------------- diff --git a/docs/multiprocessing.rst b/docs/multiprocessing.rst new file mode 100644 index 0000000..1cb29d4 --- /dev/null +++ b/docs/multiprocessing.rst @@ -0,0 +1,7 @@ +.. note:: + + Because this client uses :mod:`grpcio` library, it is safe to + share instances across threads. In multiprocessing scenarios, the best + practice is to create client instances *after* the invocation of + :func:`os.fork` by :class:`multiprocessing.Pool` or + :class:`multiprocessing.Process`. diff --git a/google/cloud/recommender_v1/proto/recommendation_pb2.py b/google/cloud/recommender_v1/proto/recommendation_pb2.py index ffbee49..64f2547 100644 --- a/google/cloud/recommender_v1/proto/recommendation_pb2.py +++ b/google/cloud/recommender_v1/proto/recommendation_pb2.py @@ -1258,8 +1258,7 @@ { "DESCRIPTOR": _VALUEMATCHER, "__module__": "google.cloud.recommender_v1.proto.recommendation_pb2", - "__doc__": """Contains various matching options for values for a GCP - resource field. + "__doc__": """Contains various matching options for values for a GCP resource field. Attributes: diff --git a/google/cloud/recommender_v1beta1/proto/insight_pb2.py b/google/cloud/recommender_v1beta1/proto/insight_pb2.py index dd91c49..85588ae 100644 --- a/google/cloud/recommender_v1beta1/proto/insight_pb2.py +++ b/google/cloud/recommender_v1beta1/proto/insight_pb2.py @@ -531,8 +531,8 @@ ), "DESCRIPTOR": _INSIGHT, "__module__": "google.cloud.recommender_v1beta1.proto.insight_pb2", - "__doc__": """An insight along with the information used to derive the insight. The - insight may have associated recomendations as well. + "__doc__": """An insight along with the information used to derive the + insight. The insight may have associated recomendations as well. Attributes: diff --git a/google/cloud/recommender_v1beta1/proto/recommender_service_pb2.py b/google/cloud/recommender_v1beta1/proto/recommender_service_pb2.py index d27c31e..e2df9fa 100644 --- a/google/cloud/recommender_v1beta1/proto/recommender_service_pb2.py +++ b/google/cloud/recommender_v1beta1/proto/recommender_service_pb2.py @@ -1083,8 +1083,7 @@ Attributes: name: - Required. Name of the insight. .. [1] a-z0-9 .. [2] - a-z0-9 .. [3] a-z0-9 + Required. Name of the insight. """, # @@protoc_insertion_point(class_scope:google.cloud.recommender.v1beta1.GetInsightRequest) }, @@ -1155,6 +1154,7 @@ Filter expression to restrict the recommendations returned. Supported filter fields: state_info.state Eg: \`state_info.state:“DISMISSED” or state_info.state:“FAILED” + .. [1] a-z0-9 .. [2] a-z0-9 .. [3] a-z0-9 """, # @@protoc_insertion_point(class_scope:google.cloud.recommender.v1beta1.ListRecommendationsRequest) }, @@ -1260,7 +1260,7 @@ state_metadata: State properties to include with this state. Overwrites any existing ``state_metadata``. Keys must match the regex ``/ - [3]_[a-z0-9_.-]{0,62}/``. Values must match the regex + [2]_[a-z0-9_.-]{0,62}/``. Values must match the regex ``/^[a-zA-Z0-9_./-]{0,255}/``. etag: Required. Fingerprint of the Recommendation. Provides @@ -1296,7 +1296,7 @@ state_metadata: State properties to include with this state. Overwrites any existing ``state_metadata``. Keys must match the regex ``/ - [2]_[a-z0-9_.-]{0,62}/``. Values must match the regex + [3]_[a-z0-9_.-]{0,62}/``. Values must match the regex ``/^[a-zA-Z0-9_./-]{0,255}/``. etag: Required. Fingerprint of the Recommendation. Provides diff --git a/synth.metadata b/synth.metadata index f8b8c2a..df0d409 100644 --- a/synth.metadata +++ b/synth.metadata @@ -3,23 +3,23 @@ { "git": { "name": ".", - "remote": "git@github.com:googleapis/python-recommender.git", - "sha": "b42c8a8b81666c14ae19d8487748788eae27326c" + "remote": "https://github.com/googleapis/python-recommender.git", + "sha": "754b32927208eb775c9d3774fc3c389e22039910" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "756b174de4a122461993c1c583345533d819936d", - "internalRef": "308824110" + "sha": "89e89786896d256c70f43e68a975470c4f4f220e", + "internalRef": "311239362" } }, { "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "01b6f23d24b27878b48667ce597876d66b59780e" + "sha": "84c4156c49be9dcabacc8fd7b0585b6fd789ae47" } } ],