sheets_v4 0.6.0 → 0.8.0

data/lib/sheets_v4/google_extensions/sheet.rb

@@ -0,0 +1,32 @@
+# Copyright (c) 2022 Yahoo
+# frozen_string_literal: true
+
+require 'google/apis/sheets_v4'
+require 'googleauth'
+
+module SheetsV4
+  module GoogleExtensions
+    # The SheetsService class implements handling credentials on top of the
+    # Google::Apis::SheetsV4::SheetsService class.
+    #
+    # @api public
+    #
+    module Sheet
+      # The sheets_service object used to create this sheet
+      #
+      # @example
+      #   sheets_service = sheet.sheets_service
+      #
+      # @return [Google::Apis::SheetsV4::SheetsService]
+      attr_reader :sheets_service
+
+      # The spreadsheet object that contains this sheet
+      #
+      # @example
+      #   spreadsheet = sheet.spreadsheet
+      #
+      # @return [Google::Apis::SheetsV4::Spreadsheet]
+      attr_reader :spreadsheet
+    end
+  end
+end

data/lib/sheets_v4/google_extensions/sheets_service.rb

@@ -0,0 +1,99 @@
+# Copyright (c) 2022 Yahoo
+# frozen_string_literal: true
+
+module SheetsV4
+  module GoogleExtensions
+    # This module extends the `Google::Apis::SheetsV4::SheetsService` class to add
+    # attributes to the `Google::Apis::SheetsV4::Spreadsheet` and `Google::Apis::SheetsV4::Sheet`
+    # classes that reference the `SheetsService` instance used to retrieve them.
+    #
+    # Similarly, an attribute is added to the `Google::Apis::SheetsV4::Sheet` class
+    # that references the `Google::Apis::SheetsV4::Spreadsheet` instance that contains it.
+    #
+    # This allows getting the `SheetsService` object from a spreadsheet or sheet object,
+    # making it unnecessary to pass the `SheetsService` object around with the spreadsheet
+    # and its sheets.
+    #
+    # @example
+    #   require 'sheets_v4/google_extensions'
+    #   sheets_service = SheetsV4::SheetsService.new
+    #   spreadsheet = sheets_service.get_spreadsheet('1nT_q0TrQzC3dLZXuI3K9V5P3mArBVZpVd_vRsOpvcyk')
+    #
+    #   spreadsheet.sheets_service == sheets_service # => true
+    #   spreadsheet.sheets.each do |sheet|
+    #     sheet.sheets_service == sheets_service # => true
+    #     sheet.spreadsheet == spreadsheet # => true
+    #   end
+    #
+    # @api public
+    #
+    module SheetsService
+      # Replace the prepending class's `get_spreadsheet` implementation
+      #
+      # When this module is prepended to a class, class's `get_spreadsheet` method
+      # is replaced wity `new_get_spreadsheet` method from this module.  The class's
+      # original `get_spreadsheet` method is renamed to `original_get_spreadsheet`.
+      #
+      # @example
+      #   Google::Apis::SheetsV4::SheetsService.prepend(
+      #     SheetsV4::GoogleExtensions::SheetsService
+      #   )
+      #
+      # @return [void]
+      #
+      # @private
+      #
+      def self.prepended(prepended_to_class)
+        prepended_to_class.send(:alias_method, :original_get_spreadsheet, :get_spreadsheet)
+        prepended_to_class.send(:remove_method, :get_spreadsheet)
+        prepended_to_class.send(:alias_method, :get_spreadsheet, :new_get_spreadsheet)
+      end
+
+      # @!method get_spreadsheet(spreadsheet_id, include_grid_data, ranges, fields, quota_user, options, &block)
+      #
+      #   @api public
+      #
+      #   Gets an existing spreadsheet
+      #
+      #   Creates a spreadsheet object by calling the original
+      #   Google::Apis::SheetsV4::SheetsService#get_spreadsheet method and then does
+      #   the following:
+      #
+      #   * Sets the `sheets_service` attribute for the returned spreadsheet.
+      #   * Sets the `sheets_service` and `spreadsheet` attributes all the sheets contained in the spreadsheet.
+      #
+      #   See the documentation for Google::Apis::SheetsV4::SheetsService#get_spreadsheet for
+      #   details on the parameters and return value.
+      #
+      #   @example Get a spreadsheet object and output new attributes:
+      #     require 'sheets_v4'
+      #     require 'sheets_v4/google_extensions'
+      #
+      #     sheets_service = SheetsV4::SheetsService.new
+      #     spreadsheet_id = '1nT_q0TrQzC3dLZXuI3K9V5P3mArBVZpVd_vRsOpvcyk'
+      #
+      #     spreadsheet = sheets_service.get_spreadsheet(spreadsheet_id)
+      #
+      #   @return [Google::Apis::SheetsV4::Spreadsheet] the spreadsheet whose ID is `spreadsheet_id`
+
+      # Replaces the `get_spreadsheet` method implementation in the prepended class
+      #
+      # @example
+      #   spreadsheet = sheets_service.new_get_spreadsheet(spreadsheet_id)
+      #
+      # @private
+      #
+      # @return [Google::Apis::SheetsV4::Spreadsheet]
+      #
+      def new_get_spreadsheet(...)
+        original_get_spreadsheet(...)&.tap do |spreadsheet|
+          spreadsheet.instance_variable_set(:@sheets_service, self)
+          spreadsheet.sheets.each do |sheet|
+            sheet.instance_variable_set(:@sheets_service, self)
+            sheet.instance_variable_set(:@spreadsheet, spreadsheet)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sheets_v4/google_extensions/spreadsheet.rb

@@ -0,0 +1,24 @@
+# Copyright (c) 2022 Yahoo
+# frozen_string_literal: true
+
+require 'google/apis/sheets_v4'
+require 'googleauth'
+
+module SheetsV4
+  module GoogleExtensions
+    # The SheetsService class implements handling credentials on top of the
+    # Google::Apis::SheetsV4::SheetsService class.
+    #
+    # @api public
+    #
+    module Spreadsheet
+      # The sheets_service object used to create this spreadsheet
+      #
+      # @example
+      #   sheets_service = spreadsheet.sheets_service
+      #
+      # @return [Google::Apis::SheetsV4::SheetsService]
+      attr_reader :sheets_service
+    end
+  end
+end

data/lib/sheets_v4/google_extensions.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module SheetsV4
+  # The Google extensions are additions directly to Google::Apis::SheetsV4 classes
+  #
+  # These additions are optional and provide convenience methods and attributes
+  # that simplify use of the Google Sheets API.
+  #
+  # To use these extensions, require the `sheets_v4/google_extensions` file.
+  #
+  # @example
+  #   require 'sheets_v4/google_extensions'
+  #
+  module GoogleExtensions; end
+end
+
+require_relative 'google_extensions/sheets_service'
+require_relative 'google_extensions/spreadsheet'
+require_relative 'google_extensions/sheet'
+
+# @private
+module Google
+  module Apis
+    # Add SheetsV4 extensions to Google::Apis::SheetsV4 classes
+    module SheetsV4
+      # Add SheetsV4 extensions to Google::Apis::SheetsV4::SheetsService
+      class SheetsService
+        prepend ::SheetsV4::GoogleExtensions::SheetsService
+      end
+
+      # Add SheetsV4 extensions to Google::Apis::SheetsV4::Spreadsheet
+      class Spreadsheet
+        prepend ::SheetsV4::GoogleExtensions::Spreadsheet
+      end
+
+      # Add SheetsV4 extensions to Google::Apis::SheetsV4::Sheet
+      class Sheet
+        prepend ::SheetsV4::GoogleExtensions::Sheet
+      end
+    end
+  end
+end

data/lib/sheets_v4/validate_api_objects/{validate.rb → validate_api_object.rb}

@@ -1,21 +1,22 @@
 # frozen_string_literal: true
 
+require 'active_support'
 require 'active_support/inflector'
 require 'json_schemer'
 
 module SheetsV4
-  module ValidateApiObjects
+  module ApiObjectValidation
     # Validate objects against a Google Sheets API request object schema
     #
     # @api public
     #
-    class Validate
+    class ValidateApiObject
       # Create a new validator
       #
       # By default, a nil logger is used. This means that no messages are logged.
       #
       # @example
-      #   validator = SheetsV4::ValidateApiObjects::Validator.new
+      #   validator = SheetsV4::ApiObjectValidation::ValidateApiObject.new
       #
       # @param logger [Logger] the logger to use
       #
@@ -30,7 +31,7 @@ module SheetsV4
       #
       # @example
       #   logger = Logger.new(STDOUT, :level => Logger::INFO)
-      #   validator = SheetsV4::ValidateApiObjects::Validator.new(logger)
+      #   validator = SheetsV4::ApiObjectValidation::ValidateApiObject.new(logger)
       #   validator.logger == logger # => true
       #   validator.logger.debug { "Debug message" }
       #
@@ -43,7 +44,7 @@ module SheetsV4
       # @example
       #   schema_name = 'batch_update_spreadsheet_request'
       #   object = { 'requests' => [] }
-      #   validator = SheetsV4::ValidateApiObjects::Validator.new
+      #   validator = SheetsV4::ApiObjectValidation::ValidateApiObject.new
       #   validator.call(schema_name:, object:)
       #
       # @param schema_name [String] the name of the schema to validate against
@@ -69,7 +70,7 @@ module SheetsV4
       # The resolver to use to resolve JSON schema references
       # @return [ResolveSchemaRef]
       # @api private
-      def ref_resolver = @ref_resolver ||= SheetsV4::ValidateApiObjects::ResolveSchemaRef.new(logger:)
+      def ref_resolver = @ref_resolver ||= SheetsV4::ApiObjectValidation::ResolveSchemaRef.new(logger:)
 
       # Raise an error when the object does not conform to the schema
       # @return [void]

data/lib/sheets_v4/validate_api_objects.rb

@@ -7,14 +7,14 @@ module SheetsV4
   #   logger = Logger.new(STDOUT, :level => Logger::ERROR)
   #   schema_name = 'batch_update_spreadsheet_request'
   #   object = { 'requests' => [] }
-  #   SheetsV4::ValidateApiObjects::Validator.new(logger:).call(schema_name:, object:)
+  #   SheetsV4::ApiObjectValidation::ValidateApiObject.new(logger:).call(schema_name:, object:)
   #
   # @api public
   #
-  module ValidateApiObjects; end
+  module ApiObjectValidation; end
 end
 
-require_relative 'validate_api_objects/load_schemas'
-require_relative 'validate_api_objects/resolve_schema_ref'
-require_relative 'validate_api_objects/traverse_object_tree'
-require_relative 'validate_api_objects/validate'
+require_relative 'api_object_validation/load_schemas'
+require_relative 'api_object_validation/resolve_schema_ref'
+require_relative 'api_object_validation/traverse_object_tree'
+require_relative 'api_object_validation/validate_api_object'

data/lib/sheets_v4/version.rb

@@ -2,5 +2,5 @@
 
 module SheetsV4
   # The version of this gem
-  VERSION = '0.6.0'
+  VERSION = '0.8.0'
 end

data/lib/sheets_v4.rb

@@ -2,9 +2,14 @@
 
 require_relative 'sheets_v4/version'
 require_relative 'sheets_v4/color'
-require_relative 'sheets_v4/credential_creator'
-require_relative 'sheets_v4/validate_api_objects'
+require_relative 'sheets_v4/convert_dates_and_times'
+require_relative 'sheets_v4/create_credential'
+require_relative 'sheets_v4/api_object_validation'
 
