files.com 1.1.7 → 1.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '045895df933d7ee7e70af3e54d72f8ff2a3a26c2dff685e793f3ebd7852af77b'
-  data.tar.gz: 195b79c751211a1e8ba022f646e2b01c1e4e7454d0c181c78c1e93dffa26e92f
+  metadata.gz: 634811398079109501dad6280320254280ea1e5231a210904855835a3c07f258
+  data.tar.gz: b857c3c1dd099249b8807fbcd7c9d22a0a8da4d5ae73e8237f6ba36db1f5709d
 SHA512:
-  metadata.gz: 3fae2012ac5edf7d114345c30009ea24e431018b5e3836e3e64d92054b7141829f0d1dee59b1120a65ea1d70650c95f895a05a3428042e38b8bb0f9d860689bc
-  data.tar.gz: 57751fea98faea1a0c1e38bf49f92529a247b420549ad081cde7174066bd5d2f4bd6e32228722f4f4d35b58ab579083940a93ef06ee3443a39dbacc3d9cd0576
+  metadata.gz: 6d693375174bb125c345f32d1f96d451e3d395fe79cda4c76e19ae7b73ed467ceb4d39545a6c9483b2c2a74342192b4bf9d646255c6d9461e34215125da50dce
+  data.tar.gz: af25113bd716a687cb013ac994f3894d00fdc5f5bd408658528b081ba34d54672334973d1c7fe590f696df8179483b4b8fdd5718d7ce541c52e4637ff519beeb

data/_VERSION

@@ -1 +1 @@
-1.1.7
+1.1.8

data/docs/automation.md

@@ -5,69 +5,71 @@
 ```
 {
   "id": 1,
+  "always_overwrite_size_matching_files": true,
   "automation": "create_folder",
   "deleted": true,
+  "description": "example",
+  "destination_replace_from": "example",
+  "destination_replace_to": "example",
+  "destinations": [
+    "destination"
+  ],
   "disabled": true,
-  "trigger": "daily",
+  "group_ids": [
+    1,
+    2
+  ],
   "interval": "week",
   "last_modified_at": "2000-01-01T01:00:00Z",
   "name": "example",
+  "path": "example",
+  "recurring_day": 25,
   "schedule": "example",
   "source": "example",
-  "destinations": [
-    "destination"
-  ],
-  "destination_replace_from": "example",
-  "destination_replace_to": "example",
-  "description": "example",
-  "recurring_day": 25,
-  "path": "example",
-  "user_id": 1,
   "sync_ids": [
     1,
     2
   ],
-  "user_ids": [
-    1,
-    2
+  "trigger_actions": [
+    "create"
   ],
-  "group_ids": [
+  "trigger": "daily",
+  "user_id": 1,
+  "user_ids": [
     1,
     2
   ],
-  "webhook_url": "https://app.files.com/api/webhooks/abc123",
-  "trigger_actions": [
-    "create"
-  ],
   "value": {
     "limit": "1"
-  }
+  },
+  "webhook_url": "https://app.files.com/api/webhooks/abc123"
 }
 ```
 
 * `id` (int64): Automation ID
+* `always_overwrite_size_matching_files` (boolean): Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
 * `automation` (string): Automation type
 * `deleted` (boolean): Indicates if the automation has been deleted.
+* `description` (string): Description for the this Automation.
+* `destination_replace_from` (string): If set, this string in the destination path will be replaced with the value in `destination_replace_to`.
+* `destination_replace_to` (string): If set, this string will replace the value `destination_replace_from` in the destination filename. You can use special patterns here.
+* `destinations` (array): Destination Paths
 * `disabled` (boolean): If true, this automation will not run.
-* `trigger` (string): How this automation is triggered to run.
+* `group_ids` (array): IDs of Groups for the Automation (i.e. who to Request File from)
 * `interval` (string): If trigger is `daily`, this specifies how often to run this automation.  One of: `day`, `week`, `week_end`, `month`, `month_end`, `quarter`, `quarter_end`, `year`, `year_end`
 * `last_modified_at` (date-time): Time when automation was last modified. Does not change for name or description updates.
 * `name` (string): Name for this automation.
+* `path` (string): Path on which this Automation runs.  Supports globs, except on remote mounts. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+* `recurring_day` (int64): If trigger type is `daily`, this specifies a day number to run in one of the supported intervals: `week`, `month`, `quarter`, `year`.
 * `schedule` (object): If trigger is `custom_schedule`, Custom schedule description for when the automation should be run.
 * `source` (string): Source Path
-* `destinations` (array): Destination Paths
-* `destination_replace_from` (string): If set, this string in the destination path will be replaced with the value in `destination_replace_to`.
-* `destination_replace_to` (string): If set, this string will replace the value `destination_replace_from` in the destination filename. You can use special patterns here.
-* `description` (string): Description for the this Automation.
-* `recurring_day` (int64): If trigger type is `daily`, this specifies a day number to run in one of the supported intervals: `week`, `month`, `quarter`, `year`.
-* `path` (string): Path on which this Automation runs.  Supports globs, except on remote mounts. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
-* `user_id` (int64): User ID of the Automation's creator.
 * `sync_ids` (array): IDs of remote sync folder behaviors to run by this Automation
-* `user_ids` (array): IDs of Users for the Automation (i.e. who to Request File from)
-* `group_ids` (array): IDs of Groups for the Automation (i.e. who to Request File from)
-* `webhook_url` (string): If trigger is `webhook`, this is the URL of the webhook to trigger the Automation.
 * `trigger_actions` (array): If trigger is `action`, this is the list of action types on which to trigger the automation. Valid actions are create, read, update, destroy, move, copy
+* `trigger` (string): How this automation is triggered to run.
+* `user_id` (int64): User ID of the Automation's creator.
+* `user_ids` (array): IDs of Users for the Automation (i.e. who to Request File from)
 * `value` (object): A Hash of attributes specific to the automation type.
+* `webhook_url` (string): If trigger is `webhook`, this is the URL of the webhook to trigger the Automation.
 * `destination` (string): DEPRECATED: Destination Path. Use `destinations` instead.
 
 
@@ -124,6 +126,7 @@ Files::Automation.create(
   user_ids: [1,2], 
   group_ids: [1,2], 
   schedule: {"days_of_week":[0,1,3],"times_of_day":["7:30","11:30"],"time_zone":"Eastern Time (US & Canada)"}, 
+  always_overwrite_size_matching_files: true, 
   description: "example", 
   disabled: true, 
   name: "example", 
@@ -148,6 +151,7 @@ Files::Automation.create(
 * `user_ids` (string): A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.
 * `group_ids` (string): A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.
 * `schedule` (object): Custom schedule for running this automation.
+* `always_overwrite_size_matching_files` (boolean): Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
 * `description` (string): Description for the this Automation.
 * `disabled` (boolean): If true, this automation will not run.
 * `name` (string): Name for this automation.
@@ -187,6 +191,7 @@ Files::Automation.update(id,
   user_ids: [1,2], 
   group_ids: [1,2], 
   schedule: {"days_of_week":[0,1,3],"times_of_day":["7:30","11:30"],"time_zone":"Eastern Time (US & Canada)"}, 
+  always_overwrite_size_matching_files: true, 
   description: "example", 
   disabled: true, 
   name: "example", 
@@ -212,6 +217,7 @@ Files::Automation.update(id,
 * `user_ids` (string): A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.
 * `group_ids` (string): A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.
 * `schedule` (object): Custom schedule for running this automation.
+* `always_overwrite_size_matching_files` (boolean): Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
 * `description` (string): Description for the this Automation.
 * `disabled` (boolean): If true, this automation will not run.
 * `name` (string): Name for this automation.
@@ -268,6 +274,7 @@ automation.update(
   user_ids: [1,2],
   group_ids: [1,2],
   schedule: {"days_of_week":[0,1,3],"times_of_day":["7:30","11:30"],"time_zone":"Eastern Time (US & Canada)"},
+  always_overwrite_size_matching_files: true,
   description: "example",
   disabled: true,
   name: "example",
@@ -293,6 +300,7 @@ automation.update(
 * `user_ids` (string): A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.
 * `group_ids` (string): A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.
 * `schedule` (object): Custom schedule for running this automation.
+* `always_overwrite_size_matching_files` (boolean): Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
 * `description` (string): Description for the this Automation.
 * `disabled` (boolean): If true, this automation will not run.
 * `name` (string): Name for this automation.

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

@@ -18,6 +18,15 @@ module Files
       @attributes[:id] = value
     end
 
+    # boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+    def always_overwrite_size_matching_files
+      @attributes[:always_overwrite_size_matching_files]
+    end
+
+    def always_overwrite_size_matching_files=(value)
+      @attributes[:always_overwrite_size_matching_files] = value
+    end
+
     # string - Automation type
     def automation
       @attributes[:automation]
@@ -36,6 +45,42 @@ module Files
       @attributes[:deleted] = value
     end
 
+    # string - Description for the this Automation.
+    def description
+      @attributes[:description]
+    end
+
+    def description=(value)
+      @attributes[:description] = value
+    end
+
+    # string - If set, this string in the destination path will be replaced with the value in `destination_replace_to`.
+    def destination_replace_from
+      @attributes[:destination_replace_from]
+    end
+
+    def destination_replace_from=(value)
+      @attributes[:destination_replace_from] = value
+    end
+
+    # string - If set, this string will replace the value `destination_replace_from` in the destination filename. You can use special patterns here.
+    def destination_replace_to
+      @attributes[:destination_replace_to]
+    end
+
+    def destination_replace_to=(value)
+      @attributes[:destination_replace_to] = value
+    end
+
+    # array - Destination Paths
+    def destinations
+      @attributes[:destinations]
+    end
+
+    def destinations=(value)
+      @attributes[:destinations] = value
+    end
+
     # boolean - If true, this automation will not run.
     def disabled
       @attributes[:disabled]
@@ -45,13 +90,13 @@ module Files
       @attributes[:disabled] = value
     end
 
-    # string - How this automation is triggered to run.
-    def trigger
-      @attributes[:trigger]
+    # array - IDs of Groups for the Automation (i.e. who to Request File from)
+    def group_ids
+      @attributes[:group_ids]
     end
 
-    def trigger=(value)
-      @attributes[:trigger] = value
+    def group_ids=(value)
+      @attributes[:group_ids] = value
     end
 
     # string - If trigger is `daily`, this specifies how often to run this automation.  One of: `day`, `week`, `week_end`, `month`, `month_end`, `quarter`, `quarter_end`, `year`, `year_end`
@@ -81,6 +126,24 @@ module Files
       @attributes[:name] = value
     end
 
+    # string - Path on which this Automation runs.  Supports globs, except on remote mounts. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+    def path
+      @attributes[:path]
+    end
+
+    def path=(value)
+      @attributes[:path] = value
+    end
+
+    # int64 - If trigger type is `daily`, this specifies a day number to run in one of the supported intervals: `week`, `month`, `quarter`, `year`.
+    def recurring_day
+      @attributes[:recurring_day]
+    end
+
+    def recurring_day=(value)
+      @attributes[:recurring_day] = value
+    end
+
     # object - If trigger is `custom_schedule`, Custom schedule description for when the automation should be run.
     def schedule
       @attributes[:schedule]
@@ -99,58 +162,31 @@ module Files
       @attributes[:source] = value
     end
 
-    # array - Destination Paths
-    def destinations
-      @attributes[:destinations]
-    end
-
-    def destinations=(value)
-      @attributes[:destinations] = value
-    end
-
-    # string - If set, this string in the destination path will be replaced with the value in `destination_replace_to`.
-    def destination_replace_from
-      @attributes[:destination_replace_from]
-    end
-
-    def destination_replace_from=(value)
-      @attributes[:destination_replace_from] = value
-    end
-
-    # string - If set, this string will replace the value `destination_replace_from` in the destination filename. You can use special patterns here.
-    def destination_replace_to
-      @attributes[:destination_replace_to]
-    end
-
-    def destination_replace_to=(value)
-      @attributes[:destination_replace_to] = value
-    end
-
-    # string - Description for the this Automation.
-    def description
-      @attributes[:description]
+    # array - IDs of remote sync folder behaviors to run by this Automation
+    def sync_ids
+      @attributes[:sync_ids]
     end
 
-    def description=(value)
-      @attributes[:description] = value
+    def sync_ids=(value)
+      @attributes[:sync_ids] = value
     end
 
-    # int64 - If trigger type is `daily`, this specifies a day number to run in one of the supported intervals: `week`, `month`, `quarter`, `year`.
-    def recurring_day
-      @attributes[:recurring_day]
+    # array - If trigger is `action`, this is the list of action types on which to trigger the automation. Valid actions are create, read, update, destroy, move, copy
+    def trigger_actions
+      @attributes[:trigger_actions]
     end
 
-    def recurring_day=(value)
-      @attributes[:recurring_day] = value
+    def trigger_actions=(value)
+      @attributes[:trigger_actions] = value
     end
 
-    # string - Path on which this Automation runs.  Supports globs, except on remote mounts. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
-    def path
-      @attributes[:path]
+    # string - How this automation is triggered to run.
+    def trigger
+      @attributes[:trigger]
     end
 
-    def path=(value)
-      @attributes[:path] = value
+    def trigger=(value)
+      @attributes[:trigger] = value
     end
 
     # int64 - User ID of the Automation's creator.
@@ -162,15 +198,6 @@ module Files
       @attributes[:user_id] = value
     end
 
-    # array - IDs of remote sync folder behaviors to run by this Automation
-    def sync_ids
-      @attributes[:sync_ids]
-    end
-
-    def sync_ids=(value)
-      @attributes[:sync_ids] = value
-    end
-
     # array - IDs of Users for the Automation (i.e. who to Request File from)
     def user_ids
       @attributes[:user_ids]
@@ -180,13 +207,13 @@ module Files
       @attributes[:user_ids] = value
     end
 
-    # array - IDs of Groups for the Automation (i.e. who to Request File from)
-    def group_ids
-      @attributes[:group_ids]
+    # object - A Hash of attributes specific to the automation type.
+    def value
+      @attributes[:value]
     end
 
-    def group_ids=(value)
-      @attributes[:group_ids] = value
+    def value=(value)
+      @attributes[:value] = value
     end
 
     # string - If trigger is `webhook`, this is the URL of the webhook to trigger the Automation.
@@ -198,24 +225,6 @@ module Files
       @attributes[:webhook_url] = value
     end
 
-    # array - If trigger is `action`, this is the list of action types on which to trigger the automation. Valid actions are create, read, update, destroy, move, copy
-    def trigger_actions
-      @attributes[:trigger_actions]
-    end
-
-    def trigger_actions=(value)
-      @attributes[:trigger_actions] = value
-    end
-
-    # object - A Hash of attributes specific to the automation type.
-    def value
-      @attributes[:value]
-    end
-
-    def value=(value)
-      @attributes[:value] = value
-    end
-
     # string - DEPRECATED: Destination Path. Use `destinations` instead.
     def destination
       @attributes[:destination]
@@ -248,6 +257,7 @@ module Files
     #   user_ids - string - A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.
     #   group_ids - string - A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.
     #   schedule - object - Custom schedule for running this automation.
+    #   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
     #   description - string - Description for the this Automation.
     #   disabled - boolean - If true, this automation will not run.
     #   name - string - Name for this automation.
@@ -365,6 +375,7 @@ module Files
     #   user_ids - string - A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.
     #   group_ids - string - A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.
     #   schedule - object - Custom schedule for running this automation.
+    #   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
     #   description - string - Description for the this Automation.
     #   disabled - boolean - If true, this automation will not run.
     #   name - string - Name for this automation.
@@ -421,6 +432,7 @@ module Files
     #   user_ids - string - A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.
     #   group_ids - string - A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.
     #   schedule - object - Custom schedule for running this automation.
+    #   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
     #   description - string - Description for the this Automation.
     #   disabled - boolean - If true, this automation will not run.
     #   name - string - Name for this automation.

data/lib/files.com/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.7
+  version: 1.1.8
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-12-19 00:00:00.000000000 Z
+date: 2023-12-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable