boxr 1.23.1 → 1.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61830d438f70d8585c435bf00b719911cba3a4687ce9df4310f7232d50b4bd5b
-  data.tar.gz: 677ffb4ccd6ea0ef5478e1dd879e202c2c8605e12561a72c865b05689295a4a1
+  metadata.gz: 61cea90fb968b5080ce842d650aafd74224bdc6caf7cbe11e168aa0f3ef7c4c3
+  data.tar.gz: 9de8543da3e1029de8ea4d9c0c346cfd6a05563a8119f7a3a81356bafd7a6831
 SHA512:
-  metadata.gz: cf1a95e4d924c7e7c64bfda48f7c33524cb3c4a6a1de8d443044c92b56dd80a6747cfe2229e9cfd5d60ff68f147538d47aa06682cec6e059ef20e69f8ed342e9
-  data.tar.gz: bbbdcbdeab436de980d16a6d9e3dd4def18068421094b75787991fee3f79bd6b530d7df2e5255171340d838ae2c6df8b7c54e525be5b73b7435c1558987048d1
+  metadata.gz: 4b16ccaec58eaa114cfb7c41f62e10cc05e8d07c45ce3e73c4e03d5ebf9407e022cb381cde5ceab0c88ace21a1d3b27b3564cf3b3b49be6fd8a3955e4006f771
+  data.tar.gz: c3eb8f6e86e09ceffd43f6a6eccd6d38f1dac13b32a924fc3ef588168e0dc2d76672bc982a0f2036a362db1bc75431c9df0b851fe41b6040016689b0c2fb9330

data/boxr.gemspec

@@ -38,5 +38,5 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency 'addressable', '~> 2.8'
   spec.add_runtime_dependency 'hashie', '>= 3.5', '< 6'
   spec.add_runtime_dependency 'httpclient', '~> 2.8'
-  spec.add_runtime_dependency 'jwt', '>= 1.4', '< 3'
+  spec.add_runtime_dependency 'jwt', '>= 1.4', '< 4'
 end

data/lib/boxr/avatars.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Boxr
+  class Client
+    def get_user_avatar(user_id)
+      user_id = ensure_id(user_id)
+      uri = "#{USERS_URI}/#{user_id}/avatar"
+
+      avatar_data, = get(uri, process_response: false)
+      avatar_data
+    end
+
+    def create_user_avatar(user_id, pic, pic_file_name: nil, pic_content_type: nil)
+      user_id = ensure_id(user_id)
+      uri = "#{USERS_URI}/#{user_id}/avatar"
+
+      body = { pic: pic }
+      body[:pic_file_name] = pic_file_name unless pic_file_name.nil?
+      body[:pic_content_type] = pic_content_type unless pic_content_type.nil?
+
+      avatar, = post(uri, body, process_body: false, content_type: 'multipart/form-data')
+      avatar
+    end
+
+    def delete_user_avatar(user_id)
+      user_id = ensure_id(user_id)
+      uri = "#{USERS_URI}/#{user_id}/avatar"
+
+      result, = delete(uri)
+      result
+    end
+  end
+end

data/lib/boxr/chunked_uploads.rb

@@ -17,7 +17,6 @@ module Boxr
       body = { folder_id: parent_id, file_size: io.size, file_name: name }
       session_info, = post(uri, body, content_type: 'application/json',
                                       success_codes: [200, 201, 202])
-
       session_info
     end
 
@@ -35,14 +34,12 @@ module Boxr
       body = { file_size: io.size, file_name: name }
       session_info, = post(uri, body, content_type: 'application/json',
                                       success_codes: [200, 201, 202])
-
       session_info
     end
 
     def chunked_upload_get_session(session_id)
       uri = "#{UPLOAD_URI}/files/upload_sessions/#{session_id}"
       session_info, = get(uri)
-
       session_info
     end
 
@@ -52,20 +49,20 @@ module Boxr
       end
     end
 
-    def chunked_upload_part_from_io(io, session_id, content_range)
+    def chunked_upload_part_from_io(io, session_id, content_range) # rubocop:disable Metrics
       io.pos = content_range.min
       part_size = content_range.max - content_range.min + 1
-      data = io.read(part_size)
+      body = io.read(part_size)
       io.rewind
 
-      digest = "sha=#{Digest::SHA1.base64digest(data)}"
+      digest = "sha=#{Digest::SHA1.base64digest(body)}"
       range = "bytes #{content_range.min}-#{content_range.max}/#{io.size}"
 
       uri = "#{UPLOAD_URI}/files/upload_sessions/#{session_id}"
-      body = data
-      part_info, = put(uri, body, process_body: false, digest: digest,
-                                  content_type: 'application/octet-stream', content_range: range, success_codes: [200, 201, 202])
-
+      part_info, = put(
+        uri, body, process_body: false, digest: digest, content_type: 'application/octet-stream',
+                   content_range: range, success_codes: [200, 201, 202]
+      )
       part_info.part
     end
 
@@ -75,140 +72,158 @@ module Boxr
       query[:limit] = limit unless limit.nil?
       query[:offset] = offset unless offset.nil?
       parts_info, = get(uri, query: query)
-
       parts_info.entries
     end
 
-    def chunked_upload_commit(path_to_file, session_id, parts, content_created_at: nil,
+    def chunked_upload_commit(path_to_file, session_id, parts, content_created_at: nil, # rubocop:disable Metrics
                               content_modified_at: nil, if_match: nil, if_non_match: nil)
       File.open(path_to_file) do |file|
-        chunked_upload_commit_from_io(file, session_id, parts,
-                                      content_created_at: content_created_at, content_modified_at: content_modified_at, if_match: if_match, if_non_match: if_non_match)
+        chunked_upload_commit_from_io(
+          file, session_id, parts,
+          content_created_at: content_created_at, content_modified_at: content_modified_at,
+          if_match: if_match, if_non_match: if_non_match
+        )
       end
     end
 
-    def chunked_upload_commit_from_io(io, session_id, parts, content_created_at: nil,
+    def chunked_upload_commit_from_io(io, session_id, parts, content_created_at: nil, # rubocop:disable Metrics
                                       content_modified_at: nil, if_match: nil, if_non_match: nil)
       io.pos = 0
-      digest = Digest::SHA1.new
-      while (buf = io.read(8 * 1024**2)) && buf.size.positive?
-        digest.update(buf)
-      end
-      io.rewind
-      digest = "sha=#{digest.base64digest}"
+      cca = content_created_at
+      cma = content_modified_at
+      digest = "sha=#{calculate_chunked_upload_digest(io).base64digest}"
 
       attributes = {}
-      unless content_created_at.nil?
-        attributes[:content_created_at] =
-          content_created_at.to_datetime.rfc3339
-      end
-      unless content_modified_at.nil?
-        attributes[:content_modified_at] =
-          content_modified_at.to_datetime.rfc3339
-      end
+      attributes[:content_created_at] = cca.to_datetime.rfc3339 if cca
+      attributes[:content_modified_at] = cma.to_datetime.rfc3339 if cma
 
       uri = "#{UPLOAD_URI}/files/upload_sessions/#{session_id}/commit"
-      body = {
-        parts: parts,
-        attributes: attributes
-      }
-      commit_info, = post(uri, body, process_body: true, digest: digest,
-                                     content_type: 'application/json', if_match: if_match, if_non_match: if_non_match, success_codes: [200, 201, 202])
+      body = { parts: parts, attributes: attributes }
 
-      commit_info
+      loop do
+        commit_info, response = post(
+          uri, body,
+          process_body: true, digest: digest, content_type: 'application/json',
+          if_match: if_match, if_non_match: if_non_match, success_codes: [200, 201, 202]
+        )
+        return commit_info if response.status != 202
+
+        sleep response.header['Retry-After'][0].to_i
+      end
     end
 
     def chunked_upload_abort_session(session_id)
       uri = "#{UPLOAD_URI}/files/upload_sessions/#{session_id}"
       abort_info, = delete(uri)
-
       abort_info
+    rescue BoxrError # Ignore errors from aborting session
+      nil
     end
 
-    def chunked_upload_file(path_to_file, parent, name: nil, n_threads: 1, content_created_at: nil,
-                            content_modified_at: nil)
+    def chunked_upload_file(path_to_file, parent, name: nil, n_threads: 1, # rubocop:disable Metrics
+                            content_created_at: nil, content_modified_at: nil)
       filename = name || File.basename(path_to_file)
 
       File.open(path_to_file) do |file|
-        chunked_upload_file_from_io(file, parent, filename, n_threads: n_threads,
-                                                            content_created_at: content_created_at, content_modified_at: content_modified_at)
+        chunked_upload_file_from_io(
+          file, parent, filename,
+          n_threads: n_threads, content_created_at: content_created_at,
+          content_modified_at: content_modified_at
+        )
       end
     end
 
-    def chunked_upload_file_from_io(io, parent, name, n_threads: 1, content_created_at: nil,
-                                    content_modified_at: nil)
-      session = nil
-      file_info = nil
-
+    def chunked_upload_file_from_io(io, parent, name, n_threads: 1, # rubocop:disable Metrics
+                                    content_created_at: nil, content_modified_at: nil)
       session = chunked_upload_create_session_new_file_from_io(io, parent, name)
-
-      file_info = chunked_upload_to_session_from_io(io, session, n_threads: n_threads,
-                                                                 content_created_at: nil, content_modified_at: nil)
-      file_info
-    ensure
-      chunked_upload_abort_session(session.id) if file_info.nil? && !session.nil?
+      chunked_upload_to_session_from_io(
+        io, session,
+        n_threads: n_threads, content_created_at: content_created_at,
+        content_modified_at: content_modified_at
+      )
     end
 
-    def chunked_upload_new_version_of_file(path_to_file, file, name: nil, n_threads: 1,
+    def chunked_upload_new_version_of_file(path_to_file, file, name: nil, n_threads: 1, # rubocop:disable Metrics
                                            content_created_at: nil, content_modified_at: nil)
       filename = name || File.basename(path_to_file)
 
       File.open(path_to_file) do |io|
-        chunked_upload_new_version_of_file_from_io(io, file, filename, n_threads: n_threads,
-                                                                       content_created_at: content_created_at, content_modified_at: content_modified_at)
+        chunked_upload_new_version_of_file_from_io(
+          io, file, filename,
+          n_threads: n_threads, content_created_at: content_created_at,
+          content_modified_at: content_modified_at
+        )
       end
     end
 
-    def chunked_upload_new_version_of_file_from_io(io, file, name, n_threads: 1,
-                                                   content_created_at: nil, content_modified_at: nil)
-      session = nil
-      file_info = nil
-
+    def chunked_upload_new_version_of_file_from_io( # rubocop:disable Metrics
+      io, file, name, n_threads: 1, content_created_at: nil, content_modified_at: nil
+    )
       session = chunked_upload_create_session_new_version_from_io(io, file, name)
-
-      file_info = chunked_upload_to_session_from_io(io, session, n_threads: n_threads,
-                                                                 content_created_at: nil, content_modified_at: nil)
-      file_info
-    ensure
-      chunked_upload_abort_session(session.id) if file_info.nil? && !session.nil?
+      chunked_upload_to_session_from_io(
+        io, session,
+        n_threads: n_threads, content_created_at: content_created_at,
+        content_modified_at: content_modified_at
+      )
     end
 
     private
 
     PARALLEL_GEM_REQUIREMENT = Gem::Requirement.create('~> 1.0').freeze
 
-    def chunked_upload_to_session_from_io(io, session, n_threads: 1, content_created_at: nil,
-                                          content_modified_at: nil)
+    def chunked_upload_to_session_from_io(io, session, n_threads: 1, # rubocop:disable Metrics
+                                          content_created_at: nil, content_modified_at: nil)
       content_ranges = []
-      offset = 0
-      loop do
-        limit = [offset + session.part_size, io.size].min - 1
-        content_ranges << (offset..limit)
-        break if limit == io.size - 1
-
-        offset = limit + 1
+      start_offset = 0
+      part_size = session.part_size
+      file_size = io.size
+      commit_info = nil
+
+      while start_offset < file_size
+        end_offset = [start_offset + part_size, file_size].min - 1
+        content_ranges << (start_offset..end_offset)
+        start_offset += part_size
       end
 
       parts =
         if n_threads > 1
-          unless gem_parallel_available?
-            raise BoxrError.new(boxr_message: "parallel chunked uploads requires gem parallel (#{PARALLEL_GEM_REQUIREMENT}) to be loaded")
-          end
-
-          Parallel.map(content_ranges, in_threads: n_threads) do |content_range|
-            File.open(io.path) do |io_dup|
-              chunked_upload_part_from_io(io_dup, session.id, content_range)
-            end
-          end
+          threaded_chunked_upload_part_from_io(io, session.id, content_ranges, n_threads)
         else
+          # Single thread
           content_ranges.map do |content_range|
             chunked_upload_part_from_io(io, session.id, content_range)
           end
         end
 
-      commit_info = chunked_upload_commit_from_io(io, session.id, parts,
-                                                  content_created_at: content_created_at, content_modified_at: content_modified_at)
+      commit_info = chunked_upload_commit_from_io(
+        io, session.id, parts,
+        content_created_at: content_created_at, content_modified_at: content_modified_at
+      )
       commit_info.entries[0]
+    ensure
+      chunked_upload_abort_session(session.id) if commit_info.nil? && session
+    end
+
+    def threaded_chunked_upload_part_from_io(io, session_id, content_ranges, n_threads)
+      unless gem_parallel_available?
+        msg = "parallel chunked uploads requires gem 'parallel'"
+        raise BoxrError.new(boxr_message: msg)
+      end
+
+      Parallel.map(content_ranges, in_threads: n_threads) do |content_range|
+        File.open(io.path) do |io_dup|
+          chunked_upload_part_from_io(io_dup, session_id, content_range)
+        end
+      end
+    end
+
+    def calculate_chunked_upload_digest(io)
+      digest = Digest::SHA1.new
+      while (buf = io.read(8 * 1024**2)) && buf.size.positive?
+        digest.update(buf)
+      end
+      io.rewind
+      digest
     end
 
     def gem_parallel_available?

data/lib/boxr/client.rb

@@ -1,37 +1,38 @@
 # frozen_string_literal: true
 
 module Boxr
-  class Client
+  class Client # rubocop:disable Metrics/ClassLength
     attr_reader :access_token, :refresh_token, :client_id, :client_secret, :identifier, :as_user_id
 
-    # API_URI = "https://wcheng.inside-box.net/api/2.0"
-    # UPLOAD_URI = "https://upload.wcheng.inside-box.net/api/2.0"
-
     API_URI = 'https://api.box.com/2.0'
     AUTH_URI = 'https://api.box.com/oauth2/token'
     REVOKE_AUTH_URI = 'https://api.box.com/oauth2/revoke'
     UPLOAD_URI = 'https://upload.box.com/api/2.0'
-    FILES_URI = "#{API_URI}/files"
-    FILES_UPLOAD_URI = "#{UPLOAD_URI}/files/content"
-    FOLDERS_URI = "#{API_URI}/folders"
-    USERS_URI = "#{API_URI}/users"
-    GROUPS_URI = "#{API_URI}/groups"
-    GROUP_MEMBERSHIPS_URI = "#{API_URI}/group_memberships"
+
+    ARCHIVES_URI = "#{API_URI}/archives"
     COLLABORATIONS_URI = "#{API_URI}/collaborations"
     COLLECTIONS_URI = "#{API_URI}/collections"
     COMMENTS_URI = "#{API_URI}/comments"
-    SEARCH_URI = "#{API_URI}/search"
-    TASKS_URI = "#{API_URI}/tasks"
-    TASK_ASSIGNMENTS_URI = "#{API_URI}/task_assignments"
-    SHARED_ITEMS_URI = "#{API_URI}/shared_items"
+    EVENTS_URI = "#{API_URI}/events"
     FILE_METADATA_URI = "#{API_URI}/files"
+    FILES_UPLOAD_URI = "#{UPLOAD_URI}/files/content"
+    FILES_URI = "#{API_URI}/files"
     FOLDER_METADATA_URI = "#{API_URI}/folders"
+    FOLDERS_URI = "#{API_URI}/folders"
+    GROUP_MEMBERSHIPS_URI = "#{API_URI}/group_memberships"
+    GROUPS_URI = "#{API_URI}/groups"
     METADATA_TEMPLATES_URI = "#{API_URI}/metadata_templates"
-    EVENTS_URI = "#{API_URI}/events"
+    SEARCH_URI = "#{API_URI}/search"
+    SHARED_ITEMS_URI = "#{API_URI}/shared_items"
+    TASK_ASSIGNMENTS_URI = "#{API_URI}/task_assignments"
+    TASKS_URI = "#{API_URI}/tasks"
+    USERS_URI = "#{API_URI}/users"
     WEB_LINKS_URI = "#{API_URI}/web_links"
     WEBHOOKS_URI = "#{API_URI}/webhooks"
     ZIP_DOWNLOADS_URI = "#{API_URI}/zip_downloads"
 
+    BOX_VERSION_HEADER_2025 = { 'box-version' => '2025.0' }.freeze
+
     DEFAULT_LIMIT = 100
     FOLDER_ITEMS_LIMIT = 1000
 
@@ -101,13 +102,14 @@ module Boxr
     private
 
     def get(uri, query: nil, success_codes: [200], process_response: true, if_match: nil,
-            box_api_header: nil, follow_redirect: true)
+            box_api_header: nil, follow_redirect: true, extra_headers: nil)
       uri = Addressable::URI.encode(uri)
 
       res = with_auto_token_refresh do
         headers = standard_headers
         headers['If-Match'] = if_match unless if_match.nil?
         headers['BoxApi'] = box_api_header unless box_api_header.nil?
+        headers.merge!(extra_headers) unless extra_headers.nil?
 
         BOX_CLIENT.get(uri, query: query, header: headers, follow_redirect: follow_redirect)
       end
@@ -151,7 +153,7 @@ module Boxr
     end
 
     def post(uri, body, query: nil, success_codes: [201], process_body: true, digest: nil,
-             content_md5: nil, content_type: nil, if_match: nil, if_non_match: nil)
+             content_md5: nil, content_type: nil, if_match: nil, if_non_match: nil, extra_headers: nil)
       uri = Addressable::URI.encode(uri)
       body = JSON.dump(body) if process_body
 
@@ -162,6 +164,7 @@ module Boxr
         headers['Content-MD5'] = content_md5 unless content_md5.nil?
         headers['Content-Type'] = content_type unless content_type.nil?
         headers['Digest'] = digest unless digest.nil?
+        headers.merge!(extra_headers) unless extra_headers.nil?
 
         BOX_CLIENT.post(uri, body: body, query: query, header: headers)
       end
@@ -172,7 +175,7 @@ module Boxr
     end
 
     def put(uri, body, query: nil, success_codes: [200, 201], process_body: true,
-            content_type: nil, content_range: nil, digest: nil, if_match: nil)
+            content_type: nil, content_range: nil, digest: nil, if_match: nil, extra_headers: nil)
       uri = Addressable::URI.encode(uri)
       body = JSON.dump(body) if process_body
 
@@ -182,6 +185,7 @@ module Boxr
         headers['Content-Type'] = content_type unless content_type.nil?
         headers['Content-Range'] = content_range unless content_range.nil?
         headers['Digest'] = digest unless digest.nil?
+        headers.merge!(extra_headers) unless extra_headers.nil?
 
         BOX_CLIENT.put(uri, body: body, query: query, header: headers)
       end
@@ -191,12 +195,13 @@ module Boxr
       processed_response(res)
     end
 
-    def delete(uri, query: nil, success_codes: [204], if_match: nil)
+    def delete(uri, query: nil, success_codes: [204], if_match: nil, extra_headers: nil)
       uri = Addressable::URI.encode(uri)
 
       res = with_auto_token_refresh do
         headers = standard_headers
         headers['If-Match'] = if_match unless if_match.nil?
+        headers.merge!(extra_headers) unless extra_headers.nil?
 
         BOX_CLIENT.delete(uri, query: query, header: headers)
       end

data/lib/boxr/collections.rb

@@ -2,6 +2,15 @@
 
 module Boxr
   class Client
+    def collection_from_id(collection_id)
+      collection_id = ensure_id(collection_id)
+      uri = "#{COLLECTIONS_URI}/#{collection_id}"
+
+      collection, = get(uri)
+      collection
+    end
+    alias collection collection_from_id
+
     def collections
       get_all_with_pagination(COLLECTIONS_URI, offset: 0, limit: DEFAULT_LIMIT)
     end

data/lib/boxr/files.rb

@@ -34,8 +34,8 @@ module Boxr
     alias preview_url embed_url
     alias preview_link embed_url
 
-    def update_file(file, name: nil, description: nil, parent: nil, shared_link: nil, tags: nil,
-                    lock: nil, if_match: nil)
+    def update_file(file, name: nil, description: nil, parent: nil, # rubocop:disable Metrics
+                    shared_link: nil, tags: nil, lock: nil, if_match: nil)
       file_id = ensure_id(file)
       parent_id = ensure_id(parent)
       uri = "#{FILES_URI}/#{file_id}"
@@ -73,14 +73,18 @@ module Boxr
       update_file(file, parent: new_parent, name: name, if_match: if_match)
     end
 
-    def download_file(file, version: nil, follow_redirect: true)
+    def download_file(file, version: nil, follow_redirect: true) # rubocop:disable Metrics
       file_id = ensure_id(file)
+      uri = "#{FILES_URI}/#{file_id}/content"
+      query = {}
+      query[:version] = version unless version.nil?
 
       loop do
-        uri = "#{FILES_URI}/#{file_id}/content"
-        query = {}
-        query[:version] = version unless version.nil?
-        _, response = get(uri, query: query, success_codes: [302, 202], process_response: false, follow_redirect: false) # we don't want httpclient to automatically follow the redirect; we need to grab it
+        # Don't automatically follow the redirect
+        _, response = get(uri, query: query, success_codes: [302, 202],
+                               process_response: false, follow_redirect: false)
+
+        # By default, Box always returns a 302
         if response.status == 302
           location = response.header['Location'][0]
           return location unless follow_redirect
