google-cloud-pubsub 2.20.0 → 2.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54d10854bbc8ae26caa6b19c2e000ebe83db42543835951e6eabc036297413d6
-  data.tar.gz: 1b5bfb201af3ce5fd0ef0fe246431fd9c592cf4abaaa136d730ee7a1c8153665
+  metadata.gz: 769d41360e1e561290f024664e2090b2a17322f0c7110bc31bb26d45f6a521d9
+  data.tar.gz: 340c7db4b5f7e27066bde07e838378c0c734738072363567d268b88657135a07
 SHA512:
-  metadata.gz: 8b5150b64376931afcf1d6a17118a8c32a892c50add2c5c0d4c4c3cdd613712bcf444b90c2339138eb01040193a42577773a5a803a82fb3db2fa4d1ef3b9fbf3
-  data.tar.gz: 3724e15d5f7f056688cc96d28bae69acaddd7925cec4113cd6c52088674cbc8b0ee48de2017354b88c4fcefff5fec44feada524a12177778c3f9c006af3f32da
+  metadata.gz: c83de697da5723967ed3287d5256cb36ba6a6f010b9882f14893e016c3055772873fcb3dd6e47c89ed950c58ab16c6f1af89e11fb4974f21259233abeae39700
+  data.tar.gz: f1480d77dacda0b07cce8bb54ef8914014ef27b5371c8a6cf1ff204239485ea0822bc71ff18fe73a18769157d17a80b77a5ee1e48165d5624e3ff0fd2ecf4fb6

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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

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.20.0".freeze
+      VERSION = "2.22.0".freeze
     end
 
     Pubsub = PubSub unless const_defined? :Pubsub

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-pubsub
 version: !ruby/object:Gem::Version
-  version: 2.20.0
+  version: 2.22.0
 platform: ruby
 authors:
 - Mike Moore
 - Chris Smith
 bindir: bin
 cert_chain: []
-date: 2025-02-13 00:00:00.000000000 Z
+date: 2025-03-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -135,7 +135,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.3
+rubygems_version: 3.6.5
 specification_version: 4
 summary: API Client library for Google Cloud Pub/Sub
 test_files: []