files.com 1.0.106 → 1.0.111

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 32131f5bd3bf8f5002f21ab2ad489b1ccf93bc1fcb7c42427ea5c18f83af9977
-  data.tar.gz: 797cf35c63d959a478f124ff84d5f3cdef1d1c1a0d1098cc2d201cc8950ec1c8
+  metadata.gz: 225dfeba48af26960bc78d58fcc6582130528647e1f4f8cbe46883f79a24cc78
+  data.tar.gz: e432cdc6416e3ff8f24911833c33f244dc6d3c030db9a1ea1d517ab4e7038098
 SHA512:
-  metadata.gz: 0b0ec308bc1cfd10683b7fd92796eb4bc686de078b364dcb819f2531b9850b120a2721da2e49e97949b424c2648b131f83195358e404ff98bb814594193bca4f
-  data.tar.gz: 4c57b09e30babaeeada3e8d08f9904dbcf17b4fe22ed9be57285e8f7cde9d2142e551b61c87f9feb955269c144989eac1d16660919ea95b47dacbba639f681ff
+  metadata.gz: ca79ab1f63905d8a1d91ebf3a4c620ec0d1f10024b6786162e6735266a1dc2c548bde72461f7ec2e653dd5bab918505b3b6bd99ed887c3152ae76d252fc55919
+  data.tar.gz: 067e4d6f28a7ecfdd71b327e026a6414988384639af8546dcc8dd0a52da280be8ded9af59b6146d99f43c3d6bd6a9ae832c4eef7af344bfb3cddeeedc6971c89

data/_VERSION

@@ -1 +1 @@
-1.0.106
+1.0.111

data/docs/app.md

@@ -9,6 +9,7 @@
   "documentation_links": "Important Info => http://files.test/learn-more",
   "icon_url": "",
   "logo_url": "",
+  "screenshot_list_urls": "",
   "logo_thumbnail_url": "",
   "sso_strategy_type": "",
   "remote_server_type": "",
@@ -24,6 +25,7 @@
 * `documentation_links` (string): Collection of named links to documentation
 * `icon_url` (string): App icon
 * `logo_url` (string): Full size logo for the App
+* `screenshot_list_urls` (string): Screenshots of the App
 * `logo_thumbnail_url` (string): Logo thumbnail for the App
 * `sso_strategy_type` (string): Associated SSO Strategy type, if any
 * `remote_server_type` (string): Associated Remote Server type, if any

data/docs/file.md

@@ -7,7 +7,6 @@ may places where a Ruby File object can be used.
 
 ```
 {
-  "id": 1,
   "path": "path/file.txt",
   "display_name": "file.txt",
   "type": "file",
@@ -27,7 +26,6 @@ may places where a Ruby File object can be used.
 }
 ```
 
-* `id` (int64): File/Folder ID
 * `path` (string): File/Folder path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `display_name` (string): File/Folder display name
 * `type` (string): Type: `directory` or `file`.

data/docs/file_upload_part.md

@@ -0,0 +1,39 @@
+# FileUploadPart
+
+## Example FileUploadPart Object
+
+```
+{
+  "send": "",
+  "action": "multipart",
+  "ask_about_overwrites": true,
+  "available_parts": 1,
+  "expires": "",
+  "headers": "",
+  "http_method": "PUT",
+  "next_partsize": 1,
+  "parallel_parts": true,
+  "parameters": "{}",
+  "part_number": 1,
+  "partsize": 1,
+  "path": "",
+  "ref": "upload-1",
+  "upload_uri": ""
+}
+```
+
+* `send` (object): Content-Type and File to send
+* `action` (string): Type of upload
+* `ask_about_overwrites` (boolean): If `true`, this file exists and you may wish to ask the user for overwrite confirmation
+* `available_parts` (int64): Number of parts in the upload
+* `expires` (string): Date/time of when this Upload part expires and the URL cannot be used any more
+* `headers` (object): Additional upload headers to provide as part of the upload
+* `http_method` (string): HTTP Method to use for uploading the part, usually `PUT`
+* `next_partsize` (int64): Size in bytes for this part
+* `parallel_parts` (boolean): If `true`, multiple parts may be uploaded in parallel.  If `false`, be sure to only upload one part at a time, in order.
+* `parameters` (object): Additional HTTP parameters to send with the upload
+* `part_number` (int64): Number of this upload part
+* `partsize` (int64): Size in bytes for the next upload part
+* `path` (string): New file path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+* `ref` (string): Reference name for this upload part
+* `upload_uri` (string): URI to upload this part to

data/docs/folder.md

@@ -9,7 +9,6 @@ Files::Dir is an alias of Files::Folder
 
 ```
 {
-  "id": 1,
   "path": "path/file.txt",
   "display_name": "file.txt",
   "type": "file",
@@ -29,7 +28,6 @@ Files::Dir is an alias of Files::Folder
 }
 ```
 
-* `id` (int64): File/Folder ID
 * `path` (string): File/Folder path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `display_name` (string): File/Folder display name
 * `type` (string): Type: `directory` or `file`.

data/docs/sso_strategy.md

@@ -13,6 +13,7 @@
   "id": 1,
   "saml_provider_cert_fingerprint": "",
   "saml_provider_issuer_url": "",
+  "saml_provider_metadata_content": "",
   "saml_provider_metadata_url": "",
   "saml_provider_slo_target_url": "",
   "saml_provider_sso_target_url": "",
@@ -53,6 +54,7 @@
 * `id` (int64): ID
 * `saml_provider_cert_fingerprint` (string): Identity provider sha256 cert fingerprint if saml_provider_metadata_url is not available.
 * `saml_provider_issuer_url` (string): Identity provider issuer url
+* `saml_provider_metadata_content` (string): Custom identity provider metadata
 * `saml_provider_metadata_url` (string): Metadata URL for the SAML identity provider
 * `saml_provider_slo_target_url` (string): Identity provider SLO endpoint
 * `saml_provider_sso_target_url` (string): Identity provider SSO endpoint if saml_provider_metadata_url is not available.

data/lib/files.com.rb

@@ -25,6 +25,7 @@ require "files.com/response"
 require "files.com/system_profiler"
 require "files.com/util"
 require "files.com/list"
+require "files.com/uri"
 
 require "files.com/models/account_line_item"
 require "files.com/models/action"
@@ -46,7 +47,7 @@ require "files.com/models/file"
 require "files.com/models/file_action"
 require "files.com/models/file_comment"
 require "files.com/models/file_comment_reaction"
-require "files.com/models/file_part_upload"
+require "files.com/models/file_upload_part"
 require "files.com/models/folder"
 require "files.com/models/group"
 require "files.com/models/group_user"

data/lib/files.com/api_client.rb

@@ -170,7 +170,12 @@ module Files
     end
 
     private def api_url(url = "", base_url = nil)
-      Addressable::URI.parse((base_url || Files.base_url) + "/api/rest/v1" + url).normalize!.to_s
+      uri        = Addressable::URI.new
+      uri.host   = Addressable::URI.parse(base_url).host
+      uri.path   = "/api/rest/v1" + Files::URI.normalized_path(url)
+      uri.scheme = Addressable::URI.parse(base_url).scheme
+
+      uri.to_s
     end
 
     private def check_api_key!(api_key)

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

@@ -34,6 +34,11 @@ module Files
       @attributes[:logo_url]
     end
 
+    # string - Screenshots of the App
+    def screenshot_list_urls
+      @attributes[:screenshot_list_urls]
+    end
+
     # string - Logo thumbnail for the App
     def logo_thumbnail_url
       @attributes[:logo_thumbnail_url]

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

@@ -588,15 +588,6 @@ module Files
       @write_io.write_nonblock *args
     end
 
-    # int64 - File/Folder ID
-    def id
-      @attributes[:id]
-    end
-
-    def id=(value)
-      @attributes[:id] = value
-    end
-
     # string - File/Folder path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
     def path
       @attributes[:path]

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

@@ -119,7 +119,7 @@ module Files
 
       response, options = Api.send_request("/file_actions/begin_upload/#{params[:path]}", :post, params, options)
       response.data.map do |entity_data|
-        FilePartUpload.new(entity_data, options)
+        FileUploadPart.new(entity_data, options)
       end
     end
   end

data/lib/files.com/models/{file_part_upload.rb → file_upload_part.rb}

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Files
-  class FilePartUpload
+  class FileUploadPart
     attr_reader :options, :attributes
 
     def initialize(attributes = {}, options = {})
@@ -19,57 +19,57 @@ module Files
       @attributes[:action]
     end
 
-    # boolean - If false, rename conflicting files instead of asking for overwrite confirmation
+    # boolean - If `true`, this file exists and you may wish to ask the user for overwrite confirmation
     def ask_about_overwrites
       @attributes[:ask_about_overwrites]
     end
 
-    # string - Currently unused
+    # int64 - Number of parts in the upload
     def available_parts
       @attributes[:available_parts]
     end
 
-    # string - Currently unused
+    # string - Date/time of when this Upload part expires and the URL cannot be used any more
     def expires
       @attributes[:expires]
     end
 
-    # object - Additional upload headers
+    # object - Additional upload headers to provide as part of the upload
     def headers
       @attributes[:headers]
     end
 
-    # string - Upload method, usually POST
+    # string - HTTP Method to use for uploading the part, usually `PUT`
     def http_method
       @attributes[:http_method]
     end
 
-    # string - Currently unused
+    # int64 - Size in bytes for this part
     def next_partsize
       @attributes[:next_partsize]
     end
 
-    # boolean - If true, parts may be uploaded in parallel
+    # boolean - If `true`, multiple parts may be uploaded in parallel.  If `false`, be sure to only upload one part at a time, in order.
     def parallel_parts
       @attributes[:parallel_parts]
     end
 
-    # string - Additional upload parameters
+    # object - Additional HTTP parameters to send with the upload
     def parameters
       @attributes[:parameters]
     end
 
-    # string - Currently unused
+    # int64 - Number of this upload part
     def part_number
       @attributes[:part_number]
     end
 
-    # string - Currently unused
+    # int64 - Size in bytes for the next upload part
     def partsize
       @attributes[:partsize]
     end
 
-    # string - Upload path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+    # string - New file 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

@@ -150,15 +150,6 @@ module Files
       path
     end
 
-    # int64 - File/Folder ID
-    def id
-      @attributes[:id]
-    end
-
-    def id=(value)
-      @attributes[:id] = value
-    end
-
     # string - File/Folder path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
     def path
       @attributes[:path]

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

@@ -44,6 +44,11 @@ module Files
       @attributes[:saml_provider_issuer_url]
     end
 
+    # string - Custom identity provider metadata
+    def saml_provider_metadata_content
+      @attributes[:saml_provider_metadata_content]
+    end
+
     # string - Metadata URL for the SAML identity provider
     def saml_provider_metadata_url
       @attributes[:saml_provider_metadata_url]

data/lib/files.com/uri.rb

@@ -0,0 +1,70 @@
+module Files
+  module URI
+    # This is a copy of Addressable::URI.normalize_component without Addressable::IDNA.unicode_normalize_kc.
+    def self.normalize_component(component, character_class =
+        Addressable::URI::CharacterClasses::RESERVED + Addressable::URI::CharacterClasses::UNRESERVED,
+                                 leave_encoded = '')
+      return nil if component.nil?
+
+      unless component.is_a? String
+        begin
+          component = component.to_str
+        rescue NoMethodError, TypeError
+          raise TypeError, "Can't convert #{component.class} into String."
+        end
+      end
+
+      unless [ String, Regexp ].include?(character_class.class)
+        raise TypeError,
+              "Expected String or Regexp, got #{character_class.inspect}"
+      end
+      if character_class.is_a?(String)
+        leave_re = unless leave_encoded.empty?
+                     character_class = "#{character_class}%" unless character_class.include?('%')
+
+                     "|%(?!#{leave_encoded.chars.map do |char|
+                       seq = SEQUENCE_ENCODING_TABLE[char]
+                       [ seq.upcase, seq.downcase ]
+                     end.flatten.join('|')})"
+                   end
+
+        character_class = /[^#{character_class}]#{leave_re}/
+      end
+      # We can't perform regexps on invalid UTF sequences, but
+      # here we need to, so switch to ASCII.
+      component = component.dup
+      component.force_encoding(Encoding::ASCII_8BIT)
+      unencoded = Addressable::URI.unencode_component(component, String, leave_encoded)
+      begin
+        encoded = Addressable::URI.encode_component(
+          # Addressable::IDNA.unicode_normalize_kc(unencoded),
+          unencoded,
+          character_class,
+          leave_encoded
+        )
+      rescue ArgumentError
+        encoded = encode_component(unencoded)
+      end
+      encoded.force_encoding(Encoding::UTF_8)
+      encoded
+    end
+
+    def self.normalized_path(path)
+      if path =~ Addressable::URI::NORMPATH
+        # Relative paths with colons in the first segment are ambiguous.
+        path = path.sub(":", "%2F")
+      end
+      # String#split(delimeter, -1) uses the more strict splitting behavior
+      # found by default in Python.
+      result = path.strip.split(Addressable::URI::SLASH, -1).map do |segment|
+        normalize_component(
+          segment,
+          Addressable::URI::CharacterClasses::PCHAR
+        )
+      end.join(Addressable::URI::SLASH)
+
+      # All normalized values should be UTF-8
+      result.force_encoding(Encoding::UTF_8)
+    end
+  end
+end

data/spec/uri_spec.rb

@@ -0,0 +1,11 @@
+require "spec_helper"
+
+RSpec.describe Files::URI do
+  describe "normalized_path" do
+    it { expect(described_class.normalized_path("[[strange stuff]]#yes.text")).to eq("%5B%5Bstrange%20stuff%5D%5D%23yes.text") }
+    it { expect(Addressable::URI.unencode_component(described_class.normalized_path("[[strange stuff]]#yes.text"))).to eq("[[strange stuff]]#yes.text") }
+
+    it { expect(described_class.normalized_path("folder/AdÇe")).to eq("folder/AdC%CC%A7e") }
+    it { expect(Addressable::URI.unencode_component(described_class.normalized_path("AdÇe"))).to eq("AdÇe") }
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.0.106
+  version: 1.0.111
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-08-20 00:00:00.000000000 Z
+date: 2020-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -105,7 +105,7 @@ files:
 - docs/file_action.md
 - docs/file_comment.md
 - docs/file_comment_reaction.md
-- docs/file_part_upload.md
+- docs/file_upload_part.md
 - docs/file_utils.md
 - docs/folder.md
 - docs/group.md
@@ -170,7 +170,7 @@ files:
 - lib/files.com/models/file_action.rb
 - lib/files.com/models/file_comment.rb
 - lib/files.com/models/file_comment_reaction.rb
-- lib/files.com/models/file_part_upload.rb
+- lib/files.com/models/file_upload_part.rb
 - lib/files.com/models/file_utils.rb
 - lib/files.com/models/folder.rb
 - lib/files.com/models/group.rb
@@ -211,12 +211,14 @@ files:
 - lib/files.com/response.rb
 - lib/files.com/sizable_io.rb
 - lib/files.com/system_profiler.rb
+- lib/files.com/uri.rb
 - lib/files.com/util.rb
 - lib/files.com/version.rb
 - spec/list_spec.rb
 - spec/models/file_spec.rb
 - spec/models/folder_spec.rb
 - spec/spec_helper.rb
+- spec/uri_spec.rb
 - test.sh
 - test/test.rb
 homepage: https://www.files.com

data/docs/file_part_upload.md

@@ -1,39 +0,0 @@
-# FilePartUpload
-
-## Example FilePartUpload Object
-
-```
-{
-  "send": "",
-  "action": "upload/direct",
-  "ask_about_overwrites": true,
-  "available_parts": "",
-  "expires": "",
-  "headers": "",
-  "http_method": "POST",
-  "next_partsize": "",
-  "parallel_parts": true,
-  "parameters": "",
-  "part_number": "",
-  "partsize": "",
-  "path": "",
-  "ref": "upload-1",
-  "upload_uri": ""
-}
-```
-
-* `send` (object): Content-Type and File to send
-* `action` (string): Type of upload
-* `ask_about_overwrites` (boolean): If false, rename conflicting files instead of asking for overwrite confirmation
-* `available_parts` (string): Currently unused
-* `expires` (string): Currently unused
-* `headers` (object): Additional upload headers
-* `http_method` (string): Upload method, usually POST
-* `next_partsize` (string): Currently unused
-* `parallel_parts` (boolean): If true, parts may be uploaded in parallel
-* `parameters` (string): Additional upload parameters
-* `part_number` (string): Currently unused
-* `partsize` (string): Currently unused
-* `path` (string): Upload path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
-* `ref` (string): Reference name for this upload part
-* `upload_uri` (string): URI to upload this part to