dropbox-api-kilgore5 0.3.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +15 -0
- data/.gitignore +7 -0
- data/.rspec +1 -0
- data/Gemfile +10 -0
- data/LICENSE +22 -0
- data/README.markdown +335 -0
- data/Rakefile +4 -0
- data/dropbox-api-kilgore5.gemspec +24 -0
- data/lib/dropbox-api.rb +23 -0
- data/lib/dropbox-api/client.rb +73 -0
- data/lib/dropbox-api/client/files.rb +40 -0
- data/lib/dropbox-api/client/raw.rb +51 -0
- data/lib/dropbox-api/connection.rb +34 -0
- data/lib/dropbox-api/connection/requests.rb +67 -0
- data/lib/dropbox-api/objects/delta.rb +11 -0
- data/lib/dropbox-api/objects/dir.rb +30 -0
- data/lib/dropbox-api/objects/file.rb +44 -0
- data/lib/dropbox-api/objects/fileops.rb +28 -0
- data/lib/dropbox-api/objects/object.rb +39 -0
- data/lib/dropbox-api/tasks.rb +48 -0
- data/lib/dropbox-api/util/config.rb +29 -0
- data/lib/dropbox-api/util/error.rb +17 -0
- data/lib/dropbox-api/util/oauth.rb +29 -0
- data/lib/dropbox-api/util/response.rb +8 -0
- data/lib/dropbox-api/util/util.rb +27 -0
- data/lib/dropbox-api/version.rb +5 -0
- data/spec/connection.sample.yml +5 -0
- data/spec/fixtures/dropbox.jpg +0 -0
- data/spec/lib/dropbox-api/client_spec.rb +201 -0
- data/spec/lib/dropbox-api/connection_spec.rb +82 -0
- data/spec/lib/dropbox-api/dir_spec.rb +44 -0
- data/spec/lib/dropbox-api/file_spec.rb +126 -0
- data/spec/lib/dropbox-api/oauth_spec.rb +17 -0
- data/spec/lib/dropbox-api/thumbnail_spec.rb +29 -0
- data/spec/spec_helper.rb +27 -0
- data/spec/support/config.rb +15 -0
- data/spec/support/jpeg.rb +39 -0
- metadata +132 -0
@@ -0,0 +1,29 @@
|
|
1
|
+
module Dropbox
|
2
|
+
module API
|
3
|
+
|
4
|
+
module Config
|
5
|
+
|
6
|
+
class << self
|
7
|
+
attr_accessor :endpoints
|
8
|
+
attr_accessor :prefix
|
9
|
+
attr_accessor :app_key
|
10
|
+
attr_accessor :app_secret
|
11
|
+
attr_accessor :mode
|
12
|
+
attr_accessor :app_name
|
13
|
+
end
|
14
|
+
|
15
|
+
self.endpoints = {
|
16
|
+
:main => "https://api.dropbox.com",
|
17
|
+
:content => "https://api-content.dropbox.com",
|
18
|
+
:authorize => "https://www.dropbox.com"
|
19
|
+
}
|
20
|
+
self.prefix = "/1"
|
21
|
+
self.app_key = nil
|
22
|
+
self.app_secret = nil
|
23
|
+
self.mode = 'sandbox'
|
24
|
+
self.app_name = nil
|
25
|
+
|
26
|
+
end
|
27
|
+
|
28
|
+
end
|
29
|
+
end
|
@@ -0,0 +1,17 @@
|
|
1
|
+
module Dropbox
|
2
|
+
module API
|
3
|
+
|
4
|
+
class Error < Exception
|
5
|
+
|
6
|
+
class ConnectionFailed < Exception; end
|
7
|
+
class Config < Exception; end
|
8
|
+
class Unauthorized < Exception; end
|
9
|
+
class Forbidden < Exception; end
|
10
|
+
class NotFound < Exception; end
|
11
|
+
class NotModified < Exception; end
|
12
|
+
class Redirect < Exception; end
|
13
|
+
|
14
|
+
end
|
15
|
+
|
16
|
+
end
|
17
|
+
end
|
@@ -0,0 +1,29 @@
|
|
1
|
+
module Dropbox
|
2
|
+
module API
|
3
|
+
|
4
|
+
module OAuth
|
5
|
+
|
6
|
+
class << self
|
7
|
+
|
8
|
+
def consumer(endpoint)
|
9
|
+
if !Dropbox::API::Config.app_key or !Dropbox::API::Config.app_secret
|
10
|
+
raise Dropbox::API::Error::Config.new("app_key or app_secret not provided")
|
11
|
+
end
|
12
|
+
::OAuth::Consumer.new(Dropbox::API::Config.app_key, Dropbox::API::Config.app_secret,
|
13
|
+
:site => Dropbox::API::Config.endpoints[endpoint],
|
14
|
+
:request_token_path => Dropbox::API::Config.prefix + "/oauth/request_token",
|
15
|
+
:authorize_path => Dropbox::API::Config.prefix + "/oauth/authorize",
|
16
|
+
:access_token_path => Dropbox::API::Config.prefix + "/oauth/access_token")
|
17
|
+
end
|
18
|
+
|
19
|
+
def access_token(consumer, options = {})
|
20
|
+
::OAuth::AccessToken.new(consumer, options[:token], options[:secret])
|
21
|
+
end
|
22
|
+
|
23
|
+
end
|
24
|
+
|
25
|
+
end
|
26
|
+
|
27
|
+
end
|
28
|
+
end
|
29
|
+
|
@@ -0,0 +1,27 @@
|
|
1
|
+
module Dropbox
|
2
|
+
module API
|
3
|
+
|
4
|
+
module Util
|
5
|
+
|
6
|
+
class << self
|
7
|
+
|
8
|
+
def escape(string)
|
9
|
+
string.gsub(/([^ a-zA-Z0-9\.\\\-\/\_]+)/) do
|
10
|
+
'%' + $1.unpack('H2' * $1.bytesize).join('%').upcase
|
11
|
+
end.gsub(' ', '%20')
|
12
|
+
end
|
13
|
+
|
14
|
+
def query(data)
|
15
|
+
data.inject([]) { |memo, entry| memo.push(entry.join('=')); memo }.join('&')
|
16
|
+
end
|
17
|
+
|
18
|
+
def remove_double_slashes(path)
|
19
|
+
path.gsub('//', '/')
|
20
|
+
end
|
21
|
+
|
22
|
+
end
|
23
|
+
|
24
|
+
end
|
25
|
+
|
26
|
+
end
|
27
|
+
end
|
Binary file
|
@@ -0,0 +1,201 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
require "spec_helper"
|
3
|
+
|
4
|
+
describe Dropbox::API::Client do
|
5
|
+
|
6
|
+
before do
|
7
|
+
# pending
|
8
|
+
@client = Dropbox::Spec.instance
|
9
|
+
end
|
10
|
+
|
11
|
+
describe "#initialize" do
|
12
|
+
|
13
|
+
it "has a handle to the connection" do
|
14
|
+
@client.connection.should be_an_instance_of(Dropbox::API::Connection)
|
15
|
+
end
|
16
|
+
|
17
|
+
end
|
18
|
+
|
19
|
+
describe "#account" do
|
20
|
+
|
21
|
+
it "retrieves the account object" do
|
22
|
+
response = @client.account
|
23
|
+
response.should be_an_instance_of(Dropbox::API::Object)
|
24
|
+
end
|
25
|
+
|
26
|
+
end
|
27
|
+
|
28
|
+
describe "#find" do
|
29
|
+
|
30
|
+
before do
|
31
|
+
@filename = "#{Dropbox::Spec.test_dir}/spec-find-file-test-#{Time.now.to_i}.txt"
|
32
|
+
@file = @client.upload @filename, "spec file"
|
33
|
+
|
34
|
+
@dirname = "#{Dropbox::Spec.test_dir}/spec-find-dir-test-#{Time.now.to_i}"
|
35
|
+
@dir = @client.mkdir @dirname
|
36
|
+
end
|
37
|
+
|
38
|
+
it "returns a single file" do
|
39
|
+
response = @client.find(@filename)
|
40
|
+
response.path.should == @file.path
|
41
|
+
response.should be_an_instance_of(Dropbox::API::File)
|
42
|
+
end
|
43
|
+
|
44
|
+
it "returns a single directory" do
|
45
|
+
response = @client.find(@dirname)
|
46
|
+
response.path.should == @dir.path
|
47
|
+
response.should be_an_instance_of(Dropbox::API::Dir)
|
48
|
+
end
|
49
|
+
|
50
|
+
end
|
51
|
+
|
52
|
+
describe "#ls" do
|
53
|
+
|
54
|
+
it "returns an array of files and dirs" do
|
55
|
+
result = @client.ls
|
56
|
+
result.should be_an_instance_of(Array)
|
57
|
+
end
|
58
|
+
|
59
|
+
it "returns a single item array of if we ls a file" do
|
60
|
+
result = @client.ls(Dropbox::Spec.test_dir)
|
61
|
+
first_file = result.detect { |f| f.class == Dropbox::API::File }
|
62
|
+
result = @client.ls first_file.path
|
63
|
+
result.should be_an_instance_of(Array)
|
64
|
+
end
|
65
|
+
|
66
|
+
end
|
67
|
+
|
68
|
+
describe "#mkdir" do
|
69
|
+
|
70
|
+
it "returns an array of files and dirs" do
|
71
|
+
dirname = "#{Dropbox::Spec.test_dir}/test-dir-#{Dropbox::Spec.namespace}"
|
72
|
+
response = @client.mkdir dirname
|
73
|
+
response.path.should == dirname
|
74
|
+
response.should be_an_instance_of(Dropbox::API::Dir)
|
75
|
+
end
|
76
|
+
|
77
|
+
it "creates dirs with tricky characters" do
|
78
|
+
dirname = "#{Dropbox::Spec.test_dir}/test-dir |!@\#$%^&*{b}[].;'.,<>?: #{Dropbox::Spec.namespace}"
|
79
|
+
response = @client.mkdir dirname
|
80
|
+
response.path.should == dirname.gsub(/[\\\:\?\*\<\>\"\|]+/, '')
|
81
|
+
response.should be_an_instance_of(Dropbox::API::Dir)
|
82
|
+
end
|
83
|
+
|
84
|
+
it "creates dirs with utf8 characters" do
|
85
|
+
dirname = "#{Dropbox::Spec.test_dir}/test-dir łółą #{Dropbox::Spec.namespace}"
|
86
|
+
response = @client.mkdir dirname
|
87
|
+
response.path.should == dirname
|
88
|
+
response.should be_an_instance_of(Dropbox::API::Dir)
|
89
|
+
end
|
90
|
+
|
91
|
+
end
|
92
|
+
|
93
|
+
describe "#upload" do
|
94
|
+
|
95
|
+
it "puts the file in dropbox" do
|
96
|
+
filename = "#{Dropbox::Spec.test_dir}/test-#{Dropbox::Spec.namespace}.txt"
|
97
|
+
response = @client.upload filename, "Some file"
|
98
|
+
response.path.should == filename
|
99
|
+
response.bytes.should == 9
|
100
|
+
end
|
101
|
+
|
102
|
+
it "uploads the file with tricky characters" do
|
103
|
+
filename = "#{Dropbox::Spec.test_dir}/test ,|!@\#$%^&*{b}[].;'.,<>?:-#{Dropbox::Spec.namespace}.txt"
|
104
|
+
response = @client.upload filename, "Some file"
|
105
|
+
response.path.should == filename
|
106
|
+
response.bytes.should == 9
|
107
|
+
end
|
108
|
+
|
109
|
+
it "uploads the file with utf8" do
|
110
|
+
filename = "#{Dropbox::Spec.test_dir}/test łołąó-#{Dropbox::Spec.namespace}.txt"
|
111
|
+
response = @client.upload filename, "Some file"
|
112
|
+
response.path.should == filename
|
113
|
+
response.bytes.should == 9
|
114
|
+
end
|
115
|
+
end
|
116
|
+
|
117
|
+
describe "#search" do
|
118
|
+
|
119
|
+
let(:term) { "searchable-test-#{Dropbox::Spec.namespace}" }
|
120
|
+
|
121
|
+
before do
|
122
|
+
filename = "#{Dropbox::Spec.test_dir}/searchable-test-#{Dropbox::Spec.namespace}.txt"
|
123
|
+
@client.upload filename, "Some file"
|
124
|
+
end
|
125
|
+
|
126
|
+
after do
|
127
|
+
@response.size.should == 1
|
128
|
+
@response.first.class.should == Dropbox::API::File
|
129
|
+
end
|
130
|
+
|
131
|
+
it "finds a file" do
|
132
|
+
@response = @client.search term, :path => "#{Dropbox::Spec.test_dir}"
|
133
|
+
end
|
134
|
+
|
135
|
+
it "works if leading slash is present in path" do
|
136
|
+
@response = @client.search term, :path => "/#{Dropbox::Spec.test_dir}"
|
137
|
+
end
|
138
|
+
|
139
|
+
end
|
140
|
+
|
141
|
+
describe "#copy_from_copy_ref" do
|
142
|
+
|
143
|
+
it "copies a file from a copy_ref" do
|
144
|
+
filename = "test/searchable-test-#{Dropbox::Spec.namespace}.txt"
|
145
|
+
@client.upload filename, "Some file"
|
146
|
+
response = @client.search "searchable-test-#{Dropbox::Spec.namespace}", :path => 'test'
|
147
|
+
ref = response.first.copy_ref['copy_ref']
|
148
|
+
@client.copy_from_copy_ref ref, "#{filename}.copied"
|
149
|
+
response = @client.search "searchable-test-#{Dropbox::Spec.namespace}.txt.copied", :path => 'test'
|
150
|
+
response.size.should == 1
|
151
|
+
response.first.class.should == Dropbox::API::File
|
152
|
+
end
|
153
|
+
|
154
|
+
end
|
155
|
+
|
156
|
+
describe "#download" do
|
157
|
+
|
158
|
+
it "downloads a file from Dropbox" do
|
159
|
+
@client.upload "#{Dropbox::Spec.test_dir}/test.txt", "Some file"
|
160
|
+
file = @client.download "#{Dropbox::Spec.test_dir}/test.txt"
|
161
|
+
file.should == "Some file"
|
162
|
+
end
|
163
|
+
|
164
|
+
it "raises a 404 when a file is not found in Dropbox" do
|
165
|
+
lambda {
|
166
|
+
@client.download "#{Dropbox::Spec.test_dir}/no.txt"
|
167
|
+
}.should raise_error(Dropbox::API::Error::NotFound)
|
168
|
+
end
|
169
|
+
|
170
|
+
end
|
171
|
+
|
172
|
+
describe "#delta" do
|
173
|
+
it "returns a cursor and list of files" do
|
174
|
+
filename = "#{Dropbox::Spec.test_dir}/delta-test-#{Dropbox::Spec.namespace}.txt"
|
175
|
+
@client.upload filename, 'Some file'
|
176
|
+
response = @client.delta
|
177
|
+
cursor, files = response.cursor, response.entries
|
178
|
+
cursor.should be_an_instance_of(String)
|
179
|
+
files.should be_an_instance_of(Array)
|
180
|
+
files.last.should be_an_instance_of(Dropbox::API::File)
|
181
|
+
end
|
182
|
+
|
183
|
+
it "returns the files that have changed since the cursor was made" do
|
184
|
+
filename = "#{Dropbox::Spec.test_dir}/delta-test-#{Dropbox::Spec.namespace}.txt"
|
185
|
+
delete_filename = "#{Dropbox::Spec.test_dir}/delta-test-delete-#{Dropbox::Spec.namespace}.txt"
|
186
|
+
@client.upload delete_filename, 'Some file'
|
187
|
+
response = @client.delta
|
188
|
+
cursor, files = response.cursor, response.entries
|
189
|
+
files.last.path.should == delete_filename
|
190
|
+
files.last.destroy
|
191
|
+
@client.upload filename, 'Another file'
|
192
|
+
response = @client.delta(cursor)
|
193
|
+
cursor, files = response.cursor, response.entries
|
194
|
+
files.length.should == 2
|
195
|
+
files.first.is_deleted.should == true
|
196
|
+
files.first.path.should == delete_filename
|
197
|
+
files.last.path.should == filename
|
198
|
+
end
|
199
|
+
end
|
200
|
+
|
201
|
+
end
|
@@ -0,0 +1,82 @@
|
|
1
|
+
require "spec_helper"
|
2
|
+
|
3
|
+
describe Dropbox::API::Connection do
|
4
|
+
|
5
|
+
before do
|
6
|
+
@connection = Dropbox::API::Connection.new(:token => Dropbox::Spec.token,
|
7
|
+
:secret => Dropbox::Spec.secret)
|
8
|
+
end
|
9
|
+
|
10
|
+
describe "#request" do
|
11
|
+
|
12
|
+
it "returns a parsed response when the response is a 200" do
|
13
|
+
response = mock :code => 200, :body => '{ "a":1}'
|
14
|
+
response = @connection.request { response }
|
15
|
+
response.should be_an_instance_of(Hash)
|
16
|
+
end
|
17
|
+
|
18
|
+
it "raises a Dropbox::API::Error::Unauthorized when the response is a 401" do
|
19
|
+
response = mock :code => 401, :body => '{ "a":1}'
|
20
|
+
lambda do
|
21
|
+
@connection.request { response }
|
22
|
+
end.should raise_error(Dropbox::API::Error::Unauthorized)
|
23
|
+
end
|
24
|
+
|
25
|
+
it "raises a Dropbox::API::Error::Forbidden when the response is a 403" do
|
26
|
+
response = mock :code => 403, :body => '{ "a":1}'
|
27
|
+
lambda do
|
28
|
+
@connection.request { response }
|
29
|
+
end.should raise_error(Dropbox::API::Error::Forbidden)
|
30
|
+
end
|
31
|
+
|
32
|
+
it "raises a Dropbox::API::Error::NotFound when the response is a 404" do
|
33
|
+
response = mock :code => 404, :body => '{ "a":1}'
|
34
|
+
lambda do
|
35
|
+
@connection.request { response }
|
36
|
+
end.should raise_error(Dropbox::API::Error::NotFound)
|
37
|
+
end
|
38
|
+
|
39
|
+
it "raises a Dropbox::API::Error when the response is a 3xx" do
|
40
|
+
response = mock :code => 301, :body => '{ "a":1}'
|
41
|
+
lambda do
|
42
|
+
@connection.request { response }
|
43
|
+
end.should raise_error(Dropbox::API::Error::Redirect)
|
44
|
+
end
|
45
|
+
|
46
|
+
it "raises a Dropbox::API::Error when the response is a 5xx" do
|
47
|
+
response = mock :code => 500, :body => '{ "a":1}'
|
48
|
+
lambda do
|
49
|
+
@connection.request { response }
|
50
|
+
end.should raise_error(Dropbox::API::Error)
|
51
|
+
end
|
52
|
+
|
53
|
+
it "raises a Dropbox::API::Error when the response is a 400" do
|
54
|
+
response = mock :code => 400, :body => '{ "error": "bad request" }'
|
55
|
+
lambda do
|
56
|
+
@connection.request { response }
|
57
|
+
end.should raise_error(Dropbox::API::Error)
|
58
|
+
end
|
59
|
+
|
60
|
+
it "raises a Dropbox::API::Error when the response is a 406" do
|
61
|
+
response = mock :code => 406, :body => '{ "error": "bad request" }'
|
62
|
+
lambda do
|
63
|
+
@connection.request { response }
|
64
|
+
end.should raise_error(Dropbox::API::Error)
|
65
|
+
end
|
66
|
+
|
67
|
+
it "returns the raw response if :raw => true is provided" do
|
68
|
+
response = mock :code => 200, :body => '{ "something": "more" }'
|
69
|
+
response = @connection.request(:raw => true) { response }
|
70
|
+
response.should == '{ "something": "more" }'
|
71
|
+
end
|
72
|
+
|
73
|
+
end
|
74
|
+
|
75
|
+
describe "#consumer" do
|
76
|
+
|
77
|
+
it "returns an appropriate consumer object" do
|
78
|
+
@connection.consumer(:main).should be_a(::OAuth::Consumer)
|
79
|
+
end
|
80
|
+
|
81
|
+
end
|
82
|
+
end
|
@@ -0,0 +1,44 @@
|
|
1
|
+
require "spec_helper"
|
2
|
+
|
3
|
+
describe Dropbox::API::Dir do
|
4
|
+
|
5
|
+
before do
|
6
|
+
@client = Dropbox::Spec.instance
|
7
|
+
@dirname = "#{Dropbox::Spec.test_dir}/spec-dir-test-#{Time.now.to_i}"
|
8
|
+
@dir = @client.mkdir @dirname
|
9
|
+
end
|
10
|
+
|
11
|
+
after do
|
12
|
+
# @dir.delete
|
13
|
+
end
|
14
|
+
|
15
|
+
describe "#copy" do
|
16
|
+
|
17
|
+
it "copies the dir properly" do
|
18
|
+
new_dirname = @dirname + "-copied"
|
19
|
+
@dir.copy new_dirname
|
20
|
+
@dir.path.should == new_dirname
|
21
|
+
end
|
22
|
+
|
23
|
+
end
|
24
|
+
|
25
|
+
describe "#move" do
|
26
|
+
|
27
|
+
it "moves the dir properly" do
|
28
|
+
new_dirname = @dirname + "-copied"
|
29
|
+
@dir.move new_dirname
|
30
|
+
@dir.path.should == new_dirname
|
31
|
+
end
|
32
|
+
|
33
|
+
end
|
34
|
+
|
35
|
+
describe "#destroy" do
|
36
|
+
|
37
|
+
it "destroys the dir properly" do
|
38
|
+
@dir.destroy
|
39
|
+
@dir.is_deleted.should == true
|
40
|
+
end
|
41
|
+
|
42
|
+
end
|
43
|
+
|
44
|
+
end
|