@@ -88,13 +92,9 @@ module Boxr
           file_content, = get(location, process_response: false)
           return file_content
 
-        # simply return the url
-
         elsif response.status == 202
-          retry_after_seconds = response.header['Retry-After'][0]
-          sleep retry_after_seconds.to_i
+          sleep response.header['Retry-After'][0].to_i
         end
-        break if file_content
       end
     end
 
@@ -102,18 +102,21 @@ module Boxr
       download_file(file, version: version, follow_redirect: false)
     end
 
-    def upload_file(path_to_file, parent, name: nil, content_created_at: nil, content_modified_at: nil,
-                    preflight_check: true, send_content_md5: true)
+    def upload_file(path_to_file, parent, name: nil, content_created_at: nil, # rubocop:disable Metrics
+                    content_modified_at: nil, preflight_check: true, send_content_md5: true)
       filename = name || File.basename(path_to_file)
 
       File.open(path_to_file) do |file|
-        upload_file_from_io(file, parent, name: filename, content_created_at: content_created_at,
-                                          content_modified_at: content_modified_at, preflight_check: preflight_check, send_content_md5: send_content_md5)
+        upload_file_from_io(
+          file, parent, name: filename, content_created_at: content_created_at,
+                        content_modified_at: content_modified_at, preflight_check: preflight_check,
+                        send_content_md5: send_content_md5
+        )
       end
     end
 
-    def upload_file_from_io(io, parent, name:, content_created_at: nil, content_modified_at: nil,
-                            preflight_check: true, send_content_md5: true)
+    def upload_file_from_io(io, parent, name:, content_created_at: nil, # rubocop:disable Metrics
+                            content_modified_at: nil, preflight_check: true, send_content_md5: true)
       parent_id = ensure_id(parent)
 
       preflight_check(io, name, parent_id) if preflight_check
@@ -141,18 +144,25 @@ module Boxr
       file_info.entries[0]
     end
 
-    def upload_new_version_of_file(path_to_file, file, content_modified_at: nil, send_content_md5: true,
-                                   preflight_check: true, if_match: nil, name: nil)
+    def upload_new_version_of_file( # rubocop:disable Metrics
+      path_to_file, file, content_modified_at: nil,
+      send_content_md5: true, preflight_check: true, if_match: nil, name: nil
+    )
       filename = name || File.basename(path_to_file)
 
       File.open(path_to_file) do |io|
-        upload_new_version_of_file_from_io(io, file, name: filename,
-                                                     content_modified_at: content_modified_at, preflight_check: preflight_check, send_content_md5: send_content_md5, if_match: if_match)
+        upload_new_version_of_file_from_io(
+          io, file,
+          name: filename, content_modified_at: content_modified_at,
+          preflight_check: preflight_check, send_content_md5: send_content_md5, if_match: if_match
+        )
       end
     end
 
