google-cloud-pubsub 2.19.0 → 2.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: db206c3eab0b2c876feeb00d0e0d8de12b6c6ac60f55153c61f06973f627ac34
-  data.tar.gz: bed374d87a423c101703159453d1ef6724062b2c6bee7ab58276b715b95d094d
+  metadata.gz: 769d41360e1e561290f024664e2090b2a17322f0c7110bc31bb26d45f6a521d9
+  data.tar.gz: 340c7db4b5f7e27066bde07e838378c0c734738072363567d268b88657135a07
 SHA512:
-  metadata.gz: 0dbec66b7af6c93d4493ddbfc8b918a661dac41aa5bfb94330169652e2da6e62682c4b22bc969f061e111950babbf7aa786bcf29305aa91f7a85438389adb87d
-  data.tar.gz: 0c8b9aba5a2c7ed59ed2cda8696db84e253e074468dc48a337a5992e4a695e3c40c87f023872db49565eaac4cc00fa5b0ec55db90839fd5a877fab8a38f334ce
+  metadata.gz: c83de697da5723967ed3287d5256cb36ba6a6f010b9882f14893e016c3055772873fcb3dd6e47c89ed950c58ab16c6f1af89e11fb4974f21259233abeae39700
+  data.tar.gz: f1480d77dacda0b07cce8bb54ef8914014ef27b5371c8a6cf1ff204239485ea0822bc71ff18fe73a18769157d17a80b77a5ee1e48165d5624e3ff0fd2ecf4fb6

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Release History
 
+### 2.22.0 (2025-03-27)
+
+#### Features
+
+* Support list schema revisions ([#29174](https://github.com/googleapis/google-cloud-ruby/issues/29174)) 
+
+### 2.21.0 (2025-03-14)
+
+#### Features
+
+* Support revision_id in Schema 
+
+### 2.20.0 (2025-02-13)
+
+#### Features
+
+* Update Ruby version requirement to 3.0 ([#29071](https://github.com/googleapis/google-cloud-ruby/issues/29071)) 
+
 ### 2.19.0 (2024-07-09)
 
 #### Features

data/lib/google/cloud/pubsub/schema.rb

@@ -84,6 +84,17 @@ module Google
           @grpc.definition if @grpc.definition && !@grpc.definition.empty?
         end
 
+        ##
+        # The revision ID of the schema.
+        #
+        # @return [String] The revision id.
+        # @return [nil] If this object is a reference.
+        #
+        def revision_id
+          return nil if reference?
+          @grpc.revision_id if @grpc.revision_id && !@grpc.revision_id.empty?
+        end
+
         ##
         # Validates a message against a schema.
         #
@@ -197,6 +208,63 @@ module Google
           @exists = false
         end
 
+        ##
+        # Commits a new schema revision to an existing schema.
+        #
+        # @param definition [String] The definition of the schema. This should
+        #   contain a string representing the full definition of the schema that
+        #   is a valid schema definition of the type specified in `type`. See
+        #   https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.schemas#Schema
+        #   for details.
+        # @param type [String, Symbol] The type of the schema. Possible values are
+        #   case-insensitive and include:
+        #
+        #     * `PROTOCOL_BUFFER` - A Protocol Buffer schema definition.
+        #     * `AVRO` - An Avro schema definition.
+        #
+        # @return [Google::Cloud::PubSub::Schema]
+        #
+        # @example
+        #   require "google/cloud/pubsub"
+        #
+        #   pubsub = Google::Cloud::PubSub.new
+        #
+        #   schema = pubsub.schema "my-schema"
+        #
+        #   definition = File.read /path/to/file
+        #
+        #   revision_schema = schema.commit definition, type: :protocol_buffer
+        #
+        def commit definition, type
+          type = type.to_s.upcase
+          grpc = service.commit_schema name, definition, type
+          Schema.from_grpc grpc, service, view: @view
+        end
+
+        ##
+        # Lists all schema revisions for the named schema.
+        #
+        # @param view [Symbol, String, nil] The set of fields to return in the response. Possible values:
+        #   * `BASIC` - Include the `name` and `type` of the schema, but not the `definition`.
+        #   * `FULL` - Include all Schema object fields.
+        #
+        # @return [Google::Cloud::PubSub::V1::ListSchemaRevisionsResponse]
+        #
+        # @example
+        #   require "google/cloud/pubsub"
+        #
+        #   pubsub = Google::Cloud::PubSub.new
+        #
+        #   schema = pubsub.schema "my-schema"
+        #   schema.list_revisions
+        #
+        def list_revisions view: nil, page_size: nil, page_token: nil
+          service.list_schema_revisions name,
+                                        view || @view,
+                                        page_size,
+                                        page_token
+        end
+
         ##
         # Determines whether the schema object was created without retrieving the
         # resource representation from the Pub/Sub service.

data/lib/google/cloud/pubsub/service.rb

@@ -341,6 +341,21 @@ module Google
           paged_enum.response
         end
 
+        ##
+        # Lists all schema revisions for the named schema.
+        # @param name [String] The name of the schema to list revisions for.
+        # @param view [String, Symbol, nil] Possible values:
+        #   * `BASIC` - Include the name and type of the schema, but not the definition.
+        #   * `FULL` - Include all Schema object fields.
+        #
+        def list_schema_revisions name, view, page_size, page_token
+          schema_view = Google::Cloud::PubSub::V1::SchemaView.const_get view.to_s.upcase
+          schemas.list_schema_revisions name: name,
+                                        view: schema_view,
+                                        page_size: page_size,
+                                        page_token: page_token
+        end
+
         ##
         # Creates a schema in the current (or given) project.
         def create_schema schema_id, type, definition, options = {}
@@ -371,6 +386,31 @@ module Google
           schemas.delete_schema name: schema_path(schema_name)
         end
 
+        ##
+        # Commits a new schema revision to an existing schema.
+        #
+        # @param name [String] The name of the schema to revision.
+        # @param definition [String] The definition of the schema. This should
+        #   contain a string representing the full definition of the schema that
+        #   is a valid schema definition of the type specified in `type`. See
+        #   https://cloud.google.com/pubsub/docs/schemas for details.
+        # @param type [String, Symbol] The type of the schema. Required. Possible
+        #   values are case-insensitive and include:
+        #
+        #     * `PROTOCOL_BUFFER` - A Protocol Buffer schema definition.
+        #     * `AVRO` - An Avro schema definition.
+        #
+        # @return [Google::Cloud::PubSub::V1::Schema]
+        #
+        def commit_schema name, definition, type
+          schema = Google::Cloud::PubSub::V1::Schema.new(
+            name: name,
+            definition: definition,
+            type: type
+          )
+          schemas.commit_schema name: name, schema: schema
+        end
+
         ##
         # Validate the definition string intended for a schema.
         def validate_schema type, definition, options = {}

data/lib/google/cloud/pubsub/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module PubSub
-      VERSION = "2.19.0".freeze
+      VERSION = "2.22.0".freeze
     end
 
     Pubsub = PubSub unless const_defined? :Pubsub

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-pubsub
 version: !ruby/object:Gem::Version
-  version: 2.19.0
+  version: 2.22.0
 platform: ruby
 authors:
 - Mike Moore
 - Chris Smith
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-07-09 00:00:00.000000000 Z
+date: 2025-03-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -43,22 +42,16 @@ dependencies:
   name: google-cloud-pubsub-v1
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0.20'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.a
+        version: '1.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0.20'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.a
+        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: retriable
   requirement: !ruby/object:Gem::Requirement
@@ -128,7 +121,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby/tree/master/google-clo
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -136,15 +128,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.6
-signing_key: 
+rubygems_version: 3.6.5
 specification_version: 4
 summary: API Client library for Google Cloud Pub/Sub
 test_files: []