google_drive_maintained 3.0.8 → 3.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 053ec12cbcb796741fed97379aef78d54f814e7e5523a8cf211e76e38e3ecc47
-  data.tar.gz: b78c0f974f0aa64a7e374be74af0edf24d29a5661ba3bd7949f2649be16db64f
+  metadata.gz: 3bc8471dadbc68ec2f2b2d4a27e44676fea447970d445b7e4554dd31183ec7a9
+  data.tar.gz: 6923ff6cda79e893cd884fa0271ca9617b0cfafae82d0117333f521b2551e86a
 SHA512:
-  metadata.gz: 52729ed042007b2a3855b8bcb8a8c037835e290cf12c2029bd4599e87ff7f1145aecba9416ee9b44ee3324c454bc86c3773f572cadefee97fab6d71774f5c14f
-  data.tar.gz: e87ae8f3694dec1a7e0502f81a32b9b2425bfaa84aa11e1a564fccd5d0425f0b899b383e003acd8eaa0f99a7bc9fcbcfec3ac28c6685bc0a10370e87ce0474e0
+  metadata.gz: 6f61fb3b709779d9c9530b4a55fa33f6c962f094605f0188efff6dce304e728ea923d9b9d1f5147d7290daf8e7ed9b3a6adfe5f3f885635abd637e10b375d411
+  data.tar.gz: 625b06e7bc2c79e164aaaed1f1f4c48440e87a2f7a86edd89beacbeeef3445f4fc2dfeef69817c807b74b8934e6b3a2e51571ca0c54c4156b3037c4602ff6b8c

data/README.md

