files.com 1.1.248 → 1.1.250

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a7a0d4ae2ef14b51cbaa2db633936546e2aad83ef4f3f9c7d3a954f00137d5eb
-  data.tar.gz: b6eaeeef6c8b9591b1e08efd65a153fb4954481a0b59199aca714cf5c9fd1f51
+  metadata.gz: 98805d730e8daca6c153de77617d11faee90e48adec0b25dec18ad78b317df3e
+  data.tar.gz: b33bcf640dc80be6556bc619df8335187eb98d79048ee29ed05074c605a2339e
 SHA512:
-  metadata.gz: a3ebd733d8ff359f4253ebcf4b863f8a9d268ea53c92f6e9fe39aa09d21ce2a38a27971e36e56a66d7a2fa0176a4a5ed22c24db7b71a64fcfa17aced9d546d06
-  data.tar.gz: d9b953f723438554603319812a47518870878401ad03540055046f2e1aba46db0a3fd56c1ff50c4b911f14686513a1b4614e8b5612bcaea2d0177d02620913f2
+  metadata.gz: 58ca2f7dcb116582d7d2e218f87fe182affa718badcbbdf717aea620e47bf932aad051a2f433d34057fd8667703598ae0bc268762f238de57f7ba0c32351df11
+  data.tar.gz: d47cede62ff9c887a6d6d20ecbe9a9bf38f0a8c3f695ae4f771070d7d45073aa4cf7be27b793a63496968da37e1db4da05be33da87d48b178d886bf274134b10

data/README.md

@@ -338,6 +338,12 @@ and error descriptions.
 
 If the specified language is not supported or the value is omitted, the API defaults to English.
 
+```shell title="Example Request"
+require 'files.com'
+
+Files.language = 'es'
+```
+
 ## Errors
 
 The Files.com Ruby SDK will return errors by raising exceptions. There are many exception classes defined in the Files SDK that correspond

data/_VERSION

@@ -1 +1 @@
-1.1.248
+1.1.250

data/docs/automation_run.md

@@ -41,12 +41,14 @@
 
 ```
 Files::AutomationRun.list(
+  user_id: 1, 
   automation_id: 1
 )
 ```
 
 ### Parameters
 
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `automation_id`, `created_at` or `status`.

data/docs/bundle_action.md

@@ -42,11 +42,14 @@
 ## List Bundle Actions
 
 ```
-Files::BundleAction.list
+Files::BundleAction.list(
+  user_id: 1
+)
 ```
 
 ### Parameters
 
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `created_at`.

data/docs/bundle_registration.md

@@ -43,12 +43,14 @@
 
 ```
 Files::BundleRegistration.list(
+  user_id: 1, 
   bundle_id: 1
 )
 ```
 
 ### Parameters
 
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `bundle_id`.

data/docs/user_cipher_use.md

@@ -35,6 +35,6 @@ Files::UserCipherUse.list(
 
 ### Parameters
 
-* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
+* `user_id` (int64): User ID. If provided, will return uses for this user.
 * `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).

data/docs/user_sftp_client_use.md

@@ -31,6 +31,6 @@ Files::UserSftpClientUse.list(
 
 ### Parameters
 
-* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
+* `user_id` (int64): User ID. If provided, will return uses for this user.
 * `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).

data/lib/files.com/api_client.rb

@@ -332,6 +332,7 @@ module Files
 
       headers["X-FilesAPI-Key"] = api_key if api_key
       headers["X-FilesAPI-Auth"] = session_id if session_id
+      headers["Accept-Language"] = Files.language if Files.language
 
       user_agent = @system_profiler.user_agent
       begin

data/lib/files.com/models/automation_run.rb

@@ -75,12 +75,14 @@ module Files
     end
 
     # Parameters:
+    #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `automation_id`, `created_at` or `status`.
     #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `status` and `automation_id`. Valid field combinations are `[ automation_id, status ]`.
     #   automation_id (required) - int64 - ID of the associated Automation.
     def self.list(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: user_id must be an Integer") if params[:user_id] and !params[:user_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if params[:sort_by] and !params[:sort_by].is_a?(Hash)

data/lib/files.com/models/bundle_action.rb

@@ -40,6 +40,7 @@ module Files
     end
 
     # Parameters:
+    #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `created_at`.
@@ -49,6 +50,7 @@ module Files
     #   filter_lt - object - If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`.
     #   filter_lteq - object - If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`.
     def self.list(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: user_id must be an Integer") if params[:user_id] and !params[:user_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if params[:sort_by] and !params[:sort_by].is_a?(Hash)

data/lib/files.com/models/bundle_registration.rb

@@ -75,11 +75,13 @@ module Files
     end
 
     # Parameters:
+    #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `bundle_id`.
     #   bundle_id - int64 - ID of the associated Bundle
     def self.list(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: user_id must be an Integer") if params[:user_id] and !params[:user_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if params[:sort_by] and !params[:sort_by].is_a?(Hash)

data/lib/files.com/models/file.rb

@@ -61,8 +61,8 @@ module Files
       new(name).each(*args, &block)
     end
 
-    def self.from_path(path)
-      File.find(path)
+    def self.from_path(path, options = {})
+      find(path, {}, options)
     end
 
     def self.identical?(path1, path2)

data/lib/files.com/models/user_cipher_use.rb

@@ -45,7 +45,7 @@ module Files
     end
 
     # Parameters:
-    #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
+    #   user_id - int64 - User ID. If provided, will return uses for this user.
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
     def self.list(params = {}, options = {})

data/lib/files.com/models/user_sftp_client_use.rb

@@ -35,7 +35,7 @@ module Files
     end
 
     # Parameters:
-    #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
+    #   user_id - int64 - User ID. If provided, will return uses for this user.
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
     def self.list(params = {}, options = {})

data/lib/files.com/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Files
-  VERSION = "1.1.248"
+  VERSION = "1.1.250"
 end

data/lib/files.com.rb

@@ -138,6 +138,7 @@ module Files
   @api_key = nil
   @app_info = nil
   @base_url = "https://app.files.com"
+  @language = nil
   @log_level = nil
   @logger = nil
   @proxy = nil
@@ -152,7 +153,7 @@ module Files
   @read_timeout = 60
 
   class << self
-    attr_accessor :api_key, :base_url, :default_headers, :initial_network_retry_delay, :max_network_retry_delay, :open_timeout, :read_timeout, :proxy, :session_id
+    attr_accessor :api_key, :base_url, :default_headers, :initial_network_retry_delay, :language, :max_network_retry_delay, :open_timeout, :read_timeout, :proxy, :session_id
   end
 
   # map to the same values as the standard library's logger

data/spec/language_spec.rb

@@ -0,0 +1,14 @@
+require "spec_helper"
+
+RSpec.describe 'Language setting', :with_test_folder do
+  it 'sets the language' do
+    # Set language and verify
+    Files.language = 'es'
+    expect(Files.language).to eq('es')
+    begin
+      Files::File.find(test_folder.join("read.txt").to_s, {}, options)
+    rescue StandardError => e
+      expect(e.message).to include('No se ha encontrado')
+    end
+  end
+end

data/spec/models/file_spec.rb

@@ -97,9 +97,6 @@ RSpec.describe Files::File, :with_test_folder, skip: ENV.fetch("GITLAB", nil) do
 
       file = Files::File.find(test_folder.join("with_rename_test.txt").to_s, {}, options)
       expect(file.read).to eq("I am a string via IO")
-
-      file = Files::File.find(test_folder.join("with_rename_test_1.txt").to_s, {}, options)
-      expect(file.read).to eq("I am a string via IO")
     end
   end
 
@@ -122,12 +119,12 @@ RSpec.describe Files::File, :with_test_folder, skip: ENV.fetch("GITLAB", nil) do
       Files::File.open(test_folder.join("read.txt").to_s, 'w', options) do |f|
         f.write("contents")
       end
-      expect(Files::File.from_path(test_folder.join("read.txt").to_s).type).to eq("file")
+      expect(Files::File.from_path(test_folder.join("read.txt").to_s, options).type).to eq("file")
     end
 
     it "returns a directory type" do
-      Files::Folder.mkdir("testdir") unless Files::Folder.exist?("testdir")
-      expect(Files::File.from_path("testdir").type).to eq("directory")
+      Files::Folder.mkdir("testdir", {}, options) unless Files::Folder.exist?("testdir", options)
+      expect(Files::File.from_path("testdir", options).type).to eq("directory")
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.248
+  version: 1.1.250
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-05-05 00:00:00.000000000 Z
+date: 2025-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -330,6 +330,7 @@ files:
 - shared/header_test_data.json
 - shared/normalization_for_comparison_test_data.json
 - shared/url_test_data.json
+- spec/language_spec.rb
 - spec/lib/api_client_spec.rb
 - spec/list_spec.rb
 - spec/models/file_spec.rb