google-cloud-iot-v1 0.9.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e22b4ae09523862e46ed9ebbf7f69be4e425a28eed3dbef9be277e9b5781232
-  data.tar.gz: e480c18f1ed6c09913b1f05590d6da2698781f407e6df4f03d5de22f7f123c11
+  metadata.gz: 757ea2616690ccdfc1b565744c84b1c6970ec2ed09a07011a3730b8c508b63db
+  data.tar.gz: 15f4412365eeba96864bee71b9acb24da72cad8e13a7d89c32b83fc3b404ff2b
 SHA512:
-  metadata.gz: 74faaed5b9519978e7f2a6cecd39aa706038db34ff952c68b757cf54e1b1791e718ce855fe1289de48e454206615719e2f1b01fd43cda1b8aa42cdc932bb763d
-  data.tar.gz: 63a366e48eba5c38bd86794b6f05781e4f8f25f7c6eb81ed55c1c4f5b832bd7799487e2064c89d69a71e9942f5c34078159170bac97360d153b5b4c2719dfac9
+  metadata.gz: 4a1d81d4e9daac94d82132f106e821696489f29de2346a21e0cd7ec7d4ca70892b4d0aa984aca46a91f7d900907e03f7c79bf2cc4d0b59d730864d8168899517
+  data.tar.gz: 02e9216687355528756ca07904be544fb1003ba48d0916810adb33399fce6163463f6713663f32279030afe1c9c3be8bbc609951767400d021a0685eb411fbf9

data/README.md

@@ -1,144 +1,4 @@
-# Ruby Client for the Cloud IoT V1 API
+# Tombstone for Ruby gem google-cloud-iot-v1
 
-Registers and manages IoT (Internet of Things) devices that connect to the Google Cloud Platform.
-
-Registers and manages IoT (Internet of Things) devices that connect to the Google Cloud Platform.
-
-https://github.com/googleapis/google-cloud-ruby
-
-This gem is a _versioned_ client. It provides basic client classes for a
-specific version of the Cloud IoT V1 API. Most users should consider using
-the main client gem,
-[google-cloud-iot](https://rubygems.org/gems/google-cloud-iot).
-See the section below titled *Which client should I use?* for more information.
-
-## Installation
-
-```
-$ gem install google-cloud-iot-v1
-```
-
-## Before You Begin
-
-In order to use this library, you first need to go through the following steps:
-
-1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
-1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
-1. [Enable the API.](https://console.cloud.google.com/apis/library/cloudiot.googleapis.com)
-1. {file:AUTHENTICATION.md Set up authentication.}
-
-## Quick Start
-
-```ruby
-require "google/cloud/iot/v1"
-
-client = ::Google::Cloud::Iot::V1::DeviceManager::Client.new
-request = ::Google::Cloud::Iot::V1::CreateDeviceRegistryRequest.new # (request fields as keyword arguments...)
-response = client.create_device_registry request
-```
-
-View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-iot-v1/latest)
-for class and method documentation.
-
-See also the [Product Documentation](https://cloud.google.com/iot)
-for general usage information.
-
-## Enabling Logging
-
-To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
-The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
-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)
-and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
-
-Configuring a Ruby stdlib logger:
-
-```ruby
-require "logger"
-
-module MyLogger
-  LOGGER = Logger.new $stderr, level: Logger::WARN
-  def logger
-    LOGGER
-  end
-end
-
-# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
-module GRPC
-  extend MyLogger
-end
-```
-
-
-## Google Cloud Samples
-
-To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
-
-## Supported Ruby Versions
-
-This library is supported on Ruby 2.6+.
-
-Google provides official support for Ruby versions that are actively supported
-by Ruby Core—that is, Ruby versions that are either in normal maintenance or
-in security maintenance, and not end of life. Older versions of Ruby _may_
-still work, but are unsupported and not recommended. See
-https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
-support schedule.
-
-## Which client should I use?
-
-Most modern Ruby client libraries for Google APIs come in two flavors: the main
-client library with a name such as `google-cloud-iot`,
-and lower-level _versioned_ client libraries with names such as
-`google-cloud-iot-v1`.
-_In most cases, you should install the main client._
-
-### What's the difference between the main client and a versioned client?
-
-A _versioned client_ provides a basic set of data types and client classes for
-a _single version_ of a specific service. (That is, for a service with multiple
-versions, there might be a separate versioned client for each service version.)
-Most versioned clients are written and maintained by a code generator.
-
-The _main client_ is designed to provide you with the _recommended_ client
-interfaces for the service. There will be only one main client for any given
-service, even a service with multiple versions. The main client includes
-factory methods for constructing the client objects we recommend for most
-users. In some cases, those will be classes provided by an underlying versioned
-client; in other cases, they will be handwritten higher-level client objects
-with additional capabilities, convenience methods, or best practices built in.
-Generally, the main client will default to a recommended service version,
-although in some cases you can override this if you need to talk to a specific
-service version.
-
-### Why would I want to use the main client?
-
-We recommend that most users install the main client gem for a service. You can
-identify this gem as the one _without_ a version in its name, e.g.
-`google-cloud-iot`.
-The main client is recommended because it will embody the best practices for
-accessing the service, and may also provide more convenient interfaces or
-tighter integration into frameworks and third-party libraries. In addition, the
-documentation and samples published by Google will generally demonstrate use of
-the main client.
-
-### Why would I want to use a versioned client?
-
-You can use a versioned client if you are content with a possibly lower-level
-class interface, you explicitly want to avoid features provided by the main
-client, or you want to access a specific service version not be covered by the
-main client. You can identify versioned client gems because the service version
-is part of the name, e.g. `google-cloud-iot-v1`.
-
-### What about the google-apis-<name> clients?
-
-Client library gems with names that begin with `google-apis-` are based on an
-older code generation technology. They talk to a REST/JSON backend (whereas
-most modern clients talk to a [gRPC](https://grpc.io/) backend) and they may
-not offer the same performance, features, and ease of use provided by more
-modern clients.
-
-The `google-apis-` clients have wide coverage across Google services, so you
-might need to use one if there is no modern client available for the service.
-However, if a modern client is available, we generally recommend it over the
-older `google-apis-` clients.
+This gem is obsolete because the related Google backend is turned down.
+For more information, see https://cloud.google.com/terms/deprecation.

data/lib/google/cloud/iot/v1/version.rb

@@ -1,12 +1,10 @@
-# frozen_string_literal: true
-
-# Copyright 2020 Google LLC
+# Copyright 2024 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-#     https://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,
@@ -14,14 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
-
-
 module Google
   module Cloud
     module Iot
       module V1
-        VERSION = "0.9.1"
+        VERSION = "1.0.0"
       end
     end
   end

metadata

@@ -1,224 +1,37 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-iot-v1
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-12 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: gapic-common
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.21.1
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 2.a
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.21.1
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 2.a
-- !ruby/object:Gem::Dependency
-  name: google-cloud-errors
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: grpc-google-iam-v1
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-- !ruby/object:Gem::Dependency
-  name: google-style
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.26.3
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.26.3
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.16'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.16'
-- !ruby/object:Gem::Dependency
-  name: minitest-focus
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-- !ruby/object:Gem::Dependency
-  name: minitest-rg
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.2'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: redcarpet
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.18'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.18'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-description: Registers and manages IoT (Internet of Things) devices that connect to
-  the Google Cloud Platform. Note that google-cloud-iot-v1 is a version-specific client
-  library. For most uses, we recommend installing the main client library google-cloud-iot
-  instead. See the readme for more details.
+date: 2024-02-07 00:00:00.000000000 Z
+dependencies: []
+description: This gem is obsolete because the related Google backend is turned down.
+  For more information, see https://cloud.google.com/terms/deprecation.
 email: googleapis-packages@google.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".yardopts"
-- AUTHENTICATION.md
 - LICENSE.md
 - README.md
-- lib/google-cloud-iot-v1.rb
-- lib/google/cloud/iot/v1.rb
-- lib/google/cloud/iot/v1/device_manager.rb
-- lib/google/cloud/iot/v1/device_manager/client.rb
-- lib/google/cloud/iot/v1/device_manager/credentials.rb
-- lib/google/cloud/iot/v1/device_manager/paths.rb
-- lib/google/cloud/iot/v1/device_manager/rest.rb
-- lib/google/cloud/iot/v1/device_manager/rest/client.rb
-- lib/google/cloud/iot/v1/device_manager/rest/service_stub.rb
-- lib/google/cloud/iot/v1/device_manager_pb.rb
-- lib/google/cloud/iot/v1/device_manager_services_pb.rb
-- lib/google/cloud/iot/v1/resources_pb.rb
-- lib/google/cloud/iot/v1/rest.rb
 - lib/google/cloud/iot/v1/version.rb
-- proto_docs/README.md
-- proto_docs/google/api/client.rb
-- proto_docs/google/api/field_behavior.rb
-- proto_docs/google/api/launch_stage.rb
-- proto_docs/google/api/resource.rb
-- proto_docs/google/cloud/iot/v1/device_manager.rb
-- proto_docs/google/cloud/iot/v1/resources.rb
-- proto_docs/google/iam/v1/iam_policy.rb
-- proto_docs/google/iam/v1/options.rb
-- proto_docs/google/iam/v1/policy.rb
-- proto_docs/google/protobuf/any.rb
-- proto_docs/google/protobuf/duration.rb
-- proto_docs/google/protobuf/empty.rb
-- proto_docs/google/protobuf/field_mask.rb
-- proto_docs/google/protobuf/timestamp.rb
-- proto_docs/google/rpc/status.rb
-- proto_docs/google/type/expr.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message: |2+
+
+  !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+  The google-cloud-iot-v1 gem is OBSOLETE.
+  For more information, see:
+  https://cloud.google.com/terms/deprecation
+  !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
 rdoc_options: []
 require_paths:
 - lib
@@ -226,7 +39,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.6'
+      version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -236,6 +49,5 @@ requirements: []
 rubygems_version: 3.5.3
 signing_key: 
 specification_version: 4
-summary: Registers and manages IoT (Internet of Things) devices that connect to the
-  Google Cloud Platform.
+summary: This gem is obsolete because the related backend is turned down.
 test_files: []

data/.yardopts

@@ -1,12 +0,0 @@
---no-private
---title="Cloud IoT V1 API"
---exclude _pb\.rb$
---markup markdown
---markup-provider redcarpet
-
-./lib/**/*.rb
-./proto_docs/**/*.rb
--
-README.md
-LICENSE.md
-AUTHENTICATION.md

data/AUTHENTICATION.md

@@ -1,122 +0,0 @@
-# Authentication
-
-The recommended way to authenticate to the google-cloud-iot-v1 library is to use
-[Application Default Credentials (ADC)](https://cloud.google.com/docs/authentication/application-default-credentials).
-To review all of your authentication options, see [Credentials lookup](#credential-lookup).
-
-## Quickstart
-
-The following example shows how to set up authentication for a local development
-environment with your user credentials. 
-
-**NOTE:** This method is _not_ recommended for running in production. User credentials
-should be used only during development.
-
-1. [Download and install the Google Cloud CLI](https://cloud.google.com/sdk).
-2. Set up a local ADC file with your user credentials:
-
-```sh
-gcloud auth application-default login
-```
-
-3. Write code as if already authenticated.
-
-For more information about setting up authentication for a local development environment, see
-[Set up Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-dev).
-
-## Credential Lookup
-
-The google-cloud-iot-v1 library provides several mechanisms to configure your system.
-Generally, using Application Default Credentials to facilitate automatic 
-credentials discovery is the easist method. But if you need to explicitly specify
-credentials, there are several methods available to you.
-
-Credentials are accepted in the following ways, in the following order or precedence:
-
-1. Credentials specified in method arguments
-2. Credentials specified in configuration
-3. Credentials pointed to or included in environment variables
-4. Credentials found in local ADC file
-5. Credentials returned by the metadata server for the attached service account (GCP)
-
-### Configuration
-
-You can configure a path to a JSON credentials file, either for an individual client object or
-globally, for all client objects. The JSON file can contain credentials created for
-[workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
-[workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
-[service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
-
-Note: Service account keys are a security risk if not managed correctly. You should
-[choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
-whenever possible.
-
-To configure a credentials file for an individual client initialization:
-
-```ruby
-require "google/cloud/iot/v1"
-
-client = ::Google::Cloud::Iot::V1::DeviceManager::Client.new do |config|
-  config.credentials = "path/to/credentialfile.json"
-end
-```
-
-To configure a credentials file globally for all clients:
-
-```ruby
-require "google/cloud/iot/v1"
-
-::Google::Cloud::Iot::V1::DeviceManager::Client.configure do |config|
-  config.credentials = "path/to/credentialfile.json"
-end
-
-client = ::Google::Cloud::Iot::V1::DeviceManager::Client.new
-```
-
-### Environment Variables
-
-You can also use an environment variable to provide a JSON credentials file.
-The environment variable can contain a path to the credentials file or, for
-environments such as Docker containers where writing files is not encouraged,
-you can include the credentials file itself.
-
-The JSON file can contain credentials created for
-[workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
-[workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
-[service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
-
-Note: Service account keys are a security risk if not managed correctly. You should
-[choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
-whenever possible.
-
-The environment variables that google-cloud-iot-v1
-checks for credentials are:
-
-* `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
-* `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
-
-```ruby
-require "google/cloud/iot/v1"
-
-ENV["GOOGLE_APPLICATION_CREDENTIALS"] = "path/to/credentialfile.json"
-
-client = ::Google::Cloud::Iot::V1::DeviceManager::Client.new
-```
-
-### Local ADC file
-
-You can set up a local ADC file with your user credentials for authentication during
-development. If credentials are not provided in code or in environment variables,
-then the local ADC credentials are discovered.
-
-Follow the steps in [Quickstart](#quickstart) to set up a local ADC file.
-
-### Google Cloud Platform environments
-
-When running on Google Cloud Platform (GCP), including Google Compute Engine
-(GCE), Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud
-Functions (GCF) and Cloud Run, credentials are retrieved from the attached
-service account automatically. Code should be written as if already authenticated.
-
-For more information, see
-[Set up ADC for Google Cloud services](https://cloud.google.com/docs/authentication/provide-credentials-adc#attached-sa).