files.com 1.0.330 → 1.0.332

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50f2f62972d81d98a1f8c879bb98c00935b1c4d567204bd8c41d60d756fc2528
-  data.tar.gz: 3cfd3870990ab9187f16e3d2de978731f861a19323a7f29d8984dd761b72db29
+  metadata.gz: 13ad2522a4dd40214766647a047e44ef3b82f26e45615d66e712b3f62cdeb24a
+  data.tar.gz: 47929ef18498cb61f94c30cf47404465937f772eeedd6d7fcb8339f43e7152e9
 SHA512:
-  metadata.gz: 2c1a15034f1d723dce4e7d0a608af08ca0d91d72b0616f3cee6f17c2f30c75227be926fee94cc18100634f9c17c55da2d6784a2bd760d96e0811d7da7e37ec9d
-  data.tar.gz: d3a2b11e223d15e5709efd015e7a4c5f5386be6fe5e309d61c3d9837a4c3269ec433aeef7104c2e08b8999f98e68546b85e3c2afb14df8a2d51d93b455b592f7
+  metadata.gz: 9079993c64d759596c7c1881594e3df987df0cd428a66f569c3f6573a0b0425d33a7dfe9aa342a07b8ecc7aa942372555cd47f9eff3e137e2c781b8c03402e38
+  data.tar.gz: 0d6984671d22fc24708c47955218a33ba045f9e2968d8287e4b1b777c77c3d07b92c7b5a29614658ecb5b3f9fd493c221f54b64834eda98f4df9d4216842c5df

data/_VERSION

@@ -1 +1 @@
-1.0.330
+1.0.332

data/docs/file_upload_part.md

@@ -17,6 +17,7 @@
   "http_method": "PUT",
   "next_partsize": 1,
   "parallel_parts": true,
+  "retry_parts": true,
   "parameters": {
     "key": "example value"
   },
@@ -37,6 +38,7 @@
 * `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.
+* `retry_parts` (boolean): If `true`, parts may be retried. If `false`, a part cannot be retried and the upload should be restarted.
 * `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

data/docs/inbox_recipient.md

@@ -17,7 +17,6 @@
 * `note` (string): A note sent to the recipient with the inbox.
 * `recipient` (string): The recipient's email address.
 * `sent_at` (date-time): When the Inbox was shared with this recipient.
-* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `inbox_id` (int64): Inbox to share.
 * `share_after_create` (boolean): Set to true to share the link with the recipient upon creation.
 
@@ -28,7 +27,6 @@
 
 ```
 Files::InboxRecipient.list(
-  user_id: 1, 
   per_page: 1, 
   inbox_id: 1
 )
@@ -36,7 +34,6 @@ Files::InboxRecipient.list(
 
 ### Parameters
 
-* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction (e.g. `sort_by[has_registrations]=desc`). Valid fields are `has_registrations`.
@@ -50,7 +47,6 @@ Files::InboxRecipient.list(
 
 ```
 Files::InboxRecipient.create(
-  user_id: 1, 
   inbox_id: 1, 
   recipient: "johndoe@gmail.com", 
   name: "John Smith", 
@@ -62,7 +58,6 @@ Files::InboxRecipient.create(
 
 ### Parameters
 
-* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `inbox_id` (int64): Required - Inbox to share.
 * `recipient` (string): Required - Email address to share this inbox with.
 * `name` (string): Name of recipient.

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

@@ -54,6 +54,11 @@ module Files
       @attributes[:parallel_parts]
     end
 
+    # boolean - If `true`, parts may be retried. If `false`, a part cannot be retried and the upload should be restarted.
+    def retry_parts
+      @attributes[:retry_parts]
+    end
+
     # object - Additional HTTP parameters to send with the upload
     def parameters
       @attributes[:parameters]

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

@@ -54,15 +54,6 @@ module Files
       @attributes[:sent_at] = value
     end
 
-    # int64 - User ID.  Provide a value of `0` to operate the current session's user.
-    def user_id
-      @attributes[:user_id]
-    end
-
-    def user_id=(value)
-      @attributes[:user_id] = value
-    end
-
     # int64 - Inbox to share.
     def inbox_id
       @attributes[:inbox_id]
@@ -91,14 +82,12 @@ module Files
     end
 
     # Parameters:
-    #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction (e.g. `sort_by[has_registrations]=desc`). Valid fields are `has_registrations`.
     #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `has_registrations`.
     #   inbox_id (required) - int64 - List recipients for the inbox with this ID.
     def self.list(params = {}, options = {})
-      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: 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)
       raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if params[:sort_by] and !params[:sort_by].is_a?(Hash)
@@ -116,7 +105,6 @@ module Files
     end
 
     # Parameters:
-    #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
     #   inbox_id (required) - int64 - Inbox to share.
     #   recipient (required) - string - Email address to share this inbox with.
     #   name - string - Name of recipient.
@@ -124,7 +112,6 @@ module Files
     #   note - string - Note to include in email.
     #   share_after_create - boolean - Set to true to share the link with the recipient upon creation.
     def self.create(params = {}, options = {})
-      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: inbox_id must be an Integer") if params[:inbox_id] and !params[:inbox_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: recipient must be an String") if params[:recipient] and !params[:recipient].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: name must be an String") if params[:name] and !params[:name].is_a?(String)

data/lib/files.com/path_util.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Files
+  module PathUtil
+    TRANSLIT_MAP = "ÀA,ÁA,ÂA,ÃA,ÄA,ÅA,ÆAE,ÇC,ÈE,ÉE,ÊE,ËE,ÌI,ÍI,ÎI,ÏI,ÐD,ÑN,ÒO,ÓO,ÔO,ÕO,ÖO,ØO,ÙU,ÚU,ÛU,ÜU,ÝY,ßss,àa,áa,âa,ãa,äa,åa,æae,çc,èe,ée,êe,ëe,ìi,íi,îi,ïi,ðd,ñn,òo,óo,ôo,õo,öo,øo,ùu,úu,ûu,üu,ýy,ÿy,ĀA,āa,ĂA,ăa,ĄA,ąa,ĆC,ćc,ĈC,ĉc,ĊC,ċc,ČC,čc,ĎD,ďd,ĐD,đd,ĒE,ēe,ĔE,ĕe,ĖE,ėe,ĘE,ęe,ĚE,ěe,ĜG,ĝg,ĞG,ğg,ĠG,ġg,ĢG,ģg,ĤH,ĥh,ĦH,ħh,ĨI,ĩi,ĪI,īi,ĬI,ĭi,ĮI,įi,İI,IJIJ,ijij,ĴJ,ĵj,ĶK,ķk,ĹL,ĺl,ĻL,ļl,ĽL,ľl,ŁL,łl,ŃN,ńn,ŅN,ņn,ŇN,ňn,ʼn'n,ŌO,ōo,ŎO,ŏo,ŐO,őo,ŒOE,œoe,ŔR,ŕr,ŖR,ŗr,ŘR,řr,ŚS,śs,ŜS,ŝs,ŞS,şs,ŠS,šs,ŢT,ţt,ŤT,ťt,ŨU,ũu,ŪU,ūu,ŬU,ŭu,ŮU,ůu,ŰU,űu,ŲU,ųu,ŴW,ŵw,ŶY,ŷy,ŸY,ŹZ,źz,ŻZ,żz,ŽZ,žz".split(",").to_h { |val| [ val[0], val[1..2] ] }.freeze
+
+    def self.normalize_for_comparison(*args)
+      unicode_normalize_and_transliterate(normalize(*args).to_s).downcase.rstrip
+    end
+
+    def self.same?(a, b)
+      normalize_for_comparison(a) == normalize_for_comparison(b)
+    end
+
+    def self.cleanpath(path)
+      new_path = Pathname.new(path).cleanpath.to_s
+
+      return "" if [ ".", ".." ].include? new_path
+      return new_path[1..] if new_path.index('/') == 0
+
+      new_path
+    end
+
+    private_class_method def self.normalize(*paths)
+      all_paths = paths.flatten.compact.map { |path| u8(path).gsub("\x00", "").gsub("\\", "/").split("/") }.flatten
+      all_paths.map { |path| cleanpath(path) }.reject(&:empty?).join("/")
+    end
+
+    private_class_method def self.u8(str)
+      new_string = begin
+        str.encode("UTF-8")
+      rescue Encoding::UndefinedConversionError
+        str.dup.force_encoding("UTF-8")
+      end
+
+      if new_string.valid_encoding?
+        new_string
+      else
+        new_string.force_encoding("ISO-8859-1").encode("UTF-8")
+      end
+    end
+
+    private_class_method def self.unicode_normalize_and_transliterate(string)
+      # convert multi-code-point characters into single-code-point characters
+      normalized_string = string.unicode_normalize(:nfkc)
+
+      normalized_string.gsub(/[^\x00-\x7f]/u) do |char|
+        TRANSLIT_MAP[char] || char
+      end
+    end
+  end
+end

data/lib/files.com.rb

@@ -30,6 +30,7 @@ require "files.com/system_profiler"
 require "files.com/util"
 require "files.com/list"
 require "files.com/uri"
+require "files.com/path_util"
 
 require "files.com/models/account_line_item"
 require "files.com/models/action"

data/shared/normalization_for_comparison_test_data.json

