files.com 1.0.193 → 1.0.197

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a599aa6d51986ff722226706994e73b660bee4b6da64aa149900796c806c9572
-  data.tar.gz: 436b1e366889606c622aad168f85a499a3f0253d5e8db462a91cd3f721a09ee7
+  metadata.gz: 132a17f2eee373017f7e623e3bc1d670024ab843407abc6efeaa3784cfc622c2
+  data.tar.gz: ef718a291170b625b796b1f7a4d0840e81db547c1f4ff67bc6ba78b47fd6a586
 SHA512:
-  metadata.gz: 2bbf45f1225e30d5a1198a575cc32754b0d99cfdca9d5540709f202b3ba067b15321cb45f6b7ed61e688dca348d36d3f768adf597ad8d6ec9374529166b81cf3
-  data.tar.gz: 28dd038c7395bc8c590153658ce0e3b474641e43fd9a1aba77f1ca6ecb14bd9d327650880a75c1321d92e30d51128d7b06c2ae88ad19329af1eb3261ec460afe
+  metadata.gz: 9cd8c1cb2c3e7cc7f829c793a45780511cbd19e8c81d845a5aa2145526c342da2f28cd3261a92c4ebc39f437ff2219499070b15a896ab081f75d15f059313d06
+  data.tar.gz: 408dd148d1778eb3cfbdd397ec046abd2224e071b280f712a0505c49608dd652ed30845a0eb2201e646b2e4cd60da371da4d97fb4c14002001cb97b85413d76c

data/_VERSION

@@ -1 +1 @@
-1.0.193
+1.0.197

data/docs/behavior.md

