files.com 1.1.129 → 1.1.131

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c960b9d5d4b80d65f84c05f3354cab4788805a81e360747b57d717ff4c54cba
-  data.tar.gz: 6a0ebb8cd98134f2e5c0585f6aa22967dcdb913a25b9ffc8ff58ffd23cfe1c5c
+  metadata.gz: 87b62527b02e1b2c1bf9a3ef13de4d0ee943a324006aa9d9cd0cca31cfbef3e2
+  data.tar.gz: 203318579966bd24bb678fc8f8f8d96770b6510dea43ce0183a141fb88132830
 SHA512:
-  metadata.gz: d61d61aad27a0451446182948ff03fb111a65e4742652c3b59abd09a51786a888247c4c0ea826b3e2948539732664a9cc740dfc2af1bdf6d3a7afe2ed77c73d9
-  data.tar.gz: 75589ac8a351977f6a7ca868b5bdf53848ffb1b418d4847411aa94e03e413cf3cfb58c570925e3f2f7830e7254464e7cb5af34c62954bc128d8a128977498f9a
+  metadata.gz: 946fef63c7906b1455e9ede3f3582701c0663de3a52b37315c113efc900ca8acb7bc3aace91e6484e65ade5ddf71aeb66191c673f58e9b2b608c67d6c545c76a
+  data.tar.gz: eb645b1e5877752256ba09da1fd0697b5496869aad336efe00d3c163aff4e5687afd2b76ae361cd2237fefe92c2a99d20a764064c7a0cdc8158e9bceea4b38ed

data/README.md

@@ -192,6 +192,93 @@ Maximum number of retries. The default value is 3.
 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.
+
+### Sorting
+
+The returned data can be sorted by passing 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 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.
+
+```ruby title="Sort Example"
+## users sorted by username
+Files.api_key = 'YOUR_API_KEY'
+Files::User.list(
+  sort_by: { "username": "asc"}
+)
+```
+
+```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"}
+)
+```
+
+```ruby title="Range Filter Example"
+#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"}
+)
+```
+
+```ruby title="Pattern Filter Example"
+## users who usernames start with 'test'
+Files.api_key = 'YOUR_API_KEY'
+Files::User.list(
+  filter_pre: { username: "test" },
+  sort_by: { "username": "asc"}
+)
+```
+
+```ruby title="Combined Filter Example"
+## users who usernames start with 'test' and are not admins
+Files.api_key = 'YOUR_API_KEY'
+Files::User.list(
+  filter_prefix: { username: "test" },
+  filter: { not_site_admin: true },
+  sort_by: { "username": "asc"}
+)
+```
+
 ## 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.129
+1.1.131

data/docs/site.md

@@ -4,6 +4,7 @@
 
 ```
 {
+  "id": 1,
   "name": "My Site",
   "additional_text_file_types": [
     "example"
@@ -285,6 +286,7 @@
 }
 ```
 
+* `id` (int64): Site Id
 * `name` (string): Site name
 * `additional_text_file_types` (array(string)): Additional extensions that are considered text files
 * `allowed_2fa_method_sms` (boolean): Is SMS two factor authentication allowed?

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

@@ -9,6 +9,11 @@ module Files
       @options = options || {}
     end
 
+    # int64 - Site Id
+    def id
+      @attributes[:id]
+    end
+
     # string - Site name
     def name
       @attributes[:name]

data/lib/files.com/version.rb

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

metadata

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