google-cloud-apigee_registry 0.2.0 → 1.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 +4 -4
 - data/AUTHENTICATION.md +1 -1
 - data/README.md +1 -27
 - data/lib/google/cloud/apigee_registry/version.rb +1 -1
 - data/lib/google/cloud/apigee_registry.rb +23 -15
 - 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: a95dcce080e339521daf570c5a7f298415636fe2023fa600c1b0d4269b81c64c
         
     | 
| 
      
 4 
     | 
    
         
            +
              data.tar.gz: aa71ab18f6a10723b8e5f1cdd2e450c937d8600bd46cdb69300b0f51a004fdd9
         
     | 
| 
       5 
5 
     | 
    
         
             
            SHA512:
         
     | 
| 
       6 
     | 
    
         
            -
              metadata.gz:  
     | 
| 
       7 
     | 
    
         
            -
              data.tar.gz:  
     | 
| 
      
 6 
     | 
    
         
            +
              metadata.gz: 0b1eebd6f99bc316adda32db14af31a4e4c20dfafc71d5a202a5cd30baa306919ba3041ec604a72001c285928458d4fbfe7b86febbbd5cc62837c3192f429637
         
     | 
| 
      
 7 
     | 
    
         
            +
              data.tar.gz: d40bf7e346bacae67ce58f0ba71f5171ce9cc3a62e2495b07c00cafe79ee1e34b133578ba617a40f6dbab220178fe0c62696bdf0f924dfb785935962608481d2
         
     | 
    
        data/AUTHENTICATION.md
    CHANGED
    
    | 
         @@ -112,7 +112,7 @@ credentials are discovered. 
     | 
|
| 
       112 
112 
     | 
    
         
             
            To configure your system for this, simply:
         
     | 
| 
       113 
113 
     | 
    
         | 
| 
       114 
114 
     | 
    
         
             
            1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
         
     | 
| 
       115 
     | 
    
         
            -
            2. Authenticate using OAuth 2.0 `$ gcloud auth login`
         
     | 
| 
      
 115 
     | 
    
         
            +
            2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
         
     | 
| 
       116 
116 
     | 
    
         
             
            3. Write code as if already authenticated.
         
     | 
| 
       117 
117 
     | 
    
         | 
| 
       118 
118 
     | 
    
         
             
            **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
         
     | 
    
        data/README.md
    CHANGED
    
    | 
         @@ -16,7 +16,7 @@ for this library, google-cloud-apigee_registry, to see the convenience methods f 
     | 
|
| 
       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
         
     | 
| 
       18 
18 
     | 
    
         
             
            client gems:
         
     | 
| 
       19 
     | 
    
         
            -
            [google-cloud-apigee_registry-v1](https:// 
     | 
| 
      
 19 
     | 
    
         
            +
            [google-cloud-apigee_registry-v1](https://cloud.google.com/ruby/docs/reference/google-cloud-apigee_registry-v1/latest).
         
     | 
| 
       20 
20 
     | 
    
         | 
| 
       21 
21 
     | 
    
         
             
            See also the [Product Documentation](https://cloud.google.com/apigee/docs/api-hub/get-started-registry-api/)
         
     | 
| 
       22 
22 
     | 
    
         
             
            for more usage information.
         
     | 
| 
         @@ -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/apigeeregistry.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+.
         
     | 
| 
         @@ -48,12 +48,14 @@ module Google 
     | 
|
| 
       48 
48 
     | 
    
         
             
                  # Create a new client object for Provisioning.
         
     | 
| 
       49 
49 
     | 
    
         
             
                  #
         
     | 
| 
       50 
50 
     | 
    
         
             
                  # By default, this returns an instance of
         
     | 
| 
       51 
     | 
    
         
            -
                  # [Google::Cloud::ApigeeRegistry::V1::Provisioning::Client](https:// 
     | 
| 
       52 
     | 
    
         
            -
                  # for version V1 of the API.
         
     | 
| 
       53 
     | 
    
         
            -
                  # However, you can specify  
     | 
| 
      
 51 
     | 
    
         
            +
                  # [Google::Cloud::ApigeeRegistry::V1::Provisioning::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-apigee_registry-v1/latest/Google-Cloud-ApigeeRegistry-V1-Provisioning-Client)
         
     | 
| 
      
 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 Provisioning 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 Provisioning
         
     | 
| 
       59 
61 
     | 
    
         
             
                  #
         
     | 
| 
         @@ -62,29 +64,33 @@ module Google 
     | 
|
| 
       62 
64 
     | 
    
         
             
                  #
         
     | 
| 
       63 
65 
     | 
    
         
             
                  # @param version [::String, ::Symbol] The API version to connect to. Optional.
         
     | 
| 
       64 
66 
     | 
    
         
             
                  #   Defaults to `:v1`.
         
     | 
| 
       65 
     | 
    
         
            -
                  # @ 
     | 
| 
      
 67 
     | 
    
         
            +
                  # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
         
     | 
| 
      
 68 
     | 
    
         
            +
                  # @return [::Object] A client object for the specified version.
         
     | 
| 
       66 
69 
     | 
    
         
             
                  #
         
     | 
| 
       67 
     | 
    
         
            -
                  def self.provisioning version: :v1, &block
         
     | 
| 
      
 70 
     | 
    
         
            +
                  def self.provisioning version: :v1, transport: :grpc, &block
         
     | 
| 
       68 
71 
     | 
    
         
             
                    require "google/cloud/apigee_registry/#{version.to_s.downcase}"
         
     | 
| 
       69 
72 
     | 
    
         | 
| 
       70 
73 
     | 
    
         
             
                    package_name = Google::Cloud::ApigeeRegistry
         
     | 
| 
       71 
74 
     | 
    
         
             
                                   .constants
         
     | 
| 
       72 
75 
     | 
    
         
             
                                   .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
         
     | 
| 
       73 
76 
     | 
    
         
             
                                   .first
         
     | 
| 
       74 
     | 
    
         
            -
                     
     | 
| 
       75 
     | 
    
         
            -
                     
     | 
| 
      
 77 
     | 
    
         
            +
                    service_module = Google::Cloud::ApigeeRegistry.const_get(package_name).const_get(:Provisioning)
         
     | 
| 
      
 78 
     | 
    
         
            +
                    service_module = service_module.const_get(:Rest) if transport == :rest
         
     | 
| 
      
 79 
     | 
    
         
            +
                    service_module.const_get(:Client).new(&block)
         
     | 
| 
       76 
80 
     | 
    
         
             
                  end
         
     | 
| 
       77 
81 
     | 
    
         | 
| 
       78 
82 
     | 
    
         
             
                  ##
         
     | 
| 
       79 
83 
     | 
    
         
             
                  # Create a new client object for Registry.
         
     | 
| 
       80 
84 
     | 
    
         
             
                  #
         
     | 
| 
       81 
85 
     | 
    
         
             
                  # By default, this returns an instance of
         
     | 
| 
       82 
     | 
    
         
            -
                  # [Google::Cloud::ApigeeRegistry::V1::Registry::Client](https:// 
     | 
| 
       83 
     | 
    
         
            -
                  # for version V1 of the API.
         
     | 
| 
       84 
     | 
    
         
            -
                  # However, you can specify  
     | 
| 
      
 86 
     | 
    
         
            +
                  # [Google::Cloud::ApigeeRegistry::V1::Registry::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-apigee_registry-v1/latest/Google-Cloud-ApigeeRegistry-V1-Registry-Client)
         
     | 
| 
      
 87 
     | 
    
         
            +
                  # for a gRPC client for version V1 of the API.
         
     | 
| 
      
 88 
     | 
    
         
            +
                  # However, you can specify a different API version by passing it in the
         
     | 
| 
       85 
89 
     | 
    
         
             
                  # `version` parameter. If the Registry service is
         
     | 
| 
       86 
90 
     | 
    
         
             
                  # supported by that API version, and the corresponding gem is available, the
         
     | 
| 
       87 
91 
     | 
    
         
             
                  # appropriate versioned client will be returned.
         
     | 
| 
      
 92 
     | 
    
         
            +
                  # You can also specify a different transport by passing `:rest` or `:grpc` in
         
     | 
| 
      
 93 
     | 
    
         
            +
                  # the `transport` parameter.
         
     | 
| 
       88 
94 
     | 
    
         
             
                  #
         
     | 
| 
       89 
95 
     | 
    
         
             
                  # ## About Registry
         
     | 
| 
       90 
96 
     | 
    
         
             
                  #
         
     | 
| 
         @@ -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 `:v1`.
         
     | 
| 
       95 
     | 
    
         
            -
                  # @ 
     | 
| 
      
 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.registry version: :v1, &block
         
     | 
| 
      
 104 
     | 
    
         
            +
                  def self.registry version: :v1, transport: :grpc, &block
         
     | 
| 
       98 
105 
     | 
    
         
             
                    require "google/cloud/apigee_registry/#{version.to_s.downcase}"
         
     | 
| 
       99 
106 
     | 
    
         | 
| 
       100 
107 
     | 
    
         
             
                    package_name = Google::Cloud::ApigeeRegistry
         
     | 
| 
       101 
108 
     | 
    
         
             
                                   .constants
         
     | 
| 
       102 
109 
     | 
    
         
             
                                   .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
         
     | 
| 
       103 
110 
     | 
    
         
             
                                   .first
         
     | 
| 
       104 
     | 
    
         
            -
                     
     | 
| 
       105 
     | 
    
         
            -
                     
     | 
| 
      
 111 
     | 
    
         
            +
                    service_module = Google::Cloud::ApigeeRegistry.const_get(package_name).const_get(:Registry)
         
     | 
| 
      
 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 
     | 
    
         
             
                  ##
         
     | 
| 
         @@ -122,7 +130,7 @@ module Google 
     | 
|
| 
       122 
130 
     | 
    
         
             
                  # * `timeout` (*type:* `Numeric`) -
         
     | 
| 
       123 
131 
     | 
    
         
             
                  #   Default timeout in seconds.
         
     | 
| 
       124 
132 
     | 
    
         
             
                  # * `metadata` (*type:* `Hash{Symbol=>String}`) -
         
     | 
| 
       125 
     | 
    
         
            -
                  #   Additional  
     | 
| 
      
 133 
     | 
    
         
            +
                  #   Additional headers to be sent with the call.
         
     | 
| 
       126 
134 
     | 
    
         
             
                  # * `retry_policy` (*type:* `Hash`) -
         
     | 
| 
       127 
135 
     | 
    
         
             
                  #   The retry policy. The value is a hash with the following keys:
         
     | 
| 
       128 
136 
     | 
    
         
             
                  #     * `: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_registry
         
     | 
| 
       3 
3 
     | 
    
         
             
            version: !ruby/object:Gem::Version
         
     | 
| 
       4 
     | 
    
         
            -
              version: 0. 
     | 
| 
      
 4 
     | 
    
         
            +
              version: 1.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:  
     | 
| 
      
 11 
     | 
    
         
            +
            date: 2023-07-28 00:00:00.000000000 Z
         
     | 
| 
       12 
12 
     | 
    
         
             
            dependencies:
         
     | 
| 
       13 
13 
     | 
    
         
             
            - !ruby/object:Gem::Dependency
         
     | 
| 
       14 
14 
     | 
    
         
             
              name: google-cloud-apigee_registry-v1
         
     | 
| 
         @@ -16,7 +16,7 @@ dependencies: 
     | 
|
| 
       16 
16 
     | 
    
         
             
                requirements:
         
     | 
| 
       17 
17 
     | 
    
         
             
                - - ">="
         
     | 
| 
       18 
18 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       19 
     | 
    
         
            -
                    version: '0. 
     | 
| 
      
 19 
     | 
    
         
            +
                    version: '0.4'
         
     | 
| 
       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.4'
         
     | 
| 
       30 
30 
     | 
    
         
             
                - - "<"
         
     | 
| 
       31 
31 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       32 
32 
     | 
    
         
             
                    version: 2.a
         
     | 
| 
         @@ -195,7 +195,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement 
     | 
|
| 
       195 
195 
     | 
    
         
             
                - !ruby/object:Gem::Version
         
     | 
| 
       196 
196 
     | 
    
         
             
                  version: '0'
         
     | 
| 
       197 
197 
     | 
    
         
             
            requirements: []
         
     | 
| 
       198 
     | 
    
         
            -
            rubygems_version: 3. 
     | 
| 
      
 198 
     | 
    
         
            +
            rubygems_version: 3.4.2
         
     | 
| 
       199 
199 
     | 
    
         
             
            signing_key: 
         
     | 
| 
       200 
200 
     | 
    
         
             
            specification_version: 4
         
     | 
| 
       201 
201 
     | 
    
         
             
            summary: API Client library for the Apigee Registry API
         
     |