-    def upload_new_version_of_file_from_io(io, file, name: nil, content_modified_at: nil, send_content_md5: true,
-                                           preflight_check: true, if_match: nil)
+    def upload_new_version_of_file_from_io( # rubocop:disable Metrics
+      io, file, name: nil, content_modified_at: nil,
+      send_content_md5: true, preflight_check: true, if_match: nil
+    )
       name || file.name
 
       file_id = ensure_id(file)
@@ -173,8 +183,9 @@ module Boxr
 
       body = { attributes: JSON.dump(attributes), file: io }
 
-      file_info, = post(uri, body, process_body: false, content_md5: content_md5,
-                                   if_match: if_match)
+      file_info, = post(
+        uri, body, process_body: false, content_md5: content_md5, if_match: if_match
+      )
 
       file_info.entries[0]
     end
@@ -225,7 +236,7 @@ module Boxr
       new_file
     end
 
-    def thumbnail(file, min_height: nil, min_width: nil, max_height: nil, max_width: nil)
+    def thumbnail(file, min_height: nil, min_width: nil, max_height: nil, max_width: nil) # rubocop:disable Metrics
       file_id = ensure_id(file)
       uri = "#{FILES_URI}/#{file_id}/thumbnail.png"
       query = {}
@@ -246,8 +257,8 @@ module Boxr
       thumbnail
     end
 
-    def create_shared_link_for_file(file, access: nil, unshared_at: nil, can_download: nil,
-                                    can_preview: nil, password: nil)
+    def create_shared_link_for_file(file, access: nil, unshared_at: nil, # rubocop:disable Metrics
+                                    can_download: nil, can_preview: nil, password: nil)
       file_id = ensure_id(file)
       uri = "#{FILES_URI}/#{file_id}"
       create_shared_link(uri, file_id, access, unshared_at, can_download, can_preview, password)

data/lib/boxr/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Boxr
-  VERSION = '1.23.1'
+  VERSION = '1.24.0'
 end

data/lib/boxr.rb

@@ -7,27 +7,28 @@ require 'addressable/template'
 require 'jwt'
 require 'securerandom'
 
-require 'boxr/version'
-require 'boxr/errors'
-require 'boxr/client'
-require 'boxr/shared_items'
-require 'boxr/folders'
-require 'boxr/files'
+require 'boxr/auth'
+require 'boxr/avatars'
 require 'boxr/chunked_uploads'
-require 'boxr/comments'
-require 'boxr/users'
-require 'boxr/groups'
+require 'boxr/client'
 require 'boxr/collaborations'
 require 'boxr/collections'
+require 'boxr/comments'
+require 'boxr/errors'
+require 'boxr/events'
+require 'boxr/files'
+require 'boxr/folders'
+require 'boxr/groups'
+require 'boxr/metadata'
 require 'boxr/search'
+require 'boxr/shared_items'
 require 'boxr/tasks'
-require 'boxr/metadata'
-require 'boxr/events'
-require 'boxr/auth'
-require 'boxr/web_links'
+require 'boxr/users'
+require 'boxr/version'
 require 'boxr/watermarking'
-require 'boxr/webhooks'
+require 'boxr/web_links'
 require 'boxr/webhook_validator'
+require 'boxr/webhooks'
 require 'boxr/zip_downloads'
 
 # Simple wrapper around Array

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: boxr
 version: !ruby/object:Gem::Version
-  version: 1.23.1
+  version: 1.24.0
 platform: ruby
 authors:
 - Chad Burnette
 - Xavier Hocquet
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-25 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: awesome_print
@@ -250,7 +249,7 @@ dependencies:
         version: '1.4'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '3'
+        version: '4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -260,7 +259,7 @@ dependencies:
         version: '1.4'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '3'
+        version: '4'
 description: ''
 email:
 - chadburnette@me.com
@@ -293,6 +292,7 @@ files:
 - examples/user_events.rb
 - lib/boxr.rb
 - lib/boxr/auth.rb
+- lib/boxr/avatars.rb
 - lib/boxr/chunked_uploads.rb
 - lib/boxr/client.rb
 - lib/boxr/collaborations.rb
@@ -318,7 +318,6 @@ homepage: https://github.com/cburnette/boxr
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -333,8 +332,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: A Ruby client library for the Box V2 Content API.
 test_files: []