@@ -0,0 +1,38 @@
+[
+  [ "filename.txt", "filename.txt" ],
+  [ "FiLeNaMe.TxT", "filename.txt" ],
+  [ "FILENAME.TXT", "filename.txt" ],
+  [ "FÎŁĘÑÂMÉ.TXT", "filename.txt" ],
+  [ "Fïłèńämê.Txt", "filename.txt" ],
+  [ "a/b/c.txt", "a/b/c.txt" ],
+  [ "A\\B\\C.TXT", "a/b/c.txt" ],
+  [ "A/B\\C.TXT", "a/b/c.txt" ],
+  [ "//a/b//c.txt", "a/b/c.txt" ],
+  [ "a/b/c.txt  ", "a/b/c.txt" ],
+  [ "a/b/c.txt\t", "a/b/c.txt" ],
+  [ "a/b/c.txt\n", "a/b/c.txt" ],
+  [ "a/b/c.txt\r", "a/b/c.txt" ],
+  [ " space_at_beginning", " space_at_beginning"],
+  [ "space_at_end ", "space_at_end"],
+  [ "tab\tseperated", "tab\tseperated"],
+  [ "<title>hello</hello>", "<title>hello</hello>"],
+  [ "안녕하세요", "안녕하세요" ],
+  [ "こんにちは", "こんにちは" ],
+  [ "今日は", "今日は" ],
+  [ "longest_unicode_character_﷽", "longest_unicode_character_﷽"],
+  [ "invalid_null_byte_before\u0000after", "invalid_null_byte_beforeafter" ],
+  [ "a/b/c/../../hello", "a/b/c/hello" ],
+  [ "a/b/c/././hello", "a/b/c/hello" ],
+  [ "one_code_point_ą", "one_code_point_a" ],
+  [ "two_code_points_ą", "two_code_points_a" ],
+  [ "one_code_point_훯", "one_code_point_훯"],
+  [ "three_code_points_훯", "three_code_points_훯" ],
+  [ "ÞþŊŋŦŧ", "þþŋŋŧŧ" ],
+  [ "ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝßàáâãäåæçèéêëìíîïðñòóôõöøùúûüýÿ", "aaaaaaaeceeeeiiiidnoooooouuuuyssaaaaaaaeceeeeiiiidnoooooouuuuyy" ],
+  [ "ĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİIJij", "aaaaaaccccccccddddeeeeeeeeeegggggggghhhhiiiiiiiiiijij" ],
+  [ "ĴĵĶķĹĺĻļĽľŁłŃńŅņŇňʼnŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤť", "jjkkllllllllnnnnnnʼnoooooooeoerrrrrrsssssssstttt" ],
+  [ "ŨũŪūŬŭŮůŰűŲųŴŵŶŷŸŹźŻżŽž", "uuuuuuuuuuuuwwyyyzzzzzz" ],
+  [ "😂❤️😍🤣😊🙏💕😭😘👍😅👏😁♥️🔥💔💖💙😢🤔😆🙄💪😉☺️👌🤗", "😂❤️😍🤣😊🙏💕😭😘👍😅👏😁♥️🔥💔💖💙😢🤔😆🙄💪😉☺️👌🤗" ],
+  [ "💜😔😎😇🌹🤦🎉💞✌️✨🤷😱😌🌸🙌😋💗💚😏💛🙂💓🤩😄😀🖤😃💯🙈👇🎶😒🤭❣️", "💜😔😎😇🌹🤦🎉💞✌️✨🤷😱😌🌸🙌😋💗💚😏💛🙂💓🤩😄😀🖤😃💯🙈👇🎶😒🤭❣️" ],
+  [ "emoji_‼️", "emoji_!!️" ]
+]

data/spec/path_util_spec.rb

@@ -0,0 +1,14 @@
+require "spec_helper"
+require 'json'
+
+RSpec.describe Files::PathUtil do
+  json_str = File.read("shared/normalization_for_comparison_test_data.json")
+  test_cases = JSON.parse json_str
+
+  test_cases.each do |test_case_info|
+    src_chars, dst_chars = test_case_info
+    example "normalizes #{src_chars} to #{dst_chars}" do
+      expect(Files::PathUtil.same?(src_chars, dst_chars)).to eq(true)
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.0.330
+  version: 1.0.332
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-16 00:00:00.000000000 Z
+date: 2023-03-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -277,15 +277,18 @@ files:
 - lib/files.com/models/user_cipher_use.rb
 - lib/files.com/models/user_request.rb
 - lib/files.com/models/webhook_test.rb
+- lib/files.com/path_util.rb
 - 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
+- shared/normalization_for_comparison_test_data.json
 - spec/list_spec.rb
 - spec/models/file_spec.rb
 - spec/models/folder_spec.rb
+- spec/path_util_spec.rb
 - spec/spec_helper.rb
 - spec/uri_spec.rb
 - test.sh