google-cloud-dataflow 0.1.3 → 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.
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