files.com 1.1.145 → 1.1.147

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48a67977717160ed7edefa9d5c8aceaacaaaf4183cc2e8b8b8c4e41d90b0d7be
-  data.tar.gz: 1ad58a2179e6a2fe80e3bbcb88f276318053826ddb7047c9d4a3e8b12d65f204
+  metadata.gz: bb798851ff19d0a3d0d0edca0d08bc4a8c4e110df74f55cb99a7000195abafc7
+  data.tar.gz: ef479ae58069b1edc3d6013e54051e4c7355ed9fb83a7b69dbda25057a621e07
 SHA512:
-  metadata.gz: 38cfe883d23ad8ec09fc52a3f510b248f5a3883fd43ce6c4b12c99c1016933181154f2c868f1d7dac72d168ba6c70a2ee5fdbc690e9a1f2c5f55bbf0916527f0
-  data.tar.gz: 17aae1b8b1f354ec59f657c17c1c4ebf53ed3f47cf908c08a4463932ea5d695afca06f04c15ee376732d62b8a01b9d3abf9213379af1611de7cbe2e2992b7300
+  metadata.gz: 5b3d99aad929ef1185dc3461c5394a1af82a8c12ff29df98ad964a8902e98df6b590a8b9ea5a6d25427f451cb2020b8d6e64b7234a91ed8e49567b0cd3e5d4f2
+  data.tar.gz: f49779d948ad5ae25f774ec4d24ae6f37b96b415fefc0dc178cb2e49f0869d2476b8c0bf81193a82e0640685d19b8ef389a86d76ff6cb07cb6bde7a74d2baff1

data/README.md

@@ -194,45 +194,18 @@ Files.max_network_retries = 5
 
 ## Sort and Filter
 
-Several of the Files.com API resources have list operations that return multiple instances of the resource.  The List operations
-can be sorted and filtered.
+Several of the Files.com API resources have list operations that return multiple instances of the
+resource. The List operations can be sorted and filtered.
 
 ### Sorting
 
-The returned data can be sorted by passing in the ```sort_by``` method argument.
+To sort the returned data, pass in the ```sort_by``` method argument.
 
-The argument value is a Ruby hash that has a key of the resource field name to sort on and a value of either ```"asc"``` or ```"desc"``` to specify the sort order.
+Each resource supports a unique set of valid sort fields and can only be sorted by one field at a
+time.
 
-Each resource has a set of valid fields for sorting and can be sorted by one field at a time.
-
-### Filters
-
-Filters apply selection criteria to the underlying query that returns the results. Filters can be applied individually to select resource fields
-and/or in a combination with each other.  The results of applying filters and filter combinations can be sorted by a single field.
-
-The passed in argument value is a Ruby hash that has a key of the resource field name to filter on and a passed in value to use in the filter comparison.
-
-Each resource has their own set of valid filters and fields, valid combinations of filters, and sortable fields.
-
-#### Types of Filters
-
-##### Exact Filter
-
-`filter` - find resources that have an exact field value match to a passed in value. (i.e., FIELD_VALUE = PASS_IN_VALUE).
-
-#### Range Filters
-
-`filter_gt` - find resources that have a field value that is greater than the passed in value.  (i.e., FIELD_VALUE > PASS_IN_VALUE).
-
-`filter_gte` - find resources that have a field value that is greater than or equal to the passed in value.  (i.e., FIELD_VALUE >=  PASS_IN_VALUE).
-
-`filter_lt` - find resources that have a field value that is less than the passed in value.  (i.e., FIELD_VALUE < PASS_IN_VALUE).
-
-`filter_lte` - find resources that have a field value that is less than or equal to the passed in value.  (i.e., FIELD_VALUE \<= PASS_IN_VALUE).
-
-##### Pattern Filter
-
-`filter_prefix` - find resources where the specified field is prefixed by the supplied value. This is applicable to values that are strings.
+The argument value is a Ruby hash that has a key of the resource field name to sort on and a value
+of either ```"asc"``` or ```"desc"``` to specify the sort order.
 
 ```ruby title="Sort Example"
 ## users sorted by username
@@ -242,35 +215,55 @@ Files::User.list(
 )
 ```
 
+### Filtering
+
+Filters apply selection criteria to the underlying query that returns the results. They can be
+applied individually or combined with other filters, and the resulting data can be sorted by a
+single field.
+
+Each resource supports a unique set of valid filter fields, filter combinations, and combinations of
+filters and sort fields.
+
+The passed in argument value is a Ruby hash that has a key of the resource field name to filter on
+and a passed in value to use in the filter comparison.
+
+#### Filter Types
+
+| Filter | Type | Description |
+| --------- | --------- | --------- |
+| `filter` | Exact | Find resources that have an exact field value match to a passed in value. (i.e., FIELD_VALUE = PASS_IN_VALUE). |
+| `filter_prefix` | Pattern | Find resources where the specified field is prefixed by the supplied value. This is applicable to values that are strings. |
+| `filter_gt` | Range | Find resources that have a field value that is greater than the passed in value.  (i.e., FIELD_VALUE > PASS_IN_VALUE). |
+| `filter_gteq` | Range | Find resources that have a field value that is greater than or equal to the passed in value.  (i.e., FIELD_VALUE >=  PASS_IN_VALUE). |
+| `filter_lt` | Range | Find resources that have a field value that is less than the passed in value.  (i.e., FIELD_VALUE < PASS_IN_VALUE). |
+| `filter_lteq` | Range | Find resources that have a field value that is less than or equal to the passed in value.  (i.e., FIELD_VALUE \<= PASS_IN_VALUE). |
+
 ```ruby title="Exact Filter Example"
 ## non admin users
 Files.api_key = 'YOUR_API_KEY'
 Files::User.list(
-  filter: { not_site_admin: true },
-  sort_by: { "username": "asc"}
+  filter: { not_site_admin: true }
 )
 ```
 
 ```ruby title="Range Filter Example"
-#users who haven't logged in since 2024-01-01
+## users who haven't logged in since 2024-01-01
 Files.api_key = 'YOUR_API_KEY'
 Files::User.list(
-filter_gte: { "last_login_at": "2024-01-01" },
-  sort_by: { "last_login_at": "asc"}
+  filter_gteq: { "last_login_at": "2024-01-01" }
 )
 ```
 
 ```ruby title="Pattern Filter Example"
-## users who usernames start with 'test'
+## users whose usernames start with 'test'
 Files.api_key = 'YOUR_API_KEY'
 Files::User.list(
-  filter_pre: { username: "test" },
-  sort_by: { "username": "asc"}
+  filter_pre: { username: "test" }
 )
 ```
 
-```ruby title="Combined Filter Example"
-## users who usernames start with 'test' and are not admins
+```ruby title="Combination Filter with Sort Example"
+## users whose usernames start with 'test' and are not admins
 Files.api_key = 'YOUR_API_KEY'
 Files::User.list(
   filter_prefix: { username: "test" },

data/_VERSION

@@ -1 +1 @@
-1.1.145
+1.1.147

data/docs/permission.md

@@ -57,8 +57,8 @@ Files::Permission.list(
 
 ```
 Files::Permission.create(
+  path: "path", 
   group_id: 1, 
-  path: "example", 
   permission: "full", 
   recursive: true, 
   user_id: 1, 
@@ -68,9 +68,9 @@ Files::Permission.create(
 
 ### Parameters
 
+* `path` (string): Required - Folder path
 * `group_id` (int64): Group ID
-* `path` (string): Folder path
-* `permission` (string):  Permission type.  Can be `admin`, `full`, `readonly`, `writeonly`, `list`, or `history`
+* `permission` (string): Permission type.  Can be `admin`, `full`, `readonly`, `writeonly`, `list`, or `history`
 * `recursive` (boolean): Apply to subfolders recursively?
 * `user_id` (int64): User ID.  Provide `username` or `user_id`
 * `username` (string): User username.  Provide `username` or `user_id`

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

@@ -137,18 +137,19 @@ module Files
     end
 
     # Parameters:
+    #   path (required) - string - Folder path
     #   group_id - int64 - Group ID
-    #   path - string - Folder path
-    #   permission - string -  Permission type.  Can be `admin`, `full`, `readonly`, `writeonly`, `list`, or `history`
+    #   permission - string - Permission type.  Can be `admin`, `full`, `readonly`, `writeonly`, `list`, or `history`
     #   recursive - boolean - Apply to subfolders recursively?
     #   user_id - int64 - User ID.  Provide `username` or `user_id`
     #   username - string - User username.  Provide `username` or `user_id`
     def self.create(params = {}, options = {})
-      raise InvalidParameterError.new("Bad parameter: group_id must be an Integer") if params[:group_id] and !params[:group_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: group_id must be an Integer") if params[:group_id] and !params[:group_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: permission must be an String") if params[:permission] and !params[:permission].is_a?(String)
       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: username must be an String") if params[:username] and !params[:username].is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params[:path]
 
       response, options = Api.send_request("/permissions", :post, params, options)
       Permission.new(response.data, options)

data/lib/files.com/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.145
+  version: 1.1.147
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-05 00:00:00.000000000 Z
+date: 2024-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable