google-cloud-dataflow 0.2.0 → 0.3.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (6) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +1 -1
  3. data/README.md +0 -26
  4. data/lib/google/cloud/dataflow/version.rb +1 -1
  5. data/lib/google/cloud/dataflow.rb +61 -37
  6. metadata +5 -5
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6d44153b504241ac848163751168ce5c57790e9e8eb53609ac8dec9ba55c468f
4
- data.tar.gz: 6c7fd912b1d0b8b6e20f4cefa25e8220ae4a7a8a56d474fb501a476909c57402
3
+ metadata.gz: fc384147fa3803d48b5cea242d0fc0f51479969e6c323613701b9e7e91dcdfbb
4
+ data.tar.gz: 4befbb291a4570a196449498d13a8e2c81f06732b2b4f486f05662a5deca0051
5
5
  SHA512:
6
- metadata.gz: b47dc87f50459ff6c0942cf76c2fd7fd824ad3fdc8a2d4d2010e30f1c707d4a37292c54f21ca35be9d079c8b3fb3e4ee79a756f92160e1349d4dad1b2f30e061
7
- data.tar.gz: e51f5aa8a66509a108ab4bc144e20e1a226dbba61873e2d5693bc1c4cbfb91804544039f5447d787e29c82a9f9cc3ba345866ceaaa0a891138294ef170187ae1
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+.
data/lib/google/cloud/dataflow/version.rb CHANGED
@@ -20,7 +20,7 @@
20
20
  module Google
21
21
  module Cloud
22
22
  module Dataflow
23
- VERSION = "0.2.0"
23
+ VERSION = "0.3.0"
24
24
  end
25
25
  end
26
26
  end
data/lib/google/cloud/dataflow.rb CHANGED
@@ -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 specify a different API version by passing it in the
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
- # @return [Snapshots::Client] A client object for the specified version.
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
- package_module = Google::Cloud::Dataflow.const_get package_name
74
- package_module.const_get(:Snapshots).const_get(:Client).new(&block)
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 specify a different API version by passing it in the
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
- # @return [Jobs::Client] A client object for the specified version.
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
- package_module = Google::Cloud::Dataflow.const_get package_name
105
- package_module.const_get(:Jobs).const_get(:Client).new(&block)
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 specify a different API version by passing it in the
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
- # @return [Messages::Client] A client object for the specified version.
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
- package_module = Google::Cloud::Dataflow.const_get package_name
136
- package_module.const_get(:Messages).const_get(:Client).new(&block)
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 specify a different API version by passing it in the
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
- # @return [Metrics::Client] A client object for the specified version.
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
- package_module = Google::Cloud::Dataflow.const_get package_name
167
- package_module.const_get(:Metrics).const_get(:Client).new(&block)
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 specify a different API version by passing it in the
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
- # @return [TemplatesService::Client] A client object for the specified version.
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
- package_module = Google::Cloud::Dataflow.const_get package_name
197
- package_module.const_get(:TemplatesService).const_get(:Client).new(&block)
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 specify a different API version by passing it in the
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
- # @return [FlexTemplatesService::Client] A client object for the specified version.
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
- package_module = Google::Cloud::Dataflow.const_get package_name
227
- package_module.const_get(:FlexTemplatesService).const_get(:Client).new(&block)
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 gRPC headers to be sent with the call.
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.2.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: 2022-07-02 00:00:00.000000000 Z
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.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.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.3.14
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