google-cloud-bigquery 1.54.0 → 1.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbfaf1f9de532a42e02ae04ce9a3373b337b401491a746a10e103c708b01d069
-  data.tar.gz: 3d7dd0f1213c69fcb79fee23f342f3e435c66842af1cc7569bf7c861f5f54773
+  metadata.gz: 7eb6ceb935eefe0881476f99a5f6e7bdf85e42debb251ba34ef999a3845ca3ef
+  data.tar.gz: 71cb8fa56300a051b257e77fb332fee37a18044fb26317a3e0eebbb57023144d
 SHA512:
-  metadata.gz: 4144ce5964844c6f8aebc2e12049639a6e42c65d74458617b88836b7bccded75c061315548c49d0030f1667a8890496911e9d8334d518adc40c0b416dc968ffe
-  data.tar.gz: 46d49fb84f11c0b97211ba5099a11be5001a21b20df26a21a4a31843633abba9869dad0cb4f80a9674156c5a4d78d84af2cfef9b77ee52395987e8e7637ce7b9
+  metadata.gz: 70305f4088f9af6ad6823f07e9326a5db55e2abfd17094d4a3d52ae1dd85dae871df5acaec43b9163130f7cbe226a3339dbcef96bbf181fdbafcbbdfca70bcb8
+  data.tar.gz: 93f2a24709c74dae96f6732ee36d328f9f46e9cecb63f87ac1da70d9e37d1a4d03c452ae4c4a772b31adb5145cb53157f4d14869d54f0131208ac2060551cb19

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Release History
 