@@ -101,7 +101,7 @@ Files::Behavior.create(
 
 ### Parameters
 
-* `value` (string): The value of the folder behavior.  Can be a integer, array, or hash depending on the type of folder behavior.
+* `value` (string): The value of the folder behavior.  Can be a integer, array, or hash depending on the type of folder behavior. See The Behavior Types section for example values for each type of behavior.
 * `attachment_file` (file): Certain behaviors may require a file, for instance, the "watermark" behavior requires a watermark image
 * `path` (string): Required - Folder behaviors path.
 * `behavior` (string): Required - Behavior type.
@@ -146,7 +146,7 @@ Files::Behavior.update(id,
 ### Parameters
 
 * `id` (int64): Required - Behavior ID.
-* `value` (string): The value of the folder behavior.  Can be a integer, array, or hash depending on the type of folder behavior.
+* `value` (string): The value of the folder behavior.  Can be a integer, array, or hash depending on the type of folder behavior. See The Behavior Types section for example values for each type of behavior.
 * `attachment_file` (file): Certain behaviors may require a file, for instance, the "watermark" behavior requires a watermark image
 * `behavior` (string): Behavior type.
 * `path` (string): Folder behaviors path.
@@ -181,7 +181,7 @@ behavior.update(
 ### Parameters
 
 * `id` (int64): Required - Behavior ID.
-* `value` (string): The value of the folder behavior.  Can be a integer, array, or hash depending on the type of folder behavior.
+* `value` (string): The value of the folder behavior.  Can be a integer, array, or hash depending on the type of folder behavior. See The Behavior Types section for example values for each type of behavior.
 * `attachment_file` (file): Certain behaviors may require a file, for instance, the "watermark" behavior requires a watermark image
 * `behavior` (string): Behavior type.
 * `path` (string): Folder behaviors path.

data/docs/bundle_registration.md

@@ -8,6 +8,7 @@
   "name": "account",
   "company": "Action Verb",
   "email": "john.doe@files.com",
+  "ip": "10.1.1.1",
   "inbox_code": "abc123",
   "clickwrap_body": "",
   "form_field_set_id": 1,
@@ -19,6 +20,7 @@
 * `name` (string): Registrant name
 * `company` (string): Registrant company name
 * `email` (string): Registrant email address
+* `ip` (string): Registrant IP Address
 * `inbox_code` (string): InboxRegistration cookie code, if there is an associated InboxRegistration
 * `clickwrap_body` (string): Clickwrap text that was shown to the registrant
 * `form_field_set_id` (int64): Id of associated form field set

data/docs/file.md

@@ -148,6 +148,85 @@ Files::File.delete(path,
 * `recursive` (boolean): If true, will recursively delete folers.  Otherwise, will error on non-empty folders.
 
 
+---
+
+## Return metadata for file/folder
+
+```
+Files::File.metadata(path, 
+  with_previews: true, 
+  with_priority_color: true
+)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+* `preview_size` (string): Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
+* `with_previews` (boolean): Include file preview information?
+* `with_priority_color` (boolean): Include file priority color information?
+
+
+---
+
+## Copy file/folder
+
+```
+Files::File.copy(path, 
+  destination: "destination", 
+  structure: true
+)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+* `destination` (string): Required - Copy destination path.
+* `structure` (boolean): Copy structure only?
+
+
+---
+
+## Move file/folder
+
+```
+Files::File.move(path, 
+  destination: "destination"
+)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+* `destination` (string): Required - Move destination path.
+
+
+---
+
+## Begin file upload
+
+```
+Files::File.begin_upload(path, 
+  mkdir_parents: true, 
+  part: 1, 
+  parts: 1, 
+  ref: "upload-1", 
+  restart: 1, 
+  with_rename: true
+)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+* `mkdir_parents` (boolean): Create parent directories if they do not exist?
+* `part` (int64): Part if uploading a part.
+* `parts` (int64): How many parts to fetch?
+* `ref` (string): 
+* `restart` (int64): File byte offset to restart from.
+* `with_rename` (boolean): Allow file rename instead of overwrite?
+
+
 ---
 
 ## Download file
@@ -206,3 +285,90 @@ file.delete(
 
 * `path` (string): Required - Path to operate on.
 * `recursive` (boolean): If true, will recursively delete folers.  Otherwise, will error on non-empty folders.
+
+
+---
+
+## Return metadata for file/folder
+
+```
+file = Files::File.list_for(path).first
+
+file.metadata(
+  with_previews: true,
+  with_priority_color: true
+)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+* `preview_size` (string): Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
+* `with_previews` (boolean): Include file preview information?
+* `with_priority_color` (boolean): Include file priority color information?
+
+
+---
+
+## Copy file/folder
+
+```
+file = Files::File.list_for(path).first
+
+file.copy(
+  destination: "destination",
+  structure: true
+)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+* `destination` (string): Required - Copy destination path.
+* `structure` (boolean): Copy structure only?
+
+
+---
+
+## Move file/folder
+
+```
+file = Files::File.list_for(path).first
+
+file.move(
+  destination: "destination"
+)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+* `destination` (string): Required - Move destination path.
+
+
+---
+
+## Begin file upload
+
+```
+file = Files::File.list_for(path).first
+
+file.begin_upload(
+  mkdir_parents: true,
+  part: 1,
+  parts: 1,
+  ref: "upload-1",
+  restart: 1,
+  with_rename: true
+)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+* `mkdir_parents` (boolean): Create parent directories if they do not exist?
+* `part` (int64): Part if uploading a part.
+* `parts` (int64): How many parts to fetch?
+* `ref` (string): 
+* `restart` (int64): File byte offset to restart from.
+* `with_rename` (boolean): Allow file rename instead of overwrite?

data/docs/file_action.md

@@ -11,129 +11,3 @@
 
 * `status` (string): Status of file operation. Possible values: completed, enqueued.
 * `file_migration_id` (int64): If status is enqueued, this is the id of the FileMigration to check for status updates.
-
-
----
-
-## Copy file/folder
-
-```
-Files::FileAction.copy(path, 
-  destination: "destination", 
-  structure: true
-)
-```
-
-### Parameters
-
-* `path` (string): Required - Path to operate on.
-* `destination` (string): Required - Copy destination path.
-* `structure` (boolean): Copy structure only?
-
-
----
-
-## Move file/folder
-
-```
-Files::FileAction.move(path, 
-  destination: "destination"
-)
-```
-
-### Parameters
-
-* `path` (string): Required - Path to operate on.
-* `destination` (string): Required - Move destination path.
-
-
----
-
-## Begin file upload
-
-```
-Files::FileAction.begin_upload(path, 
-  mkdir_parents: true, 
-  part: 1, 
-  parts: 1, 
-  ref: "upload-1", 
-  restart: 1, 
-  with_rename: true
-)
-```
-
-### Parameters
-
-* `path` (string): Required - Path to operate on.
-* `mkdir_parents` (boolean): Create parent directories if they do not exist?
-* `part` (int64): Part if uploading a part.
-* `parts` (int64): How many parts to fetch?
-* `ref` (string): 
-* `restart` (int64): File byte offset to restart from.
-* `with_rename` (boolean): Allow file rename instead of overwrite?
-
-
----
-
-## Copy file/folder
-
-```
-file_action = Files::FileAction.list_for(path).first
-
-file_action.copy(
-  destination: "destination",
-  structure: true
-)
-```
-
-### Parameters
-
-* `path` (string): Required - Path to operate on.
-* `destination` (string): Required - Copy destination path.
-* `structure` (boolean): Copy structure only?
-
-
----
-
-## Move file/folder
-
-```
-file_action = Files::FileAction.list_for(path).first
-
-file_action.move(
-  destination: "destination"
-)
-```
-
-### Parameters
-
-* `path` (string): Required - Path to operate on.
-* `destination` (string): Required - Move destination path.
-
-
----
-
-## Begin file upload
-
-```
-file_action = Files::FileAction.list_for(path).first
-
-file_action.begin_upload(
-  mkdir_parents: true,
-  part: 1,
-  parts: 1,
-  ref: "upload-1",
-  restart: 1,
-  with_rename: true
-)
-```
-
-### Parameters
-
-* `path` (string): Required - Path to operate on.
-* `mkdir_parents` (boolean): Create parent directories if they do not exist?
-* `part` (int64): Part if uploading a part.
-* `parts` (int64): How many parts to fetch?
-* `ref` (string): 
-* `restart` (int64): File byte offset to restart from.
-* `with_rename` (boolean): Allow file rename instead of overwrite?

data/docs/file_migration.md

@@ -11,7 +11,8 @@
   "files_total": 1,
   "operation": "move",
   "region": "USA",
-  "status": "complete"
+  "status": "complete",
+  "log_url": "https://www.example.com/log_file"
 }
 ```
 
@@ -23,6 +24,7 @@
 * `operation` (string): The type of operation
 * `region` (string): Region
 * `status` (string): Status
+* `log_url` (string): Link to download the log file for this migration.
 
 
 ---

data/docs/history_export.md

@@ -38,7 +38,7 @@
 * `end_at` (date-time): End date/time of export range.
 * `status` (string): Status of export.  Will be: `building`, `ready`, or `failed`
 * `query_action` (string): Filter results by this this action type. Valid values: `create`, `read`, `update`, `destroy`, `move`, `login`, `failedlogin`, `copy`, `user_create`, `user_update`, `user_destroy`, `group_create`, `group_update`, `group_destroy`, `permission_create`, `permission_destroy`, `api_key_create`, `api_key_update`, `api_key_destroy`
-* `query_interface` (string): Filter results by this this interface type. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`
+* `query_interface` (string): Filter results by this this interface type. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`, `mobile`
 * `query_user_id` (string): Return results that are actions performed by the user indiciated by this User ID
 * `query_file_id` (string): Return results that are file actions related to the file indicated by this File ID
 * `query_parent_id` (string): Return results that are file actions inside the parent folder specified by this folder ID
@@ -110,7 +110,7 @@ Files::HistoryExport.create(
 * `start_at` (string): Start date/time of export range.
 * `end_at` (string): End date/time of export range.
 * `query_action` (string): Filter results by this this action type. Valid values: `create`, `read`, `update`, `destroy`, `move`, `login`, `failedlogin`, `copy`, `user_create`, `user_update`, `user_destroy`, `group_create`, `group_update`, `group_destroy`, `permission_create`, `permission_destroy`, `api_key_create`, `api_key_update`, `api_key_destroy`
-* `query_interface` (string): Filter results by this this interface type. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`
+* `query_interface` (string): Filter results by this this interface type. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`, `mobile`
 * `query_user_id` (string): Return results that are actions performed by the user indiciated by this User ID
 * `query_file_id` (string): Return results that are file actions related to the file indicated by this File ID
 * `query_parent_id` (string): Return results that are file actions inside the parent folder specified by this folder ID

data/docs/history_export_result.md

@@ -43,7 +43,7 @@
 * `username` (string): Username of the user that performed the action
 * `action` (string): What action was taken. Valid values: `create`, `read`, `update`, `destroy`, `move`, `login`, `failedlogin`, `copy`, `user_create`, `user_update`, `user_destroy`, `group_create`, `group_update`, `group_destroy`, `permission_create`, `permission_destroy`, `api_key_create`, `api_key_update`, `api_key_destroy`
 * `failure_type` (string): The type of login failure, if applicable.  Valid values: `expired_trial`, `account_overdue`, `locked_out`, `ip_mismatch`, `password_mismatch`, `site_mismatch`, `username_not_found`, `none`, `no_ftp_permission`, `no_web_permission`, `no_directory`, `errno_enoent`, `no_sftp_permission`, `no_dav_permission`, `no_restapi_permission`, `key_mismatch`, `region_mismatch`, `expired_access`, `desktop_ip_mismatch`, `desktop_api_key_not_used_quickly_enough`, `disabled`, `country_mismatch`
-* `interface` (string): Inteface through which the action was taken. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`
+* `interface` (string): Inteface through which the action was taken. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`, `mobile`
 * `target_id` (int64): ID of the object (such as Users, or API Keys) on which the action was taken
 * `target_name` (string): Name of the User, Group or other object with a name related to this action
 * `target_permission` (string): Permission level of the action

data/docs/site.md

@@ -31,6 +31,9 @@
   "desktop_app": true,
   "desktop_app_session_ip_pinning": true,
   "desktop_app_session_lifetime": 1,
+  "mobile_app": true,
+  "mobile_app_session_ip_pinning": true,
+  "mobile_app_session_lifetime": 1,
   "disallowed_countries": "US,DE",
   "disable_notifications": true,
   "disable_password_reset": true,
@@ -234,6 +237,9 @@
 * `desktop_app` (boolean): Is the desktop app enabled?
 * `desktop_app_session_ip_pinning` (boolean): Is desktop app session IP pinning enabled?
 * `desktop_app_session_lifetime` (int64): Desktop app session lifetime (in hours)
+* `mobile_app` (boolean): Is the mobile app enabled?
+* `mobile_app_session_ip_pinning` (boolean): Is mobile app session IP pinning enabled?
+* `mobile_app_session_lifetime` (int64): Mobile app session lifetime (in hours)
 * `disallowed_countries` (string): Comma seperated list of disallowed Country codes
 * `disable_notifications` (boolean): Are notifications disabled?
 * `disable_password_reset` (boolean): Is password reset disabled?
@@ -367,6 +373,9 @@ Files::Site.update(
   desktop_app: true, 
   desktop_app_session_ip_pinning: true, 
   desktop_app_session_lifetime: 1, 
+  mobile_app: true, 
+  mobile_app_session_ip_pinning: true, 
+  mobile_app_session_lifetime: 1, 
   folder_permissions_groups_only: true, 
   welcome_screen: "user_controlled", 
   office_integration_available: true, 
@@ -463,6 +472,9 @@ Files::Site.update(
 * `desktop_app` (boolean): Is the desktop app enabled?
 * `desktop_app_session_ip_pinning` (boolean): Is desktop app session IP pinning enabled?
 * `desktop_app_session_lifetime` (int64): Desktop app session lifetime (in hours)
+* `mobile_app` (boolean): Is the mobile app enabled?
+* `mobile_app_session_ip_pinning` (boolean): Is mobile app session IP pinning enabled?
+* `mobile_app_session_lifetime` (int64): Mobile app session lifetime (in hours)
 * `folder_permissions_groups_only` (boolean): If true, permissions for this site must be bound to a group (not a user). Otherwise, permissions must be bound to a user.
 * `welcome_screen` (string): Does the welcome screen appear?
 * `office_integration_available` (boolean): Allow users to use Office for the web?

data/lib/files.com/errors.rb

@@ -110,6 +110,7 @@ module Files
   class ApiKeyIsDisabledError < NotAuthorizedError; end
   class ApiKeyIsPathRestrictedError < NotAuthorizedError; end
   class ApiKeyOnlyForDesktopAppError < NotAuthorizedError; end
+  class ApiKeyOnlyForMobileAppError < NotAuthorizedError; end
   class ApiKeyOnlyForOfficeIntegrationError < NotAuthorizedError; end
   class BillingPermissionRequiredError < NotAuthorizedError; end
   class BundleMaximumUsesReachedError < NotAuthorizedError; end

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

@@ -64,7 +64,7 @@ module Files
     end
 
     # Parameters:
-    #   value - string - The value of the folder behavior.  Can be a integer, array, or hash depending on the type of folder behavior.
+    #   value - string - The value of the folder behavior.  Can be a integer, array, or hash depending on the type of folder behavior. See The Behavior Types section for example values for each type of behavior.
     #   attachment_file - file - Certain behaviors may require a file, for instance, the "watermark" behavior requires a watermark image
     #   behavior - string - Behavior type.
     #   path - string - Folder behaviors path.
@@ -188,7 +188,7 @@ module Files
     end
 
     # Parameters:
-    #   value - string - The value of the folder behavior.  Can be a integer, array, or hash depending on the type of folder behavior.
+    #   value - string - The value of the folder behavior.  Can be a integer, array, or hash depending on the type of folder behavior. See The Behavior Types section for example values for each type of behavior.
     #   attachment_file - file - Certain behaviors may require a file, for instance, the "watermark" behavior requires a watermark image
     #   path (required) - string - Folder behaviors path.
     #   behavior (required) - string - Behavior type.
@@ -224,7 +224,7 @@ module Files
     end
 
     # Parameters:
-    #   value - string - The value of the folder behavior.  Can be a integer, array, or hash depending on the type of folder behavior.
+    #   value - string - The value of the folder behavior.  Can be a integer, array, or hash depending on the type of folder behavior. See The Behavior Types section for example values for each type of behavior.
     #   attachment_file - file - Certain behaviors may require a file, for instance, the "watermark" behavior requires a watermark image
     #   behavior - string - Behavior type.
     #   path - string - Folder behaviors path.

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

@@ -29,6 +29,11 @@ module Files
       @attributes[:email]
     end
 
+    # string - Registrant IP Address
+    def ip
+      @attributes[:ip]
+    end
+
     # string - InboxRegistration cookie code, if there is an associated InboxRegistration
     def inbox_code
       @attributes[:inbox_code]

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

@@ -70,6 +70,10 @@ module Files
       new(name).each(*args, &block)
     end
 
+    def self.from_path(path)
+      File.metadata(path)
+    end
+
     def self.get(path, params = {}, options = {})
       find(path, params, options)
     end
@@ -863,6 +867,79 @@ module Files
       delete(params)
     end
 
+    # Return metadata for file/folder
+    #
+    # Parameters:
+    #   preview_size - string - Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
+    #   with_previews - boolean - Include file preview information?
+    #   with_priority_color - boolean - Include file priority color information?
+    def metadata(params = {})
+      params ||= {}
+      params[:path] = @attributes[:path]
+      raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: preview_size must be an String") if params.dig(:preview_size) and !params.dig(:preview_size).is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
+
+      Api.send_request("/file_actions/metadata/#{@attributes[:path]}", :get, params, @options)
+    end
+
+    # Copy file/folder
+    #
+    # Parameters:
+    #   destination (required) - string - Copy destination path.
+    #   structure - boolean - Copy structure only?
+    def copy(params = {})
+      params ||= {}
+      params[:path] = @attributes[:path]
+      raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: destination must be an String") if params.dig(:destination) and !params.dig(:destination).is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
+      raise MissingParameterError.new("Parameter missing: destination") unless params.dig(:destination)
+
+      Api.send_request("/file_actions/copy/#{@attributes[:path]}", :post, params, @options)
+    end
+
+    # Move file/folder
+    #
+    # Parameters:
+    #   destination (required) - string - Move destination path.
+    def move(params = {})
+      params ||= {}
+      params[:path] = @attributes[:path]
+      raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: destination must be an String") if params.dig(:destination) and !params.dig(:destination).is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
+      raise MissingParameterError.new("Parameter missing: destination") unless params.dig(:destination)
+
+      Api.send_request("/file_actions/move/#{@attributes[:path]}", :post, params, @options)
+    end
+
+    # Begin file upload
+    #
+    # Parameters:
+    #   mkdir_parents - boolean - Create parent directories if they do not exist?
+    #   part - int64 - Part if uploading a part.
+    #   parts - int64 - How many parts to fetch?
+    #   ref - string -
+    #   restart - int64 - File byte offset to restart from.
+    #   with_rename - boolean - Allow file rename instead of overwrite?
+    def begin_upload(params = {})
+      params ||= {}
+      params[:path] = @attributes[:path]
+      raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: part must be an Integer") if params.dig(:part) and !params.dig(:part).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: parts must be an Integer") if params.dig(:parts) and !params.dig(:parts).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: ref must be an String") if params.dig(:ref) and !params.dig(:ref).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: restart must be an Integer") if params.dig(:restart) and !params.dig(:restart).is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
+
+      Api.send_request("/file_actions/begin_upload/#{@attributes[:path]}", :post, params, @options)
+    end
+
     def save
       new_obj = File.create(path, @attributes, @options)
       @attributes = new_obj.attributes
@@ -951,5 +1028,80 @@ module Files
     def self.destroy(path, params = {}, options = {})
       delete(path, params, options)
     end
+
+    # Return metadata for file/folder
+    #
+    # Parameters:
+    #   preview_size - string - Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
+    #   with_previews - boolean - Include file preview information?
+    #   with_priority_color - boolean - Include file priority color information?
+    def self.metadata(path, params = {}, options = {})
+      params ||= {}
+      params[:path] = path
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: preview_size must be an String") if params.dig(:preview_size) and !params.dig(:preview_size).is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
+
+      response, options = Api.send_request("/file_actions/metadata/#{params[:path]}", :get, params, options)
+      File.new(response.data, options)
+    end
+
+    # Copy file/folder
+    #
+    # Parameters:
+    #   destination (required) - string - Copy destination path.
+    #   structure - boolean - Copy structure only?
+    def self.copy(path, params = {}, options = {})
+      params ||= {}
+      params[:path] = path
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: destination must be an String") if params.dig(:destination) and !params.dig(:destination).is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
+      raise MissingParameterError.new("Parameter missing: destination") unless params.dig(:destination)
+
+      response, options = Api.send_request("/file_actions/copy/#{params[:path]}", :post, params, options)
+      FileAction.new(response.data, options)
+    end
+
+    # Move file/folder
+    #
+    # Parameters:
+    #   destination (required) - string - Move destination path.
+    def self.move(path, params = {}, options = {})
+      params ||= {}
+      params[:path] = path
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: destination must be an String") if params.dig(:destination) and !params.dig(:destination).is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
+      raise MissingParameterError.new("Parameter missing: destination") unless params.dig(:destination)
+
+      response, options = Api.send_request("/file_actions/move/#{params[:path]}", :post, params, options)
+      FileAction.new(response.data, options)
+    end
+
+    # Begin file upload
+    #
+    # Parameters:
+    #   mkdir_parents - boolean - Create parent directories if they do not exist?
+    #   part - int64 - Part if uploading a part.
+    #   parts - int64 - How many parts to fetch?
+    #   ref - string -
+    #   restart - int64 - File byte offset to restart from.
+    #   with_rename - boolean - Allow file rename instead of overwrite?
+    def self.begin_upload(path, params = {}, options = {})
+      params ||= {}
+      params[:path] = path
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: part must be an Integer") if params.dig(:part) and !params.dig(:part).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: parts must be an Integer") if params.dig(:parts) and !params.dig(:parts).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: ref must be an String") if params.dig(:ref) and !params.dig(:ref).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: restart must be an Integer") if params.dig(:restart) and !params.dig(:restart).is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
+
+      response, options = Api.send_request("/file_actions/begin_upload/#{params[:path]}", :post, params, options)
+      response.data.map do |entity_data|
+        FileUploadPart.new(entity_data, options)
+      end
+    end
   end
 end

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

@@ -18,119 +18,5 @@ module Files
     def file_migration_id
       @attributes[:file_migration_id]
     end
-
-    # Copy file/folder
-    #
-    # Parameters:
-    #   destination (required) - string - Copy destination path.
-    #   structure - boolean - Copy structure only?
-    def copy(params = {})
-      params ||= {}
-      params[:path] = @attributes[:path]
-      raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
-      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
-      raise InvalidParameterError.new("Bad parameter: destination must be an String") if params.dig(:destination) and !params.dig(:destination).is_a?(String)
-      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
-      raise MissingParameterError.new("Parameter missing: destination") unless params.dig(:destination)
-
-      Api.send_request("/file_actions/copy/#{@attributes[:path]}", :post, params, @options)
-    end
-
-    # Move file/folder
-    #
-    # Parameters:
-    #   destination (required) - string - Move destination path.
-    def move(params = {})
-      params ||= {}
-      params[:path] = @attributes[:path]
-      raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
-      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
-      raise InvalidParameterError.new("Bad parameter: destination must be an String") if params.dig(:destination) and !params.dig(:destination).is_a?(String)
-      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
-      raise MissingParameterError.new("Parameter missing: destination") unless params.dig(:destination)
-
-      Api.send_request("/file_actions/move/#{@attributes[:path]}", :post, params, @options)
-    end
-
-    # Begin file upload
-    #
-    # Parameters:
-    #   mkdir_parents - boolean - Create parent directories if they do not exist?
-    #   part - int64 - Part if uploading a part.
-    #   parts - int64 - How many parts to fetch?
-    #   ref - string -
-    #   restart - int64 - File byte offset to restart from.
-    #   with_rename - boolean - Allow file rename instead of overwrite?
-    def begin_upload(params = {})
-      params ||= {}
-      params[:path] = @attributes[:path]
-      raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
-      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
-      raise InvalidParameterError.new("Bad parameter: part must be an Integer") if params.dig(:part) and !params.dig(:part).is_a?(Integer)
-      raise InvalidParameterError.new("Bad parameter: parts must be an Integer") if params.dig(:parts) and !params.dig(:parts).is_a?(Integer)
-      raise InvalidParameterError.new("Bad parameter: ref must be an String") if params.dig(:ref) and !params.dig(:ref).is_a?(String)
-      raise InvalidParameterError.new("Bad parameter: restart must be an Integer") if params.dig(:restart) and !params.dig(:restart).is_a?(Integer)
-      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
-
-      Api.send_request("/file_actions/begin_upload/#{@attributes[:path]}", :post, params, @options)
-    end
-
-    # Copy file/folder
-    #
-    # Parameters:
-    #   destination (required) - string - Copy destination path.
-    #   structure - boolean - Copy structure only?
-    def self.copy(path, params = {}, options = {})
-      params ||= {}
-      params[:path] = path
-      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
-      raise InvalidParameterError.new("Bad parameter: destination must be an String") if params.dig(:destination) and !params.dig(:destination).is_a?(String)
-      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
-      raise MissingParameterError.new("Parameter missing: destination") unless params.dig(:destination)
-
-      response, options = Api.send_request("/file_actions/copy/#{params[:path]}", :post, params, options)
-      FileAction.new(response.data, options)
-    end
-
-    # Move file/folder
-    #
-    # Parameters:
-    #   destination (required) - string - Move destination path.
-    def self.move(path, params = {}, options = {})
-      params ||= {}
-      params[:path] = path
-      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
-      raise InvalidParameterError.new("Bad parameter: destination must be an String") if params.dig(:destination) and !params.dig(:destination).is_a?(String)
-      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
-      raise MissingParameterError.new("Parameter missing: destination") unless params.dig(:destination)
-
-      response, options = Api.send_request("/file_actions/move/#{params[:path]}", :post, params, options)
-      FileAction.new(response.data, options)
-    end
-
-    # Begin file upload
-    #
-    # Parameters:
-    #   mkdir_parents - boolean - Create parent directories if they do not exist?
-    #   part - int64 - Part if uploading a part.
-    #   parts - int64 - How many parts to fetch?
-    #   ref - string -
-    #   restart - int64 - File byte offset to restart from.
-    #   with_rename - boolean - Allow file rename instead of overwrite?
-    def self.begin_upload(path, params = {}, options = {})
-      params ||= {}
-      params[:path] = path
-      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
-      raise InvalidParameterError.new("Bad parameter: part must be an Integer") if params.dig(:part) and !params.dig(:part).is_a?(Integer)
-      raise InvalidParameterError.new("Bad parameter: parts must be an Integer") if params.dig(:parts) and !params.dig(:parts).is_a?(Integer)
-      raise InvalidParameterError.new("Bad parameter: ref must be an String") if params.dig(:ref) and !params.dig(:ref).is_a?(String)
-      raise InvalidParameterError.new("Bad parameter: restart must be an Integer") if params.dig(:restart) and !params.dig(:restart).is_a?(Integer)
-      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
-
-      response, options = Api.send_request("/file_actions/begin_upload/#{params[:path]}", :post, params, options)
-      response.data.map do |entity_data|
-        FileUploadPart.new(entity_data, options)
-      end
-    end
   end
 end

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

@@ -49,6 +49,11 @@ module Files
       @attributes[:status]
     end
 
+    # string - Link to download the log file for this migration.
+    def log_url
+      @attributes[:log_url]
+    end
+
     # Parameters:
     #   id (required) - int64 - File Migration ID.
     def self.find(id, params = {}, options = {})

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

@@ -63,7 +63,7 @@ module Files
       @attributes[:query_action] = value
     end
 
-    # string - Filter results by this this interface type. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`
+    # string - Filter results by this this interface type. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`, `mobile`
     def query_interface
       @attributes[:query_interface]
     end
@@ -273,7 +273,7 @@ module Files
     #   start_at - string - Start date/time of export range.
     #   end_at - string - End date/time of export range.
     #   query_action - string - Filter results by this this action type. Valid values: `create`, `read`, `update`, `destroy`, `move`, `login`, `failedlogin`, `copy`, `user_create`, `user_update`, `user_destroy`, `group_create`, `group_update`, `group_destroy`, `permission_create`, `permission_destroy`, `api_key_create`, `api_key_update`, `api_key_destroy`
-    #   query_interface - string - Filter results by this this interface type. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`
+    #   query_interface - string - Filter results by this this interface type. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`, `mobile`
     #   query_user_id - string - Return results that are actions performed by the user indiciated by this User ID
     #   query_file_id - string - Return results that are file actions related to the file indicated by this File ID
     #   query_parent_id - string - Return results that are file actions inside the parent folder specified by this folder ID

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

@@ -74,7 +74,7 @@ module Files
       @attributes[:failure_type]
     end
 
-    # string - Inteface through which the action was taken. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`
+    # string - Inteface through which the action was taken. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`, `mobile`
     def interface
       @attributes[:interface]
     end

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

@@ -144,6 +144,21 @@ module Files
       @attributes[:desktop_app_session_lifetime]
     end
 
+    # boolean - Is the mobile app enabled?
+    def mobile_app
+      @attributes[:mobile_app]
+    end
+
+    # boolean - Is mobile app session IP pinning enabled?
+    def mobile_app_session_ip_pinning
+      @attributes[:mobile_app_session_ip_pinning]
+    end
+
+    # int64 - Mobile app session lifetime (in hours)
+    def mobile_app_session_lifetime
+      @attributes[:mobile_app_session_lifetime]
+    end
+
     # string - Comma seperated list of disallowed Country codes
     def disallowed_countries
       @attributes[:disallowed_countries]
@@ -619,6 +634,9 @@ module Files
     #   desktop_app - boolean - Is the desktop app enabled?
     #   desktop_app_session_ip_pinning - boolean - Is desktop app session IP pinning enabled?
     #   desktop_app_session_lifetime - int64 - Desktop app session lifetime (in hours)
+    #   mobile_app - boolean - Is the mobile app enabled?
+    #   mobile_app_session_ip_pinning - boolean - Is mobile app session IP pinning enabled?
+    #   mobile_app_session_lifetime - int64 - Mobile app session lifetime (in hours)
     #   folder_permissions_groups_only - boolean - If true, permissions for this site must be bound to a group (not a user). Otherwise, permissions must be bound to a user.
     #   welcome_screen - string - Does the welcome screen appear?
     #   office_integration_available - boolean - Allow users to use Office for the web?
@@ -718,6 +736,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: language must be an String") if params.dig(:language) and !params.dig(:language).is_a?(String)
       raise InvalidParameterError.new("Bad parameter: default_time_zone must be an String") if params.dig(:default_time_zone) and !params.dig(:default_time_zone).is_a?(String)
       raise InvalidParameterError.new("Bad parameter: desktop_app_session_lifetime must be an Integer") if params.dig(:desktop_app_session_lifetime) and !params.dig(:desktop_app_session_lifetime).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: mobile_app_session_lifetime must be an Integer") if params.dig(:mobile_app_session_lifetime) and !params.dig(:mobile_app_session_lifetime).is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: welcome_screen must be an String") if params.dig(:welcome_screen) and !params.dig(:welcome_screen).is_a?(String)
       raise InvalidParameterError.new("Bad parameter: session_expiry must be an Float") if params.dig(:session_expiry) and !params.dig(:session_expiry).is_a?(Float)
       raise InvalidParameterError.new("Bad parameter: user_lockout_tries must be an Integer") if params.dig(:user_lockout_tries) and !params.dig(:user_lockout_tries).is_a?(Integer)

data/spec/models/file_spec.rb

@@ -97,4 +97,18 @@ RSpec.describe Files::File, :with_test_folder, skip: ENV["GITLAB"] do
       expect(io.tap(&:rewind).read).to eq("I am a string")
     end
   end
+
+  describe ".from_path" do
+    it "returns a File object for a file" do
+      Files::File.open(test_folder.join("read.txt").to_s, 'w', options) do |f|
+        f.write("contents")
+      end
+      expect(Files::File.from_path("read.txt")).to be_a_kind_of(Files::File)
+    end
+
+    it "returns a Folder object for a Folder" do
+      Files::Folder.mkdir("testdir")
+      expect(Files::File.from_path("testdir")).to be_a_kind_of(Files::Folder)
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.0.193
+  version: 1.0.197
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-05 00:00:00.000000000 Z
+date: 2021-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable