dropbox_api 0.1.18 → 0.1.21

data/lib/dropbox_api/metadata/search_order_by.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module DropboxApi::Metadata
+  class SearchOrderBy < DropboxApi::Metadata::Tag
+    VALID_VALUES = %i[
+      relevance
+      last_modified_time
+    ].freeze
+
+    def self.valid_values
+      VALID_VALUES
+    end
+  end
+end

data/lib/dropbox_api/metadata/shared_folder.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   # Example of a serialized {SharedFolder} object:
   #

data/lib/dropbox_api/metadata/shared_folder_policy.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   # Example of a serialized {SharedFolderPolicy} object:
   #

data/lib/dropbox_api/metadata/shared_link.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   class SharedLink < Base
     VALID_KEYS = [:url, :password]
@@ -6,7 +7,7 @@ module DropboxApi::Metadata
       @shared_link =
         case param
         when String
-          {:url => param}
+          {url: param}
         when Hash
           param
         end
@@ -16,7 +17,7 @@ module DropboxApi::Metadata
 
     def check_validity
       if @shared_link[:url].nil?
-        raise ArgumentError, "Missing `:url` option"
+        raise ArgumentError, 'Missing `:url` option'
       end
 
       @shared_link.keys.each do |key|

data/lib/dropbox_api/metadata/shared_link_metadata.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   # This class is used as an adapter so we can create an object of the pertinent
   # class when we need to infer the type from the data.
@@ -6,7 +7,7 @@ module DropboxApi::Metadata
   class SharedLinkMetadata
     class << self
       def new(data)
-        class_for(data[".tag"].to_sym).new(data)
+        class_for(data['.tag'].to_sym).new(data)
       end
 
       private

data/lib/dropbox_api/metadata/space_allocation.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   # Example of a serialized {SpaceAllocation} object:
   #

data/lib/dropbox_api/metadata/space_usage.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   # Example of a serialized {SpaceUsage} object:
   #

data/lib/dropbox_api/metadata/tag.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   class Tag < DropboxApi::Metadata::Base
     def self.new(data)
@@ -5,7 +6,7 @@ module DropboxApi::Metadata
       when ::Symbol
         validate(data)
       when Hash
-        new(data[".tag"].to_sym)
+        new(data['.tag'].to_sym)
       when String
         new(data.to_sym)
       else

data/lib/dropbox_api/metadata/team.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   class Team < Base
     field :id, String

data/lib/dropbox_api/metadata/team_member_info.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   # Example of a serialized {TeamMemberInfo} object:
   #

data/lib/dropbox_api/metadata/team_root_info.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+module DropboxApi::Metadata
+  class TeamRootInfo < Base
+    field :root_namespace_id, String
+    field :home_namespace_id, String
+    field :home_path, String
+  end
+end

data/lib/dropbox_api/metadata/thumbnail_batch_result_data.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   class ThumbnailBatchResultData < Base
     field :metadata, DropboxApi::Metadata::File

data/lib/dropbox_api/metadata/thumbnail_batch_result_entry.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   # This class is used as an adapter so we can create an object of the pertinent
   # class when we need to infer the type from the data.
@@ -9,11 +10,11 @@ module DropboxApi::Metadata
   class ThumbnailBatchResultEntry
     class << self
       def new(data)
-        case data[".tag"].to_sym
+        case data['.tag'].to_sym
         when :success
           DropboxApi::Metadata::ThumbnailBatchResultData.new(data)
         when :failure
-          DropboxApi::Errors::ThumbnailError.build("Thumbnail generation failed", data["failure"])
+          DropboxApi::Errors::ThumbnailError.build('Thumbnail generation failed', data['failure'])
         else
           raise NotImplementedError, "Unknown result type: #{data[".tag"]}"
         end

data/lib/dropbox_api/metadata/upload_session_cursor.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   # Example of a serialized {UploadSessionCursor} object:
   #

data/lib/dropbox_api/metadata/user_root_info.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+module DropboxApi::Metadata
+  class UserRootInfo < Base
+    field :root_namespace_id, String
+    field :home_namespace_id, String
+  end
+end

data/lib/dropbox_api/metadata/video_metadata.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   # Example of a serialized {MediaInfo} object:
   #

data/lib/dropbox_api/metadata/write_mode.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Metadata
   # Your intent when writing a file to some path. This is used to determine
   # what constitutes a conflict and what the autorename strategy is.
@@ -48,22 +49,22 @@ module DropboxApi::Metadata
         @write_mode = write_mode
       when String, ::Symbol
         @write_mode = {
-          ".tag" => write_mode
+          '.tag' => write_mode
         }
         @write_mode[write_mode.to_s] = options unless options.nil?
       end
-      @write_mode[".tag"] = @write_mode[".tag"].to_sym
+      @write_mode['.tag'] = @write_mode['.tag'].to_sym
 
       check_validity
     end
 
     def check_validity
-      unless valid_mode? @write_mode[".tag"]
+      unless valid_mode? @write_mode['.tag']
         raise ArgumentError, "Invalid write mode: #{@write_mode[".tag"]}"
       end
 
-      if @write_mode[".tag"] == :update && @write_mode["update"].nil?
-        raise ArgumentError, "Mode `:update` expects a `rev` number"
+      if @write_mode['.tag'] == :update && @write_mode['update'].nil?
+        raise ArgumentError, 'Mode `:update` expects a `rev` number'
       end
     end
 

data/lib/dropbox_api/middleware/decode_result.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::MiddleWare
   class DecodeResult < Faraday::Middleware
     def call(rq_env)
@@ -14,7 +15,7 @@ module DropboxApi::MiddleWare
       # Dropbox may send a response with the string 'null' in its body, this
       # would be a void result. `add_folder_member` is an example of an
       # endpoint without return values.
-      if json == "null"
+      if json == 'null'
         {}
       else
         JSON.parse json
@@ -22,5 +23,5 @@ module DropboxApi::MiddleWare
     end
   end
 
-  Faraday::Response.register_middleware :decode_result => DecodeResult
+  Faraday::Response.register_middleware decode_result: DecodeResult
 end

data/lib/dropbox_api/middleware/path_root.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+module DropboxApi::MiddleWare
+  class PathRoot < Faraday::Middleware
+    HEADER_NAME = 'Dropbox-API-Path-Root'
+
+    def initialize(app, options = {})
+      super(app)
+      @options = options
+    end
+
+    def namespace_id
+      if @options[:namespace_id].nil?
+        return nil
+      else
+        return @options[:namespace_id]
+      end
+    end
+
+    def namespace_id_header_value
+      JSON.dump(
+        DropboxApi::Metadata::NamespaceId.new({
+          'namespace_id' => namespace_id
+        }).to_hash
+      )
+    end
+
+    def call(env)
+      if !namespace_id.nil?
+        env[:request_headers][HEADER_NAME] ||= namespace_id_header_value
+      end
+
+      @app.call env
+    end
+  end
+end

data/lib/dropbox_api/middleware/stack.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::MiddleWare
   class Stack
     def initialize

data/lib/dropbox_api/options_validator.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi
   module OptionsValidator
     # Takes in a list of valid option keys and a hash of options. If one of the

data/lib/dropbox_api/result_builder.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi
   class ResultBuilder
     def initialize(response_data)
@@ -5,11 +6,11 @@ module DropboxApi
     end
 
     def error_summary
-      @response_data["error_summary"] if @response_data.is_a? Hash
+      @response_data['error_summary'] if @response_data.is_a? Hash
     end
 
     def error
-      @response_data["error"]
+      @response_data['error']
     end
 
     def has_error?

data/lib/dropbox_api/results/add_file_member_result_list.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   # Example of a result of the `add_file_member` endpoint:
   #   [{

data/lib/dropbox_api/results/base.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class Base
     def initialize(result_data)

data/lib/dropbox_api/results/basic_account_batch.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class BasicAccountBatch < Array
     def initialize(accounts)

data/lib/dropbox_api/results/copy_batch_result.rb

@@ -1,7 +1,8 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class CopyBatchResult < DropboxApi::Results::Base
     def self.new(result_data)
-      case result_data[".tag"]
+      case result_data['.tag']
       when 'async_job_id'
         result_data['async_job_id']
       when 'complete'

data/lib/dropbox_api/results/create_folder_batch_result.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   # Result returned by {Client#create_folder_batch} that may either launch an
   # asynchronous job or complete synchronously.
@@ -5,11 +6,11 @@ module DropboxApi::Results
   # The value will be either a job id or a list of job statuses.
   class CreateFolderBatchResult < DropboxApi::Results::Base
     def self.new(result_data)
-      case result_data[".tag"]
-      when "async_job_id"
+      case result_data['.tag']
+      when 'async_job_id'
         result_data
-      when "complete"
-        result_data["entries"].map do |entry|
+      when 'complete'
+        result_data['entries'].map do |entry|
           DropboxApi::Results::CreateFolderBatchResultEntry.new(entry)
         end
       else

data/lib/dropbox_api/results/create_folder_batch_result_entry.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class CreateFolderBatchResultEntry < DropboxApi::Results::Base
     def self.new(result_data)