+### 1.58.0 (2025-09-03)
+
+#### Features
+
+* Add support for remote function options ([#30822](https://github.com/googleapis/google-cloud-ruby/issues/30822)) 
+
+### 1.57.0 (2025-08-28)
+
+#### Features
+
+* Add support for reference_file_schema_uri for LoadJobConfig and ExternalDataSource ([#30859](https://github.com/googleapis/google-cloud-ruby/issues/30859)) 
+
+### 1.56.0 (2025-08-27)
+
+#### Features
+
+* Add support for preserve_ascii_control_characters in CSVOptions and LoadJobConfiguration ([#30857](https://github.com/googleapis/google-cloud-ruby/issues/30857)) 
+
+### 1.55.0 (2025-08-26)
+
+#### Features
+
+* Add support for IAM Condition in Dataset Access ([#30854](https://github.com/googleapis/google-cloud-ruby/issues/30854)) 
+
 ### 1.54.0 (2025-08-15)
 
 #### Features

data/lib/google/cloud/bigquery/condition.rb

@@ -0,0 +1,218 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require "google/apis/bigquery_v2"
+
+module Google
+  module Cloud
+    module Bigquery
+      ##
+      # # Condition
+      #
+      # Represents a textual expression in the Common Expression Language (CEL) syntax.
+      # CEL is a C-like expression language. The syntax and semantics of CEL are documented
+      # at https://github.com/google/cel-spec
+      #
+      # Used to define condition for {Dataset::Access} rules
+      #
+      class Condition
+        ##
+        # Returns the textual representation of an expression in Common Expression Language syntax.
+        #
+        # @return [String] The expression of the condition.
+        #
+        # @example
+        #   condition = Google::Cloud::Bigquery::Condition.new(
+        #     "resource.name.startsWith('projects/my-project')"
+        #   )
+        #   puts condition.expression # => "resource.name.startsWith('projects/my-project')"
+        #
+        def expression
+          @expression
+        end
+
+        ##
+        # Sets the textual representation of an expression in Common Expression Language syntax.
+        #
+        # @param [String] val The expression to set.
+        #
+        # @raise [ArgumentError] if the expression is nil or empty.
+        #
+        # @example
+        #   condition = Google::Cloud::Bigquery::Condition.new(
+        #     "resource.name.startsWith('projects/my-project')"
+        #   )
+        #   condition.expression = "document.summary.size() < 100"
+        #
+        def expression= val
+          if val.nil? || val.strip.empty?
+            raise ArgumentError, "Expression cannot be nil or empty"
+          end
+          @expression = val
+        end
+
+        ##
+        # Returns the optional description of the expression. This is a longer text which describes
+        # the expression, e.g. when hovered over it in a UI.
+        #
+        # @return [String, nil] The description of the condition. nil if not set.
+        #
+        # @example
+        #   condition = Google::Cloud::Bigquery::Condition.new(
+        #     "document.summary.size() < 100",
+        #     description: "Checks if summary is less than 100 chars"
+        #   )
+        #   puts condition.description # => "Checks if summary is less than 100 chars"
+        #
+        def description
+          @description
+        end
+
+        ##
+        # Sets the optional description of the expression. This is a longer text which describes
+        # the expression, e.g. when hovered over it in a UI.
+        #
+        # @param [String, nil] val The description to set. nil to unset.
+        #
+        # @example
+        #   condition = Google::Cloud::Bigquery::Condition.new(
+        #     "document.summary.size() < 100"
+        #   )
+        #   condition.description = "Checks if summary is less than 100 chars"
+        #
+        def description= val
+          @description = val
+        end
+
+        ##
+        # Returns the optional string indicating the location of the expression for error reporting,
+        # e.g. a file name and a position in the file.
+        #
+        # @return [String, nil] The location of the condition. nil if not set.
+        #
+        # @example
+        #   condition = Google::Cloud::Bigquery::Condition.new(
+        #     "document.summary.size() < 100",
+        #     location: "document/summary"
+        #   )
+        #   puts condition.location # => "document/summary"
+        #
+        def location
+          @location
+        end
+
+        ##
+        # Sets the optional string indicating the location of the expression for error reporting,
+        # e.g. a file name and a position in the file.
+        #
+        # @param [String, nil] val The location to set. nil to unset.
+        #
+        # @example
+        #   condition = Google::Cloud::Bigquery::Condition.new(
+        #     "document.summary.size() < 100"
+        #   )
+        #   condition.location = "document/summary"
+        #
+        def location= val
+          @location = val
+        end
+
+        ##
+        # Returns the optional title for the expression, i.e. a short string describing its purpose.
+        # This can be used e.g. in UIs which allow to enter the expression.
+        #
+        # @return [String, nil] The title of the condition. nil if not set.
+        #
+        # @example
+        #   condition = Google::Cloud::Bigquery::Condition.new(
+        #     "document.summary.size() < 100",
+        #     title: "Summary size limit"
+        #   )
+        #   puts condition.title # => "Summary size limit"
+        #
+        def title
+          @title
+        end
+
+        ##
+        # Sets the optional title for the expression, i.e. a short string describing its purpose.
+        # This can be used e.g. in UIs which allow to enter the expression.
+        #
+        # @param [String, nil] val The title to set. nil to unset.
+        #
+        # @example
+        #   condition = Google::Cloud::Bigquery::Condition.new(
+        #     "document.summary.size() < 100"
+        #   )
+        #   condition.title = "Summary size limit"
+        #
+        def title= val
+          @title = val
+        end
+
+        ##
+        # Create a new Condition object.
+        #
+        # @param [String] expression The expression in CEL syntax.
+        # @param [String] description Optional description of the expression.
+        # @param [String] location Optional location of the expression for error reporting.
+        # @param [String] title Optional title for the expression.
+        #
+        # @raise [ArgumentError] if expression is nil or empty.
+        #
+        # @example
+        #   condition = Google::Cloud::Bigquery::Condition.new(
+        #     "document.summary.size() < 100",
+        #     description: "Determines if a summary is less than 100 chars",
+        #     location: "document/summary",
+        #     title: "Summary size limit"
+        #   )
+        #
+        # @see https://cloud.google.com/bigquery/docs/reference/auditlogs/rest/Shared.Types/Expr
+        #
+        def initialize expression, description: nil, location: nil, title: nil
+          if expression.nil? || expression.strip.empty?
+            raise ArgumentError, "Expression cannot be nil or empty"
+          end
+          @expression = expression
+          @description = description
+          @location = location
+          @title = title
+        end
+
+        ##
+        # @private Convert the Condition object to a Google API Client object.
+        #
+        # @return [Google::Apis::BigqueryV2::Expr] The Google API Client object representing the condition.
+        #
+        # @example
+        #   condition = Google::Cloud::Bigquery::Condition.new(
+        #     "resource.name.startsWith('projects/my-project')"
+        #   )
+        #   gapi_condition = condition.to_gapi
+        #
+        # @see https://cloud.google.com/bigquery/docs/reference/auditlogs/rest/Shared.Types/Expr
+        #
+        def to_gapi
+          gapi = Google::Apis::BigqueryV2::Expr.new
+          gapi.description = @description unless @description.nil?
+          gapi.expression = @expression
+          gapi.location = @location unless @location.nil?
+          gapi.title = @title unless @title.nil?
+          gapi
+        end
+      end
+    end
+  end
+end