Add save_url method

lib/dropbox/client.rb

@@ -57,6 +57,18 @@ def restore(path, rev)
       object_from_response(resp, 'file')
     end
 
+    def save_url(path, url)
+      resp = request('/save_url', path: path, url: url)
+      case resp['.tag']
+      when 'complete'
+        object_from_response(resp['complete'], 'file')
+      when 'async_job_id'
+        resp['async_job_id']
+      else
+        raise ClientError.unknown_response_type
+      end
+    end
+
     def search(query, path='', max=100)
       resp = request('/search', path: path, query: query, max_results: max)
       resp['matches'].map { |m| object_from_response(m['metadata']) }
@@ -70,7 +82,7 @@ def object_from_response(resp, tag=resp['.tag'])
         when 'folder'
           FolderMetadata.new(resp['id'], resp['path_lower'])
         else
-          raise ClientError.new('Unknown response type')
+          raise ClientError.unknown_response_type
         end
       end
 

lib/dropbox/error.rb

@@ -4,6 +4,10 @@ module Dropbox
   class ClientError < StandardError
     attr_reader :message
 
+    def self.unknown_response_type
+      self.new("Unknown response type '#{str}'")
+    end
+
     def initialize(message=nil)
       @message = message
     end

test/test_client.rb

@@ -162,6 +162,19 @@ def test_restore_error
     end
   end
 
+  def test_save_url
+    job_id = @client.save_url('/saved_file.txt', 'https://www.dropbox.com/robots.txt')
+
+    assert job_id.is_a?(String)
+    assert_match /^[a-z0-9_-]{22}$/i, job_id
+  end
+
+  def test_save_url_error
+    assert_raises(Dropbox::APIError) do
+      @client.save_url('/saved_file.txt', 'ht:/invalid_url')
+    end
+  end
+
   def test_search
     matches = @client.search('folder')
     assert_equal 3, matches.length