google-cloud-iot 1.2.0 → 2.0.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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 5b88ff4100fb84bfadb32526da300e0102fb7561b754789065a96d9fc319e638
4
- data.tar.gz: 6ef3b06e9a13c9d69d05fd1d67207bad0728e8c05ad5d993cbecc795ebf22d8f
3
+ metadata.gz: f4a54fb60fa5f1e93b622e969a647faa25267d326836a74a782a0ac6eee22ad2
4
+ data.tar.gz: ed8fe62eae9a67c11b6968751f2efc226dfb8474cec6f1488810030997df2c94
5
5
  SHA512:
6
- metadata.gz: eb739a95ef1a9e587c2cbc936ed0a83110d679edcb05eacfa45921f0e7438eff7c84e35bd1d2b619e6f6aa1ab1728881cb8b91f2929cacb606667ef036ee3f68
7
- data.tar.gz: 35753ae88feb36e1908830af80f1aacb2cbc298cfbfbf48b7c4e6e69ef9d0dfbbf1c2bf130343733afd51f757cc5948f2376ed0cb82af67061463bd630257219
6
+ metadata.gz: 00a6ae87219395d53806ea9617f0f3364a2066a2257d81e40c0c3d2955add3e73943736638d421699b6c5e3841d688a320f963c78d3527c4a9edf679d9ce5728
7
+ data.tar.gz: 89683ec3c67a4eb9f83453c1386611a49e3bb5e5ded99ffc7da6593d3757a0ed6141871db566041a39afddf9c5ec95882e3d93b6cf1847510dd3d3a28d1e93a5
data/README.md CHANGED
@@ -1,104 +1,4 @@
1
- # Ruby Client for the Cloud IoT API
1
+ # Tombstone for Ruby gem google-cloud-iot
2
2
 
3
- API Client library for the Cloud IoT API
4
-
5
- Registers and manages IoT (Internet of Things) devices that connect to the Google Cloud Platform.
6
-
7
- Actual client classes for the various versions of this API are defined in
8
- _versioned_ client gems, with names of the form `google-cloud-iot-v*`.
9
- The gem `google-cloud-iot` is the main client library that brings the
10
- verisoned gems in as dependencies, and provides high-level methods for
11
- constructing clients. More information on versioned clients can be found below
12
- in the section titled *Which client should I use?*.
13
-
14
- View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-iot/latest)
15
- for this library, google-cloud-iot, to see the convenience methods for
16
- constructing client objects. Reference documentation for the client objects
17
- themselves can be found in the client library documentation for the versioned
18
- client gems:
19
- [google-cloud-iot-v1](https://googleapis.dev/ruby/google-cloud-iot-v1/latest).
20
-
21
- See also the [Product Documentation](https://cloud.google.com/iot)
22
- for more usage information.
23
-
24
- ## Quick Start
25
-
26
- ```
27
- $ gem install google-cloud-iot
28
- ```
29
-
30
- In order to use this library, you first need to go through the following steps:
31
-
32
- 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
33
- 1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
34
- 1. [Enable the API.](https://console.cloud.google.com/apis/library/cloudiot.googleapis.com)
35
- 1. {file:AUTHENTICATION.md Set up authentication.}
36
-
37
- ## Supported Ruby Versions
38
-
39
- This library is supported on Ruby 2.6+.
40
-
41
- Google provides official support for Ruby versions that are actively supported
42
- by Ruby Core—that is, Ruby versions that are either in normal maintenance or
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.
47
-
48
- ## Which client should I use?
49
-
50
- Most modern Ruby client libraries for Google APIs come in two flavors: the main
51
- client library with a name such as `google-cloud-iot`,
52
- and lower-level _versioned_ client libraries with names such as
53
- `google-cloud-iot-v1`.
54
- _In most cases, you should install the main client._
55
-
56
- ### What's the difference between the main client and a versioned client?
57
-
58
- A _versioned client_ provides a basic set of data types and client classes for
59
- a _single version_ of a specific service. (That is, for a service with multiple
60
- versions, there might be a separate versioned client for each service version.)
61
- Most versioned clients are written and maintained by a code generator.
62
-
63
- The _main client_ is designed to provide you with the _recommended_ client
64
- interfaces for the service. There will be only one main client for any given
65
- service, even a service with multiple versions. The main client includes
66
- factory methods for constructing the client objects we recommend for most
67
- users. In some cases, those will be classes provided by an underlying versioned
68
- client; in other cases, they will be handwritten higher-level client objects
69
- with additional capabilities, convenience methods, or best practices built in.
70
- Generally, the main client will default to a recommended service version,
71
- although in some cases you can override this if you need to talk to a specific
72
- service version.
73
-
74
- ### Why would I want to use the main client?
75
-
76
- We recommend that most users install the main client gem for a service. You can
77
- identify this gem as the one _without_ a version in its name, e.g.
78
- `google-cloud-iot`.
79
- The main client is recommended because it will embody the best practices for
80
- accessing the service, and may also provide more convenient interfaces or
81
- tighter integration into frameworks and third-party libraries. In addition, the
82
- documentation and samples published by Google will generally demonstrate use of
83
- the main client.
84
-
85
- ### Why would I want to use a versioned client?
86
-
87
- You can use a versioned client if you are content with a possibly lower-level
88
- class interface, you explicitly want to avoid features provided by the main
89
- client, or you want to access a specific service version not be covered by the
90
- main client. You can identify versioned client gems because the service version
91
- is part of the name, e.g. `google-cloud-iot-v1`.
92
-
93
- ### What about the google-apis-<name> clients?
94
-
95
- Client library gems with names that begin with `google-apis-` are based on an
96
- older code generation technology. They talk to a REST/JSON backend (whereas
97
- most modern clients talk to a [gRPC](https://grpc.io/) backend) and they may
98
- not offer the same performance, features, and ease of use provided by more
99
- modern clients.
100
-
101
- The `google-apis-` clients have wide coverage across Google services, so you
102
- might need to use one if there is no modern client available for the service.
103
- However, if a modern client is available, we generally recommend it over the
104
- older `google-apis-` clients.
3
+ This gem is obsolete because the related Google backend is turned down.
4
+ For more information, see https://cloud.google.com/terms/deprecation.
@@ -1,12 +1,10 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright 2020 Google LLC
1
+ # Copyright 2024 Google LLC
4
2
  #
5
3
  # Licensed under the Apache License, Version 2.0 (the "License");
6
4
  # you may not use this file except in compliance with the License.
7
5
  # You may obtain a copy of the License at
8
6
  #
9
- # https://www.apache.org/licenses/LICENSE-2.0
7
+ # http://www.apache.org/licenses/LICENSE-2.0
10
8
  #
11
9
  # Unless required by applicable law or agreed to in writing, software
12
10
  # distributed under the License is distributed on an "AS IS" BASIS,
@@ -14,13 +12,10 @@
14
12
  # See the License for the specific language governing permissions and
15
13
  # limitations under the License.
16
14
 
17
- # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
-
19
-
20
15
  module Google
21
16
  module Cloud
22
17
  module Iot
23
- VERSION = "1.2.0"
18
+ VERSION = "2.0.0"
24
19
  end
25
20
  end
26
21
  end
metadata CHANGED
@@ -1,180 +1,37 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-iot
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.2.0
4
+ version: 2.0.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: 2023-03-09 00:00:00.000000000 Z
12
- dependencies:
13
- - !ruby/object:Gem::Dependency
14
- name: google-cloud-core
15
- requirement: !ruby/object:Gem::Requirement
16
- requirements:
17
- - - "~>"
18
- - !ruby/object:Gem::Version
19
- version: '1.6'
20
- type: :runtime
21
- prerelease: false
22
- version_requirements: !ruby/object:Gem::Requirement
23
- requirements:
24
- - - "~>"
25
- - !ruby/object:Gem::Version
26
- version: '1.6'
27
- - !ruby/object:Gem::Dependency
28
- name: google-cloud-iot-v1
29
- requirement: !ruby/object:Gem::Requirement
30
- requirements:
31
- - - ">="
32
- - !ruby/object:Gem::Version
33
- version: '0.6'
34
- - - "<"
35
- - !ruby/object:Gem::Version
36
- version: 2.a
37
- type: :runtime
38
- prerelease: false
39
- version_requirements: !ruby/object:Gem::Requirement
40
- requirements:
41
- - - ">="
42
- - !ruby/object:Gem::Version
43
- version: '0.6'
44
- - - "<"
45
- - !ruby/object:Gem::Version
46
- version: 2.a
47
- - !ruby/object:Gem::Dependency
48
- name: google-style
49
- requirement: !ruby/object:Gem::Requirement
50
- requirements:
51
- - - "~>"
52
- - !ruby/object:Gem::Version
53
- version: 1.26.1
54
- type: :development
55
- prerelease: false
56
- version_requirements: !ruby/object:Gem::Requirement
57
- requirements:
58
- - - "~>"
59
- - !ruby/object:Gem::Version
60
- version: 1.26.1
61
- - !ruby/object:Gem::Dependency
62
- name: minitest
63
- requirement: !ruby/object:Gem::Requirement
64
- requirements:
65
- - - "~>"
66
- - !ruby/object:Gem::Version
67
- version: '5.16'
68
- type: :development
69
- prerelease: false
70
- version_requirements: !ruby/object:Gem::Requirement
71
- requirements:
72
- - - "~>"
73
- - !ruby/object:Gem::Version
74
- version: '5.16'
75
- - !ruby/object:Gem::Dependency
76
- name: minitest-focus
77
- requirement: !ruby/object:Gem::Requirement
78
- requirements:
79
- - - "~>"
80
- - !ruby/object:Gem::Version
81
- version: '1.1'
82
- type: :development
83
- prerelease: false
84
- version_requirements: !ruby/object:Gem::Requirement
85
- requirements:
86
- - - "~>"
87
- - !ruby/object:Gem::Version
88
- version: '1.1'
89
- - !ruby/object:Gem::Dependency
90
- name: minitest-rg
91
- requirement: !ruby/object:Gem::Requirement
92
- requirements:
93
- - - "~>"
94
- - !ruby/object:Gem::Version
95
- version: '5.2'
96
- type: :development
97
- prerelease: false
98
- version_requirements: !ruby/object:Gem::Requirement
99
- requirements:
100
- - - "~>"
101
- - !ruby/object:Gem::Version
102
- version: '5.2'
103
- - !ruby/object:Gem::Dependency
104
- name: rake
105
- requirement: !ruby/object:Gem::Requirement
106
- requirements:
107
- - - ">="
108
- - !ruby/object:Gem::Version
109
- version: '13.0'
110
- type: :development
111
- prerelease: false
112
- version_requirements: !ruby/object:Gem::Requirement
113
- requirements:
114
- - - ">="
115
- - !ruby/object:Gem::Version
116
- version: '13.0'
117
- - !ruby/object:Gem::Dependency
118
- name: redcarpet
119
- requirement: !ruby/object:Gem::Requirement
120
- requirements:
121
- - - "~>"
122
- - !ruby/object:Gem::Version
123
- version: '3.0'
124
- type: :development
125
- prerelease: false
126
- version_requirements: !ruby/object:Gem::Requirement
127
- requirements:
128
- - - "~>"
129
- - !ruby/object:Gem::Version
130
- version: '3.0'
131
- - !ruby/object:Gem::Dependency
132
- name: simplecov
133
- requirement: !ruby/object:Gem::Requirement
134
- requirements:
135
- - - "~>"
136
- - !ruby/object:Gem::Version
137
- version: '0.9'
138
- type: :development
139
- prerelease: false
140
- version_requirements: !ruby/object:Gem::Requirement
141
- requirements:
142
- - - "~>"
143
- - !ruby/object:Gem::Version
144
- version: '0.9'
145
- - !ruby/object:Gem::Dependency
146
- name: yard
147
- requirement: !ruby/object:Gem::Requirement
148
- requirements:
149
- - - "~>"
150
- - !ruby/object:Gem::Version
151
- version: '0.9'
152
- type: :development
153
- prerelease: false
154
- version_requirements: !ruby/object:Gem::Requirement
155
- requirements:
156
- - - "~>"
157
- - !ruby/object:Gem::Version
158
- version: '0.9'
159
- description: Registers and manages IoT (Internet of Things) devices that connect to
160
- the Google Cloud Platform.
11
+ date: 2024-02-07 00:00:00.000000000 Z
12
+ dependencies: []
13
+ description: This gem is obsolete because the related Google backend is turned down.
14
+ For more information, see https://cloud.google.com/terms/deprecation.
161
15
  email: googleapis-packages@google.com
162
16
  executables: []
163
17
  extensions: []
164
18
  extra_rdoc_files: []
165
19
  files:
166
- - ".yardopts"
167
- - AUTHENTICATION.md
168
20
  - LICENSE.md
169
21
  - README.md
170
- - lib/google-cloud-iot.rb
171
- - lib/google/cloud/iot.rb
172
22
  - lib/google/cloud/iot/version.rb
173
23
  homepage: https://github.com/googleapis/google-cloud-ruby
174
24
  licenses:
175
25
  - Apache-2.0
176
26
  metadata: {}
177
- post_install_message:
27
+ post_install_message: |2+
28
+
29
+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
30
+ The google-cloud-iot gem is OBSOLETE.
31
+ For more information, see:
32
+ https://cloud.google.com/terms/deprecation
33
+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
34
+
178
35
  rdoc_options: []
179
36
  require_paths:
180
37
  - lib
@@ -182,15 +39,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
182
39
  requirements:
183
40
  - - ">="
184
41
  - !ruby/object:Gem::Version
185
- version: '2.6'
42
+ version: '2.0'
186
43
  required_rubygems_version: !ruby/object:Gem::Requirement
187
44
  requirements:
188
45
  - - ">="
189
46
  - !ruby/object:Gem::Version
190
47
  version: '0'
191
48
  requirements: []
192
- rubygems_version: 3.4.2
49
+ rubygems_version: 3.5.3
193
50
  signing_key:
194
51
  specification_version: 4
195
- summary: API Client library for the Cloud IoT API
52
+ summary: This gem is obsolete because the related backend is turned down.
196
53
  test_files: []
data/.yardopts DELETED
@@ -1,11 +0,0 @@
1
- --no-private
2
- --title="Cloud IoT API"
3
- --exclude _pb\.rb$
4
- --markup markdown
5
- --markup-provider redcarpet
6
-
7
- ./lib/**/*.rb
8
- -
9
- README.md
10
- AUTHENTICATION.md
11
- LICENSE.md
data/AUTHENTICATION.md DELETED
@@ -1,151 +0,0 @@
1
- # Authentication
2
-
3
- In general, the google-cloud-iot library uses
4
- [Service Account](https://cloud.google.com/iam/docs/creating-managing-service-accounts)
5
- credentials to connect to Google Cloud services. When running within
6
- [Google Cloud Platform environments](#google-cloud-platform-environments) the
7
- credentials will be discovered automatically. When running on other
8
- environments, the Service Account credentials can be specified by providing the
9
- path to the
10
- [JSON keyfile](https://cloud.google.com/iam/docs/managing-service-account-keys)
11
- for the account (or the JSON itself) in
12
- [environment variables](#environment-variables). Additionally, Cloud SDK
13
- credentials can also be discovered automatically, but this is only recommended
14
- during development.
15
-
16
- ## Quickstart
17
-
18
- 1. [Create a service account and credentials](#creating-a-service-account).
19
- 2. Set the [environment variable](#environment-variables).
20
-
21
- ```sh
22
- export IOT_CREDENTIALS=path/to/keyfile.json
23
- ```
24
-
25
- 3. Initialize the client.
26
-
27
- ```ruby
28
- require "google/cloud/iot"
29
-
30
- client = Google::Cloud::Iot.device_manager
31
- ```
32
-
33
- ## Credential Lookup
34
-
35
- The google-cloud-iot library aims to make authentication
36
- as simple as possible, and provides several mechanisms to configure your system
37
- without requiring **Service Account Credentials** directly in code.
38
-
39
- **Credentials** are discovered in the following order:
40
-
41
- 1. Specify credentials in method arguments
42
- 2. Specify credentials in configuration
43
- 3. Discover credentials path in environment variables
44
- 4. Discover credentials JSON in environment variables
45
- 5. Discover credentials file in the Cloud SDK's path
46
- 6. Discover GCP credentials
47
-
48
- ### Google Cloud Platform environments
49
-
50
- When running on Google Cloud Platform (GCP), including Google Compute Engine
51
- (GCE), Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud
52
- Functions (GCF) and Cloud Run, **Credentials** are discovered automatically.
53
- Code should be written as if already authenticated.
54
-
55
- ### Environment Variables
56
-
57
- The **Credentials JSON** can be placed in environment variables instead of
58
- declaring them directly in code. Each service has its own environment variable,
59
- allowing for different service accounts to be used for different services. (See
60
- the READMEs for the individual service gems for details.) The path to the
61
- **Credentials JSON** file can be stored in the environment variable, or the
62
- **Credentials JSON** itself can be stored for environments such as Docker
63
- containers where writing files is difficult or not encouraged.
64
-
65
- The environment variables that google-cloud-iot
66
- checks for credentials are configured on the service Credentials class (such as
67
- `::Google::Cloud::Iot::V1::DeviceManager::Credentials`):
68
-
69
- * `IOT_CREDENTIALS` - Path to JSON file, or JSON contents
70
- * `IOT_KEYFILE` - Path to JSON file, or JSON contents
71
- * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
- * `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
- * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
74
-
75
- ```ruby
76
- require "google/cloud/iot"
77
-
78
- ENV["IOT_CREDENTIALS"] = "path/to/keyfile.json"
79
-
80
- client = Google::Cloud::Iot.device_manager
81
- ```
82
-
83
- ### Configuration
84
-
85
- The path to the **Credentials JSON** file can be configured instead of storing
86
- it in an environment variable. Either on an individual client initialization:
87
-
88
- ```ruby
89
- require "google/cloud/iot"
90
-
91
- client = Google::Cloud::Iot.device_manager do |config|
92
- config.credentials = "path/to/keyfile.json"
93
- end
94
- ```
95
-
96
- Or globally for all clients:
97
-
98
- ```ruby
99
- require "google/cloud/iot"
100
-
101
- Google::Cloud::Iot.configure do |config|
102
- config.credentials = "path/to/keyfile.json"
103
- end
104
-
105
- client = Google::Cloud::Iot.device_manager
106
- ```
107
-
108
- ### Cloud SDK
109
-
110
- This option allows for an easy way to authenticate during development. If
111
- credentials are not provided in code or in environment variables, then Cloud SDK
112
- credentials are discovered.
113
-
114
- To configure your system for this, simply:
115
-
116
- 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
117
- 2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
118
- 3. Write code as if already authenticated.
119
-
120
- **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
121
- *should* only be used during development.
122
-
123
- ## Creating a Service Account
124
-
125
- Google Cloud requires **Service Account Credentials** to
126
- connect to the APIs. You will use the **JSON key file** to
127
- connect to most services with google-cloud-iot.
128
-
129
- If you are not running this client within
130
- [Google Cloud Platform environments](#google-cloud-platform-environments), you
131
- need a Google Developers service account.
132
-
133
- 1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
134
- 2. Create a new project or click on an existing project.
135
- 3. Activate the menu in the upper left and select **APIs & Services**. From
136
- here, you will enable the APIs that your application requires.
137
-
138
- *Note: You may need to enable billing in order to use these services.*
139
-
140
- 4. Select **Credentials** from the side navigation.
141
-
142
- Find the "Create credentials" drop down near the top of the page, and select
143
- "Service account" to be guided through downloading a new JSON key file.
144
-
145
- If you want to re-use an existing service account, you can easily generate a
146
- new key file. Just select the account you wish to re-use, click the pencil
147
- tool on the right side to edit the service account, select the **Keys** tab,
148
- and then select **Add Key**.
149
-
150
- The key file you download will be used by this library to authenticate API
151
- requests and should be stored in a secure location.
@@ -1,119 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright 2020 Google LLC
4
- #
5
- # Licensed under the Apache License, Version 2.0 (the "License");
6
- # you may not use this file except in compliance with the License.
7
- # You may obtain a copy of the License at
8
- #
9
- # https://www.apache.org/licenses/LICENSE-2.0
10
- #
11
- # Unless required by applicable law or agreed to in writing, software
12
- # distributed under the License is distributed on an "AS IS" BASIS,
13
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- # See the License for the specific language governing permissions and
15
- # limitations under the License.
16
-
17
- # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
-
19
- # Require this file early so that the version constant gets defined before
20
- # requiring "google/cloud". This is because google-cloud-core will load the
21
- # entrypoint (gem name) file, which in turn re-requires this file (hence
22
- # causing a require cycle) unless the version constant is already defined.
23
- require "google/cloud/iot/version"
24
-
25
- require "googleauth"
26
- gem "google-cloud-core"
27
- require "google/cloud" unless defined? ::Google::Cloud.new
28
- require "google/cloud/config"
29
-
30
- # Set the default configuration
31
- ::Google::Cloud.configure.add_config! :iot do |config|
32
- config.add_field! :endpoint, "cloudiot.googleapis.com", match: ::String
33
- config.add_field! :credentials, nil, match: [::String, ::Hash, ::Google::Auth::Credentials]
34
- config.add_field! :scope, nil, match: [::Array, ::String]
35
- config.add_field! :lib_name, nil, match: ::String
36
- config.add_field! :lib_version, nil, match: ::String
37
- config.add_field! :interceptors, nil, match: ::Array
38
- config.add_field! :timeout, nil, match: ::Numeric
39
- config.add_field! :metadata, nil, match: ::Hash
40
- config.add_field! :retry_policy, nil, match: [::Hash, ::Proc]
41
- config.add_field! :quota_project, nil, match: ::String
42
- end
43
-
44
- module Google
45
- module Cloud
46
- module Iot
47
- ##
48
- # Create a new client object for DeviceManager.
49
- #
50
- # By default, this returns an instance of
51
- # [Google::Cloud::Iot::V1::DeviceManager::Client](https://googleapis.dev/ruby/google-cloud-iot-v1/latest/Google/Cloud/Iot/V1/DeviceManager/Client.html)
52
- # for a gRPC client for version V1 of the API.
53
- # However, you can specify a different API version by passing it in the
54
- # `version` parameter. If the DeviceManager service is
55
- # supported by that API version, and the corresponding gem is available, the
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.
59
- #
60
- # ## About DeviceManager
61
- #
62
- # Internet of Things (IoT) service. Securely connect and manage IoT devices.
63
- #
64
- # @param version [::String, ::Symbol] The API version to connect to. Optional.
65
- # Defaults to `:v1`.
66
- # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
67
- # @return [::Object] A client object for the specified version.
68
- #
69
- def self.device_manager version: :v1, transport: :grpc, &block
70
- require "google/cloud/iot/#{version.to_s.downcase}"
71
-
72
- package_name = Google::Cloud::Iot
73
- .constants
74
- .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
75
- .first
76
- service_module = Google::Cloud::Iot.const_get(package_name).const_get(:DeviceManager)
77
- service_module = service_module.const_get(:Rest) if transport == :rest
78
- service_module.const_get(:Client).new(&block)
79
- end
80
-
81
- ##
82
- # Configure the google-cloud-iot library.
83
- #
84
- # The following configuration parameters are supported:
85
- #
86
- # * `credentials` (*type:* `String, Hash, Google::Auth::Credentials`) -
87
- # The path to the keyfile as a String, the contents of the keyfile as a
88
- # Hash, or a Google::Auth::Credentials object.
89
- # * `lib_name` (*type:* `String`) -
90
- # The library name as recorded in instrumentation and logging.
91
- # * `lib_version` (*type:* `String`) -
92
- # The library version as recorded in instrumentation and logging.
93
- # * `interceptors` (*type:* `Array<GRPC::ClientInterceptor>`) -
94
- # An array of interceptors that are run before calls are executed.
95
- # * `timeout` (*type:* `Numeric`) -
96
- # Default timeout in seconds.
97
- # * `metadata` (*type:* `Hash{Symbol=>String}`) -
98
- # Additional headers to be sent with the call.
99
- # * `retry_policy` (*type:* `Hash`) -
100
- # The retry policy. The value is a hash with the following keys:
101
- # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
102
- # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
103
- # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
104
- # * `:retry_codes` (*type:* `Array<String>`) -
105
- # The error codes that should trigger a retry.
106
- #
107
- # @return [::Google::Cloud::Config] The default configuration used by this library
108
- #
109
- def self.configure
110
- yield ::Google::Cloud.configure.iot if block_given?
111
-
112
- ::Google::Cloud.configure.iot
113
- end
114
- end
115
- end
116
- end
117
-
118
- helper_path = ::File.join __dir__, "iot", "helpers.rb"
119
- require "google/cloud/iot/helpers" if ::File.file? helper_path
@@ -1,19 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright 2020 Google LLC
4
- #
5
- # Licensed under the Apache License, Version 2.0 (the "License");
6
- # you may not use this file except in compliance with the License.
7
- # You may obtain a copy of the License at
8
- #
9
- # https://www.apache.org/licenses/LICENSE-2.0
10
- #
11
- # Unless required by applicable law or agreed to in writing, software
12
- # distributed under the License is distributed on an "AS IS" BASIS,
13
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- # See the License for the specific language governing permissions and
15
- # limitations under the License.
16
-
17
- # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
-
19
- require "google/cloud/iot" unless defined? Google::Cloud::Iot::VERSION