Skip to content

Commit 7504e3f

Browse files
yoshi-automationtseaver
yoshi-automation
authored and
tseaver
committed
Pick up stub docstring fix in GAPIC generator. (googleapis#6965)
1 parent 27be94c commit 7504e3f

3 files changed

Lines changed: 92 additions & 80 deletions

File tree

‎bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/enums.py‎

Lines changed: 55 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -32,22 +32,6 @@ class NullValue(enum.IntEnum):
3232
NULL_VALUE = 0
3333

3434

35-
class TransferType(enum.IntEnum):
36-
"""
37-
DEPRECATED. Represents data transfer type.
38-
39-
Attributes:
40-
TRANSFER_TYPE_UNSPECIFIED (int): Invalid or Unknown transfer type placeholder.
41-
BATCH (int): Batch data transfer.
42-
STREAMING (int): Streaming data transfer. Streaming data source currently doesn't
43-
support multiple transfer configs per project.
44-
"""
45-
46-
TRANSFER_TYPE_UNSPECIFIED = 0
47-
BATCH = 1
48-
STREAMING = 2
49-
50-
5135
class TransferState(enum.IntEnum):
5236
"""
5337
Represents data transfer run state.
@@ -70,47 +54,20 @@ class TransferState(enum.IntEnum):
7054
CANCELLED = 6
7155

7256

73-
class TransferMessage(object):
74-
class MessageSeverity(enum.IntEnum):
75-
"""
76-
Represents data transfer user facing message severity.
77-
78-
Attributes:
79-
MESSAGE_SEVERITY_UNSPECIFIED (int): No severity specified.
80-
INFO (int): Informational message.
81-
WARNING (int): Warning message.
82-
ERROR (int): Error message.
83-
"""
84-
85-
MESSAGE_SEVERITY_UNSPECIFIED = 0
86-
INFO = 1
87-
WARNING = 2
88-
ERROR = 3
89-
90-
91-
class DataSourceParameter(object):
92-
class Type(enum.IntEnum):
93-
"""
94-
Parameter type.
57+
class TransferType(enum.IntEnum):
58+
"""
59+
DEPRECATED. Represents data transfer type.
9560
96-
Attributes:
97-
TYPE_UNSPECIFIED (int): Type unspecified.
98-
STRING (int): String parameter.
99-
INTEGER (int): Integer parameter (64-bits).
100-
Will be serialized to json as string.
101-
DOUBLE (int): Double precision floating point parameter.
102-
BOOLEAN (int): Boolean parameter.
103-
RECORD (int): Record parameter.
104-
PLUS_PAGE (int): Page ID for a Google+ Page.
105-
"""
61+
Attributes:
62+
TRANSFER_TYPE_UNSPECIFIED (int): Invalid or Unknown transfer type placeholder.
63+
BATCH (int): Batch data transfer.
64+
STREAMING (int): Streaming data transfer. Streaming data source currently doesn't
65+
support multiple transfer configs per project.
66+
"""
10667

107-
TYPE_UNSPECIFIED = 0
108-
STRING = 1
109-
INTEGER = 2
110-
DOUBLE = 3
111-
BOOLEAN = 4
112-
RECORD = 5
113-
PLUS_PAGE = 6
68+
TRANSFER_TYPE_UNSPECIFIED = 0
69+
BATCH = 1
70+
STREAMING = 2
11471

11572

11673
class DataSource(object):
@@ -149,6 +106,31 @@ class DataRefreshType(enum.IntEnum):
149106
CUSTOM_SLIDING_WINDOW = 2
150107

151108

109+
class DataSourceParameter(object):
110+
class Type(enum.IntEnum):
111+
"""
112+
Parameter type.
113+
114+
Attributes:
115+
TYPE_UNSPECIFIED (int): Type unspecified.
116+
STRING (int): String parameter.
117+
INTEGER (int): Integer parameter (64-bits).
118+
Will be serialized to json as string.
119+
DOUBLE (int): Double precision floating point parameter.
120+
BOOLEAN (int): Boolean parameter.
121+
RECORD (int): Record parameter.
122+
PLUS_PAGE (int): Page ID for a Google+ Page.
123+
"""
124+
125+
TYPE_UNSPECIFIED = 0
126+
STRING = 1
127+
INTEGER = 2
128+
DOUBLE = 3
129+
BOOLEAN = 4
130+
RECORD = 5
131+
PLUS_PAGE = 6
132+
133+
152134
class ListTransferRunsRequest(object):
153135
class RunAttempt(enum.IntEnum):
154136
"""
@@ -161,3 +143,21 @@ class RunAttempt(enum.IntEnum):
161143

162144
RUN_ATTEMPT_UNSPECIFIED = 0
163145
LATEST = 1
146+
147+
148+
class TransferMessage(object):
149+
class MessageSeverity(enum.IntEnum):
150+
"""
151+
Represents data transfer user facing message severity.
152+
153+
Attributes:
154+
MESSAGE_SEVERITY_UNSPECIFIED (int): No severity specified.
155+
INFO (int): Informational message.
156+
WARNING (int): Warning message.
157+
ERROR (int): Error message.
158+
"""
159+
160+
MESSAGE_SEVERITY_UNSPECIFIED = 0
161+
INFO = 1
162+
WARNING = 2
163+
ERROR = 3

‎bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/transports/data_transfer_service_grpc_transport.py‎

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ def channel(self):
104104

105105
@property
106106
def get_data_source(self):
107-
"""Return the gRPC stub for {$apiMethod.name}.
107+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.get_data_source`.
108108
109109
Retrieves a supported data source and returns its settings,
110110
which can be used for UI rendering.
@@ -118,7 +118,7 @@ def get_data_source(self):
118118

119119
@property
120120
def list_data_sources(self):
121-
"""Return the gRPC stub for {$apiMethod.name}.
121+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.list_data_sources`.
122122
123123
Lists supported data sources and returns their settings,
124124
which can be used for UI rendering.
@@ -132,7 +132,7 @@ def list_data_sources(self):
132132

133133
@property
134134
def create_transfer_config(self):
135-
"""Return the gRPC stub for {$apiMethod.name}.
135+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.create_transfer_config`.
136136
137137
Creates a new data transfer configuration.
138138
@@ -145,7 +145,7 @@ def create_transfer_config(self):
145145

146146
@property
147147
def update_transfer_config(self):
148-
"""Return the gRPC stub for {$apiMethod.name}.
148+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.update_transfer_config`.
149149
150150
Updates a data transfer configuration.
151151
All fields must be set, even if they are not updated.
@@ -159,7 +159,7 @@ def update_transfer_config(self):
159159

160160
@property
161161
def delete_transfer_config(self):
162-
"""Return the gRPC stub for {$apiMethod.name}.
162+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.delete_transfer_config`.
163163
164164
Deletes a data transfer configuration,
165165
including any associated transfer runs and logs.
@@ -173,7 +173,7 @@ def delete_transfer_config(self):
173173

174174
@property
175175
def get_transfer_config(self):
176-
"""Return the gRPC stub for {$apiMethod.name}.
176+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.get_transfer_config`.
177177
178178
Returns information about a data transfer config.
179179
@@ -186,7 +186,7 @@ def get_transfer_config(self):
186186

187187
@property
188188
def list_transfer_configs(self):
189-
"""Return the gRPC stub for {$apiMethod.name}.
189+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.list_transfer_configs`.
190190
191191
Returns information about all data transfers in the project.
192192
@@ -199,7 +199,7 @@ def list_transfer_configs(self):
199199

200200
@property
201201
def schedule_transfer_runs(self):
202-
"""Return the gRPC stub for {$apiMethod.name}.
202+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.schedule_transfer_runs`.
203203
204204
Creates transfer runs for a time range [start\_time, end\_time]. For
205205
each date - or whatever granularity the data source supports - in the
@@ -215,7 +215,7 @@ def schedule_transfer_runs(self):
215215

216216
@property
217217
def get_transfer_run(self):
218-
"""Return the gRPC stub for {$apiMethod.name}.
218+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.get_transfer_run`.
219219
220220
Returns information about the particular transfer run.
221221
@@ -228,7 +228,7 @@ def get_transfer_run(self):
228228

229229
@property
230230
def delete_transfer_run(self):
231-
"""Return the gRPC stub for {$apiMethod.name}.
231+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.delete_transfer_run`.
232232
233233
Deletes the specified transfer run.
234234
@@ -241,7 +241,7 @@ def delete_transfer_run(self):
241241

242242
@property
243243
def list_transfer_runs(self):
244-
"""Return the gRPC stub for {$apiMethod.name}.
244+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.list_transfer_runs`.
245245
246246
Returns information about running and completed jobs.
247247
@@ -254,7 +254,7 @@ def list_transfer_runs(self):
254254

255255
@property
256256
def list_transfer_logs(self):
257-
"""Return the gRPC stub for {$apiMethod.name}.
257+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.list_transfer_logs`.
258258
259259
Returns user facing log messages for the data transfer run.
260260
@@ -267,7 +267,7 @@ def list_transfer_logs(self):
267267

268268
@property
269269
def check_valid_creds(self):
270-
"""Return the gRPC stub for {$apiMethod.name}.
270+
"""Return the gRPC stub for :meth:`DataTransferServiceClient.check_valid_creds`.
271271
272272
Returns true if valid credentials exist for the given data source and
273273
requesting user.

‎bigquery_datatransfer/synth.metadata‎

Lines changed: 24 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,38 @@
11
{
2+
"updateTime": "2018-12-18T13:12:15.168875Z",
23
"sources": [
4+
{
5+
"generator": {
6+
"name": "artman",
7+
"version": "0.16.3",
8+
"dockerImage": "googleapis/artman@sha256:bfb92654b4a77368471f70e2808eaf4e60f263b9559f27bb3284097322787bf1"
9+
}
10+
},
311
{
412
"git": {
513
"name": "googleapis",
614
"remote": "https://github.com/googleapis/googleapis.git",
7-
"sha": "5a57f0c13a358b2b15452bf2d67453774a5f6d4f",
8-
"internalRef": "221837528"
15+
"sha": "c04bc0dc0a9164d924a9ab923fd6845b4ae6a7ab",
16+
"internalRef": "225851467"
917
}
1018
},
1119
{
12-
"git": {
13-
"name": "googleapis-private",
14-
"remote": "https://github.com/googleapis/googleapis-private.git",
15-
"sha": "6aa8e1a447bb8d0367150356a28cb4d3f2332641",
16-
"internalRef": "221340946"
20+
"template": {
21+
"name": "python_library",
22+
"origin": "synthtool.gcp",
23+
"version": "2018.12.6"
1724
}
18-
},
25+
}
26+
],
27+
"destinations": [
1928
{
20-
"generator": {
21-
"name": "artman",
22-
"version": "0.16.0",
23-
"dockerImage": "googleapis/artman@sha256:90f9d15e9bad675aeecd586725bce48f5667ffe7d5fc4d1e96d51ff34304815b"
29+
"client": {
30+
"source": "googleapis",
31+
"apiName": "bigquery-datatransfer",
32+
"apiVersion": "v1",
33+
"language": "python",
34+
"generator": "gapic",
35+
"config": "google/cloud/bigquery/datatransfer/artman_bigquerydatatransfer.yaml"
2436
}
2537
}
2638
]

0 commit comments

Comments
 (0)