google-cloud-dataflow 0.1.3 → 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 +6 -32
  4. data/lib/google/cloud/dataflow/version.rb +1 -1
  5. data/lib/google/cloud/dataflow.rb +61 -37
  6. metadata +12 -12
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 0b43d3cfc2fbce3a8079f2311e7d9eaa2a736bf7e5b4462f1213393acedbe2a6
4
- data.tar.gz: 658b047ac43c7258affbb82e8b5266273480534a95dae82c6d136f70bdd426df
3
+ metadata.gz: fc384147fa3803d48b5cea242d0fc0f51479969e6c323613701b9e7e91dcdfbb
4
+ data.tar.gz: 4befbb291a4570a196449498d13a8e2c81f06732b2b4f486f05662a5deca0051
5
5
  SHA512:
6
- metadata.gz: ee1c23f681bc47532853ea63a06a8017976cbf851d2022ec4b6023ceef0b9f7d035d8d68283541b560f413661b16e191a23d23957d8e16ffee72ab2296a46f73
7
- data.tar.gz: bdd9771f8423917ed36d5db6438102ef3f022efb40896933b91c0ba694cf374c99762719b9d7709876995c53825469bc9fcec7b85523fc87f8019aafcd2c8890
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
@@ -11,7 +11,7 @@ verisoned gems in as dependencies, and provides high-level methods for
11
11
  constructing clients. More information on versioned clients can be found below
12
12
  in the section titled *Which client should I use?*.
13
13
 
14
- View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-dataflow/latest)
14
+ View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-dataflow/latest)
15
15
  for this library, google-cloud-dataflow, to see the convenience methods for
16
16
  constructing client objects. Reference documentation for the client objects
17
17
  themselves can be found in the client library documentation for the versioned
@@ -34,42 +34,16 @@ 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
- This library is supported on Ruby 2.5+.
39
+ This library is supported on Ruby 2.6+.
66
40
 
67
41
  Google provides official support for Ruby versions that are actively supported
68
42
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
69
- in security maintenance, and not end of life. Currently, this means Ruby 2.5
70
- and later. Older versions of Ruby _may_ still work, but are unsupported and not
71
- recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
72
- about the Ruby support schedule.
43
+ in security maintenance, and not end of life. Older versions of Ruby _may_
44
+ still work, but are unsupported and not recommended. See
45
+ https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
46
+ support schedule.
73
47
 
74
48
  ## Which client should I use?
75
49
 
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.1.3"
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.1.3
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-01-11 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
@@ -50,28 +50,28 @@ dependencies:
50
50
  requirements:
51
51
  - - "~>"
52
52
  - !ruby/object:Gem::Version
53
- version: 1.25.1
53
+ version: 1.26.1
54
54
  type: :development
55
55
  prerelease: false
56
56
  version_requirements: !ruby/object:Gem::Requirement
57
57
  requirements:
58
58
  - - "~>"
59
59
  - !ruby/object:Gem::Version
60
- version: 1.25.1
60
+ version: 1.26.1
61
61
  - !ruby/object:Gem::Dependency
62
62
  name: minitest
63
63
  requirement: !ruby/object:Gem::Requirement
64
64
  requirements:
65
65
  - - "~>"
66
66
  - !ruby/object:Gem::Version
67
- version: '5.14'
67
+ version: '5.16'
68
68
  type: :development
69
69
  prerelease: false
70
70
  version_requirements: !ruby/object:Gem::Requirement
71
71
  requirements:
72
72
  - - "~>"
73
73
  - !ruby/object:Gem::Version
74
- version: '5.14'
74
+ version: '5.16'
75
75
  - !ruby/object:Gem::Dependency
76
76
  name: minitest-focus
77
77
  requirement: !ruby/object:Gem::Requirement
@@ -106,14 +106,14 @@ dependencies:
106
106
  requirements:
107
107
  - - ">="
108
108
  - !ruby/object:Gem::Version
109
- version: '12.0'
109
+ version: '13.0'
110
110
  type: :development
111
111
  prerelease: false
112
112
  version_requirements: !ruby/object:Gem::Requirement
113
113
  requirements:
114
114
  - - ">="
115
115
  - !ruby/object:Gem::Version
116
- version: '12.0'
116
+ version: '13.0'
117
117
  - !ruby/object:Gem::Dependency
118
118
  name: redcarpet
119
119
  requirement: !ruby/object:Gem::Requirement
@@ -182,14 +182,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
182
182
  requirements:
183
183
  - - ">="
184
184
  - !ruby/object:Gem::Version
185
- version: '2.5'
185
+ version: '2.6'
186
186
  required_rubygems_version: !ruby/object:Gem::Requirement
187
187
  requirements:
188
188
  - - ">="
189
189
  - !ruby/object:Gem::Version
190
190
  version: '0'
191
191
  requirements: []
192
- rubygems_version: 3.3.4
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