forked from googleapis/google-cloud-python
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathsynth.py
More file actions
121 lines (104 loc) · 4.45 KB
/
synth.py
File metadata and controls
121 lines (104 loc) · 4.45 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
# Copyright 2018 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.
"""This script is used to synthesize generated parts of this library."""
import synthtool as s
import synthtool.gcp as gcp
import logging
logging.basicConfig(level=logging.DEBUG)
gapic = gcp.GAPICGenerator()
common = gcp.CommonTemplates()
excludes = ["README.rst", "setup.py", "nox*.py", "docs/index.rst"]
# ----------------------------------------------------------------------------
# Generate tasks GAPIC layer
# ----------------------------------------------------------------------------
for version in ["v2beta2", "v2beta3", "v2"]:
library = gapic.py_library(
"tasks",
version,
config_path=f"artman_cloudtasks_{version}.yaml",
include_protos=True,
)
s.copy(library, excludes=excludes)
s.replace(
f"google/cloud/tasks_{version}/gapic/cloud_tasks_client.py",
"(Google IAM .*?_) ",
"\g<1>_ ",
)
# Issues with Anonymous ('__') links. Change to named.
s.replace(f"google/cloud/tasks_{version}/proto/*.py", ">`__", ">`_")
# Wrapped link fails due to space in link (v2beta2)
s.replace(
"google/cloud/tasks_v2beta2/proto/queue_pb2.py",
"(in queue.yaml/xml) <\n\s+",
"\g<1>\n <",
)
# Wrapped link fails due to newline (v2)
s.replace(
"google/cloud/tasks_v2/proto/queue_pb2.py",
"""#retry_parameters>
`__\.""",
"#retry_parameters>`__.",
)
# Restore updated example from PR #7025.
s.replace(
"google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py",
">>> # TODO: Initialize `queue`:",
">>> # Initialize `queue`:",
)
s.replace(
"google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py",
"^(\s+)>>> queue = {}\n",
"\g<1>>>> queue = {\n"
"\g<1>... # The fully qualified path to the queue\n"
"\g<1>... 'name': client.queue_path('[PROJECT]', '[LOCATION]', '[NAME]'),\n"
"\g<1>... 'app_engine_http_queue': {\n"
"\g<1>... 'app_engine_routing_override': {\n"
"\g<1>... # The App Engine service that will receive the tasks.\n"
"\g<1>... 'service': 'default',\n"
"\g<1>... },\n"
"\g<1>... },\n"
"\g<1>... }\n",
)
# Fix enum docstring references
s.replace(
"google/cloud/**/cloud_tasks_client.py",
"types\.View",
"enums.Task.View")
# Change wording of optional params to disambiguate
# client library request methods from Cloud Task requests
s.replace("google/cloud/**/*.py",
""" retry \(Optional\[google\.api_core\.retry\.Retry\]\): A retry object used
to retry requests\. If ``None`` is specified, requests will
be retried using a default configuration\.
timeout \(Optional\[float\]\): The amount of time, in seconds, to wait
for the request to complete\. Note that if ``retry`` is
specified, the timeout applies to each individual attempt\.
metadata \(Optional\[Sequence\[Tuple\[str, str\]\]\]\): Additional metadata
that is provided to the method\.
""",
""" retry (Optional[google.api_core.retry.Retry]): A retry object used
to retry client library requests. If ``None`` is specified,
requests will be retried using a default configuration.
timeout (Optional[float]): The amount of time, in seconds, to wait
for the client library request to complete. Note that if ``retry`` is
specified, the timeout applies to each individual attempt.
metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
that is provided to the client library method.
""")
# ----------------------------------------------------------------------------
# Add templated files
# ----------------------------------------------------------------------------
templated_files = common.py_library(unit_cov_level=97, cov_level=100)
s.move(templated_files)
s.shell.run(["nox", "-s", "blacken"], hide_output=False)