data/lib/dropbox_api/results/delete_batch_result.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   # Result returned by {Client#delete_batch} that may either launch an
   # asynchronous job or complete synchronously.
@@ -5,11 +6,11 @@ module DropboxApi::Results
   # The value will be either a job id or a list of job statuses.
   class DeleteBatchResult < DropboxApi::Results::Base
     def self.new(result_data)
-      case result_data[".tag"]
-      when "async_job_id"
+      case result_data['.tag']
+      when 'async_job_id'
         result_data
-      when "complete"
-        result_data["entries"].map do |entry|
+      when 'complete'
+        result_data['entries'].map do |entry|
           DropboxApi::Results::DeleteBatchResultEntry.new(entry)
         end
       else

data/lib/dropbox_api/results/delete_batch_result_entry.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class DeleteBatchResultEntry < DropboxApi::Results::Base
     def self.new(result_data)

data/lib/dropbox_api/results/get_copy_reference_result.rb

@@ -1,20 +1,21 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class GetCopyReferenceResult < DropboxApi::Results::Base
     # Metadata of the file or folder.
     def resource
-      @resource ||= DropboxApi::Metadata::Resource.new @data["metadata"]
+      @resource ||= DropboxApi::Metadata::Resource.new @data['metadata']
     end
 
     # A copy reference to the file or folder.
     def copy_reference
-      @copy_reference ||= @data["copy_reference"]
+      @copy_reference ||= @data['copy_reference']
     end
 
     # The expiration date of the copy reference.
     # This value is currently set to be far enough in the future
     # so that expiration is effectively not an issue.
     def expires
-      @expires ||= Time.parse(@data["expires"])
+      @expires ||= Time.parse(@data['expires'])
     end
   end
 end

data/lib/dropbox_api/results/get_temporary_link_result.rb

@@ -1,11 +1,12 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class GetTemporaryLinkResult < DropboxApi::Results::Base
     def file
-      @file ||= DropboxApi::Metadata::File.new(@data["metadata"])
+      @file ||= DropboxApi::Metadata::File.new(@data['metadata'])
     end
 
     def link
-      @data["link"]
+      @data['link']
     end
   end
 end

data/lib/dropbox_api/results/get_thumbnail_batch_result.rb

@@ -1,7 +1,8 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class GetThumbnailBatchResult < DropboxApi::Results::Base
     def entries
-      @entries ||= @data["entries"].map do |entry|
+      @entries ||= @data['entries'].map do |entry|
         DropboxApi::Metadata::ThumbnailBatchResultEntry.new entry
       end
     end

data/lib/dropbox_api/results/list_folder_get_latest_cursor_result.rb

@@ -1,7 +1,8 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class ListFolderGetLatestCursorResult < DropboxApi::Results::Base
     def cursor
-      @data["cursor"]
+      @data['cursor']
     end
   end
 end

data/lib/dropbox_api/results/list_folder_longpoll_result.rb

@@ -1,15 +1,16 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class ListFolderLongpollResult < DropboxApi::Results::Base
     # Indicates whether new changes are available. If true, call
     # `list_folder_continue` to retrieve the changes.
     def changes
-      @data["changes"].to_s == "true"
+      @data['changes'].to_s == 'true'
     end
 
     # If present, backoff for at least this many seconds before calling
     # `list_folder_longpoll` again. This field is optional.
     def backoff
-      @data["backoff"]
+      @data['backoff']
     end
   end
 end

data/lib/dropbox_api/results/list_folder_result.rb

@@ -1,8 +1,9 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class ListFolderResult < DropboxApi::Results::Base
     # A collection of files and directories.
     def entries
-      @entries ||= @data["entries"].map do |entry|
+      @entries ||= @data['entries'].map do |entry|
         DropboxApi::Metadata::Resource.new entry
       end
     end
@@ -10,13 +11,13 @@ module DropboxApi::Results
     # Pass the cursor into `list_folder_continue` to see what's changed in the
     # folder since your previous query.
     def cursor
-      @data["cursor"]
+      @data['cursor']
     end
 
     # If true, then there are more entries available. Pass the cursor to
     # `list_folder_continue` to retrieve the rest.
     def has_more?
-      @data["has_more"].to_s == "true"
+      @data['has_more'].to_s == 'true'
     end
   end
 end

data/lib/dropbox_api/results/list_revisions_result.rb

@@ -1,14 +1,15 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class ListRevisionsResult < DropboxApi::Results::Base
     # A collection of files and directories.
     def entries
-      @entries ||= @data["entries"].map do |entry|
+      @entries ||= @data['entries'].map do |entry|
         DropboxApi::Metadata::File.new entry
       end
     end
 
     def is_deleted?
-      @data["is_deleted"] == true
+      @data['is_deleted'] == true
     end
   end
 end

data/lib/dropbox_api/results/list_shared_links_result.rb

@@ -1,8 +1,9 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class ListSharedLinksResult < DropboxApi::Results::Base
     #  Shared links applicable to the path argument.
     def links
-      @entries ||= @data["links"].map do |entry|
+      @entries ||= @data['links'].map do |entry|
         DropboxApi::Metadata::SharedLinkMetadata.new entry
       end
     end
@@ -10,13 +11,13 @@ module DropboxApi::Results
     # Pass the cursor into `list_folder_continue` to see what's changed in the
     # folder since your previous query.
     def cursor
-      @data["cursor"]
+      @data['cursor']
     end
 
     # If true, then there are more entries available. Pass the cursor to
     # `list_folder_continue` to retrieve the rest.
     def has_more?
-      @data["has_more"].to_s == "true"
+      @data['has_more'].to_s == 'true'
     end
   end
 end

data/lib/dropbox_api/results/relocation_batch_result.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   # Result returned by {Client#copy_batch} or {Client#move_batch} that may
   # either launch an asynchronous job or complete synchronously.
@@ -5,11 +6,11 @@ module DropboxApi::Results
   # The value will be either `:in_progress` or a list of job statuses.
   class RelocationBatchResult < DropboxApi::Results::Base
     def self.new(result_data)
-      case result_data[".tag"]
-      when "in_progress"
+      case result_data['.tag']
+      when 'in_progress'
         :in_progress
-      when "complete"
-        result_data["entries"].map do |entry|
+      when 'complete'
+        result_data['entries'].map do |entry|
           DropboxApi::Results::RelocationBatchResultEntry.new(entry)
         end
       else

data/lib/dropbox_api/results/relocation_batch_result_entry.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class RelocationBatchResultEntry < DropboxApi::Results::Base
     def self.new(result_data)

data/lib/dropbox_api/results/save_copy_reference_result.rb

@@ -1,8 +1,9 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class SaveCopyReferenceResult < DropboxApi::Results::Base
     # The saved file or folder in the user's Dropbox.
     def resource
-      @resource ||= DropboxApi::Metadata::Resource.new @data["metadata"]
+      @resource ||= DropboxApi::Metadata::Resource.new @data['metadata']
     end
   end
 end

data/lib/dropbox_api/results/save_url_job_status.rb

@@ -1,14 +1,15 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class SaveUrlJobStatus < DropboxApi::Results::Base
     def self.new(result_data)
-      case result_data[".tag"]
-      when "in_progress"
+      case result_data['.tag']
+      when 'in_progress'
         :in_progress
-      when "complete"
+      when 'complete'
         DropboxApi::Metadata::File.new result_data
-      when "failed"
-        DropboxApi::Errors::SaveUrlError.build("Async job failed",
-                                               result_data["failed"])
+      when 'failed'
+        DropboxApi::Errors::SaveUrlError.build('Async job failed',
+                                               result_data['failed'])
       else
         raise NotImplementedError, "Unknown result type: #{result_data[".tag"]}"
       end

data/lib/dropbox_api/results/save_url_result.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Results
   class SaveUrlResult < DropboxApi::Results::Base
     # Example with an async job:
@@ -8,7 +9,7 @@ module DropboxApi::Results
     #
     # I couldn't manage to get anything other than an async job.
     def async_job_id
-      @data["async_job_id"]
+      @data['async_job_id']
     end
   end
 end

data/lib/dropbox_api/results/search/match.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DropboxApi::Results::Search
   class Match
     def initialize(data)
@@ -5,11 +6,11 @@ module DropboxApi::Results::Search
     end
 
     def match_type
-      @data["match_type"]
+      @data['match_type']
     end
 
     def resource
-      @resource ||= DropboxApi::Metadata::Resource.new @data["metadata"]
+      @resource ||= DropboxApi::Metadata::Resource.new @data['metadata']
     end
   end
 end

data/lib/dropbox_api/results/search_v2_result.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+module DropboxApi::Results
+  class SearchV2Result < DropboxApi::Results::Base
+    # A list (possibly empty) of matches for the query.
+    def matches
+      @matches ||= @data['matches'].map do |match|
+        DropboxApi::Metadata::SearchMatchV2.new match
+      end
+    end
+
+    # Used for paging. If true, indicates there is another page of results
+    # available that can be fetched by calling search again.
+    def has_more?
+      @data['has_more'].to_s == 'true'
+    end
+
+    # Pass the cursor into #search_continue to fetch the next page of results.
+    # This field is optional.
+    def cursor
+      @data['cursor']
+    end
+  end
+end