files.com 1.0.341 → 1.0.343

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42facb096cac23769533241c08e783056751f132a0a1d5021da0e2f35f8d7d36
-  data.tar.gz: 3d160c69bcf1af9966be73e4f62706045af6fa903f948623b63354ddf3a73881
+  metadata.gz: c71156389e0b6234b60ed41cfb6a47c63d40733c7510e8ab5fb6aaf9b0994c24
+  data.tar.gz: 10b5604e99412b84b1011ceea259c14a111c4a5a6196430a4fce201ccbfaa1a8
 SHA512:
-  metadata.gz: 8092f446d0281ad11b4d6541d162dd06dcd9a7be8fb1ffcd7635c25b2617394cf3bad31c89471bbf4f9865369238857544245c3fbf517ce9b2a523bbef436dab
-  data.tar.gz: 9b89571030ea82226be5cf6e719c139a5cf9eaac1ec693b43b1c876ef1632bb21410fe80bc0fa8cbcdff20e135c93398c9a1b290905921f4992f2a7d26c5ad69
+  metadata.gz: 8a2746cc39fcf8518b8d3e5cdbda82ded80e1f0ac5bf130728c49e708bc4ca856cc2f39826f54c590f4702dd2c13ea991a5d00c08d24156bf673d180565ed1b2
+  data.tar.gz: d5851ae9f52779f23fd9e04a45ab22e8e890d05a145455cf450395ef8b1aa266a1f10466b6f226d3349e62d84a59aab31d1c50bd44656baf803f4c7a69545244

data/_VERSION

@@ -1 +1 @@
-1.0.341
+1.0.343

data/docs/behavior.md

@@ -17,7 +17,7 @@
 ```
 
 * `id` (int64): Folder behavior ID
-* `path` (string): Folder path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+* `path` (string): Folder path.  Note that Behavior paths cannot be updated once initially set.  You will need to remove and re-create the behavior on the new path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `attachment_url` (string): URL for attached file
 * `behavior` (string): Behavior type.
 * `name` (string): Name for this behavior.

data/docs/folder.md

@@ -75,7 +75,7 @@ Files::Folder.list_for(path,
 * `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header or the X-Files-Cursor-Prev header.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `path` (string): Required - Path to operate on.
-* `filter` (string): If specified, will filter folders/files list by this string.  Wildcards of `*` and `?` are acceptable here.
+* `filter` (string): If specified, will filter folders/files list by name. Ignores text before last `/`. Wildcards of `*` and `?` are acceptable here.
 * `preview_size` (string): Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
 * `sort_by` (object): Search by field and direction. Valid fields are `path`, `size`, `modified_at_datetime`, `provided_modified_at`.  Valid directions are `asc` and `desc`.  Defaults to `{"path":"asc"}`.
 * `search` (string): If `search_all` is `true`, provide the search string here.  Otherwise, this parameter acts like an alias of `filter`.

data/docs/snapshot.md

@@ -1,5 +1,22 @@
 # Snapshot
 
+## Example Snapshot Object
+
+```
+{
+  "expires_at": "2000-01-01T01:00:00Z",
+  "finalized_at": "2000-01-01T01:00:00Z",
+  "name": "My Snapshot",
+  "user_id": 1,
+  "bundle_id": 1
+}
+```
+
+* `expires_at` (date-time): When the snapshot expires.
+* `finalized_at` (date-time): When the snapshot was finalized.
+* `name` (string): A name for the snapshot.
+* `user_id` (int64): The user that created this snapshot, if applicable.
+* `bundle_id` (int64): The bundle using this snapshot, if applicable.
 * `id` (int64): Snapshot ID.
 
 

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

@@ -18,7 +18,7 @@ module Files
       @attributes[:id] = value
     end
 
-    # string - Folder path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+    # string - Folder path.  Note that Behavior paths cannot be updated once initially set.  You will need to remove and re-create the behavior on the new path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
     def path
       @attributes[:path]
     end

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

@@ -326,7 +326,7 @@ module Files
     #   cursor - string - Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header or the X-Files-Cursor-Prev header.
     #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
     #   path (required) - string - Path to operate on.
-    #   filter - string - If specified, will filter folders/files list by this string.  Wildcards of `*` and `?` are acceptable here.
+    #   filter - string - If specified, will filter folders/files list by name. Ignores text before last `/`. Wildcards of `*` and `?` are acceptable here.
     #   preview_size - string - Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
     #   sort_by - object - Search by field and direction. Valid fields are `path`, `size`, `modified_at_datetime`, `provided_modified_at`.  Valid directions are `asc` and `desc`.  Defaults to `{"path":"asc"}`.
     #   search - string - If `search_all` is `true`, provide the search string here.  Otherwise, this parameter acts like an alias of `filter`.

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

@@ -9,6 +9,51 @@ module Files
       @options = options || {}
     end
 
+    # date-time - When the snapshot expires.
+    def expires_at
+      @attributes[:expires_at]
+    end
+
+    def expires_at=(value)
+      @attributes[:expires_at] = value
+    end
+
+    # date-time - When the snapshot was finalized.
+    def finalized_at
+      @attributes[:finalized_at]
+    end
+
+    def finalized_at=(value)
+      @attributes[:finalized_at] = value
+    end
+
+    # string - A name for the snapshot.
+    def name
+      @attributes[:name]
+    end
+
+    def name=(value)
+      @attributes[:name] = value
+    end
+
+    # int64 - The user that created this snapshot, if applicable.
+    def user_id
+      @attributes[:user_id]
+    end
+
+    def user_id=(value)
+      @attributes[:user_id] = value
+    end
+
+    # int64 - The bundle using this snapshot, if applicable.
+    def bundle_id
+      @attributes[:bundle_id]
+    end
+
+    def bundle_id=(value)
+      @attributes[:bundle_id] = value
+    end
+
     # int64 - Snapshot ID.
     def id
       @attributes[:id]
@@ -58,8 +103,9 @@ module Files
       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)
 
-      response, _options = Api.send_request("/snapshots", :get, params, options)
-      response.data
+      List.new(Snapshot, params) do
+        Api.send_request("/snapshots", :get, params, options)
+      end
     end
 
     def self.all(params = {}, options = {})
@@ -74,8 +120,8 @@ module Files
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, _options = Api.send_request("/snapshots/#{params[:id]}", :get, params, options)
-      response.data
+      response, options = Api.send_request("/snapshots/#{params[:id]}", :get, params, options)
+      Snapshot.new(response.data, options)
     end
 
     def self.get(id, params = {}, options = {})
@@ -83,8 +129,8 @@ module Files
     end
 
     def self.create(params = {}, options = {})
-      response, _options = Api.send_request("/snapshots", :post, params, options)
-      response.data
+      response, options = Api.send_request("/snapshots", :post, params, options)
+      Snapshot.new(response.data, options)
     end
 
     def self.update(id, params = {}, options = {})
@@ -93,8 +139,8 @@ module Files
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, _options = Api.send_request("/snapshots/#{params[:id]}", :patch, params, options)
-      response.data
+      response, options = Api.send_request("/snapshots/#{params[:id]}", :patch, params, options)
+      Snapshot.new(response.data, options)
     end
 
     def self.delete(id, params = {}, options = {})

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.0.341
+  version: 1.0.343
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-24 00:00:00.000000000 Z
+date: 2023-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable