google-cloud-eventarc-publishing 0.1.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
 - data/AUTHENTICATION.md +1 -1
 - data/README.md +5 -31
 - data/lib/google/cloud/eventarc/publishing/version.rb +1 -1
 - data/lib/google/cloud/eventarc/publishing.rb +11 -7
 - metadata +12 -12
 
    
        checksums.yaml
    CHANGED
    
    | 
         @@ -1,7 +1,7 @@ 
     | 
|
| 
       1 
1 
     | 
    
         
             
            ---
         
     | 
| 
       2 
2 
     | 
    
         
             
            SHA256:
         
     | 
| 
       3 
     | 
    
         
            -
              metadata.gz:  
     | 
| 
       4 
     | 
    
         
            -
              data.tar.gz:  
     | 
| 
      
 3 
     | 
    
         
            +
              metadata.gz: 003dfaeba1cd6ed34087b17b5114acaa43294966aa1cbaeb9c1e1e831affb3fb
         
     | 
| 
      
 4 
     | 
    
         
            +
              data.tar.gz: '08af8cf3f8414a2c560100ad65001f355453ad5a228560467227e5377f52ecaa'
         
     | 
| 
       5 
5 
     | 
    
         
             
            SHA512:
         
     | 
| 
       6 
     | 
    
         
            -
              metadata.gz:  
     | 
| 
       7 
     | 
    
         
            -
              data.tar.gz:  
     | 
| 
      
 6 
     | 
    
         
            +
              metadata.gz: e3c5068f76f267eabbe5dc542609fb214800ce5b08910cd6b0618bc1d824fa475b5987d329094e85c971f27029768605bc05e29fd90c6eec83eb8978dc460b5a
         
     | 
| 
      
 7 
     | 
    
         
            +
              data.tar.gz: 128cc5a8e2d670e526b014abaa8a6f06908f941c47ad2cc1269a7dda9a14aabbbc0c6b049a214b951f87b11e8079646ea8e7ba8cd92feef0923992c29ea9b06a
         
     | 
    
        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,42 +34,16 @@ In order to use this library, you first need to go through the following steps: 
     | 
|
| 
       34 
34 
     | 
    
         
             
            1. [Enable the API.](https://console.cloud.google.com/apis/library/eventarcpublishing.googleapis.com)
         
     | 
| 
       35 
35 
     | 
    
         
             
            1. {file:AUTHENTICATION.md Set up authentication.}
         
     | 
| 
       36 
36 
     | 
    
         | 
| 
       37 
     | 
    
         
            -
            ## Enabling Logging
         
     | 
| 
       38 
     | 
    
         
            -
             
     | 
| 
       39 
     | 
    
         
            -
            To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
         
     | 
| 
       40 
     | 
    
         
            -
            The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
         
     | 
| 
       41 
     | 
    
         
            -
            or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
         
     | 
| 
       42 
     | 
    
         
            -
            that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
         
     | 
| 
       43 
     | 
    
         
            -
            and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
         
     | 
| 
       44 
     | 
    
         
            -
             
     | 
| 
       45 
     | 
    
         
            -
            Configuring a Ruby stdlib logger:
         
     | 
| 
       46 
     | 
    
         
            -
             
     | 
| 
       47 
     | 
    
         
            -
            ```ruby
         
     | 
| 
       48 
     | 
    
         
            -
            require "logger"
         
     | 
| 
       49 
     | 
    
         
            -
             
     | 
| 
       50 
     | 
    
         
            -
            module MyLogger
         
     | 
| 
       51 
     | 
    
         
            -
              LOGGER = Logger.new $stderr, level: Logger::WARN
         
     | 
| 
       52 
     | 
    
         
            -
              def logger
         
     | 
| 
       53 
     | 
    
         
            -
                LOGGER
         
     | 
| 
       54 
     | 
    
         
            -
              end
         
     | 
| 
       55 
     | 
    
         
            -
            end
         
     | 
| 
       56 
     | 
    
         
            -
             
     | 
| 
       57 
     | 
    
         
            -
            # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
         
     | 
| 
       58 
     | 
    
         
            -
            module GRPC
         
     | 
| 
       59 
     | 
    
         
            -
              extend MyLogger
         
     | 
| 
       60 
     | 
    
         
            -
            end
         
     | 
| 
       61 
     | 
    
         
            -
            ```
         
     | 
| 
       62 
     | 
    
         
            -
             
     | 
| 
       63 
37 
     | 
    
         
             
            ## Supported Ruby Versions
         
     | 
| 
       64 
38 
     | 
    
         | 
| 
       65 
     | 
    
         
            -
            This library is supported on Ruby 2. 
     | 
| 
      
 39 
     | 
    
         
            +
            This library is supported on Ruby 2.6+.
         
     | 
| 
       66 
40 
     | 
    
         | 
| 
       67 
41 
     | 
    
         
             
            Google provides official support for Ruby versions that are actively supported
         
     | 
| 
       68 
42 
     | 
    
         
             
            by Ruby Core—that is, Ruby versions that are either in normal maintenance or
         
     | 
| 
       69 
     | 
    
         
            -
            in security maintenance, and not end of life.  
     | 
| 
       70 
     | 
    
         
            -
             
     | 
| 
       71 
     | 
    
         
            -
             
     | 
| 
       72 
     | 
    
         
            -
             
     | 
| 
      
 43 
     | 
    
         
            +
            in security maintenance, and not end of life. Older versions of Ruby _may_
         
     | 
| 
      
 44 
     | 
    
         
            +
            still work, but are unsupported and not recommended. See
         
     | 
| 
      
 45 
     | 
    
         
            +
            https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
         
     | 
| 
      
 46 
     | 
    
         
            +
            support schedule.
         
     | 
| 
       73 
47 
     | 
    
         | 
| 
       74 
48 
     | 
    
         
             
            ## Which client should I use?
         
     | 
| 
       75 
49 
     | 
    
         | 
| 
         @@ -50,11 +50,13 @@ module Google 
     | 
|
| 
       50 
50 
     | 
    
         
             
                    #
         
     | 
| 
       51 
51 
     | 
    
         
             
                    # By default, this returns an instance of
         
     | 
| 
       52 
52 
     | 
    
         
             
                    # [Google::Cloud::Eventarc::Publishing::V1::Publisher::Client](https://googleapis.dev/ruby/google-cloud-eventarc-publishing-v1/latest/Google/Cloud/Eventarc/Publishing/V1/Publisher/Client.html)
         
     | 
| 
       53 
     | 
    
         
            -
                    # for version V1 of the API.
         
     | 
| 
       54 
     | 
    
         
            -
                    # However, you can specify  
     | 
| 
      
 53 
     | 
    
         
            +
                    # for a gRPC client for version V1 of the API.
         
     | 
| 
      
 54 
     | 
    
         
            +
                    # However, you can specify a different API version by passing it in the
         
     | 
| 
       55 
55 
     | 
    
         
             
                    # `version` parameter. If the Publisher service is
         
     | 
| 
       56 
56 
     | 
    
         
             
                    # supported by that API version, and the corresponding gem is available, the
         
     | 
| 
       57 
57 
     | 
    
         
             
                    # appropriate versioned client will be returned.
         
     | 
| 
      
 58 
     | 
    
         
            +
                    # You can also specify a different transport by passing `:rest` or `:grpc` in
         
     | 
| 
      
 59 
     | 
    
         
            +
                    # the `transport` parameter.
         
     | 
| 
       58 
60 
     | 
    
         
             
                    #
         
     | 
| 
       59 
61 
     | 
    
         
             
                    # ## About Publisher
         
     | 
| 
       60 
62 
     | 
    
         
             
                    #
         
     | 
| 
         @@ -85,17 +87,19 @@ module Google 
     | 
|
| 
       85 
87 
     | 
    
         
             
                    #
         
     | 
| 
       86 
88 
     | 
    
         
             
                    # @param version [::String, ::Symbol] The API version to connect to. Optional.
         
     | 
| 
       87 
89 
     | 
    
         
             
                    #   Defaults to `:v1`.
         
     | 
| 
       88 
     | 
    
         
            -
                    # @ 
     | 
| 
      
 90 
     | 
    
         
            +
                    # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
         
     | 
| 
      
 91 
     | 
    
         
            +
                    # @return [::Object] A client object for the specified version.
         
     | 
| 
       89 
92 
     | 
    
         
             
                    #
         
     | 
| 
       90 
     | 
    
         
            -
                    def self.publisher version: :v1, &block
         
     | 
| 
      
 93 
     | 
    
         
            +
                    def self.publisher version: :v1, transport: :grpc, &block
         
     | 
| 
       91 
94 
     | 
    
         
             
                      require "google/cloud/eventarc/publishing/#{version.to_s.downcase}"
         
     | 
| 
       92 
95 
     | 
    
         | 
| 
       93 
96 
     | 
    
         
             
                      package_name = Google::Cloud::Eventarc::Publishing
         
     | 
| 
       94 
97 
     | 
    
         
             
                                     .constants
         
     | 
| 
       95 
98 
     | 
    
         
             
                                     .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
         
     | 
| 
       96 
99 
     | 
    
         
             
                                     .first
         
     | 
| 
       97 
     | 
    
         
            -
                       
     | 
| 
       98 
     | 
    
         
            -
                       
     | 
| 
      
 100 
     | 
    
         
            +
                      service_module = Google::Cloud::Eventarc::Publishing.const_get(package_name).const_get(:Publisher)
         
     | 
| 
      
 101 
     | 
    
         
            +
                      service_module = service_module.const_get(:Rest) if transport == :rest
         
     | 
| 
      
 102 
     | 
    
         
            +
                      service_module.const_get(:Client).new(&block)
         
     | 
| 
       99 
103 
     | 
    
         
             
                    end
         
     | 
| 
       100 
104 
     | 
    
         | 
| 
       101 
105 
     | 
    
         
             
                    ##
         
     | 
| 
         @@ -115,7 +119,7 @@ module Google 
     | 
|
| 
       115 
119 
     | 
    
         
             
                    # * `timeout` (*type:* `Numeric`) -
         
     | 
| 
       116 
120 
     | 
    
         
             
                    #   Default timeout in seconds.
         
     | 
| 
       117 
121 
     | 
    
         
             
                    # * `metadata` (*type:* `Hash{Symbol=>String}`) -
         
     | 
| 
       118 
     | 
    
         
            -
                    #   Additional  
     | 
| 
      
 122 
     | 
    
         
            +
                    #   Additional headers to be sent with the call.
         
     | 
| 
       119 
123 
     | 
    
         
             
                    # * `retry_policy` (*type:* `Hash`) -
         
     | 
| 
       120 
124 
     | 
    
         
             
                    #   The retry policy. The value is a hash with the following keys:
         
     | 
| 
       121 
125 
     | 
    
         
             
                    #     * `: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-eventarc-publishing
         
     | 
| 
       3 
3 
     | 
    
         
             
            version: !ruby/object:Gem::Version
         
     | 
| 
       4 
     | 
    
         
            -
              version: 0. 
     | 
| 
      
 4 
     | 
    
         
            +
              version: 0.3.0
         
     | 
| 
       5 
5 
     | 
    
         
             
            platform: ruby
         
     | 
| 
       6 
6 
     | 
    
         
             
            authors:
         
     | 
| 
       7 
7 
     | 
    
         
             
            - Google LLC
         
     | 
| 
       8 
8 
     | 
    
         
             
            autorequire: 
         
     | 
| 
       9 
9 
     | 
    
         
             
            bindir: bin
         
     | 
| 
       10 
10 
     | 
    
         
             
            cert_chain: []
         
     | 
| 
       11 
     | 
    
         
            -
            date:  
     | 
| 
      
 11 
     | 
    
         
            +
            date: 2023-03-09 00:00:00.000000000 Z
         
     | 
| 
       12 
12 
     | 
    
         
             
            dependencies:
         
     | 
| 
       13 
13 
     | 
    
         
             
            - !ruby/object:Gem::Dependency
         
     | 
| 
       14 
14 
     | 
    
         
             
              name: google-cloud-core
         
     | 
| 
         @@ -30,7 +30,7 @@ dependencies: 
     | 
|
| 
       30 
30 
     | 
    
         
             
                requirements:
         
     | 
| 
       31 
31 
     | 
    
         
             
                - - ">="
         
     | 
| 
       32 
32 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       33 
     | 
    
         
            -
                    version: '0. 
     | 
| 
      
 33 
     | 
    
         
            +
                    version: '0.5'
         
     | 
| 
       34 
34 
     | 
    
         
             
                - - "<"
         
     | 
| 
       35 
35 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       36 
36 
     | 
    
         
             
                    version: 2.a
         
     | 
| 
         @@ -40,7 +40,7 @@ dependencies: 
     | 
|
| 
       40 
40 
     | 
    
         
             
                requirements:
         
     | 
| 
       41 
41 
     | 
    
         
             
                - - ">="
         
     | 
| 
       42 
42 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       43 
     | 
    
         
            -
                    version: '0. 
     | 
| 
      
 43 
     | 
    
         
            +
                    version: '0.5'
         
     | 
| 
       44 
44 
     | 
    
         
             
                - - "<"
         
     | 
| 
       45 
45 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       46 
46 
     | 
    
         
             
                    version: 2.a
         
     | 
| 
         @@ -50,28 +50,28 @@ dependencies: 
     | 
|
| 
       50 
50 
     | 
    
         
             
                requirements:
         
     | 
| 
       51 
51 
     | 
    
         
             
                - - "~>"
         
     | 
| 
       52 
52 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       53 
     | 
    
         
            -
                    version: 1. 
     | 
| 
      
 53 
     | 
    
         
            +
                    version: 1.26.1
         
     | 
| 
       54 
54 
     | 
    
         
             
              type: :development
         
     | 
| 
       55 
55 
     | 
    
         
             
              prerelease: false
         
     | 
| 
       56 
56 
     | 
    
         
             
              version_requirements: !ruby/object:Gem::Requirement
         
     | 
| 
       57 
57 
     | 
    
         
             
                requirements:
         
     | 
| 
       58 
58 
     | 
    
         
             
                - - "~>"
         
     | 
| 
       59 
59 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       60 
     | 
    
         
            -
                    version: 1. 
     | 
| 
      
 60 
     | 
    
         
            +
                    version: 1.26.1
         
     | 
| 
       61 
61 
     | 
    
         
             
            - !ruby/object:Gem::Dependency
         
     | 
| 
       62 
62 
     | 
    
         
             
              name: minitest
         
     | 
| 
       63 
63 
     | 
    
         
             
              requirement: !ruby/object:Gem::Requirement
         
     | 
| 
       64 
64 
     | 
    
         
             
                requirements:
         
     | 
| 
       65 
65 
     | 
    
         
             
                - - "~>"
         
     | 
| 
       66 
66 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       67 
     | 
    
         
            -
                    version: '5. 
     | 
| 
      
 67 
     | 
    
         
            +
                    version: '5.16'
         
     | 
| 
       68 
68 
     | 
    
         
             
              type: :development
         
     | 
| 
       69 
69 
     | 
    
         
             
              prerelease: false
         
     | 
| 
       70 
70 
     | 
    
         
             
              version_requirements: !ruby/object:Gem::Requirement
         
     | 
| 
       71 
71 
     | 
    
         
             
                requirements:
         
     | 
| 
       72 
72 
     | 
    
         
             
                - - "~>"
         
     | 
| 
       73 
73 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       74 
     | 
    
         
            -
                    version: '5. 
     | 
| 
      
 74 
     | 
    
         
            +
                    version: '5.16'
         
     | 
| 
       75 
75 
     | 
    
         
             
            - !ruby/object:Gem::Dependency
         
     | 
| 
       76 
76 
     | 
    
         
             
              name: minitest-focus
         
     | 
| 
       77 
77 
     | 
    
         
             
              requirement: !ruby/object:Gem::Requirement
         
     | 
| 
         @@ -106,14 +106,14 @@ dependencies: 
     | 
|
| 
       106 
106 
     | 
    
         
             
                requirements:
         
     | 
| 
       107 
107 
     | 
    
         
             
                - - ">="
         
     | 
| 
       108 
108 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       109 
     | 
    
         
            -
                    version: ' 
     | 
| 
      
 109 
     | 
    
         
            +
                    version: '13.0'
         
     | 
| 
       110 
110 
     | 
    
         
             
              type: :development
         
     | 
| 
       111 
111 
     | 
    
         
             
              prerelease: false
         
     | 
| 
       112 
112 
     | 
    
         
             
              version_requirements: !ruby/object:Gem::Requirement
         
     | 
| 
       113 
113 
     | 
    
         
             
                requirements:
         
     | 
| 
       114 
114 
     | 
    
         
             
                - - ">="
         
     | 
| 
       115 
115 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       116 
     | 
    
         
            -
                    version: ' 
     | 
| 
      
 116 
     | 
    
         
            +
                    version: '13.0'
         
     | 
| 
       117 
117 
     | 
    
         
             
            - !ruby/object:Gem::Dependency
         
     | 
| 
       118 
118 
     | 
    
         
             
              name: redcarpet
         
     | 
| 
       119 
119 
     | 
    
         
             
              requirement: !ruby/object:Gem::Requirement
         
     | 
| 
         @@ -184,14 +184,14 @@ required_ruby_version: !ruby/object:Gem::Requirement 
     | 
|
| 
       184 
184 
     | 
    
         
             
              requirements:
         
     | 
| 
       185 
185 
     | 
    
         
             
              - - ">="
         
     | 
| 
       186 
186 
     | 
    
         
             
                - !ruby/object:Gem::Version
         
     | 
| 
       187 
     | 
    
         
            -
                  version: '2. 
     | 
| 
      
 187 
     | 
    
         
            +
                  version: '2.6'
         
     | 
| 
       188 
188 
     | 
    
         
             
            required_rubygems_version: !ruby/object:Gem::Requirement
         
     | 
| 
       189 
189 
     | 
    
         
             
              requirements:
         
     | 
| 
       190 
190 
     | 
    
         
             
              - - ">="
         
     | 
| 
       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 Eventarc Publishing API
         
     |