@@ -1,9 +1,34 @@
-# google-drive-ruby [![Build Status](https://travis-ci.org/gimite/google-drive-ruby.svg?branch=master)](https://travis-ci.org/gimite/google-drive-ruby)
+# google-drive-ruby
+
+[![Gem](https://img.shields.io/gem/v/google_drive_maintained.svg)](https://rubygems.org/gems/google_drive_maintained)
+[![GitHub Actions Workflow Status](https://github.com/y-bonfire/google-drive-ruby-maintained/actions/workflows/ci.yml/badge.svg)](https://github.com/y-bonfire/google-drive-ruby-maintained/actions/workflows/ci.yml)
 
 This is a Ruby library to read/write files/spreadsheets in Google Drive/Docs.
 
 NOTE: This is NOT a library to create Google Drive App.
-NOTE: This is an unofficial maintained fork of google-drive-ruby, originally created by Hiroshi Ichikawa.
+
+## Introduction
+⚠️This is an unofficial maintained fork of [gimite/google-drive-ruby](https://github.com/gimite/google-drive-ruby), originally created by Hiroshi Ichikawa.
+
+We focus on preserving compatibility and fixing bugs, with minimal disruptive changes.
+New features may be added carefully when justified, but the core behavior will remain stable.
+
+See [this issue](https://github.com/y-bonfire/google-drive-ruby-maintained/issues/7) for background and intent.
+
+## Contributing
+
+We are actively working on improving the library, updating dependencies, and refining the development workflow.  
+If you'd like to contribute, please check [CONTRIBUTING.md](./CONTRIBUTING.md) for up-to-date contribution guidelines and technical notes (CI, testing, gem build, etc.).
+
+
+✅ GitHub Actions Integration
+We've started testing this library with GitHub Actions:
+👉 [CI Workflow Link](https://github.com/y-bonfire/google-drive-ruby-maintained/actions)
+
+This enables automated testing on every push and pull request, helping ensure long-term reliability.
+We welcome feedback and contributions to improve the CI process or test coverage. 🤗
+
+## table of contents
 
 * [Migration from ver. 2.x.x or before](#migration)
 * [How to install](#install)
@@ -19,7 +44,7 @@ NOTE: This is an unofficial maintained fork of google-drive-ruby, originally cre
 ## <a name="migration">Migration from ver. 2.x.x or before</a>
 
 There are some incompatible API changes. See
-[MIGRATING.md](https://github.com/gimite/google-drive-ruby/blob/master/MIGRATING.md).
+[MIGRATING.md](MIGRATING.md).
 
 
 ## <a name="install">How to install</a>
@@ -27,7 +52,7 @@ There are some incompatible API changes. See
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'google_drive'
+gem 'google_drive_maintained'
 ```
 
 And then execute:
@@ -39,20 +64,20 @@ $ bundle
 Or install it yourself as:
 
 ```
-$ gem install google_drive
+$ gem install google_drive_maintained
 ```
 
 If you need system wide installation, execute below:
 
 ```
-$ sudo gem install google_drive
+$ sudo gem install google_drive_maintained
 ```
 
 ## <a name="use">How to use</a>
 
 ### Authorization
 
-Follow one of the options in [Authorization](https://github.com/gimite/google-drive-ruby/blob/master/doc/authorization.md) to construct a session object. The example code below assumes "On behalf of you" option.
+Follow one of the options in [Authorization](doc/authorization.md) to construct a session object. The example code below assumes "On behalf of you" option.
 
 ### Example to read/write files in Google Drive
 
@@ -128,7 +153,7 @@ New BSD Licence.
 
 ## <a name="environments">Supported environments</a>
 
-Ruby 3.0.0 or later. Checked with Ruby 3.3.0.
+Ruby 3.2.0 or later. Checked with Ruby 3.3.0.
 
 
 ## <a name="author">Author</a>

data/lib/google_drive/cell.rb

@@ -0,0 +1,53 @@
+require 'forwardable'
+
+module GoogleDrive
+
+  class Cell
+    attr_reader :row, :col, :value
+
+    # @!attribute [r] properties
+    #   @return [Hash] properties
+    attr_reader :properties
+
+    # @!attribute [rw] worksheet
+    #   @return [Worksheet] worksheet
+    attr_accessor :worksheet
+
+    def initialize(worksheet, row, col, value, properties = {})
+      @worksheet = worksheet
+      @row = row
+      @col = col
+      @value = value
+      @properties = properties || {}
+    end
+
+    def ==(other)
+      case other
+      when GoogleDrive::Cell
+        @value == other.value
+      else
+        @value == other
+      end
+    end
+
+    def to_s
+      @value.to_s
+    end
+
+    def encoding
+      @value.respond_to?(:encoding) ? value.encoding : nil
+    end
+
+    def background_color=(color)
+      @worksheet.set_background_color(@row, @col, 1, 1, color)
+    end
+
+    def set_hyperlink_rich(text, hyperlink)
+      @worksheet.set_hyperlink_rich(@row, @col, 1, 1, text, hyperlink)
+    end
+
+    def hyperlink
+      @properties[:hyperlink]
+    end
+  end
+end

data/lib/google_drive/file.rb

@@ -96,7 +96,7 @@ module GoogleDrive
     def download_to_file(path, params = {})
       @session.drive_service.get_file(
         id,
-        { download_dest: path, supports_all_drives: true }.merge(params)
+        **{ download_dest: path, supports_all_drives: true }.merge(params)
       )
     end
 

data/lib/google_drive/session.rb

@@ -77,6 +77,7 @@ module GoogleDrive
     # As with from_config, you can configure Google API client behavior with
     # +client_options+ and +request_options+. Unlike in from_config, these
     # are passed as positional arguments.
+    # @return [GoogleDrive::Session]
     def self.from_service_account_key(
         json_key_path_or_io, scope = DEFAULT_SCOPE, client_options = nil,
         request_options = nil
@@ -270,6 +271,19 @@ module GoogleDrive
     # If given an Array, traverses folders by title. e.g.:
     #   session.file_by_title(
     #     ["myfolder", "mysubfolder/even/w/slash", "myfile"])
+    # root
+    # └── myfolder
+    #     └── mysubfolder/even/w/slash
+    #         └── myfile
+    # In Google Drive,
+    #
+    # "mysubfolder/even/w/slash"
+    #
+    # is a folder with a single name that includes a slash.
+    # For example, you can create a folder named mysubfolder/even/w/slash directly
+    # This is not a UNIX-style "path."
+    #
+    # @return [GoogleDrive::File]
     def file_by_title(title)
       if title.is_a?(Array)
         root_collection.file_by_title(title)
@@ -329,6 +343,7 @@ module GoogleDrive
     #   # https://docs.google.com/spreadsheets/d/1L3-kvwJblyW_TvjYD-7pE-AXxw5_bkb6S_MljuIPVL0/edit
     #   session.spreadsheet_by_key(
     #     "1L3-kvwJblyW_TvjYD-7pE-AXxw5_bkb6S_MljuIPVL0")
+    # @return [GoogleDrive::Spreadsheet]
     def spreadsheet_by_key(key)
       file = file_by_id(key)
       unless file.is_a?(Spreadsheet)

data/lib/google_drive/spreadsheet.rb

@@ -48,6 +48,7 @@ module GoogleDrive
     end
 
     # Returns worksheets of the spreadsheet as array of GoogleDrive::Worksheet.
+    # @return [Array<GoogleDrive::Worksheet>]
     def worksheets
       api_spreadsheet = @session.sheets_service.get_spreadsheet(id, fields: 'sheets.properties')
       api_spreadsheet.sheets.map{ |s| Worksheet.new(@session, self, s.properties) }

data/lib/google_drive/util.rb

@@ -27,6 +27,7 @@ module GoogleDrive
       '.htm' => 'text/html',
       '.html' => 'text/html',
       '.zip' => 'application/zip',
+      '.epub' => 'application/epub+zip',
       '.swf' => 'application/x-shockwave-flash'
     }.freeze
 

data/lib/google_drive/worksheet.rb

@@ -5,10 +5,10 @@ require 'cgi'
 require 'set'
 require 'uri'
 
-require 'google_drive/util'
-require 'google_drive/error'
-require 'google_drive/list'
-require_relative "worksheet_formatting"
+require_relative 'util'
+require_relative 'error'
+require_relative 'list'
+require_relative "cell"
 
 module GoogleDrive
   # A worksheet (i.e. a tab) in a spreadsheet.
@@ -16,7 +16,6 @@ module GoogleDrive
   # object.
   class Worksheet
     include(Util)
-    include(WorksheetFormatting)
 
     # A few default color instances that match the colors from the Google Sheets web UI.
     #
@@ -63,6 +62,7 @@ module GoogleDrive
       @cells = nil
       @input_values = nil
       @numeric_values = nil
+      @cell_properties = nil
       @modified = Set.new
       @list = nil
       @v4_requests = []
@@ -171,7 +171,7 @@ module GoogleDrive
     def [](*args)
       (row, col) = parse_cell_args(args)
       value = cells[[row, col]] || ''
-      Cell.new(self, row, col, value)
+      Cell.new(self, row, col, value, @cell_properties[[row, col]])
     end
 
     # Updates content of the cell.
@@ -192,6 +192,7 @@ module GoogleDrive
       @cells[[row, col]] = value
       @input_values[[row, col]] = value
       @numeric_values[[row, col]] = nil
+      @cell_properties[[row, col]] = nil
       @modified.add([row, col])
       self.max_rows = row if row > @max_rows
       self.max_cols = col if col > @max_cols
@@ -391,7 +392,7 @@ module GoogleDrive
           ranges: "'%s'" % @title,
           fields:
             'sheets(properties,data.rowData.values' \
-            '(formattedValue,userEnteredValue,effectiveValue))'
+            '(formattedValue,userEnteredValue,effectiveValue,hyperlink))'
         )
       api_sheet = api_spreadsheet.sheets[0]
       set_properties(api_sheet.properties)
@@ -419,7 +420,7 @@ module GoogleDrive
         })
       end
 
-      if !@v4_requests.empty?
+      unless @v4_requests.empty?
         self.spreadsheet.batch_update(@v4_requests)
         @v4_requests = []
         sent = true
@@ -588,6 +589,28 @@ module GoogleDrive
       format_cells(top_row, left_col, num_rows, num_cols, format, fields)
     end
 
+    def set_hyperlink_rich(top_row, left_col, num_rows, num_cols, text, uri)
+      cell = Google::Apis::SheetsV4::CellData.new(
+        user_entered_value: Google::Apis::SheetsV4::ExtendedValue.new(string_value: text),
+        text_format_runs: [
+          Google::Apis::SheetsV4::TextFormatRun.new(
+            start_index: 0,
+            format: Google::Apis::SheetsV4::TextFormat.new(
+              link: Google::Apis::SheetsV4::Link.new(uri: uri)
+            )
+          )
+        ]
+      )
+
+      add_request(
+        repeat_cell: Google::Apis::SheetsV4::RepeatCellRequest.new(
+          range: v4_range_object(top_row, left_col, num_rows, num_cols),
+          cell: cell,
+          fields: 'userEnteredValue,textFormatRuns'
+        )
+      )
+    end
+
     # Changes the background color on a range of cells. e.g.:
     #   worksheet.set_background_color(1, 1, 1, 1, GoogleDrive::Worksheet::Colors::DARK_YELLOW_1)
     #
@@ -635,7 +658,7 @@ module GoogleDrive
     #     {bottom: Google::Apis::SheetsV4::Border.new(
     #       style: "DOUBLE", color: GoogleDrive::Worksheet::Colors::BLACK)})
     def update_borders(top_row, left_col, num_rows, num_cols, borders)
-      request = Google::Apis::SheetsV4::UpdateBordersRequest.new(borders)
+      request = Google::Apis::SheetsV4::UpdateBordersRequest.new(**borders)
       request.range = v4_range_object(top_row, left_col, num_rows, num_cols)
       add_request({update_borders: request})
     end
@@ -685,7 +708,7 @@ module GoogleDrive
           @session.sheets_service.get_spreadsheet(
               spreadsheet.id,
               ranges: "'%s'" % @remote_title,
-              fields: 'sheets.data.rowData.values(formattedValue,userEnteredValue,effectiveValue)'
+              fields: 'sheets.data.rowData.values(formattedValue,userEnteredValue,effectiveValue,hyperlink)'
           )
       update_cells_from_api_sheet(response.sheets[0])
     end
@@ -698,17 +721,19 @@ module GoogleDrive
       @cells = {}
       @input_values = {}
       @numeric_values = {}
+      @cell_properties = {}
 
       rows_data.each_with_index do |row_data, r|
-        next if !row_data.values
+        next unless row_data.values
         @num_cols = row_data.values.size if row_data.values.size > @num_cols
         row_data.values.each_with_index do |cell_data, c|
           k = [r + 1, c + 1]
           @cells[k] = cell_data.formatted_value || ''
           @input_values[k] = extended_value_to_str(cell_data.user_entered_value)
           @numeric_values[k] =
-              cell_data.effective_value && cell_data.effective_value.number_value ?
+            cell_data.effective_value&.number_value ?
                   cell_data.effective_value.number_value.to_f : nil
+          @cell_properties[k] = { hyperlink: cell_data.hyperlink }
         end
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google_drive_maintained
 version: !ruby/object:Gem::Version
-  version: 3.0.8
+  version: 3.0.11
 platform: ruby
 authors:
 - Hiroshi Ichikawa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-07-25 00:00:00.000000000 Z
+date: 2025-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.5.3
+        version: '1.18'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.0.0
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.5.3
+        version: '1.18'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.0.0
@@ -34,62 +34,44 @@ dependencies:
   name: google-apis-drive_v3
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: 0.63.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: 0.63.0
 - !ruby/object:Gem::Dependency
   name: google-apis-sheets_v4
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.4'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.42.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.4'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.42.0
 - !ruby/object:Gem::Dependency
   name: googleauth
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: '1.14'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: '1.14'
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
@@ -114,22 +96,16 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 13.0.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 13.0.3
 - !ruby/object:Gem::Dependency
   name: rspec-mocks
   requirement: !ruby/object:Gem::Requirement
@@ -167,6 +143,7 @@ files:
 - lib/google_drive/acl_entry.rb
 - lib/google_drive/api_client_fetcher.rb
 - lib/google_drive/authentication_error.rb
+- lib/google_drive/cell.rb
 - lib/google_drive/collection.rb
 - lib/google_drive/config.rb
 - lib/google_drive/error.rb
@@ -178,11 +155,15 @@ files:
 - lib/google_drive/spreadsheet.rb
 - lib/google_drive/util.rb
 - lib/google_drive/worksheet.rb
-- lib/google_drive/worksheet_formatting.rb
 homepage: https://github.com/y-bonfire/google-drive-ruby-maintained
 licenses:
 - BSD-3-Clause
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/y-bonfire/google-drive-ruby-maintained
+  source_code_uri: https://github.com/y-bonfire/google-drive-ruby-maintained
+  changelog_uri: https://github.com/y-bonfire/google-drive-ruby-maintained/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/y-bonfire/google-drive-ruby-maintained/issues
+  documentation_uri: https://rubydoc.info/gems/google_drive_ruby_maintained
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -191,7 +172,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/lib/google_drive/worksheet_formatting.rb

@@ -1,53 +0,0 @@
-require 'forwardable'
-
-module GoogleDrive
-
-  class Cell
-    attr_reader :row, :col, :value
-
-    def initialize(worksheet, row, col, value)
-      @worksheet = worksheet
-      @row = row
-      @col = col
-      @value = value
-    end
-
-    #
-    # === 等価性
-    #
-    def ==(other)
-      case other
-      when GoogleDrive::Cell
-        @value == other.value
-      else
-        @value == other
-      end
-    end
-
-    def to_s
-      value.to_s
-    end
-
-    def encoding
-      value.respond_to?(:encoding) ? value.encoding : nil
-    end
-
-    def background_color=(color)
-      @worksheet.set_background_color(@row, @col, 1, 1, color)
-    end
-
-  end
-
-  module WorksheetFormatting
-
-    def set_background_color_at(row, col, color)
-      set_background_color(row, col, 1, 1, color)
-    end
-
-    def set_bold(row, col, enable = true)
-      # 太字設定
-    end
-
-    # ... 他にも text_color, font_size など拡張しやすい
-  end
-end