+require 'active_support'
+require 'active_support/values/time_zone'
+require 'active_support/core_ext/numeric/time'
+require 'active_support/core_ext/string/zones'
 require 'google/apis/sheets_v4'
 require 'json'
 require 'logger'
@@ -15,102 +20,227 @@ require 'net/http'
 # @api public
 #
 module SheetsV4
-  # Create a new Google::Apis::SheetsV4::SheetsService object
-  #
-  # Simplifies creating and configuring a the credential.
-  #
-  # @example using the credential in `~/.google-api-credential`
-  #   SheetsV4.sheets_service
-  #
-  # @example using a credential passed in as a string
-  #   credential_source = File.read(File.expand_path('~/.google-api-credential.json'))
-  #   SheetsV4.sheets_service(credential_source:)
-  #
-  # @example using a credential passed in as an IO
-  #   credential_source = File.open(File.expand_path('~/.google-api-credential.json'))
-  #   SheetsV4.sheets_service(credential_source:)
-  #
-  # @param credential_source [nil, String, IO, Google::Auth::*] may
-  #   be either an already constructed credential, the credential read into a String or
-  #   an open file with the credential ready to be read. Passing `nil` will result
-  #   in the credential being read from `~/.google-api-credential.json`.
-  #
-  # @param scopes [Object, Array] one or more scopes to access.
-  #
-  # @param credential_creator [#credential] Used to inject the credential creator for
-  #   testing.
-  #
-  # @return a new SheetsService instance
-  #
-  def self.sheets_service(credential_source: nil, scopes: nil, credential_creator: SheetsV4::CredentialCreator)
-    credential_source ||= File.read(File.expand_path('~/.google-api-credential.json'))
-    scopes ||= [Google::Apis::SheetsV4::AUTH_SPREADSHEETS]
-
-    Google::Apis::SheetsV4::SheetsService.new.tap do |service|
-      service.authorization = credential_creator.call(credential_source, scopes)
+  class << self
+    # Create a new Google::Apis::SheetsV4::SheetsService object
+    #
+    # Simplifies creating and configuring a the credential.
+    #
+    # @example using the credential in `~/.google-api-credential`
+    #   SheetsV4.sheets_service
+    #
+    # @example using a credential passed in as a string
+    #   credential_source = File.read(File.expand_path('~/.google-api-credential.json'))
+    #   SheetsV4.sheets_service(credential_source:)
+    #
+    # @example using a credential passed in as an IO
+    #   credential_source = File.open(File.expand_path('~/.google-api-credential.json'))
+    #   SheetsV4.sheets_service(credential_source:)
+    #
+    # @param credential_source [nil, String, IO, Google::Auth::*] may
+    #   be either an already constructed credential, the credential read into a String or
+    #   an open file with the credential ready to be read. Passing `nil` will result
+    #   in the credential being read from `~/.google-api-credential.json`.
+    #
+    # @param scopes [Object, Array] one or more scopes to access.
+    #
+    # @param credential_creator [#credential] Used to inject the credential creator for
+    #   testing.
+    #
+    # @return a new SheetsService instance
+    #
+    def sheets_service(credential_source: nil, scopes: nil, credential_creator: SheetsV4::CreateCredential)
+      credential_source ||= File.read(File.expand_path('~/.google-api-credential.json'))
+      scopes ||= [Google::Apis::SheetsV4::AUTH_SPREADSHEETS]
+
+      Google::Apis::SheetsV4::SheetsService.new.tap do |service|
+        service.authorization = credential_creator.call(credential_source, scopes)
+      end
     end
-  end
 
-  # Validate the object using the named JSON schema
-  #
-  # The JSON schemas are loaded from the Google Disocvery API. The schemas names are
-  # returned by `SheetsV4.api_object_schema_names`.
-  #
-  # @example
-  #   schema_name = 'batch_update_spreadsheet_request'
-  #   object = { 'requests' => [] }
-  #   SheetsV4.validate_api_object(schema_name:, object:)
-  #
-  # @param schema_name [String] the name of the schema to validate against
-  # @param object [Object] the object to validate
-  # @param logger [Logger] the logger to use for logging error, info, and debug message
-  #
-  # @raise [RuntimeError] if the object does not conform to the schema
-  #
-  # @return [void]
-  #
-  def self.validate_api_object(schema_name:, object:, logger: Logger.new(nil))
-    SheetsV4::ValidateApiObjects::Validate.new(logger:).call(schema_name:, object:)
-  end
+    # @!group Validation
 
-  # List the names of the schemas available to use in the Google Sheets API
-  #
-  # @example List the name of the schemas available
-  #   SheetsV4.api_object_schema_names #=> ["add_banding_request", "add_banding_response", ...]
-  #
-  # @return [Array<String>] the names of the schemas available
-  #
-  def self.api_object_schema_names(logger: Logger.new(nil))
-    SheetsV4::ValidateApiObjects::LoadSchemas.new(logger:).call.keys.sort
-  end
+    # Validate the object using the named JSON schema
+    #
+    # The JSON schemas are loaded from the Google Disocvery API. The schemas names are
+    # returned by `SheetsV4.api_object_schema_names`.
+    #
+    # @example
+    #   schema_name = 'batch_update_spreadsheet_request'
+    #   object = { 'requests' => [] }
+    #   SheetsV4.validate_api_object(schema_name:, object:)
+    #
+    # @param schema_name [String] the name of the schema to validate against
+    # @param object [Object] the object to validate
+    # @param logger [Logger] the logger to use for logging error, info, and debug message
+    #
+    # @raise [RuntimeError] if the object does not conform to the schema
+    #
+    # @return [void]
+    #
+    def validate_api_object(schema_name:, object:, logger: Logger.new(nil))
+      SheetsV4::ApiObjectValidation::ValidateApiObject.new(logger:).call(schema_name:, object:)
+    end
 
-  # Given the name of the color, return a Google Sheets API color object
-  #
-  # Available color names are listed using `SheetsV4.color_names`.
-  #
-  # The object returned is frozen.  If you want a color you can change (for instance,
-  # to adjust the `alpha` attribute), you must clone the object returned.
-  #
-  # @example
-  #   SheetsV4::Color.color(:red) #=> { "red": 1.0, "green": 0.0, "blue": 0.0 }
-  #
-  # @param name [#to_sym] the name of the color requested
-  #
-  # @return [Hash] The color requested e.g. `{ "red": 1.0, "green": 0.0, "blue": 0.0 }`
-  #
-  # @api public
-  #
-  def self.color(name)
-    SheetsV4::Color::COLORS[name.to_sym] || raise("Color #{name} not found")
-  end
+    # List the names of the schemas available to use in the Google Sheets API
+    #
+    # @example List the name of the schemas available
+    #   SheetsV4.api_object_schema_names #=> ["add_banding_request", "add_banding_response", ...]
+    #
+    # @return [Array<String>] the names of the schemas available
+    #
+    def api_object_schema_names(logger: Logger.new(nil))
+      SheetsV4::ApiObjectValidation::LoadSchemas.new(logger:).call.keys.sort
+    end
+
+    # @!group Colors
+
+    # Given the name of the color, return a Google Sheets API color object
+    #
+    # Available color names are listed using `SheetsV4.color_names`.
+    #
+    # The object returned is frozen.  If you want a color you can change (for instance,
+    # to adjust the `alpha` attribute), you must clone the object returned.
+    #
+    # @example
+    #   SheetsV4::Color.color(:red) #=> { "red": 1.0, "green": 0.0, "blue": 0.0 }
+    #
+    # @param name [#to_sym] the name of the color requested
+    #
+    # @return [Hash] The color requested e.g. `{ "red": 1.0, "green": 0.0, "blue": 0.0 }`
+    #
+    def color(name)
+      SheetsV4::Color::COLORS[name.to_sym] || raise("Color #{name} not found")
+    end
+
+    # List the names of the colors available to use in the Google Sheets API
+    #
+    # @example
+    #   SheetsV4::Color.color_names #=> [:black, :white, :red, :green, :blue, :yellow, :magenta, :cyan, ...]
+    #
+    # @return [Array<Symbol>] the names of the colors available
+    #
+    def color_names = SheetsV4::Color::COLORS.keys
+
+    # @!group Date and DateTime Conversions
+
+    # @!attribute [rw] default_spreadsheet_tz
+    #
+    # Set the default time zone for date and time conversions
+    #
+    # Valid time zone names are those listed in one of these two sources:
+    # * `ActiveSupport::TimeZone.all.map { |tz| tz.tzinfo.name }`
+    # * `ActiveSupport::TimeZone.all.map(&:name)`
+    #
+    # If you want to set the timezone to the time zone of the system's local time,
+    # you could use the [timezone_local gem](https://rubygems.org/gems/timezone_local).
+    #
+    # @example
+    #   SheetsV4.default_spreadsheet_tz = 'America/Los_Angeles'
+    #
+    # @example Set the time zone to the system's local time
+    #   require 'timezone_local'
+    #   SheetsV4.default_spreadsheet_tz = TimeZone::Local.get.name
+    #
+    # @return [void]
+    #
+    def default_spreadsheet_tz
+      @default_spreadsheet_tz || raise('default_spreadsheet_tz not set')
+    end
 
-  # List the names of the colors available to use in the Google Sheets API
-  #
-  # @example
-  #   SheetsV4::Color.color_names #=> [:black, :white, :red, :green, :blue, :yellow, :magenta, :cyan, ...]
-  #
-  # @return [Array<Symbol>] the names of the colors available
-  # @api public
-  #
-  def self.color_names = SheetsV4::Color::COLORS.keys
+    def default_spreadsheet_tz=(time_zone)
+      raise "Invalid time zone '#{time_zone}'" unless ActiveSupport::TimeZone.new(time_zone)
+
+      @default_date_and_time_converter = nil unless @default_spreadsheet_tz == time_zone
+      @default_spreadsheet_tz = time_zone
+    end
+
+    # The default converter for dates and times
+    # @return [SheetsV4::ConvertDatesAndTimes]
+    # @api private
+    def default_date_and_time_converter
+      @default_date_and_time_converter ||= SheetsV4::ConvertDatesAndTimes.new(default_spreadsheet_tz)
+    end
+
+    # Convert a Ruby Date object to a Google Sheet date value
+    #
+    # Uses the time zone given by `SheetsV4.default_spreadsheet_tz`.
+    #
+    # @example with a Date object
+    #   SheetsV4.default_spreadsheet_tz = 'America/Los_Angeles'
+    #   date = Date.parse('2021-05-17')
+    #   SheetsV4.date_to_gs(date) #=> 44333
+    #
+    # @example with a DateTime object
+    #   SheetsV4.default_spreadsheet_tz = 'America/Los_Angeles'
+    #   date_time = DateTime.parse('2021-05-17 11:36:00 UTC')
+    #   SheetsV4.date_to_gs(date_time) #=> 44333
+    #
+    # @param date [DateTime, Date, nil] the date to convert
+    #
+    # @return [Float, String] the value to sstore in a Google Sheet cell
+    #   Returns a Float if date is not nil; otherwise, returns an empty string
+    #
+    def date_to_gs(date)
+      default_date_and_time_converter.date_to_gs(date)
+    end
+
+    # Convert a Google Sheets date value to a Ruby Date object
+    #
+    # @example with a date value
+    #   SheetsV4.default_spreadsheet_tz = 'America/Los_Angeles'
+    #   gs_value = 44333
+    #   SheetsV4.gs_to_date(gs_value) #=> #<Date: 2021-05-17 ...>
+    #
+    # @example with a date and time value
+    #   SheetsV4.default_spreadsheet_tz = 'America/Los_Angeles'
+    #   gs_value = 44333.191666666666
+    #   SheetsV4.gs_to_date(gs_value) #=> #<Date: 2021-05-17 ...>
+    #
+    # @param gs_value [Float, "", nil] the value from the Google Sheets cell
+    #
+    # @return [Date, nil] the value represented by gs_date
+    #
+    #   Returns a Date object if a Float was given; otherwise, returns nil if an
+    #   empty string or nil was given.
+    #
+    def gs_to_date(gs_value)
+      default_date_and_time_converter.gs_to_date(gs_value)
+    end
+
+    # Convert a Ruby DateTime object to a Google Sheets value
+    #
+    # @example
+    #   SheetsV4.default_spreadsheet_tz = 'America/Los_Angeles'
+    #   date_time = DateTime.parse('2021-05-17 11:36:00 UTC')
+    #   SheetsV4.datetime_to_gs(date_time) #=> 44333.191666666666
+    #
+    # @param datetime [DateTime, nil] the date and time to convert
+    #
+    # @return [Float, String] the value to store in a Google Sheet cell
+    #   Returns a Float if datetime is not nil; otherwise, returns an empty string.
+    #
+    def datetime_to_gs(datetime)
+      default_date_and_time_converter.datetime_to_gs(datetime)
+    end
+
+    # Convert a Google Sheets date time value to a DateTime object
+    #
+    # Time is rounded to the nearest second. The DateTime object returned is in
+    # the time zone given by `SheetsV4.default_spreadsheet_tz`.
+    #
+    # @example
+    #   SheetsV4.default_spreadsheet_tz = 'America/Los_Angeles'
+    #   gs_value = 44333.191666666666
+    #   SheetsV4.gs_to_datetime(gs_value) #=> #<DateTime: 2021-05-17T04:35:59-07:00 ...>
+    #
+    # @param gs_value [Float, "", nil] the value from the Google Sheets cell
+    #
+    # @return [DateTime, nil] the value represented by gs_datetime
+    #   Returns a DateTime object if a Float was given; otherwise, returns nil if an
+    #   empty string or nil was given.
+    #
+    def gs_to_datetime(gs_value)
+      default_date_and_time_converter.gs_to_datetime(gs_value)
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sheets_v4
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - James Couball
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-10-04 00:00:00.000000000 Z
+date: 2023-10-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler-audit
@@ -260,13 +260,20 @@ files:
 - examples/set_background_color
 - examples/set_background_color2
 - lib/sheets_v4.rb
+- lib/sheets_v4/api_object_validation.rb
+- lib/sheets_v4/api_object_validation/load_schemas.rb
+- lib/sheets_v4/api_object_validation/resolve_schema_ref.rb
+- lib/sheets_v4/api_object_validation/traverse_object_tree.rb
+- lib/sheets_v4/api_object_validation/validate_api_object.rb
 - lib/sheets_v4/color.rb
-- lib/sheets_v4/credential_creator.rb
+- lib/sheets_v4/convert_dates_and_times.rb
+- lib/sheets_v4/create_credential.rb
+- lib/sheets_v4/google_extensions.rb
+- lib/sheets_v4/google_extensions/sheet.rb
+- lib/sheets_v4/google_extensions/sheets_service.rb
+- lib/sheets_v4/google_extensions/spreadsheet.rb
 - lib/sheets_v4/validate_api_objects.rb
-- lib/sheets_v4/validate_api_objects/load_schemas.rb
-- lib/sheets_v4/validate_api_objects/resolve_schema_ref.rb
-- lib/sheets_v4/validate_api_objects/traverse_object_tree.rb
-- lib/sheets_v4/validate_api_objects/validate.rb
+- lib/sheets_v4/validate_api_objects/validate_api_object.rb
 - lib/sheets_v4/version.rb
 homepage: https://github.com/main-branch/sheets_v4
 licenses: