google-cloud-apigee_connect 1.1.0 → 1.2.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 +4 -4
 - data/AUTHENTICATION.md +1 -1
 - data/README.md +0 -26
 - data/lib/google/cloud/apigee_connect/version.rb +1 -1
 - data/lib/google/cloud/apigee_connect.rb +16 -12
 - metadata +5 -5
 
    
        checksums.yaml
    CHANGED
    
    | 
         @@ -1,7 +1,7 @@ 
     | 
|
| 
       1 
1 
     | 
    
         
             
            ---
         
     | 
| 
       2 
2 
     | 
    
         
             
            SHA256:
         
     | 
| 
       3 
     | 
    
         
            -
              metadata.gz:  
     | 
| 
       4 
     | 
    
         
            -
              data.tar.gz:  
     | 
| 
      
 3 
     | 
    
         
            +
              metadata.gz: f6ba7a1253837ea9425d7ca42f3cc898d0ab560e9143138221a03e8a8532c2b4
         
     | 
| 
      
 4 
     | 
    
         
            +
              data.tar.gz: ecd43acd8acdde87466298b9f31939eb795147f8421376c3acf5cbb3470329e9
         
     | 
| 
       5 
5 
     | 
    
         
             
            SHA512:
         
     | 
| 
       6 
     | 
    
         
            -
              metadata.gz:  
     | 
| 
       7 
     | 
    
         
            -
              data.tar.gz:  
     | 
| 
      
 6 
     | 
    
         
            +
              metadata.gz: 26d67ef7b409c8e2998b1665cf9b0410e2af8a3a2bd406451e412a71279be262a2a9267a39a98cb7ab46d79f485421458aa29859ddd174149e9352f1cbd28fd1
         
     | 
| 
      
 7 
     | 
    
         
            +
              data.tar.gz: f215310d6d15ed81b1014e190b8756907fde5ccad22051b663c27fa9792c3191a8f4be5d1b2ebbeb6bc78fbd688d34802db1b3b6fd6b470a0c8e47c981168002
         
     | 
    
        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/apigeeconnect.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+.
         
     | 
| 
         @@ -49,11 +49,13 @@ module Google 
     | 
|
| 
       49 
49 
     | 
    
         
             
                  #
         
     | 
| 
       50 
50 
     | 
    
         
             
                  # By default, this returns an instance of
         
     | 
| 
       51 
51 
     | 
    
         
             
                  # [Google::Cloud::ApigeeConnect::V1::ConnectionService::Client](https://googleapis.dev/ruby/google-cloud-apigee_connect-v1/latest/Google/Cloud/ApigeeConnect/V1/ConnectionService/Client.html)
         
     | 
| 
       52 
     | 
    
         
            -
                  # for version V1 of the API.
         
     | 
| 
       53 
     | 
    
         
            -
                  # However, you can specify  
     | 
| 
      
 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 
54 
     | 
    
         
             
                  # `version` parameter. If the ConnectionService 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 ConnectionService
         
     | 
| 
       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 `:v1`.
         
     | 
| 
       64 
     | 
    
         
            -
                  # @ 
     | 
| 
      
 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.connection_service version: :v1, &block
         
     | 
| 
      
 69 
     | 
    
         
            +
                  def self.connection_service version: :v1, transport: :grpc, &block
         
     | 
| 
       67 
70 
     | 
    
         
             
                    require "google/cloud/apigee_connect/#{version.to_s.downcase}"
         
     | 
| 
       68 
71 
     | 
    
         | 
| 
       69 
72 
     | 
    
         
             
                    package_name = Google::Cloud::ApigeeConnect
         
     | 
| 
       70 
73 
     | 
    
         
             
                                   .constants
         
     | 
| 
       71 
74 
     | 
    
         
             
                                   .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
         
     | 
| 
       72 
75 
     | 
    
         
             
                                   .first
         
     | 
| 
       73 
     | 
    
         
            -
                     
     | 
| 
       74 
     | 
    
         
            -
                     
     | 
| 
      
 76 
     | 
    
         
            +
                    service_module = Google::Cloud::ApigeeConnect.const_get(package_name).const_get(:ConnectionService)
         
     | 
| 
      
 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,8 +83,8 @@ module Google 
     | 
|
| 
       79 
83 
     | 
    
         
             
                  #
         
     | 
| 
       80 
84 
     | 
    
         
             
                  # By default, this returns an instance of
         
     | 
| 
       81 
85 
     | 
    
         
             
                  # [Google::Cloud::ApigeeConnect::V1::Tether::Client](https://googleapis.dev/ruby/google-cloud-apigee_connect-v1/latest/Google/Cloud/ApigeeConnect/V1/Tether/Client.html)
         
     | 
| 
       82 
     | 
    
         
            -
                  # for version V1 of the API.
         
     | 
| 
       83 
     | 
    
         
            -
                  # However, you can specify  
     | 
| 
      
 86 
     | 
    
         
            +
                  # for a gRPC client for version V1 of the API.
         
     | 
| 
      
 87 
     | 
    
         
            +
                  # However, you can specify a different API version by passing it in the
         
     | 
| 
       84 
88 
     | 
    
         
             
                  # `version` parameter. If the Tether service is
         
     | 
| 
       85 
89 
     | 
    
         
             
                  # supported by that API version, and the corresponding gem is available, the
         
     | 
| 
       86 
90 
     | 
    
         
             
                  # appropriate versioned client will be returned.
         
     | 
| 
         @@ -93,7 +97,7 @@ module Google 
     | 
|
| 
       93 
97 
     | 
    
         
             
                  #
         
     | 
| 
       94 
98 
     | 
    
         
             
                  # @param version [::String, ::Symbol] The API version to connect to. Optional.
         
     | 
| 
       95 
99 
     | 
    
         
             
                  #   Defaults to `:v1`.
         
     | 
| 
       96 
     | 
    
         
            -
                  # @return [ 
     | 
| 
      
 100 
     | 
    
         
            +
                  # @return [::Object] A client object for the specified version.
         
     | 
| 
       97 
101 
     | 
    
         
             
                  #
         
     | 
| 
       98 
102 
     | 
    
         
             
                  def self.tether version: :v1, &block
         
     | 
| 
       99 
103 
     | 
    
         
             
                    require "google/cloud/apigee_connect/#{version.to_s.downcase}"
         
     | 
| 
         @@ -102,8 +106,8 @@ module Google 
     | 
|
| 
       102 
106 
     | 
    
         
             
                                   .constants
         
     | 
| 
       103 
107 
     | 
    
         
             
                                   .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
         
     | 
| 
       104 
108 
     | 
    
         
             
                                   .first
         
     | 
| 
       105 
     | 
    
         
            -
                     
     | 
| 
       106 
     | 
    
         
            -
                     
     | 
| 
      
 109 
     | 
    
         
            +
                    service_module = Google::Cloud::ApigeeConnect.const_get(package_name).const_get(:Tether)
         
     | 
| 
      
 110 
     | 
    
         
            +
                    service_module.const_get(:Client).new(&block)
         
     | 
| 
       107 
111 
     | 
    
         
             
                  end
         
     | 
| 
       108 
112 
     | 
    
         | 
| 
       109 
113 
     | 
    
         
             
                  ##
         
     | 
| 
         @@ -123,7 +127,7 @@ module Google 
     | 
|
| 
       123 
127 
     | 
    
         
             
                  # * `timeout` (*type:* `Numeric`) -
         
     | 
| 
       124 
128 
     | 
    
         
             
                  #   Default timeout in seconds.
         
     | 
| 
       125 
129 
     | 
    
         
             
                  # * `metadata` (*type:* `Hash{Symbol=>String}`) -
         
     | 
| 
       126 
     | 
    
         
            -
                  #   Additional  
     | 
| 
      
 130 
     | 
    
         
            +
                  #   Additional headers to be sent with the call.
         
     | 
| 
       127 
131 
     | 
    
         
             
                  # * `retry_policy` (*type:* `Hash`) -
         
     | 
| 
       128 
132 
     | 
    
         
             
                  #   The retry policy. The value is a hash with the following keys:
         
     | 
| 
       129 
133 
     | 
    
         
             
                  #     * `: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-apigee_connect
         
     | 
| 
       3 
3 
     | 
    
         
             
            version: !ruby/object:Gem::Version
         
     | 
| 
       4 
     | 
    
         
            -
              version: 1. 
     | 
| 
      
 4 
     | 
    
         
            +
              version: 1.2.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:  
     | 
| 
      
 11 
     | 
    
         
            +
            date: 2023-03-09 00:00:00.000000000 Z
         
     | 
| 
       12 
12 
     | 
    
         
             
            dependencies:
         
     | 
| 
       13 
13 
     | 
    
         
             
            - !ruby/object:Gem::Dependency
         
     | 
| 
       14 
14 
     | 
    
         
             
              name: google-cloud-apigee_connect-v1
         
     | 
| 
         @@ -16,7 +16,7 @@ dependencies: 
     | 
|
| 
       16 
16 
     | 
    
         
             
                requirements:
         
     | 
| 
       17 
17 
     | 
    
         
             
                - - ">="
         
     | 
| 
       18 
18 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       19 
     | 
    
         
            -
                    version: '0. 
     | 
| 
      
 19 
     | 
    
         
            +
                    version: '0.3'
         
     | 
| 
       20 
20 
     | 
    
         
             
                - - "<"
         
     | 
| 
       21 
21 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       22 
22 
     | 
    
         
             
                    version: 2.a
         
     | 
| 
         @@ -26,7 +26,7 @@ dependencies: 
     | 
|
| 
       26 
26 
     | 
    
         
             
                requirements:
         
     | 
| 
       27 
27 
     | 
    
         
             
                - - ">="
         
     | 
| 
       28 
28 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       29 
     | 
    
         
            -
                    version: '0. 
     | 
| 
      
 29 
     | 
    
         
            +
                    version: '0.3'
         
     | 
| 
       30 
30 
     | 
    
         
             
                - - "<"
         
     | 
| 
       31 
31 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       32 
32 
     | 
    
         
             
                    version: 2.a
         
     | 
| 
         @@ -191,7 +191,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement 
     | 
|
| 
       191 
191 
     | 
    
         
             
                - !ruby/object:Gem::Version
         
     | 
| 
       192 
192 
     | 
    
         
             
                  version: '0'
         
     | 
| 
       193 
193 
     | 
    
         
             
            requirements: []
         
     | 
| 
       194 
     | 
    
         
            -
            rubygems_version: 3. 
     | 
| 
      
 194 
     | 
    
         
            +
            rubygems_version: 3.4.2
         
     | 
| 
       195 
195 
     | 
    
         
             
            signing_key: 
         
     | 
| 
       196 
196 
     | 
    
         
             
            specification_version: 4
         
     | 
| 
       197 
197 
     | 
    
         
             
            summary: API Client library for the Apigee Connect API
         
     |