google-cloud-dataflow 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/AUTHENTICATION.md +1 -1
- data/README.md +0 -26
- data/lib/google/cloud/dataflow/version.rb +1 -1
- data/lib/google/cloud/dataflow.rb +61 -37
- metadata +5 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: fc384147fa3803d48b5cea242d0fc0f51479969e6c323613701b9e7e91dcdfbb
|
4
|
+
data.tar.gz: 4befbb291a4570a196449498d13a8e2c81f06732b2b4f486f05662a5deca0051
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: dfba7b354a31f16ba00084df1020ad90609997f3069b5cc234c0683c909107b80110bd9545c333b42ffc286c2fd970fbeaf871e60fafefe101ab580c32c2181b
|
7
|
+
data.tar.gz: 34b89a68051d445190167f8bce5a72a1f85bdd5194ad3846d466793bdce65771a28badf7262191eb5d0c91b7cd9ab560b539338180640b718001ea03a312be7c
|
data/AUTHENTICATION.md
CHANGED
@@ -114,7 +114,7 @@ credentials are discovered.
|
|
114
114
|
To configure your system for this, simply:
|
115
115
|
|
116
116
|
1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
|
117
|
-
2. Authenticate using OAuth 2.0 `$ gcloud auth login`
|
117
|
+
2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
|
118
118
|
3. Write code as if already authenticated.
|
119
119
|
|
120
120
|
**NOTE:** This is _not_ recommended for running in production. The Cloud SDK
|
data/README.md
CHANGED
@@ -34,32 +34,6 @@ In order to use this library, you first need to go through the following steps:
|
|
34
34
|
1. [Enable the API.](https://console.cloud.google.com/apis/library/dataflow.googleapis.com)
|
35
35
|
1. {file:AUTHENTICATION.md Set up authentication.}
|
36
36
|
|
37
|
-
## Enabling Logging
|
38
|
-
|
39
|
-
To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
|
40
|
-
The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
|
41
|
-
or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
|
42
|
-
that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
|
43
|
-
and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
|
44
|
-
|
45
|
-
Configuring a Ruby stdlib logger:
|
46
|
-
|
47
|
-
```ruby
|
48
|
-
require "logger"
|
49
|
-
|
50
|
-
module MyLogger
|
51
|
-
LOGGER = Logger.new $stderr, level: Logger::WARN
|
52
|
-
def logger
|
53
|
-
LOGGER
|
54
|
-
end
|
55
|
-
end
|
56
|
-
|
57
|
-
# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
|
58
|
-
module GRPC
|
59
|
-
extend MyLogger
|
60
|
-
end
|
61
|
-
```
|
62
|
-
|
63
37
|
## Supported Ruby Versions
|
64
38
|
|
65
39
|
This library is supported on Ruby 2.6+.
|
@@ -49,11 +49,13 @@ module Google
|
|
49
49
|
#
|
50
50
|
# By default, this returns an instance of
|
51
51
|
# [Google::Cloud::Dataflow::V1beta3::Snapshots::Client](https://googleapis.dev/ruby/google-cloud-dataflow-v1beta3/latest/Google/Cloud/Dataflow/V1beta3/Snapshots/Client.html)
|
52
|
-
# for version V1beta3 of the API.
|
53
|
-
# However, you can specify
|
52
|
+
# for a gRPC client for version V1beta3 of the API.
|
53
|
+
# However, you can specify a different API version by passing it in the
|
54
54
|
# `version` parameter. If the Snapshots service is
|
55
55
|
# supported by that API version, and the corresponding gem is available, the
|
56
56
|
# appropriate versioned client will be returned.
|
57
|
+
# You can also specify a different transport by passing `:rest` or `:grpc` in
|
58
|
+
# the `transport` parameter.
|
57
59
|
#
|
58
60
|
# ## About Snapshots
|
59
61
|
#
|
@@ -61,17 +63,19 @@ module Google
|
|
61
63
|
#
|
62
64
|
# @param version [::String, ::Symbol] The API version to connect to. Optional.
|
63
65
|
# Defaults to `:v1beta3`.
|
64
|
-
# @
|
66
|
+
# @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
|
67
|
+
# @return [::Object] A client object for the specified version.
|
65
68
|
#
|
66
|
-
def self.snapshots version: :v1beta3, &block
|
69
|
+
def self.snapshots version: :v1beta3, transport: :grpc, &block
|
67
70
|
require "google/cloud/dataflow/#{version.to_s.downcase}"
|
68
71
|
|
69
72
|
package_name = Google::Cloud::Dataflow
|
70
73
|
.constants
|
71
74
|
.select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
|
72
75
|
.first
|
73
|
-
|
74
|
-
|
76
|
+
service_module = Google::Cloud::Dataflow.const_get(package_name).const_get(:Snapshots)
|
77
|
+
service_module = service_module.const_get(:Rest) if transport == :rest
|
78
|
+
service_module.const_get(:Client).new(&block)
|
75
79
|
end
|
76
80
|
|
77
81
|
##
|
@@ -79,11 +83,13 @@ module Google
|
|
79
83
|
#
|
80
84
|
# By default, this returns an instance of
|
81
85
|
# [Google::Cloud::Dataflow::V1beta3::Jobs::Client](https://googleapis.dev/ruby/google-cloud-dataflow-v1beta3/latest/Google/Cloud/Dataflow/V1beta3/Jobs/Client.html)
|
82
|
-
# for version V1beta3 of the API.
|
83
|
-
# However, you can specify
|
86
|
+
# for a gRPC client for version V1beta3 of the API.
|
87
|
+
# However, you can specify a different API version by passing it in the
|
84
88
|
# `version` parameter. If the Jobs service is
|
85
89
|
# supported by that API version, and the corresponding gem is available, the
|
86
90
|
# appropriate versioned client will be returned.
|
91
|
+
# You can also specify a different transport by passing `:rest` or `:grpc` in
|
92
|
+
# the `transport` parameter.
|
87
93
|
#
|
88
94
|
# ## About Jobs
|
89
95
|
#
|
@@ -92,17 +98,19 @@ module Google
|
|
92
98
|
#
|
93
99
|
# @param version [::String, ::Symbol] The API version to connect to. Optional.
|
94
100
|
# Defaults to `:v1beta3`.
|
95
|
-
# @
|
101
|
+
# @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
|
102
|
+
# @return [::Object] A client object for the specified version.
|
96
103
|
#
|
97
|
-
def self.jobs version: :v1beta3, &block
|
104
|
+
def self.jobs version: :v1beta3, transport: :grpc, &block
|
98
105
|
require "google/cloud/dataflow/#{version.to_s.downcase}"
|
99
106
|
|
100
107
|
package_name = Google::Cloud::Dataflow
|
101
108
|
.constants
|
102
109
|
.select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
|
103
110
|
.first
|
104
|
-
|
105
|
-
|
111
|
+
service_module = Google::Cloud::Dataflow.const_get(package_name).const_get(:Jobs)
|
112
|
+
service_module = service_module.const_get(:Rest) if transport == :rest
|
113
|
+
service_module.const_get(:Client).new(&block)
|
106
114
|
end
|
107
115
|
|
108
116
|
##
|
@@ -110,11 +118,13 @@ module Google
|
|
110
118
|
#
|
111
119
|
# By default, this returns an instance of
|
112
120
|
# [Google::Cloud::Dataflow::V1beta3::Messages::Client](https://googleapis.dev/ruby/google-cloud-dataflow-v1beta3/latest/Google/Cloud/Dataflow/V1beta3/Messages/Client.html)
|
113
|
-
# for version V1beta3 of the API.
|
114
|
-
# However, you can specify
|
121
|
+
# for a gRPC client for version V1beta3 of the API.
|
122
|
+
# However, you can specify a different API version by passing it in the
|
115
123
|
# `version` parameter. If the Messages service is
|
116
124
|
# supported by that API version, and the corresponding gem is available, the
|
117
125
|
# appropriate versioned client will be returned.
|
126
|
+
# You can also specify a different transport by passing `:rest` or `:grpc` in
|
127
|
+
# the `transport` parameter.
|
118
128
|
#
|
119
129
|
# ## About Messages
|
120
130
|
#
|
@@ -123,17 +133,19 @@ module Google
|
|
123
133
|
#
|
124
134
|
# @param version [::String, ::Symbol] The API version to connect to. Optional.
|
125
135
|
# Defaults to `:v1beta3`.
|
126
|
-
# @
|
136
|
+
# @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
|
137
|
+
# @return [::Object] A client object for the specified version.
|
127
138
|
#
|
128
|
-
def self.messages version: :v1beta3, &block
|
139
|
+
def self.messages version: :v1beta3, transport: :grpc, &block
|
129
140
|
require "google/cloud/dataflow/#{version.to_s.downcase}"
|
130
141
|
|
131
142
|
package_name = Google::Cloud::Dataflow
|
132
143
|
.constants
|
133
144
|
.select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
|
134
145
|
.first
|
135
|
-
|
136
|
-
|
146
|
+
service_module = Google::Cloud::Dataflow.const_get(package_name).const_get(:Messages)
|
147
|
+
service_module = service_module.const_get(:Rest) if transport == :rest
|
148
|
+
service_module.const_get(:Client).new(&block)
|
137
149
|
end
|
138
150
|
|
139
151
|
##
|
@@ -141,11 +153,13 @@ module Google
|
|
141
153
|
#
|
142
154
|
# By default, this returns an instance of
|
143
155
|
# [Google::Cloud::Dataflow::V1beta3::Metrics::Client](https://googleapis.dev/ruby/google-cloud-dataflow-v1beta3/latest/Google/Cloud/Dataflow/V1beta3/Metrics/Client.html)
|
144
|
-
# for version V1beta3 of the API.
|
145
|
-
# However, you can specify
|
156
|
+
# for a gRPC client for version V1beta3 of the API.
|
157
|
+
# However, you can specify a different API version by passing it in the
|
146
158
|
# `version` parameter. If the Metrics service is
|
147
159
|
# supported by that API version, and the corresponding gem is available, the
|
148
160
|
# appropriate versioned client will be returned.
|
161
|
+
# You can also specify a different transport by passing `:rest` or `:grpc` in
|
162
|
+
# the `transport` parameter.
|
149
163
|
#
|
150
164
|
# ## About Metrics
|
151
165
|
#
|
@@ -154,17 +168,19 @@ module Google
|
|
154
168
|
#
|
155
169
|
# @param version [::String, ::Symbol] The API version to connect to. Optional.
|
156
170
|
# Defaults to `:v1beta3`.
|
157
|
-
# @
|
171
|
+
# @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
|
172
|
+
# @return [::Object] A client object for the specified version.
|
158
173
|
#
|
159
|
-
def self.metrics version: :v1beta3, &block
|
174
|
+
def self.metrics version: :v1beta3, transport: :grpc, &block
|
160
175
|
require "google/cloud/dataflow/#{version.to_s.downcase}"
|
161
176
|
|
162
177
|
package_name = Google::Cloud::Dataflow
|
163
178
|
.constants
|
164
179
|
.select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
|
165
180
|
.first
|
166
|
-
|
167
|
-
|
181
|
+
service_module = Google::Cloud::Dataflow.const_get(package_name).const_get(:Metrics)
|
182
|
+
service_module = service_module.const_get(:Rest) if transport == :rest
|
183
|
+
service_module.const_get(:Client).new(&block)
|
168
184
|
end
|
169
185
|
|
170
186
|
##
|
@@ -172,11 +188,13 @@ module Google
|
|
172
188
|
#
|
173
189
|
# By default, this returns an instance of
|
174
190
|
# [Google::Cloud::Dataflow::V1beta3::TemplatesService::Client](https://googleapis.dev/ruby/google-cloud-dataflow-v1beta3/latest/Google/Cloud/Dataflow/V1beta3/TemplatesService/Client.html)
|
175
|
-
# for version V1beta3 of the API.
|
176
|
-
# However, you can specify
|
191
|
+
# for a gRPC client for version V1beta3 of the API.
|
192
|
+
# However, you can specify a different API version by passing it in the
|
177
193
|
# `version` parameter. If the TemplatesService service is
|
178
194
|
# supported by that API version, and the corresponding gem is available, the
|
179
195
|
# appropriate versioned client will be returned.
|
196
|
+
# You can also specify a different transport by passing `:rest` or `:grpc` in
|
197
|
+
# the `transport` parameter.
|
180
198
|
#
|
181
199
|
# ## About TemplatesService
|
182
200
|
#
|
@@ -184,17 +202,19 @@ module Google
|
|
184
202
|
#
|
185
203
|
# @param version [::String, ::Symbol] The API version to connect to. Optional.
|
186
204
|
# Defaults to `:v1beta3`.
|
187
|
-
# @
|
205
|
+
# @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
|
206
|
+
# @return [::Object] A client object for the specified version.
|
188
207
|
#
|
189
|
-
def self.templates_service version: :v1beta3, &block
|
208
|
+
def self.templates_service version: :v1beta3, transport: :grpc, &block
|
190
209
|
require "google/cloud/dataflow/#{version.to_s.downcase}"
|
191
210
|
|
192
211
|
package_name = Google::Cloud::Dataflow
|
193
212
|
.constants
|
194
213
|
.select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
|
195
214
|
.first
|
196
|
-
|
197
|
-
|
215
|
+
service_module = Google::Cloud::Dataflow.const_get(package_name).const_get(:TemplatesService)
|
216
|
+
service_module = service_module.const_get(:Rest) if transport == :rest
|
217
|
+
service_module.const_get(:Client).new(&block)
|
198
218
|
end
|
199
219
|
|
200
220
|
##
|
@@ -202,11 +222,13 @@ module Google
|
|
202
222
|
#
|
203
223
|
# By default, this returns an instance of
|
204
224
|
# [Google::Cloud::Dataflow::V1beta3::FlexTemplatesService::Client](https://googleapis.dev/ruby/google-cloud-dataflow-v1beta3/latest/Google/Cloud/Dataflow/V1beta3/FlexTemplatesService/Client.html)
|
205
|
-
# for version V1beta3 of the API.
|
206
|
-
# However, you can specify
|
225
|
+
# for a gRPC client for version V1beta3 of the API.
|
226
|
+
# However, you can specify a different API version by passing it in the
|
207
227
|
# `version` parameter. If the FlexTemplatesService service is
|
208
228
|
# supported by that API version, and the corresponding gem is available, the
|
209
229
|
# appropriate versioned client will be returned.
|
230
|
+
# You can also specify a different transport by passing `:rest` or `:grpc` in
|
231
|
+
# the `transport` parameter.
|
210
232
|
#
|
211
233
|
# ## About FlexTemplatesService
|
212
234
|
#
|
@@ -214,17 +236,19 @@ module Google
|
|
214
236
|
#
|
215
237
|
# @param version [::String, ::Symbol] The API version to connect to. Optional.
|
216
238
|
# Defaults to `:v1beta3`.
|
217
|
-
# @
|
239
|
+
# @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
|
240
|
+
# @return [::Object] A client object for the specified version.
|
218
241
|
#
|
219
|
-
def self.flex_templates_service version: :v1beta3, &block
|
242
|
+
def self.flex_templates_service version: :v1beta3, transport: :grpc, &block
|
220
243
|
require "google/cloud/dataflow/#{version.to_s.downcase}"
|
221
244
|
|
222
245
|
package_name = Google::Cloud::Dataflow
|
223
246
|
.constants
|
224
247
|
.select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
|
225
248
|
.first
|
226
|
-
|
227
|
-
|
249
|
+
service_module = Google::Cloud::Dataflow.const_get(package_name).const_get(:FlexTemplatesService)
|
250
|
+
service_module = service_module.const_get(:Rest) if transport == :rest
|
251
|
+
service_module.const_get(:Client).new(&block)
|
228
252
|
end
|
229
253
|
|
230
254
|
##
|
@@ -244,7 +268,7 @@ module Google
|
|
244
268
|
# * `timeout` (*type:* `Numeric`) -
|
245
269
|
# Default timeout in seconds.
|
246
270
|
# * `metadata` (*type:* `Hash{Symbol=>String}`) -
|
247
|
-
# Additional
|
271
|
+
# Additional headers to be sent with the call.
|
248
272
|
# * `retry_policy` (*type:* `Hash`) -
|
249
273
|
# The retry policy. The value is a hash with the following keys:
|
250
274
|
# * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-cloud-dataflow
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.3.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Google LLC
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2023-03-09 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: google-cloud-core
|
@@ -30,7 +30,7 @@ dependencies:
|
|
30
30
|
requirements:
|
31
31
|
- - ">="
|
32
32
|
- !ruby/object:Gem::Version
|
33
|
-
version: '0.
|
33
|
+
version: '0.5'
|
34
34
|
- - "<"
|
35
35
|
- !ruby/object:Gem::Version
|
36
36
|
version: 2.a
|
@@ -40,7 +40,7 @@ dependencies:
|
|
40
40
|
requirements:
|
41
41
|
- - ">="
|
42
42
|
- !ruby/object:Gem::Version
|
43
|
-
version: '0.
|
43
|
+
version: '0.5'
|
44
44
|
- - "<"
|
45
45
|
- !ruby/object:Gem::Version
|
46
46
|
version: 2.a
|
@@ -189,7 +189,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
189
189
|
- !ruby/object:Gem::Version
|
190
190
|
version: '0'
|
191
191
|
requirements: []
|
192
|
-
rubygems_version: 3.
|
192
|
+
rubygems_version: 3.4.2
|
193
193
|
signing_key:
|
194
194
|
specification_version: 4
|
195
195
|
summary: API Client library for the Dataflow API
|