|
1
|
|
|
""" |
|
2
|
|
|
Copyright George Sibble 2018 |
|
3
|
|
|
""" |
|
4
|
|
|
|
|
5
|
1 |
|
from .b2_file import B2File |
|
6
|
1 |
|
from ..utilities import b2_url_encode, get_content_length, get_part_ranges, decode_error, RangeStream, StreamWithHashProgress |
|
|
|
|
|
|
7
|
1 |
|
from ..b2_exceptions import B2Exception, B2FileNotFoundError |
|
8
|
1 |
|
from multiprocessing.dummy import Pool as ThreadPool |
|
|
|
|
|
|
9
|
1 |
|
from ..api import API |
|
10
|
|
|
|
|
11
|
1 |
|
class B2FileList(object): |
|
|
|
|
|
|
12
|
|
|
""" |
|
13
|
|
|
|
|
14
|
|
|
""" |
|
15
|
1 |
|
def __init__(self, connector, bucket): |
|
16
|
|
|
""" |
|
17
|
|
|
|
|
18
|
|
|
:param connector: |
|
19
|
|
|
:param bucket: |
|
20
|
|
|
""" |
|
21
|
|
|
self.connector = connector |
|
22
|
|
|
self.bucket = bucket |
|
23
|
|
|
self._files_by_name = {} |
|
24
|
|
|
self._files_by_id = {} |
|
25
|
|
|
|
|
26
|
1 |
|
def all(self, include_hidden=False, limit=None): |
|
27
|
|
|
""" Return an updated list of all files. |
|
28
|
|
|
(This does not include hidden files unless include_hidden flag set to True) |
|
29
|
|
|
|
|
30
|
|
|
Parameters: |
|
31
|
|
|
include_hidden: (bool) Include hidden files |
|
32
|
|
|
limit: (int) Limit number of file results |
|
33
|
|
|
|
|
34
|
|
|
""" |
|
35
|
|
|
if not include_hidden: |
|
36
|
|
|
return self._update_files_list(retrieve=True, limit=limit) |
|
37
|
|
|
else: |
|
38
|
|
|
results = self.all_file_versions(limit=limit) |
|
39
|
|
|
versions = results['file_versions'] |
|
40
|
|
|
file_ids = results['file_ids'] |
|
41
|
|
|
if versions: |
|
42
|
|
|
# Return only the first file from a given file with multiple versions |
|
43
|
|
|
files = [versions[f][0] for f in file_ids] |
|
44
|
|
|
return files |
|
45
|
|
|
return [] # Return empty set on no results |
|
46
|
|
|
|
|
47
|
1 |
|
def delete_all(self, confirm=False): |
|
48
|
|
|
""" Delete all files in the bucket. |
|
|
|
|
|
|
49
|
|
|
Parameters: |
|
50
|
|
|
confirm: (bool) Safety check. Confirm deletion |
|
51
|
|
|
""" |
|
|
|
|
|
|
52
|
|
|
if not confirm: |
|
53
|
|
|
raise Exception('This will delete all files! Pass confirm=True') |
|
54
|
|
|
|
|
|
|
|
|
|
55
|
|
|
all_files = self.all(include_hidden=True) |
|
56
|
|
|
try: |
|
57
|
|
|
for f in all_files: |
|
|
|
|
|
|
58
|
|
|
f.delete_all_versions(confirm=True) |
|
59
|
|
|
except Exception as E: |
|
|
|
|
|
|
60
|
|
|
raise B2Exception.parse(E) |
|
61
|
|
|
return [] |
|
62
|
|
|
|
|
63
|
|
|
|
|
|
|
|
|
|
64
|
1 |
|
def _update_files_list(self, retrieve=False, limit=None): |
|
65
|
|
|
""" Retrieve list of all files in bucket |
|
|
|
|
|
|
66
|
|
|
Parameters: |
|
67
|
|
|
limit: (int) Max number of file results, default 10000 |
|
68
|
|
|
retrieve: (bool) Refresh local store. (default: false) |
|
69
|
|
|
""" |
|
70
|
|
|
path = API.list_all_files |
|
71
|
|
|
files = [] |
|
72
|
|
|
new_files_to_retrieve = True |
|
73
|
|
|
params = { |
|
74
|
|
|
'bucketId': self.bucket.bucket_id, |
|
75
|
|
|
'maxFileCount': limit or 10000 |
|
76
|
|
|
} |
|
77
|
|
|
while new_files_to_retrieve: |
|
78
|
|
|
response = self.connector.make_request(path=path, method='post', params=params) |
|
79
|
|
|
if response.status_code == 200: |
|
80
|
|
|
files_json = response.json() |
|
81
|
|
|
self._files_by_name = {} |
|
82
|
|
|
self._files_by_id = {} |
|
83
|
|
|
for file_json in files_json['files']: |
|
84
|
|
|
new_file = B2File(connector=self.connector, parent_list=self, **file_json) |
|
85
|
|
|
files.append(new_file) |
|
86
|
|
|
self._files_by_name[file_json['fileName']] = new_file |
|
87
|
|
|
self._files_by_id[file_json['fileId']] = new_file |
|
88
|
|
|
if files_json['nextFileName'] is None: |
|
89
|
|
|
new_files_to_retrieve = False |
|
90
|
|
|
else: |
|
91
|
|
|
params['startFileName'] = files_json['nextFileName'] |
|
92
|
|
|
else: |
|
93
|
|
|
raise B2Exception.parse(response) |
|
94
|
|
|
if retrieve: |
|
95
|
|
|
return files |
|
96
|
|
|
|
|
97
|
|
|
|
|
98
|
1 |
|
def get(self, file_name=None, file_id=None): |
|
99
|
|
|
""" Get a file by file name or id. |
|
100
|
|
|
Required: |
|
101
|
|
|
file_name or file_id |
|
102
|
|
|
|
|
103
|
|
|
Parameters: |
|
104
|
|
|
file_name: (str) File name |
|
|
|
|
|
|
105
|
|
|
file_id: (str) File ID |
|
|
|
|
|
|
106
|
|
|
""" |
|
107
|
|
|
if file_name: |
|
108
|
|
|
file = self._get_by_name(file_name) |
|
|
|
|
|
|
109
|
|
|
|
|
110
|
|
|
elif file_id: |
|
111
|
|
|
file = self._get_by_id(file_id) |
|
112
|
|
|
else: |
|
113
|
|
|
raise ValueError('file_name or file_id must be passed') |
|
114
|
|
|
|
|
|
|
|
|
|
115
|
|
|
return file |
|
116
|
|
|
|
|
117
|
|
|
|
|
118
|
1 |
|
def get_versions(self, file_name=None, file_id=None, limit=None): |
|
|
|
|
|
|
119
|
|
|
""" Return list of all the versions of one file in current bucket. |
|
|
|
|
|
|
120
|
|
|
Required: |
|
121
|
|
|
file_id or file_name (either) |
|
122
|
|
|
|
|
123
|
|
|
Params: |
|
124
|
|
|
file_id: (str) File id |
|
125
|
|
|
file_name: (str) File id |
|
126
|
|
|
limit: (int) Limit number of results returned (optional) |
|
127
|
|
|
|
|
128
|
|
|
Returns: |
|
129
|
|
|
file_versions (list) B2FileObject of all file versions |
|
130
|
|
|
""" |
|
|
|
|
|
|
131
|
|
|
if file_name: |
|
132
|
|
|
file = self.get(file_name) |
|
|
|
|
|
|
133
|
|
|
|
|
134
|
|
|
elif file_id: |
|
135
|
|
|
file = self.get(file_id=file_id) |
|
136
|
|
|
else: |
|
137
|
|
|
raise ValueError('Either file_id or file_name required for get_versions') |
|
138
|
|
|
return file.get_versions() |
|
139
|
|
|
|
|
|
|
|
|
|
140
|
|
|
|
|
141
|
1 |
|
def all_file_versions(self, limit=None): |
|
142
|
|
|
""" Return all the versions of all files in a given bucket. |
|
143
|
|
|
|
|
144
|
|
|
Params: |
|
145
|
|
|
limit: (int) Limit number of results returned (optional). Defaults to 10000 |
|
|
|
|
|
|
146
|
|
|
|
|
147
|
|
|
Returns dict: |
|
|
|
|
|
|
148
|
|
|
'file_names': (list) String filenames |
|
149
|
|
|
'file_ids': (list) File IDs |
|
150
|
|
|
'file_versions': (dict) b2blaze File objects, keyed by file name |
|
151
|
|
|
""" |
|
|
|
|
|
|
152
|
|
|
|
|
153
|
|
|
path = API.list_file_versions |
|
154
|
|
|
file_versions = dict() |
|
155
|
|
|
file_names = [] |
|
156
|
|
|
file_ids = [] |
|
157
|
|
|
new_files_to_retrieve = True |
|
158
|
|
|
params = { |
|
159
|
|
|
'bucketId': self.bucket.bucket_id, |
|
160
|
|
|
'maxFileCount': 10000 |
|
161
|
|
|
} |
|
162
|
|
|
|
|
163
|
|
|
# Limit files |
|
164
|
|
|
if limit: |
|
165
|
|
|
params['maxFileCount'] = limit |
|
166
|
|
|
|
|
167
|
|
|
while new_files_to_retrieve: |
|
168
|
|
|
|
|
169
|
|
|
response = self.connector.make_request(path=path, method='post', params=params) |
|
170
|
|
|
if response.status_code == 200: |
|
171
|
|
|
files_json = response.json() |
|
172
|
|
|
for file_json in files_json['files']: |
|
173
|
|
|
new_file = B2File(connector=self.connector, parent_list=self, **file_json) |
|
174
|
|
|
|
|
175
|
|
|
# Append file_id, file_name to lists |
|
176
|
|
|
file_name, file_id = file_json['fileName'], file_json['fileId'] |
|
177
|
|
|
file_names.append(file_name) |
|
178
|
|
|
file_ids.append(file_id) |
|
179
|
|
|
|
|
|
|
|
|
|
180
|
|
|
# Add file to list keyed by file_id |
|
181
|
|
|
if file_id in file_versions: |
|
182
|
|
|
file_versions[file_id].append(new_file) |
|
183
|
|
|
else: |
|
184
|
|
|
file_versions[file_id] = [new_file] |
|
185
|
|
|
|
|
186
|
|
|
if files_json['nextFileName'] is None: |
|
187
|
|
|
new_files_to_retrieve = False |
|
188
|
|
|
else: |
|
189
|
|
|
params['startFileName'] = files_json['nextFileName'] |
|
190
|
|
|
else: |
|
191
|
|
|
raise B2Exception.parse(response) |
|
192
|
|
|
return {'file_names': file_names, 'file_versions': file_versions, 'file_ids': file_ids} |
|
193
|
|
|
|
|
194
|
|
|
|
|
195
|
1 |
|
def _get_by_name(self, file_name): |
|
196
|
|
|
""" Internal method, return single file by file name """ |
|
|
|
|
|
|
197
|
|
|
path = API.list_all_files |
|
198
|
|
|
params = { |
|
199
|
|
|
'prefix': b2_url_encode(file_name), |
|
200
|
|
|
'bucketId': self.bucket.bucket_id |
|
201
|
|
|
} |
|
202
|
|
|
|
|
203
|
|
|
response = self.connector.make_request(path, method='post', params=params) |
|
204
|
|
|
file_json = response.json() |
|
205
|
|
|
|
|
206
|
|
|
# Handle errors and empty files |
|
207
|
|
|
if not response.status_code == 200: |
|
208
|
|
|
raise B2Exception.parse(response) |
|
209
|
|
|
if not len(file_json['files']) > 0: |
|
|
|
|
|
|
210
|
|
|
raise B2FileNotFoundError('Filename {} not found'.format(file_name)) |
|
211
|
|
|
else: |
|
212
|
|
|
return B2File(connector=self.connector, parent_list=self, **file_json['files'][0]) |
|
213
|
|
|
|
|
214
|
1 |
|
def _get_by_id(self, file_id): |
|
215
|
|
|
""" Internal method, return single file by file id """ |
|
|
|
|
|
|
216
|
|
|
path = API.file_info |
|
217
|
|
|
params = { |
|
218
|
|
|
'fileId': file_id |
|
219
|
|
|
} |
|
220
|
|
|
response = self.connector.make_request(path, method='post', params=params) |
|
221
|
|
|
if response.status_code == 200: |
|
222
|
|
|
file_json = response.json() |
|
223
|
|
|
return B2File(connector=self.connector, parent_list=self, **file_json) |
|
224
|
|
|
else: |
|
225
|
|
|
raise B2Exception.parse(response) |
|
226
|
|
|
|
|
|
|
|
|
|
227
|
|
|
|
|
228
|
1 |
|
def upload(self, contents, file_name, mime_content_type=None, content_length=None, progress_listener=None): |
|
|
|
|
|
|
229
|
|
|
""" |
|
230
|
|
|
|
|
231
|
|
|
:param contents: |
|
232
|
|
|
:param file_name: |
|
233
|
|
|
:param mime_content_type: |
|
234
|
|
|
:param content_length: |
|
235
|
|
|
:param progress_listener: |
|
236
|
|
|
:return: |
|
237
|
|
|
""" |
|
238
|
|
|
if file_name[0] == '/': |
|
239
|
|
|
file_name = file_name[1:] |
|
240
|
|
|
get_upload_url_path = API.upload_url |
|
241
|
|
|
params = { |
|
242
|
|
|
'bucketId': self.bucket.bucket_id |
|
243
|
|
|
} |
|
244
|
|
|
upload_url_response = self.connector.make_request(path=get_upload_url_path, method='post', params=params) |
|
|
|
|
|
|
245
|
|
|
if upload_url_response.status_code == 200: |
|
246
|
|
|
upload_url = upload_url_response.json().get('uploadUrl', None) |
|
247
|
|
|
auth_token = upload_url_response.json().get('authorizationToken', None) |
|
248
|
|
|
upload_response = self.connector.upload_file(file_contents=contents, file_name=file_name, |
|
|
|
|
|
|
249
|
|
|
upload_url=upload_url, auth_token=auth_token, |
|
|
|
|
|
|
250
|
|
|
content_length=content_length, progress_listener=progress_listener) |
|
|
|
|
|
|
251
|
|
|
if upload_response.status_code == 200: |
|
252
|
|
|
new_file = B2File(connector=self.connector, parent_list=self, **upload_response.json()) |
|
|
|
|
|
|
253
|
|
|
# Update file list after upload |
|
254
|
|
|
self._update_files_list() |
|
255
|
|
|
return new_file |
|
256
|
|
|
else: |
|
257
|
|
|
raise B2Exception.parse(upload_response) |
|
258
|
|
|
else: |
|
259
|
|
|
raise B2Exception.parse(upload_url_response) |
|
260
|
|
|
|
|
261
|
1 |
|
def upload_large_file(self, contents, file_name, part_size=None, num_threads=4, |
|
|
|
|
|
|
262
|
|
|
mime_content_type=None, content_length=None, progress_listener=None): |
|
263
|
|
|
""" |
|
264
|
|
|
|
|
265
|
|
|
:param contents: |
|
266
|
|
|
:param file_name: |
|
267
|
|
|
:param part_size: |
|
268
|
|
|
:param num_threads: |
|
269
|
|
|
:param mime_content_type: |
|
270
|
|
|
:param content_length: |
|
271
|
|
|
:param progress_listener: |
|
272
|
|
|
:return: |
|
273
|
|
|
""" |
|
274
|
|
|
if file_name[0] == '/': |
|
275
|
|
|
file_name = file_name[1:] |
|
276
|
|
|
if part_size == None: |
|
|
|
|
|
|
277
|
|
|
part_size = self.connector.recommended_part_size |
|
278
|
|
|
if content_length == None: |
|
|
|
|
|
|
279
|
|
|
content_length = get_content_length(contents) |
|
280
|
|
|
start_large_file_path = API.upload_large |
|
281
|
|
|
params = { |
|
282
|
|
|
'bucketId': self.bucket.bucket_id, |
|
283
|
|
|
'fileName': b2_url_encode(file_name), |
|
284
|
|
|
'contentType': mime_content_type or 'b2/x-auto' |
|
285
|
|
|
} |
|
286
|
|
|
large_file_response = self.connector.make_request(path=start_large_file_path, method='post', params=params) |
|
|
|
|
|
|
287
|
|
|
if large_file_response.status_code == 200: |
|
288
|
|
|
file_id = large_file_response.json().get('fileId', None) |
|
289
|
|
|
get_upload_part_url_path = API.upload_large_part |
|
290
|
|
|
params = { |
|
291
|
|
|
'fileId': file_id |
|
292
|
|
|
} |
|
293
|
|
|
pool = ThreadPool(num_threads) |
|
294
|
|
|
def upload_part_worker(args): |
|
|
|
|
|
|
295
|
|
|
part_number, part_range = args |
|
296
|
|
|
offset, content_length = part_range |
|
297
|
|
|
with open(contents.name, 'rb') as file: |
|
|
|
|
|
|
298
|
|
|
file.seek(offset) |
|
299
|
|
|
stream = RangeStream(file, offset, content_length) |
|
300
|
|
|
upload_part_url_response = self.connector.make_request(path=get_upload_part_url_path, method='post', params=params) |
|
|
|
|
|
|
301
|
|
|
if upload_part_url_response.status_code == 200: |
|
302
|
|
|
upload_url = upload_part_url_response.json().get('uploadUrl') |
|
303
|
|
|
auth_token = upload_part_url_response.json().get('authorizationToken') |
|
304
|
|
|
upload_part_response = self.connector.upload_part(file_contents=stream, content_length=content_length, |
|
|
|
|
|
|
305
|
|
|
part_number=part_number, upload_url=upload_url, |
|
|
|
|
|
|
306
|
|
|
auth_token=auth_token, progress_listener=progress_listener) |
|
|
|
|
|
|
307
|
|
|
if upload_part_response.status_code == 200: |
|
308
|
|
|
return upload_part_response.json().get('contentSha1', None) |
|
309
|
|
|
else: |
|
310
|
|
|
raise B2Exception.parse(upload_part_response) |
|
311
|
|
|
else: |
|
312
|
|
|
raise B2Exception.parse(upload_part_url_response) |
|
313
|
|
|
sha_list = pool.map(upload_part_worker, enumerate(get_part_ranges(content_length, part_size), 1)) |
|
|
|
|
|
|
314
|
|
|
pool.close() |
|
315
|
|
|
pool.join() |
|
316
|
|
|
finish_large_file_path = API.upload_large_finish |
|
317
|
|
|
params = { |
|
318
|
|
|
'fileId': file_id, |
|
319
|
|
|
'partSha1Array': sha_list |
|
320
|
|
|
} |
|
321
|
|
|
finish_large_file_response = self.connector.make_request(path=finish_large_file_path, method='post', params=params) |
|
|
|
|
|
|
322
|
|
|
if finish_large_file_response.status_code == 200: |
|
323
|
|
|
new_file = B2File(connector=self.connector, parent_list=self, **finish_large_file_response.json()) |
|
|
|
|
|
|
324
|
|
|
return new_file |
|
325
|
|
|
else: |
|
326
|
|
|
raise B2Exception.parse(finish_large_file_response) |
|
327
|
|
|
else: |
|
328
|
|
|
raise B2Exception.parse(large_file_response) |
|
329
|
|
|
|
This check looks for lines that are too long. You can specify the maximum line length.