sheets_v4 0.1.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e8b306cf08149067ba4f5506c54c88df4e2af706f064b3b2b7cc7f5919991f4
-  data.tar.gz: 438a64d88598542b9f9ed56552077836089e04b411aa8a4ceabf5279b131a393
+  metadata.gz: 27e014c65904a88e3fb4df001a8b28c64c307363b3cd658da252a951c55da992
+  data.tar.gz: c6900f0d163abdb621a49080295ca7e59f82b89bae69d5e5729aa74aac765a1b
 SHA512:
-  metadata.gz: 3728b1539d987a5aa7dfbbb45d0a9637d01c39d5fe3d8a3e19cd7206b9fab4b9ce1458d1f6e534e6ddb79d93d2792c93f940f3a800f2eb657647dd4dfdebceb9
-  data.tar.gz: fe7d8f59b7663f76804d18e13ece431bdce418252efe51a2e50d28a5d3e5fe1c979b367287155032e82571e09c593bd9be2b40cc461901a4bf5bec728cfcc8e2
+  metadata.gz: e60614708c5f348d05388a1bfe7b51603a92797e852aa20445d37451a493655aac69ea86fd901d500a9898a289f469d9a3780fdbe2f2756cfb80a65110641455
+  data.tar.gz: 71ea62ff3e93faf9d9ece533ccd98f5491dea2f04d00d01c01020dd501a251a3b0b61544e0e57e85643fc0afedbfe97e92250d71b5968c63650822f0e3338433

data/.markdownlint.yml

@@ -0,0 +1,25 @@
+default: true
+
+# Unordered list indentation
+MD007: { indent: 2 }
+
+# Line length
+MD013: { line_length: 90, tables: false, code_blocks: false }
+
+# Heading duplication is allowed for non-sibling headings
+MD024: { siblings_only: true }
+
+# Do not allow the specified trailig punctuation in a header
+MD026: { punctuation: '.,;:' }
+
+# Order list items must have a prefix that increases in numerical order
+MD029: { style: 'ordered' }
+
+# Lists do not need to be surrounded by blank lines
+MD032: false
+
+# Allow raw HTML in Markdown
+MD033: false
+
+# Allow emphasis to be used instead of a heading
+MD036: false

data/.rubocop.yml

@@ -23,6 +23,9 @@ Metrics/BlockLength:
     - "spec/**/*_spec.rb"
     - "*.gemspec"
 
+Metrics/ModuleLength:
+  CountAsOne: ['hash']
+
 # When writing minitest tests, it is very hard to limit test class length:
 Metrics/ClassLength:
   Exclude:

data/CHANGELOG.md

@@ -4,6 +4,24 @@ Changes for each release are listed in this file.
 
 This project adheres to [Semantic Versioning](https://semver.org/) for its releases.
 
+## v0.3.0 (2023-09-28)
+
+[Full Changelog](https://github.com/main-branch/sheets_v4/compare/v0.2.0..v0.3.0)
+
+Changes since v0.2.0:
+
+* 0fb4579 Add predefined color objects (#8)
+
+## v0.2.0 (2023-09-26)
+
+[Full Changelog](https://github.com/main-branch/sheets_v4/compare/v0.1.1..v0.2.0)
+
+Changes since v0.1.1:
+
+* 489ff50 Add SheetsV4.validate_api_object (#6)
+* b44eba4 List all examples that should be created (#5)
+* 2edd688 Add links to Google Sheets documentation to the README.md (#4)
+
 ## v0.1.1 (2023-09-22)
 
 [Full Changelog](https://github.com/main-branch/sheets_v4/compare/v0.1.0..v0.1.1)

data/README.md

@@ -9,12 +9,33 @@
 
 Unofficial helpers for the Google Sheets V4 API
 
-- [SheetsV4](#sheetsv4)
-  - [Installation](#installation)
-  - [Usage](#usage)
-  - [Development](#development)
-  - [Contributing](#contributing)
-  - [License](#license)
+* [Important Links for Programming Google Sheets](#important-links-for-programming-google-sheets)
+  * [General API Documentation](#general-api-documentation)
+  * [Ruby Implementation of the Sheets API](#ruby-implementation-of-the-sheets-api)
+  * [Other Links](#other-links)
+* [Installation](#installation)
+* [Usage](#usage)
+* [Development](#development)
+* [Creating a Google API Service Account](#creating-a-google-api-service-account)
+* [Contributing](#contributing)
+* [License](#license)
+
+## Important Links for Programming Google Sheets
+
+### General API Documentation
+
+* [Google Sheets API Overview](https://developers.google.com/sheets/api)
+* [Google Sheets API Reference](https://developers.google.com/sheets/api/reference/rest)
+* [Batch Update Requests](https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/request)
+
+### Ruby Implementation of the Sheets API
+
+* [SheetsService Class](https://github.com/googleapis/google-api-ruby-client/blob/main/generated/google-apis-sheets_v4/lib/google/apis/sheets_v4/service.rb)
+* [All Other Sheets Classes](https://github.com/googleapis/google-api-ruby-client/blob/main/generated/google-apis-sheets_v4/lib/google/apis/sheets_v4/classes.rb)
+
+### Other Links
+
+* [Apps Script for Sheets](https://developers.google.com/apps-script/guides/sheets)
 
 ## Installation
 
@@ -46,6 +67,9 @@ release a new version, update the version number in `version.rb`, and then run
 commits and the created tag, and push the `.gem` file to
 [rubygems.org](https://rubygems.org).
 
+## Creating a Google API Service Account
+
+
 ## Contributing
 
 Bug reports and pull requests are welcome on [the main-branch/sheets_v4 GitHub project](https://github.com/main-branch/sheets_v4).
@@ -53,4 +77,4 @@ Bug reports and pull requests are welcome on [the main-branch/sheets_v4 GitHub p
 ## License
 
 The gem is available as open source under the terms of the
-[MIT License](https://opensource.org/licenses/MIT).
+[MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -4,7 +4,7 @@ desc 'Run the same tasks that the CI build will run'
 if RUBY_PLATFORM == 'java'
   task default: %w[spec rubocop bundle:audit build]
 else
-  task default: %w[spec rubocop yard yard:audit yard:coverage bundle:audit build]
+  task default: %w[spec rubocop yard bundle:audit build]
 end
 
 # Bundler Audit
@@ -58,28 +58,41 @@ end
 CLEAN << 'rubocop-report.json'
 
 unless RUBY_PLATFORM == 'java'
-  # YARD
+  # yard:build
 
   require 'yard'
-  YARD::Rake::YardocTask.new do |t|
-    t.files = %w[lib/**/*.rb examples/**/*]
+
+  YARD::Rake::YardocTask.new('yard:build') do |t|
+    t.files = %w[lib/**/*.rb]
+    t.stats_options = ['--list-undoc']
   end
 
   CLEAN << '.yardoc'
   CLEAN << 'doc'
 
-  # Yardstick
+  # yard:audit
 
   desc 'Run yardstick to show missing YARD doc elements'
   task :'yard:audit' do
     sh "yardstick 'lib/**/*.rb'"
   end
 
-  # Yardstick coverage
+  # yard:coverage
 
   require 'yardstick/rake/verify'
 
   Yardstick::Rake::Verify.new(:'yard:coverage') do |verify|
     verify.threshold = 100
+    verify.require_exact_threshold = false
+  end
+
+  task yard: %i[yard:build yard:audit yard:coverage]
+
+  # github-pages:publish
+
+  require 'github_pages_rake_tasks'
+  GithubPagesRakeTasks::PublishTask.new do |task|
+    # task.doc_dir = 'documentation'
+    task.verbose = true
   end
 end

data/examples/README.md

@@ -0,0 +1,47 @@
+# Google Sheets Examples
+
+* [ ] Creating a Google API service account [1](https://www.youtube.com/watch?v=sAgWCbGMzTo&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=1)
+[2](https://www.youtube.com/watch?v=sVURhxyc6jE&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=43)
+* [ ] Create a SheetsService instance
+* [ ] Creating Google Sheets files [1](https://www.youtube.com/watch?v=JRUxeQ6ZCy0&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=2)
+* [ ] Writing data to a sheet [1](https://www.youtube.com/watch?v=YF7Ad-7pvks&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=3)
+* [ ] Reading data from a sheet [1](https://www.youtube.com/watch?v=gkglr8GID5E&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=4)
+  * Reading data
+  * Reading formulas
+* [ ] Data formatting basics [1](https://www.youtube.com/watch?v=R4EN3iPRris&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=5)
+* [ ] Creating charts [1](https://www.youtube.com/watch?v=xt3p5I8mNWE&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=6)
+* [ ] Data validation [1](https://www.youtube.com/watch?v=n_Z2565gu6Y&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=7)
+* [ ] Cut, copy, and paste [1](https://www.youtube.com/watch?v=r8GWH2E_ehw&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=8)
+* [ ] Duplicate sheets [1](https://www.youtube.com/watch?v=BgQoPcoOiGY&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=9)
+* [ ] List sheets in a spreadsheet [1](https://www.youtube.com/watch?v=BgQoPcoOiGY&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=9)
+* [ ] Set column width and row height [1](https://www.youtube.com/watch?v=H3uMEaPqTVE&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=11)
+* [ ] Append rows and columns [1](https://www.youtube.com/watch?v=txfiwEjb7sk&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=12)
+* [ ] Delete rows and columns [1](https://www.youtube.com/watch?v=w1jrCxWx7Tc&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=13)
+* [ ] Insert rows and columns [1](https://www.youtube.com/watch?v=FL7WSsO5EVs&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=14)
+* [ ] Move rows and columns [1](https://www.youtube.com/watch?v=YHk3305dkOc&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=15)
+* [ ] Clear data [1](https://www.youtube.com/watch?v=mvbnhfdDrro&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=16)
+* [ ] Add and delete sheets [1](https://www.youtube.com/watch?v=X9PVQQVoJFc&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=17)
+* [ ] Copy sheet from one spreadsheet to another [1](https://www.youtube.com/watch?v=aIEM7Ts4n-c&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=18)
+* [ ] Add a new sheet to an existing spreadsheet
+* [ ] Export a sheet to a CSV file [1](https://www.youtube.com/watch?v=Dz22fsWsLhI&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=25)
+* [ ] Sort sheets [1](https://www.youtube.com/watch?v=qbBZX7uBM1M&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=27)
+* [ ] Add calculated fields into a pivot table [1](https://www.youtube.com/watch?v=VR8zOz5ATLU&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=32)
+* [ ] Named ranges [1](https://www.youtube.com/watch?v=LTPdfXS_LHA&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=42)
+* [ ] Create a pivot table [1](https://www.youtube.com/watch?v=preFnuL7ua0&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=28)
+* [ ] Calculated pivot fields [1](https://www.youtube.com/watch?v=QLssI4uvjk4&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=33)
+* [ ] Delete a pivot table
+* [ ] Add pivot fields [1](https://www.youtube.com/watch?v=VR8zOz5ATLU&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=32)
+* [ ] Add pivot filters [1](https://www.youtube.com/watch?v=EKikw-eIcbY&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=29)
+* [ ] Collapse/expand pivot table groups [1](https://www.youtube.com/watch?v=-S9bs5-ZJ5E&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=31)
+* [ ] Extract pivot table metadata [1](https://www.youtube.com/watch?v=H1SGdqbaL4w&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=30)
+* [ ] Filter views [1](https://www.youtube.com/watch?v=GyRxsSlx0GU&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=34)
+* [ ] Locate the last row in a column [1](https://www.youtube.com/watch?v=NWWHleJll28&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=35)
+* [ ] Autofill [1](https://www.youtube.com/watch?v=guHGNmODdpM&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=36)
+* [ ] Rename a sheet [1](https://www.youtube.com/watch?v=iuiDUJ4NrQI&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=37)
+* [ ] Find and replace [1](https://www.youtube.com/watch?v=YaFR0bu5CrY&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=39)
+* [ ] Add and delete sheets [1](https://www.youtube.com/watch?v=gMD4v8F8vlc&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=38)
+* [ ] Sum across sheets [1](https://www.youtube.com/watch?v=7QNk-MXkPC4&list=PL3JVwFmb_BnSee8RFaRPZ3nykuMRlaQp1&index=44)
+* [ ] Freeze rows / columns
+* [ ] Protected ranges
+* [ ] Resize a sheet
+* [ ] Retrying on error

data/lib/sheets_v4/color.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'json_schemer'
+
+module SheetsV4
+  # Predefined color objects
+  # @api public
+  class Color
+    class << self
+      # Return a color object for the given name from SheetsV4::COLORS or call super
+      #
+      # @param method_name [Symbol] the name of the color
+      # @param arguments [Array] ignored
+      # @param block [Proc] ignored
+      # @return [Hash] the color object
+      # @api private
+      def method_missing(method_name, *arguments, &)
+        SheetsV4::COLORS[method_name.to_sym] || super
+      end
+
+      # Return true if the given method name is a color name or call super
+      #
+      # @param method_name [Symbol] the name of the color
+      # @param include_private [Boolean] ignored
+      # @return [Boolean] true if the method name is a color name
+      # @api private
+      def respond_to_missing?(method_name, include_private = false)
+        SheetsV4::COLORS.key?(method_name.to_sym) || super
+      end
+    end
+  end
+end

data/lib/sheets_v4/validate_api_object.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+require 'json_schemer'
+
+module SheetsV4
+  # Validate objects against a Google Sheets API request object schema
+  #
+  # @api public
+  #
+  class ValidateApiObject
+    # Create a new validator
+    #
+    # By default, a nil logger is used. This means that no messages are logged.
+    #
+    # @example
+    #   logger = Logger.new(STDOUT, :level => Logger::INFO)
+    #   validator = SheetsV4::ValidateApiObject.new(logger)
+    #
+    # @param logger [Logger] the logger to use
+    #
+    def initialize(logger = Logger.new(nil))
+      @logger = logger
+    end
+
+    # The logger to use internally
+    #
+    # Validation errors are logged at the error level. Other messages are logged
+    # at the debug level.
+    #
+    # @example
+    #   logger = Logger.new(STDOUT, :level => Logger::INFO)
+    #   validator = SheetsV4::ValidateApiObject.new(logger)
+    #   validator.logger == logger # => true
+    #   validator.logger.debug { "Debug message" }
+    #
+    # @return [Logger]
+    #
+    attr_reader :logger
+
+    # Validate the object using the JSON schema named schema_name
+    #
+    # @example
+    #   schema_name = 'BatchUpdateSpreadsheetRequest'
+    #   object = { 'requests' => [] }
+    #   validator = SheetsV4::ValidateApiObject.new
+    #   validator.call(schema_name, object)
+    #
+    # @param schema_name [String] the name of the schema to validate against
+    # @param object [Object] the object to validate
+    #
+    # @raise [RuntimeError] if the object does not conform to the schema
+    #
+    # @return [void]
+    #
+    def call(schema_name, object)
+      logger.debug { "Validating #{object} against #{schema_name}" }
+
+      schema = { '$ref' => schema_name }
+      schemer = JSONSchemer.schema(schema, ref_resolver:)
+      errors = schemer.validate(object)
+      raise_error!(schema_name, object, errors) if errors.any?
+
+      logger.debug { "Object #{object} conforms to #{schema_name}" }
+    end
+
+    private
+
+    # The resolver to use to resolve JSON schema references
+    # @return [SchemaRefResolver]
+    # @api private
+    def ref_resolver = @ref_resolver ||= SchemaRefResolver.new(logger)
+
+    # Raise an error when the object does not conform to the schema
+    # @return [void]
+    # @raise [RuntimeError]
+    # @api private
+    def raise_error!(schema_name, object, errors)
+      error = errors.first['error']
+      error_message = "Object #{object} does not conform to #{schema_name}: #{error}"
+      logger.error(error_message)
+      raise error_message
+    end
+  end
+
+  # Resolve JSON schema references to Google Sheets API schemas
+  #
+  # Uses the Google Discovery API to get the schemas. This is an implementation
+  # detail used to interact with JSONSchemer.
+  #
+  # @api private
+  #
+  class SchemaRefResolver
+    # Create a new schema resolver
+    #
+    # @param logger [Logger] the logger to use
+    #
+    # @api private
+    #
+    def initialize(logger)
+      @logger = logger
+    end
+
+    # The logger to use internally
+    #
+    # Currently, only info messages are logged.
+    #
+    # @return [Logger]
+    #
+    # @api private
+    #
+    attr_reader :logger
+
+    # Resolve a JSON schema reference
+    #
+    # @param ref [String] the reference to resolve usually in the form "#/definitions/schema_name"
+    #
+    # @return [Hash] the schema object as a hash
+    #
+    # @api private
+    #
+    def call(ref)
+      schema_name = ref.path[1..]
+      logger.debug { "Reading schema #{schema_name}" }
+      schema_object = SheetsV4.api_object_schemas[schema_name]
+      raise "Schema for #{ref} not found" unless schema_object
+
+      schema_object.to_h.tap do |schema|
+        schema['unevaluatedProperties'] = false
+      end
+    end
+  end
+end

data/lib/sheets_v4/version.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
 module SheetsV4
-  VERSION = '0.1.1'
+  # The version of this gem
+  VERSION = '0.3.0'
 end

data/lib/sheets_v4.rb

@@ -1,8 +1,242 @@
 # frozen_string_literal: true
 
 require_relative 'sheets_v4/version'
+require_relative 'sheets_v4/color'
+require_relative 'sheets_v4/validate_api_object'
 
+require 'json'
+require 'logger'
+require 'net/http'
+
+# Unofficial helpers for the Google Sheets V4 API
+#
+# @api public
+#
 module SheetsV4
-  class Error < StandardError; end
-  # Your code goes here...
+  # 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_schemas.keys`.
+  #
+  # @example
+  #   schema_name = 'BatchUpdateSpreadsheetRequest'
+  #   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))
+    ValidateApiObject.new(logger).call(schema_name, object)
+  end
+
+  # A hash of schemas keyed by the schema name loaded from the Google Discovery API
+  #
+  # @example
+  #   SheetsV4.api_object_schemas #=> { 'PersonSchema' => { 'type' => 'object', ... } ... }
+  #
+  # @return [Hash<String, Object>] a hash of schemas keyed by schema name
+  #
+  def self.api_object_schemas
+    schema_load_semaphore.synchronize { @api_object_schemas ||= load_api_object_schemas }
+  end
+
+  # Validate
+  # A mutex used to synchronize access to the schemas so they are only loaded
+  # once.
+  #
+  @schema_load_semaphore = Thread::Mutex.new
+
+  # A mutex used to synchronize access to the schemas so they are only loaded once
+  #
+  # @return [Thread::Mutex]
+  #
+  # @api private
+  #
+  def self.schema_load_semaphore = @schema_load_semaphore
+
+  # Load the schemas from the Google Discovery API
+  #
+  # @return [Hash<String, Object>] a hash of schemas keyed by schema name
+  #
+  # @api private
+  #
+  def self.load_api_object_schemas
+    source = 'https://sheets.googleapis.com/$discovery/rest?version=v4'
+    resp = Net::HTTP.get_response(URI.parse(source))
+    data = resp.body
+    JSON.parse(data)['schemas'].tap do |schemas|
+      schemas.each { |_name, schema| schema['unevaluatedProperties'] = false }
+    end
+  end
+
+  # Return a color object for the given name from SheetsV4::COLORS
+  #
+  # @example
+  #   SheetsV4::Color.color(:red) #=> { "red": 1.0, "green": 0.0, "blue": 0.0 }
+  #
+  # @param name [Symbol] the name of the color
+  # @return [Hash] the color object
+  # @api public
+  def self.color(name)
+    SheetsV4::COLORS[name.to_sym]
+  end
+
+  # Colors to use in the Google Sheets API
+  COLORS = {
+    # Standard Google Sheets colors
+
+    black: { red: 0.000000000, green: 0.000000000, blue: 0.000000000 },
+    dark_gray4: { red: 0.262745098, green: 0.262745098, blue: 0.262745098 },
+    dark_gray3: { red: 0.400000000, green: 0.400000000, blue: 0.400000000 },
+    dark_gray2: { red: 0.600000000, green: 0.600000000, blue: 0.600000000 },
+    dark_gray1: { red: 0.717647059, green: 0.717647059, blue: 0.717647059 },
+    gray: { red: 0.800000000, green: 0.800000000, blue: 0.800000000 },
+    light_gray1: { red: 0.850980392, green: 0.850980392, blue: 0.850980392 },
+    light_gray2: { red: 0.937254902, green: 0.937254902, blue: 0.937254902 },
+    light_gray3: { red: 0.952941176, green: 0.952941176, blue: 0.952941176 },
+    white: { red: 1.000000000, green: 1.000000000, blue: 1.000000000 },
+    red_berry: { red: 0.596078431, green: 0.000000000, blue: 0.000000000 },
+    red: { red: 1.000000000, green: 0.000000000, blue: 0.000000000 },
+    orange: { red: 1.000000000, green: 0.600000000, blue: 0.000000000 },
+    yellow: { red: 1.000000000, green: 1.000000000, blue: 0.000000000 },
+    green: { red: 0.000000000, green: 1.000000000, blue: 0.000000000 },
+    cyan: { red: 0.000000000, green: 1.000000000, blue: 1.000000000 },
+    cornflower_blue: { red: 0.290196078, green: 0.525490196, blue: 0.909803922 },
+    blue: { red: 0.000000000, green: 0.000000000, blue: 1.000000000 },
+    purple: { red: 0.600000000, green: 0.000000000, blue: 1.000000000 },
+    magenta: { red: 1.000000000, green: 0.000000000, blue: 1.000000000 },
+    light_red_berry3: { red: 0.901960784, green: 0.721568627, blue: 0.686274510 },
+    light_red3: { red: 0.956862745, green: 0.800000000, blue: 0.800000000 },
+    light_orange3: { red: 0.988235294, green: 0.898039216, blue: 0.803921569 },
+    light_yellow3: { red: 1.000000000, green: 0.949019608, blue: 0.800000000 },
+    light_green3: { red: 0.850980392, green: 0.917647059, blue: 0.827450980 },
+    light_cyan3: { red: 0.815686275, green: 0.878431373, blue: 0.890196078 },
+    light_cornflower_blue3: { red: 0.788235294, green: 0.854901961, blue: 0.972549020 },
+    light_blue3: { red: 0.811764706, green: 0.886274510, blue: 0.952941176 },
+    light_purple3: { red: 0.850980392, green: 0.823529412, blue: 0.913725490 },
+    light_magenta3: { red: 0.917647059, green: 0.819607843, blue: 0.862745098 },
+    light_red_berry2: { red: 0.866666667, green: 0.494117647, blue: 0.419607843 },
+    light_red2: { red: 0.917647059, green: 0.600000000, blue: 0.600000000 },
+    light_orange2: { red: 0.976470588, green: 0.796078431, blue: 0.611764706 },
+    light_yellow2: { red: 1.000000000, green: 0.898039216, blue: 0.600000000 },
+    light_green2: { red: 0.713725490, green: 0.843137255, blue: 0.658823529 },
+    light_cyan2: { red: 0.635294118, green: 0.768627451, blue: 0.788235294 },
+    light_cornflower_blue2: { red: 0.643137255, green: 0.760784314, blue: 0.956862745 },
+    light_blue2: { red: 0.623529412, green: 0.772549020, blue: 0.909803922 },
+    light_purple2: { red: 0.705882353, green: 0.654901961, blue: 0.839215686 },
+    light_magenta2: { red: 0.835294118, green: 0.650980392, blue: 0.741176471 },
+    light_red_berry1: { red: 0.800000000, green: 0.254901961, blue: 0.145098039 },
+    light_red1: { red: 0.878431373, green: 0.400000000, blue: 0.400000000 },
+    light_orange1: { red: 0.964705882, green: 0.698039216, blue: 0.419607843 },
+    light_yellow1: { red: 1.000000000, green: 0.850980392, blue: 0.400000000 },
+    light_green1: { red: 0.576470588, green: 0.768627451, blue: 0.490196078 },
+    light_cyan1: { red: 0.462745098, green: 0.647058824, blue: 0.686274510 },
+    light_cornflower_blue1: { red: 0.427450980, green: 0.619607843, blue: 0.921568627 },
+    light_blue1: { red: 0.435294118, green: 0.658823529, blue: 0.862745098 },
+    light_purple1: { red: 0.556862745, green: 0.486274510, blue: 0.764705882 },
+    light_magenta1: { red: 0.760784314, green: 0.482352941, blue: 0.627450980 },
+    dark_red_berry1: { red: 0.650980392, green: 0.109803922, blue: 0.000000000 },
+    dark_red1: { red: 0.800000000, green: 0.000000000, blue: 0.000000000 },
+    dark_orange1: { red: 0.901960784, green: 0.568627451, blue: 0.219607843 },
+    dark_yellow1: { red: 0.945098039, green: 0.760784314, blue: 0.196078431 },
+    dark_green1: { red: 0.415686275, green: 0.658823529, blue: 0.309803922 },
+    dark_cyan1: { red: 0.270588235, green: 0.505882353, blue: 0.556862745 },
+    dark_cornflower_blue1: { red: 0.235294118, green: 0.470588235, blue: 0.847058824 },
+    dark_blue1: { red: 0.239215686, green: 0.521568627, blue: 0.776470588 },
+    dark_purple1: { red: 0.403921569, green: 0.305882353, blue: 0.654901961 },
+    dark_magenta1: { red: 0.650980392, green: 0.301960784, blue: 0.474509804 },
+    dark_red_berry2: { red: 0.521568627, green: 0.125490196, blue: 0.047058824 },
+    dark_red2: { red: 0.600000000, green: 0.000000000, blue: 0.000000000 },
+    dark_orange2: { red: 0.705882353, green: 0.372549020, blue: 0.023529412 },
+    dark_yellow2: { red: 0.749019608, green: 0.564705882, blue: 0.000000000 },
+    dark_green2: { red: 0.219607843, green: 0.462745098, blue: 0.113725490 },
+    dark_cyan2: { red: 0.074509804, green: 0.309803922, blue: 0.360784314 },
+    dark_cornflower_blue2: { red: 0.066666667, green: 0.333333333, blue: 0.800000000 },
+    dark_blue2: { red: 0.043137255, green: 0.325490196, blue: 0.580392157 },
+    dark_purple2: { red: 0.207843137, green: 0.109803922, blue: 0.458823529 },
+    dark_magenta2: { red: 0.454901961, green: 0.105882353, blue: 0.278431373 },
+    dark_red_berry3: { red: 0.356862745, green: 0.058823529, blue: 0.000000000 },
+    dark_red3: { red: 0.400000000, green: 0.000000000, blue: 0.000000000 },
+    dark_orange3: { red: 0.470588235, green: 0.247058824, blue: 0.015686275 },
+    dark_yellow3: { red: 0.498039216, green: 0.376470588, blue: 0.000000000 },
+    dark_green3: { red: 0.152941176, green: 0.305882353, blue: 0.074509804 },
+    darn_cyan3: { red: 0.047058824, green: 0.203921569, blue: 0.239215686 },
+    dark_cornflower_blue3: { red: 0.109803922, green: 0.270588235, blue: 0.529411765 },
+    dark_blue3: { red: 0.027450980, green: 0.215686275, blue: 0.388235294 },
+    dark_purple3: { red: 0.125490196, green: 0.070588235, blue: 0.301960784 },
+    dark_magenta3: { red: 0.298039216, green: 0.066666667, blue: 0.188235294 },
+
+    # Yahoo brand colors
+
+    grape_jelly: { red: 0.376470588, green: 0.003921569, blue: 0.823529412 },
+    hulk_pants: { red: 0.494117647, green: 0.121568627, blue: 1.000000000 },
+    malbec: { red: 0.223529412, green: 0.000000000, blue: 0.490196078 },
+    tumeric: { red: 1.000000000, green: 0.654901961, blue: 0.000000000 },
+    mulah: { red: 0.101960784, green: 0.772549020, blue: 0.403921569 },
+    dory: { red: 0.058823529, green: 0.411764706, blue: 1.000000000 },
+    malibu: { red: 1.000000000, green: 0.000000000, blue: 0.501960784 },
+    sea_foam: { red: 0.066666667, green: 0.827450980, blue: 0.803921569 },
+    tumeric_tint: { red: 0.980392157, green: 0.866666667, blue: 0.694117647 },
+    mulah_tint: { red: 0.733333333, green: 0.901960784, blue: 0.776470588 },
+    dory_tint: { red: 0.662745098, green: 0.772549020, blue: 0.984313725 },
+    malibu_tint: { red: 0.968627451, green: 0.682352941, blue: 0.800000000 },
+    sea_foam_tint: { red: 0.749019608, green: 0.925490196, blue: 0.921568627 },
+
+    # Yahoo health colors
+
+    health_green: { red: 0.000000000, green: 0.690196078, blue: 0.313725490 },
+    health_yellow: { red: 1.000000000, green: 0.654901961, blue: 0.000000000 },
+    health_red: { red: 1.000000000, green: 0.000000000, blue: 0.000000000 },
+
+    # Yahoo Fuji design color palette
+
+    fuji_color_watermelon: { red: 1.000000000, green: 0.321568627, blue: 0.341176471 },
+    fuji_color_solo_cup: { red: 0.921568627, green: 0.058823529, blue: 0.160784314 },
+    fuji_color_malibu: { red: 1.000000000, green: 0.000000000, blue: 0.501960784 },
+    fuji_color_barney: { red: 0.800000000, green: 0.000000000, blue: 0.549019608 },
+    fuji_color_mimosa: { red: 1.000000000, green: 0.827450980, blue: 0.200000000 },
+    fuji_color_turmeric: { red: 1.000000000, green: 0.654901961, blue: 0.000000000 },
+    fuji_color_cheetos: { red: 0.992156863, green: 0.380392157, blue: 0.000000000 },
+    fuji_color_carrot_juice: { red: 1.000000000, green: 0.321568627, blue: 0.050980392 },
+    fuji_color_mulah: { red: 0.101960784, green: 0.772549020, blue: 0.403921569 },
+    fuji_color_bonsai: { red: 0.000000000, green: 0.529411765, blue: 0.317647059 },
+    fuji_color_spirulina: { red: 0.000000000, green: 0.627450980, blue: 0.627450980 },
+    fuji_color_sea_foam: { red: 0.066666667, green: 0.827450980, blue: 0.803921569 },
+    fuji_color_peeps: { red: 0.490196078, green: 0.796078431, blue: 1.000000000 },
+    fuji_color_sky: { red: 0.070588235, green: 0.662745098, blue: 1.000000000 },
+    fuji_color_dory: { red: 0.058823529, green: 0.411764706, blue: 1.000000000 },
+    fuji_color_scooter: { red: 0.000000000, green: 0.388235294, blue: 0.921568627 },
+    fuji_color_cobalt: { red: 0.000000000, green: 0.227450980, blue: 0.737254902 },
+    fuji_color_denim: { red: 0.101960784, green: 0.050980392, blue: 0.670588235 },
+    fuji_color_blurple: { red: 0.364705882, green: 0.368627451, blue: 1.000000000 },
+    fuji_color_hendrix: { red: 0.972549020, green: 0.956862745, blue: 1.000000000 },
+    fuji_color_thanos: { red: 0.564705882, green: 0.486274510, blue: 1.000000000 },
+    fuji_color_starfish: { red: 0.466666667, green: 0.349019608, blue: 1.000000000 },
+    fuji_color_hulk_pants: { red: 0.494117647, green: 0.121568627, blue: 1.000000000 },
+    fuji_color_grape_jelly: { red: 0.376470588, green: 0.003921569, blue: 0.823529412 },
+    fuji_color_mulberry: { red: 0.313725490, green: 0.082352941, blue: 0.690196078 },
+    fuji_color_malbec: { red: 0.223529412, green: 0.000000000, blue: 0.490196078 },
+    fuji_grayscale_black: { red: 0.000000000, green: 0.000000000, blue: 0.000000000 },
+    fuji_grayscale_midnight: { red: 0.062745098, green: 0.082352941, blue: 0.094117647 },
+    fuji_grayscale_inkwell: { red: 0.113725490, green: 0.133333333, blue: 0.156862745 },
+    fuji_grayscale_batcave: { red: 0.137254902, green: 0.164705882, blue: 0.192156863 },
+    fuji_grayscale_ramones: { red: 0.172549020, green: 0.211764706, blue: 0.247058824 },
+    fuji_grayscale_charcoal: { red: 0.274509804, green: 0.305882353, blue: 0.337254902 },
+    fuji_grayscale_battleship: { red: 0.356862745, green: 0.388235294, blue: 0.415686275 },
+    fuji_grayscale_dolphin: { red: 0.431372549, green: 0.466666667, blue: 0.501960784 },
+    fuji_grayscale_shark: { red: 0.509803922, green: 0.541176471, blue: 0.576470588 },
+    fuji_grayscale_gandalf: { red: 0.592156863, green: 0.619607843, blue: 0.658823529 },
+    fuji_grayscale_bob: { red: 0.690196078, green: 0.725490196, blue: 0.756862745 },
+    fuji_grayscale_pebble: { red: 0.780392157, green: 0.803921569, blue: 0.823529412 },
+    fuji_grayscale_dirty_seagull: { red: 0.878431373, green: 0.894117647, blue: 0.913725490 },
+    fuji_grayscale_grey_hair: { red: 0.941176471, green: 0.952941176, blue: 0.960784314 },
+    fuji_grayscale_marshmallow: { red: 0.960784314, green: 0.972549020, blue: 0.980392157 },
+    fuji_grayscale_white: { red: 1.000000000, green: 1.000000000, blue: 1.000000000 }
+  }.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sheets_v4
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.3.0
 platform: ruby
 authors:
 - James Couball
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-09-22 00:00:00.000000000 Z
+date: 2023-09-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler-audit
@@ -170,6 +170,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: github_pages_rake_tasks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: google-apis-sheets_v4
   requirement: !ruby/object:Gem::Requirement
@@ -198,6 +212,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: json_schemer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rltk
   requirement: !ruby/object:Gem::Requirement
@@ -219,6 +247,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".markdownlint.yml"
 - ".rspec"
 - ".rubocop.yml"
 - ".yardopts"
@@ -227,7 +256,10 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- examples/README.md
 - lib/sheets_v4.rb
+- lib/sheets_v4/color.rb
+- lib/sheets_v4/validate_api_object.rb
 - lib/sheets_v4/version.rb
 homepage: https://github.com/main-branch/sheets_v4
 licenses: