1
|
|
|
#!/usr/bin/env python3 |
2
|
4 |
|
"""This module is used for network connections; APIs, downloading, etc.""" |
3
|
|
|
|
4
|
4 |
|
import os # filesystem read |
5
|
4 |
|
try: |
6
|
4 |
|
from defusedxml import ElementTree # safer XML parsing |
7
|
|
|
except (ImportError, AttributeError): |
8
|
|
|
from xml.etree import ElementTree # XML parsing |
9
|
4 |
|
import re # regexes |
10
|
4 |
|
import concurrent.futures # multiprocessing/threading |
11
|
4 |
|
import glob # pem file lookup |
12
|
4 |
|
import requests # downloading |
13
|
4 |
|
from bs4 import BeautifulSoup # scraping |
14
|
4 |
|
from bbarchivist import utilities # parse filesize |
15
|
4 |
|
from bbarchivist.bbconstants import SERVERS # lookup servers |
16
|
|
|
|
17
|
4 |
|
__author__ = "Thurask" |
18
|
4 |
|
__license__ = "WTFPL v2" |
19
|
4 |
|
__copyright__ = "Copyright 2015-2016 Thurask" |
20
|
|
|
|
21
|
|
|
|
22
|
4 |
|
def grab_pem(): |
23
|
|
|
""" |
24
|
|
|
Work with either local cacerts or system cacerts. |
25
|
|
|
""" |
26
|
4 |
|
try: |
27
|
4 |
|
pemfile = glob.glob(os.path.join(os.getcwd(), "cacert.pem"))[0] |
28
|
4 |
|
except IndexError: |
29
|
4 |
|
return requests.certs.where() # no local cacerts |
30
|
|
|
else: |
31
|
4 |
|
return os.path.abspath(pemfile) # local cacerts |
32
|
|
|
|
33
|
|
|
|
34
|
4 |
|
def pem_wrapper(method): |
35
|
|
|
""" |
36
|
|
|
Decorator to set REQUESTS_CA_BUNDLE. |
37
|
|
|
|
38
|
|
|
:param method: Method to use. |
39
|
|
|
:type method: function |
40
|
|
|
""" |
41
|
4 |
|
def wrapper(*args, **kwargs): |
42
|
|
|
""" |
43
|
|
|
Set REQUESTS_CA_BUNDLE before doing function. |
44
|
|
|
""" |
45
|
4 |
|
os.environ["REQUESTS_CA_BUNDLE"] = grab_pem() |
46
|
4 |
|
return method(*args, **kwargs) |
47
|
4 |
|
return wrapper |
48
|
|
|
|
49
|
|
|
|
50
|
4 |
|
def generic_soup_parser(url, session=None): |
51
|
|
|
""" |
52
|
|
|
Get a BeautifulSoup HTML parser for some URL. |
53
|
|
|
|
54
|
|
|
:param url: The URL to check. |
55
|
|
|
:type url: str |
56
|
|
|
|
57
|
|
|
:param session: Requests session object, default is created on the fly. |
58
|
|
|
:type session: requests.Session() |
59
|
|
|
""" |
60
|
4 |
|
session = requests.Session() if session is None else session |
61
|
4 |
|
req = session.get(url) |
62
|
4 |
|
soup = BeautifulSoup(req.content, "html.parser") |
63
|
4 |
|
return soup |
64
|
|
|
|
65
|
|
|
|
66
|
4 |
|
@pem_wrapper |
67
|
4 |
|
def get_length(url, session=None): |
68
|
|
|
""" |
69
|
|
|
Get content-length header from some URL. |
70
|
|
|
|
71
|
|
|
:param url: The URL to check. |
72
|
|
|
:type url: str |
73
|
|
|
|
74
|
|
|
:param session: Requests session object, default is created on the fly. |
75
|
|
|
:type session: requests.Session() |
76
|
|
|
""" |
77
|
4 |
|
session = requests.Session() if session is None else session |
78
|
4 |
|
if url is None: |
79
|
4 |
|
return 0 |
80
|
4 |
|
try: |
81
|
4 |
|
heads = session.head(url) |
82
|
4 |
|
fsize = heads.headers['content-length'] |
83
|
4 |
|
return int(fsize) |
84
|
4 |
|
except requests.ConnectionError: |
85
|
4 |
|
return 0 |
86
|
|
|
|
87
|
|
|
|
88
|
4 |
|
@pem_wrapper |
89
|
4 |
|
def download(url, output_directory=None, session=None): |
90
|
|
|
""" |
91
|
|
|
Download file from given URL. |
92
|
|
|
|
93
|
|
|
:param url: URL to download from. |
94
|
|
|
:type url: str |
95
|
|
|
|
96
|
|
|
:param output_directory: Download folder. Default is local. |
97
|
|
|
:type output_directory: str |
98
|
|
|
|
99
|
|
|
:param session: Requests session object, default is created on the fly. |
100
|
|
|
:type session: requests.Session() |
101
|
|
|
""" |
102
|
4 |
|
session = requests.Session() if session is None else session |
103
|
4 |
|
output_directory = os.getcwd() if output_directory is None else output_directory |
104
|
4 |
|
lfname = url.split('/')[-1] |
105
|
4 |
|
sname = utilities.stripper(lfname) |
106
|
4 |
|
fname = os.path.join(output_directory, lfname) |
107
|
4 |
|
download_writer(url, fname, lfname, sname, session) |
108
|
4 |
|
remove_empty_download(fname) |
109
|
|
|
|
110
|
|
|
|
111
|
4 |
|
def remove_empty_download(fname): |
112
|
|
|
""" |
113
|
|
|
Remove file if it's empty. |
114
|
|
|
|
115
|
|
|
:param fname: File path. |
116
|
|
|
:type fname: str |
117
|
|
|
""" |
118
|
4 |
|
if os.stat(fname).st_size == 0: |
119
|
4 |
|
os.remove(fname) |
120
|
|
|
|
121
|
|
|
|
122
|
4 |
|
def download_writer(url, fname, lfname, sname, session=None): |
123
|
|
|
""" |
124
|
|
|
Download file and write to disk. |
125
|
|
|
|
126
|
|
|
:param url: URL to download from. |
127
|
|
|
:type url: str |
128
|
|
|
|
129
|
|
|
:param fname: File path. |
130
|
|
|
:type fname: str |
131
|
|
|
|
132
|
|
|
:param lfname: Long filename. |
133
|
|
|
:type lfname: str |
134
|
|
|
|
135
|
|
|
:param sname: Short name, for printing to screen. |
136
|
|
|
:type sname: str |
137
|
|
|
|
138
|
|
|
:param session: Requests session object, default is created on the fly. |
139
|
|
|
:type session: requests.Session() |
140
|
|
|
""" |
141
|
4 |
|
with open(fname, "wb") as file: |
142
|
4 |
|
req = session.get(url, stream=True) |
143
|
4 |
|
clength = req.headers['content-length'] |
144
|
4 |
|
fsize = utilities.fsizer(clength) |
145
|
4 |
|
if req.status_code == 200: # 200 OK |
146
|
4 |
|
print("DOWNLOADING {0} [{1}]".format(sname, fsize)) |
147
|
4 |
|
for chunk in req.iter_content(chunk_size=1024): |
148
|
4 |
|
file.write(chunk) |
149
|
|
|
else: |
150
|
4 |
|
print("ERROR: HTTP {0} IN {1}".format(req.status_code, lfname)) |
151
|
|
|
|
152
|
|
|
|
153
|
4 |
|
def download_bootstrap(urls, outdir=None, workers=5, session=None): |
154
|
|
|
""" |
155
|
|
|
Run downloaders for each file in given URL iterable. |
156
|
|
|
|
157
|
|
|
:param urls: URLs to download. |
158
|
|
|
:type urls: list |
159
|
|
|
|
160
|
|
|
:param outdir: Download folder. Default is handled in :func:`download`. |
161
|
|
|
:type outdir: str |
162
|
|
|
|
163
|
|
|
:param workers: Number of worker processes. Default is 5. |
164
|
|
|
:type workers: int |
165
|
|
|
|
166
|
|
|
:param session: Requests session object, default is created on the fly. |
167
|
|
|
:type session: requests.Session() |
168
|
|
|
""" |
169
|
4 |
|
workers = len(urls) if len(urls) < workers else workers |
170
|
4 |
|
spinman = utilities.SpinManager() |
171
|
4 |
|
with concurrent.futures.ThreadPoolExecutor(max_workers=workers) as xec: |
172
|
4 |
|
try: |
173
|
4 |
|
spinman.start() |
174
|
4 |
|
for url in urls: |
175
|
4 |
|
xec.submit(download, url, outdir, session) |
176
|
|
|
except (KeyboardInterrupt, SystemExit): |
177
|
|
|
xec.shutdown() |
178
|
|
|
spinman.stop() |
179
|
4 |
|
spinman.stop() |
180
|
4 |
|
utilities.spinner_clear() |
181
|
4 |
|
utilities.line_begin() |
182
|
|
|
|
183
|
|
|
|
184
|
4 |
|
@pem_wrapper |
185
|
4 |
|
def availability(url, session=None): |
186
|
|
|
""" |
187
|
|
|
Check HTTP status code of given URL. |
188
|
|
|
200 or 301-308 is OK, else is not. |
189
|
|
|
|
190
|
|
|
:param url: URL to check. |
191
|
|
|
:type url: str |
192
|
|
|
|
193
|
|
|
:param session: Requests session object, default is created on the fly. |
194
|
|
|
:type session: requests.Session() |
195
|
|
|
""" |
196
|
4 |
|
session = requests.Session() if session is None else session |
197
|
4 |
|
try: |
198
|
4 |
|
avlty = session.head(url) |
199
|
4 |
|
status = int(avlty.status_code) |
200
|
4 |
|
return status == 200 or 300 < status <= 308 |
201
|
4 |
|
except requests.ConnectionError: |
202
|
4 |
|
return False |
203
|
|
|
|
204
|
|
|
|
205
|
4 |
|
def clean_availability(results, server): |
206
|
|
|
""" |
207
|
|
|
Clean availability for autolookup script. |
208
|
|
|
|
209
|
|
|
:param results: Result dict. |
210
|
|
|
:type results: dict(str: str) |
211
|
|
|
|
212
|
|
|
:param server: Server, key for result dict. |
213
|
|
|
:type server: str |
214
|
|
|
""" |
215
|
4 |
|
marker = "PD" if server == "p" else server.upper() |
216
|
4 |
|
rel = results[server.lower()] |
217
|
4 |
|
avail = marker if rel != "SR not in system" and rel is not None else " " |
218
|
4 |
|
return rel, avail |
219
|
|
|
|
220
|
|
|
|
221
|
4 |
|
@pem_wrapper |
222
|
4 |
|
def carrier_checker(mcc, mnc, session=None): |
223
|
|
|
""" |
224
|
|
|
Query BlackBerry World to map a MCC and a MNC to a country and carrier. |
225
|
|
|
|
226
|
|
|
:param mcc: Country code. |
227
|
|
|
:type mcc: int |
228
|
|
|
|
229
|
|
|
:param mnc: Network code. |
230
|
|
|
:type mnc: int |
231
|
|
|
|
232
|
|
|
:param session: Requests session object, default is created on the fly. |
233
|
|
|
:type session: requests.Session() |
234
|
|
|
""" |
235
|
4 |
|
session = requests.Session() if session is None else session |
236
|
4 |
|
url = "http://appworld.blackberry.com/ClientAPI/checkcarrier?homemcc={0}&homemnc={1}&devicevendorid=-1&pin=0".format( |
237
|
|
|
mcc, mnc) |
238
|
4 |
|
user_agent = {'User-agent': 'AppWorld/5.1.0.60'} |
239
|
4 |
|
req = session.get(url, headers=user_agent) |
240
|
4 |
|
root = ElementTree.fromstring(req.text) |
241
|
4 |
|
for child in root: |
242
|
4 |
|
if child.tag == "country": |
243
|
4 |
|
country = child.get("name") |
244
|
4 |
|
if child.tag == "carrier": |
245
|
4 |
|
carrier = child.get("name") |
246
|
4 |
|
return country, carrier |
247
|
|
|
|
248
|
|
|
|
249
|
4 |
|
def return_npc(mcc, mnc): |
250
|
|
|
""" |
251
|
|
|
Format MCC and MNC into a NPC. |
252
|
|
|
|
253
|
|
|
:param mcc: Country code. |
254
|
|
|
:type mcc: int |
255
|
|
|
|
256
|
|
|
:param mnc: Network code. |
257
|
|
|
:type mnc: int |
258
|
|
|
""" |
259
|
4 |
|
return "{0}{1}30".format(str(mcc).zfill(3), str(mnc).zfill(3)) |
260
|
|
|
|
261
|
|
|
|
262
|
4 |
|
@pem_wrapper |
263
|
4 |
|
def carrier_query(npc, device, upgrade=False, blitz=False, forced=None, session=None): |
264
|
|
|
""" |
265
|
|
|
Query BlackBerry servers, check which update is out for a carrier. |
266
|
|
|
|
267
|
|
|
:param npc: MCC + MNC (see `func:return_npc`) |
268
|
|
|
:type npc: int |
269
|
|
|
|
270
|
|
|
:param device: Hexadecimal hardware ID. |
271
|
|
|
:type device: str |
272
|
|
|
|
273
|
|
|
:param upgrade: Whether to use upgrade files. False by default. |
274
|
|
|
:type upgrade: bool |
275
|
|
|
|
276
|
|
|
:param blitz: Whether or not to create a blitz package. False by default. |
277
|
|
|
:type blitz: bool |
278
|
|
|
|
279
|
|
|
:param forced: Force a software release. |
280
|
|
|
:type forced: str |
281
|
|
|
|
282
|
|
|
:param session: Requests session object, default is created on the fly. |
283
|
|
|
:type session: requests.Session() |
284
|
|
|
""" |
285
|
4 |
|
session = requests.Session() if session is None else session |
286
|
4 |
|
upg = "upgrade" if upgrade else "repair" |
287
|
4 |
|
forced = "latest" if forced is None else forced |
288
|
4 |
|
url = "https://cs.sl.blackberry.com/cse/updateDetails/2.2/" |
289
|
4 |
|
query = '<?xml version="1.0" encoding="UTF-8"?>' |
290
|
4 |
|
query += '<updateDetailRequest version="2.2.1" authEchoTS="1366644680359">' |
291
|
4 |
|
query += "<clientProperties>" |
292
|
4 |
|
query += "<hardware>" |
293
|
4 |
|
query += "<pin>0x2FFFFFB3</pin><bsn>1128121361</bsn>" |
294
|
4 |
|
query += "<imei>004401139269240</imei>" |
295
|
4 |
|
query += "<id>0x{0}</id>".format(device) |
296
|
4 |
|
query += "</hardware>" |
297
|
4 |
|
query += "<network>" |
298
|
4 |
|
query += "<homeNPC>0x{0}</homeNPC>".format(npc) |
299
|
4 |
|
query += "<iccid>89014104255505565333</iccid>" |
300
|
4 |
|
query += "</network>" |
301
|
4 |
|
query += "<software>" |
302
|
4 |
|
query += "<currentLocale>en_US</currentLocale>" |
303
|
4 |
|
query += "<legalLocale>en_US</legalLocale>" |
304
|
4 |
|
query += "</software>" |
305
|
4 |
|
query += "</clientProperties>" |
306
|
4 |
|
query += "<updateDirectives>" |
307
|
4 |
|
query += '<allowPatching type="REDBEND">true</allowPatching>' |
308
|
4 |
|
query += "<upgradeMode>{0}</upgradeMode>".format(upg) |
309
|
4 |
|
query += "<provideDescriptions>false</provideDescriptions>" |
310
|
4 |
|
query += "<provideFiles>true</provideFiles>" |
311
|
4 |
|
query += "<queryType>NOTIFICATION_CHECK</queryType>" |
312
|
4 |
|
query += "</updateDirectives>" |
313
|
4 |
|
query += "<pollType>manual</pollType>" |
314
|
4 |
|
query += "<resultPackageSetCriteria>" |
315
|
4 |
|
query += '<softwareRelease softwareReleaseVersion="{0}" />'.format(forced) |
316
|
4 |
|
query += "<releaseIndependent>" |
317
|
4 |
|
query += '<packageType operation="include">application</packageType>' |
318
|
4 |
|
query += "</releaseIndependent>" |
319
|
4 |
|
query += "</resultPackageSetCriteria>" |
320
|
4 |
|
query += "</updateDetailRequest>" |
321
|
4 |
|
header = {"Content-Type": "text/xml;charset=UTF-8"} |
322
|
4 |
|
req = session.post(url, headers=header, data=query) |
323
|
4 |
|
return parse_carrier_xml(req.text, blitz) |
324
|
|
|
|
325
|
|
|
|
326
|
4 |
|
def carrier_swver_get(root): |
327
|
|
|
""" |
328
|
|
|
Get software release from carrier XML. |
329
|
|
|
|
330
|
|
|
:param root: ElementTree we're barking up. |
331
|
|
|
:type root: xml.etree.ElementTree.ElementTree |
332
|
|
|
""" |
333
|
4 |
|
for child in root.iter("softwareReleaseMetadata"): |
334
|
4 |
|
swver = child.get("softwareReleaseVersion") |
335
|
4 |
|
return swver |
336
|
|
|
|
337
|
|
|
|
338
|
4 |
|
def carrier_child_fileappend(child, files, baseurl, blitz=False): |
339
|
|
|
""" |
340
|
|
|
Append bar file links to a list from a child element. |
341
|
|
|
|
342
|
|
|
:param child: Child element in use. |
343
|
|
|
:type child: xml.etree.ElementTree.Element |
344
|
|
|
|
345
|
|
|
:param files: Filelist. |
346
|
|
|
:type files: list(str) |
347
|
|
|
|
348
|
|
|
:param baseurl: Base URL, URL minus the filename. |
349
|
|
|
:type baseurl: str |
350
|
|
|
|
351
|
|
|
:param blitz: Whether or not to create a blitz package. False by default. |
352
|
|
|
:type blitz: bool |
353
|
|
|
""" |
354
|
4 |
|
if not blitz: |
355
|
4 |
|
files.append(baseurl + child.get("path")) |
356
|
|
|
else: |
357
|
|
|
if child.get("type") not in ["system:radio", "system:desktop", "system:os"]: |
358
|
|
|
files.append(baseurl + child.get("path")) |
359
|
4 |
|
return files |
360
|
|
|
|
361
|
|
|
|
362
|
4 |
|
def carrier_child_finder(root, files, baseurl, blitz=False): |
363
|
|
|
""" |
364
|
|
|
Extract filenames, radio and OS from child elements. |
365
|
|
|
|
366
|
|
|
:param root: ElementTree we're barking up. |
367
|
|
|
:type root: xml.etree.ElementTree.ElementTree |
368
|
|
|
|
369
|
|
|
:param files: Filelist. |
370
|
|
|
:type files: list(str) |
371
|
|
|
|
372
|
|
|
:param baseurl: Base URL, URL minus the filename. |
373
|
|
|
:type baseurl: str |
374
|
|
|
|
375
|
|
|
:param blitz: Whether or not to create a blitz package. False by default. |
376
|
|
|
:type blitz: bool |
377
|
|
|
""" |
378
|
4 |
|
osver = radver = "" |
379
|
4 |
|
for child in root.iter("package"): |
380
|
4 |
|
files = carrier_child_fileappend(child, files, baseurl, blitz) |
381
|
4 |
|
if child.get("type") == "system:radio": |
382
|
4 |
|
radver = child.get("version") |
383
|
4 |
|
elif child.get("type") == "system:desktop": |
384
|
4 |
|
osver = child.get("version") |
385
|
|
|
elif child.get("type") == "system:os": |
386
|
|
|
osver = child.get("version") |
387
|
4 |
|
return osver, radver, files |
388
|
|
|
|
389
|
|
|
|
390
|
4 |
|
def parse_carrier_xml(data, blitz=False): |
391
|
|
|
""" |
392
|
|
|
Parse the response to a carrier update request and return the juicy bits. |
393
|
|
|
|
394
|
|
|
:param data: The data to parse. |
395
|
|
|
:type data: xml |
396
|
|
|
|
397
|
|
|
:param blitz: Whether or not to create a blitz package. False by default. |
398
|
|
|
:type blitz: bool |
399
|
|
|
""" |
400
|
4 |
|
root = ElementTree.fromstring(data) |
401
|
4 |
|
sw_exists = root.find('./data/content/softwareReleaseMetadata') |
402
|
4 |
|
swver = "N/A" if sw_exists is None else "" |
403
|
4 |
|
if sw_exists is not None: |
404
|
4 |
|
swver = carrier_swver_get(root) |
405
|
4 |
|
files = [] |
406
|
4 |
|
package_exists = root.find('./data/content/fileSets/fileSet') |
407
|
4 |
|
osver = radver = "" |
408
|
4 |
|
if package_exists is not None: |
409
|
4 |
|
baseurl = "{0}/".format(package_exists.get("url")) |
410
|
4 |
|
osver, radver, files = carrier_child_finder(root, files, baseurl, blitz) |
411
|
4 |
|
return(swver, osver, radver, files) |
412
|
|
|
|
413
|
|
|
|
414
|
4 |
|
@pem_wrapper |
415
|
4 |
|
def sr_lookup(osver, server, session=None): |
416
|
|
|
""" |
417
|
|
|
Software release lookup, with choice of server. |
418
|
|
|
:data:`bbarchivist.bbconstants.SERVERLIST` for server list. |
419
|
|
|
|
420
|
|
|
:param osver: OS version to lookup, 10.x.y.zzzz. |
421
|
|
|
:type osver: str |
422
|
|
|
|
423
|
|
|
:param server: Server to use. |
424
|
|
|
:type server: str |
425
|
|
|
|
426
|
|
|
:param session: Requests session object, default is created on the fly. |
427
|
|
|
:type session: requests.Session() |
428
|
|
|
""" |
429
|
4 |
|
session = requests.Session() if session is None else session |
430
|
4 |
|
reg = re.compile(r"(\d{1,4}\.)(\d{1,4}\.)(\d{1,4}\.)(\d{1,4})") |
431
|
4 |
|
query = '<?xml version="1.0" encoding="UTF-8"?>' |
432
|
4 |
|
query += '<srVersionLookupRequest version="2.0.0"' |
433
|
4 |
|
query += ' authEchoTS="1366644680359">' |
434
|
4 |
|
query += '<clientProperties><hardware>' |
435
|
4 |
|
query += '<pin>0x2FFFFFB3</pin><bsn>1140011878</bsn>' |
436
|
4 |
|
query += '<imei>004402242176786</imei><id>0x8D00240A</id>' |
437
|
4 |
|
query += '<isBootROMSecure>true</isBootROMSecure>' |
438
|
4 |
|
query += '</hardware>' |
439
|
4 |
|
query += '<network>' |
440
|
4 |
|
query += '<vendorId>0x0</vendorId><homeNPC>0x60</homeNPC>' |
441
|
4 |
|
query += '<currentNPC>0x60</currentNPC><ecid>0x1</ecid>' |
442
|
4 |
|
query += '</network>' |
443
|
4 |
|
query += '<software><currentLocale>en_US</currentLocale>' |
444
|
4 |
|
query += '<legalLocale>en_US</legalLocale>' |
445
|
4 |
|
query += '<osVersion>{0}</osVersion>'.format(osver) |
446
|
4 |
|
query += '<omadmEnabled>false</omadmEnabled>' |
447
|
4 |
|
query += '</software></clientProperties>' |
448
|
4 |
|
query += '</srVersionLookupRequest>' |
449
|
4 |
|
header = {"Content-Type": "text/xml;charset=UTF-8"} |
450
|
4 |
|
try: |
451
|
4 |
|
req = session.post(server, headers=header, data=query, timeout=1) |
452
|
4 |
|
except (requests.exceptions.Timeout, requests.exceptions.ConnectionError): |
453
|
4 |
|
return "SR not in system" |
454
|
4 |
|
try: |
455
|
4 |
|
root = ElementTree.fromstring(req.text) |
456
|
4 |
|
except ElementTree.ParseError: |
457
|
4 |
|
return "SR not in system" |
458
|
|
|
else: |
459
|
4 |
|
packages = root.findall('./data/content/') |
460
|
4 |
|
for package in packages: |
461
|
4 |
|
if package.text is not None: |
462
|
4 |
|
match = reg.match(package.text) |
463
|
4 |
|
if match: |
464
|
4 |
|
return package.text |
465
|
|
|
else: |
466
|
4 |
|
return "SR not in system" |
467
|
|
|
|
468
|
|
|
|
469
|
4 |
|
def sr_lookup_bootstrap(osv, session=None, noalpha2=False): |
470
|
|
|
""" |
471
|
|
|
Run lookups for each server for given OS. |
472
|
|
|
|
473
|
|
|
:param osv: OS to check. |
474
|
|
|
:type osv: str |
475
|
|
|
|
476
|
|
|
:param session: Requests session object, default is created on the fly. |
477
|
|
|
:type session: requests.Session() |
478
|
|
|
|
479
|
|
|
:param noalpha2: Whether to skip Alpha2 server. Default is false. |
480
|
|
|
:type noalpha2: bool |
481
|
|
|
""" |
482
|
4 |
|
with concurrent.futures.ThreadPoolExecutor(max_workers=5) as xec: |
483
|
4 |
|
try: |
484
|
4 |
|
results = { |
485
|
|
|
"p": None, |
486
|
|
|
"a1": None, |
487
|
|
|
"a2": None, |
488
|
|
|
"b1": None, |
489
|
|
|
"b2": None |
490
|
|
|
} |
491
|
4 |
|
if noalpha2: |
492
|
4 |
|
del results["a2"] |
493
|
4 |
|
for key in results: |
494
|
4 |
|
results[key] = xec.submit(sr_lookup, osv, SERVERS[key], session).result() |
495
|
4 |
|
return results |
496
|
|
|
except KeyboardInterrupt: |
497
|
|
|
xec.shutdown(wait=False) |
498
|
|
|
|
499
|
|
|
|
500
|
4 |
|
@pem_wrapper |
501
|
4 |
|
def available_bundle_lookup(mcc, mnc, device, session=None): |
502
|
|
|
""" |
503
|
|
|
Check which software releases were ever released for a carrier. |
504
|
|
|
|
505
|
|
|
:param mcc: Country code. |
506
|
|
|
:type mcc: int |
507
|
|
|
|
508
|
|
|
:param mnc: Network code. |
509
|
|
|
:type mnc: int |
510
|
|
|
|
511
|
|
|
:param device: Hexadecimal hardware ID. |
512
|
|
|
:type device: str |
513
|
|
|
|
514
|
|
|
:param session: Requests session object, default is created on the fly. |
515
|
|
|
:type session: requests.Session() |
516
|
|
|
""" |
517
|
4 |
|
session = requests.Session() if session is None else session |
518
|
4 |
|
server = "https://cs.sl.blackberry.com/cse/availableBundles/1.0.0/" |
519
|
4 |
|
npc = return_npc(mcc, mnc) |
520
|
4 |
|
query = '<?xml version="1.0" encoding="UTF-8"?>' |
521
|
4 |
|
query += '<availableBundlesRequest version="1.0.0" ' |
522
|
4 |
|
query += 'authEchoTS="1366644680359">' |
523
|
4 |
|
query += '<deviceId><pin>0x2FFFFFB3</pin></deviceId>' |
524
|
4 |
|
query += '<clientProperties><hardware><id>0x{0}</id>'.format(device) |
525
|
4 |
|
query += '<isBootROMSecure>true</isBootROMSecure></hardware>' |
526
|
4 |
|
query += '<network><vendorId>0x0</vendorId><homeNPC>0x{0}</homeNPC>'.format(npc) |
527
|
4 |
|
query += '<currentNPC>0x{0}</currentNPC></network><software>'.format(npc) |
528
|
4 |
|
query += '<currentLocale>en_US</currentLocale>' |
529
|
4 |
|
query += '<legalLocale>en_US</legalLocale>' |
530
|
4 |
|
query += '<osVersion>10.0.0.0</osVersion>' |
531
|
4 |
|
query += '<radioVersion>10.0.0.0</radioVersion></software>' |
532
|
4 |
|
query += '</clientProperties><updateDirectives><bundleVersionFilter>' |
533
|
4 |
|
query += '</bundleVersionFilter></updateDirectives>' |
534
|
4 |
|
query += '</availableBundlesRequest>' |
535
|
4 |
|
header = {"Content-Type": "text/xml;charset=UTF-8"} |
536
|
4 |
|
req = session.post(server, headers=header, data=query) |
537
|
4 |
|
root = ElementTree.fromstring(req.text) |
538
|
4 |
|
package = root.find('./data/content') |
539
|
4 |
|
bundlelist = [child.attrib["version"] for child in package] |
540
|
4 |
|
return bundlelist |
541
|
|
|
|
542
|
|
|
|
543
|
4 |
|
@pem_wrapper |
544
|
|
|
def ptcrb_scraper(ptcrbid): |
545
|
|
|
""" |
546
|
|
|
Get the PTCRB results for a given device. |
547
|
|
|
|
548
|
|
|
:param ptcrbid: Numerical ID from PTCRB (end of URL). |
549
|
|
|
:type ptcrbid: str |
550
|
|
|
""" |
551
|
4 |
|
baseurl = "https://ptcrb.com/vendor/complete/view_complete_request_guest.cfm?modelid={0}".format( |
552
|
|
|
ptcrbid) |
553
|
4 |
|
soup = generic_soup_parser(baseurl) |
554
|
4 |
|
text = soup.get_text() |
555
|
4 |
|
text = text.replace("\r\n", " ") |
556
|
4 |
|
prelimlist = re.findall("OS .+[^\\n]", text, re.IGNORECASE) |
557
|
4 |
|
if not prelimlist: # Priv |
558
|
4 |
|
prelimlist = re.findall(r"[A-Z]{3}[0-9]{3}[\s]", text) |
559
|
4 |
|
cleanlist = [] |
560
|
4 |
|
for item in prelimlist: |
561
|
4 |
|
if not item.endswith("\r\n"): # they should hire QC people... |
562
|
4 |
|
cleanlist.append(ptcrb_item_cleaner(item)) |
563
|
4 |
|
return cleanlist |
564
|
|
|
|
565
|
|
|
|
566
|
4 |
|
def ptcrb_item_cleaner(item): |
567
|
|
|
""" |
568
|
|
|
Cleanup poorly formatted PTCRB entries written by an intern. |
569
|
|
|
|
570
|
|
|
:param item: The item to clean. |
571
|
|
|
:type item: str |
572
|
|
|
""" |
573
|
4 |
|
item = item.replace("<td>", "") |
574
|
4 |
|
item = item.replace("</td>", "") |
575
|
4 |
|
item = item.replace("\n", "") |
576
|
4 |
|
item = item.replace(" (SR", ", SR") |
577
|
4 |
|
item = re.sub(r"\s?\((.*)$", "", item) |
578
|
4 |
|
item = re.sub(r"\sSV.*$", "", item) |
579
|
4 |
|
item = item.replace(")", "") |
580
|
4 |
|
item = item.replace(". ", ".") |
581
|
4 |
|
item = item.replace(";", "") |
582
|
4 |
|
item = item.replace("version", "Version") |
583
|
4 |
|
item = item.replace("Verison", "Version") |
584
|
4 |
|
if item.count("OS") > 1: |
585
|
4 |
|
templist = item.split("OS") |
586
|
4 |
|
templist[0] = "OS" |
587
|
4 |
|
item = "".join([templist[0], templist[1]]) |
588
|
4 |
|
item = item.replace("SR", "SW Release") |
589
|
4 |
|
item = item.replace(" Version:", ":") |
590
|
4 |
|
item = item.replace("Version ", " ") |
591
|
4 |
|
item = item.replace(":1", ": 1") |
592
|
4 |
|
item = item.replace(", ", " ") |
593
|
4 |
|
item = item.replace("Software", "SW") |
594
|
4 |
|
item = item.replace(" ", " ") |
595
|
4 |
|
item = item.replace("OS ", "OS: ") |
596
|
4 |
|
item = item.replace("Radio ", "Radio: ") |
597
|
4 |
|
item = item.replace("Release ", "Release: ") |
598
|
4 |
|
spaclist = item.split(" ") |
599
|
4 |
|
if len(spaclist) > 1: |
600
|
4 |
|
while len(spaclist[1]) < 11: |
601
|
4 |
|
spaclist[1] += " " |
602
|
4 |
|
while len(spaclist[3]) < 11: |
603
|
4 |
|
spaclist[3] += " " |
604
|
|
|
else: |
605
|
4 |
|
spaclist.insert(0, "OS:") |
606
|
4 |
|
item = " ".join(spaclist) |
607
|
4 |
|
item = item.strip() |
608
|
4 |
|
return item |
609
|
|
|
|
610
|
|
|
|
611
|
4 |
|
@pem_wrapper |
612
|
4 |
|
def kernel_scraper(utils=False): |
613
|
|
|
""" |
614
|
|
|
Scrape BlackBerry's GitHub kernel repo for available branches. |
615
|
|
|
|
616
|
|
|
:param utils: Check android-utils repo instead of android-linux-kernel. Default is False. |
617
|
|
|
:type utils: bool |
618
|
|
|
""" |
619
|
4 |
|
repo = "android-utils" if utils else "android-linux-kernel" |
620
|
4 |
|
kernlist = [] |
621
|
4 |
|
sess = requests.Session() |
622
|
4 |
|
for page in range(1, 10): |
623
|
4 |
|
url = "https://github.com/blackberry/{0}/branches/all?page={1}".format(repo, page) |
624
|
4 |
|
soup = generic_soup_parser(url, sess) |
625
|
4 |
|
if soup.find("div", {"class": "no-results-message"}): |
626
|
4 |
|
break |
627
|
|
|
else: |
628
|
4 |
|
text = soup.get_text() |
629
|
4 |
|
kernlist.extend(re.findall(r"msm[0-9]{4}\/[A-Z0-9]{6}", text, re.IGNORECASE)) |
630
|
4 |
|
return kernlist |
631
|
|
|
|
632
|
|
|
|
633
|
4 |
|
def root_generator(folder, build, variant="common"): |
634
|
|
|
""" |
635
|
|
|
Generate roots for the SHAxxx hash lookup URLs. |
636
|
|
|
|
637
|
|
|
:param folder: Dictionary of variant: loader name pairs. |
638
|
|
|
:type folder: dict(str: str) |
639
|
|
|
|
640
|
|
|
:param build: Build to check, 3 letters + 3 numbers. |
641
|
|
|
:type build: str |
642
|
|
|
|
643
|
|
|
:param variant: Autoloader variant. Default is "common". |
644
|
|
|
:type variant: str |
645
|
|
|
""" |
646
|
|
|
#Priv specific |
647
|
4 |
|
privx = "bbfoundation/hashfiles_priv/{0}".format(folder[variant]) |
648
|
|
|
#DTEK50 specific |
649
|
4 |
|
dtek50x = "bbSupport/DTEK50" if build[:3] == "AAF" else "bbfoundation/hashfiles_priv/dtek50" |
650
|
|
|
#DTEK60 specific |
651
|
4 |
|
dtek60x = dtek50x # still uses dtek50 folder, for some reason |
652
|
|
|
#Pack it up |
653
|
4 |
|
roots = {"Priv": privx, "DTEK50": dtek50x, "DTEK60": dtek60x} |
654
|
4 |
|
return roots |
655
|
|
|
|
656
|
|
|
|
657
|
4 |
|
def make_droid_skeleton(method, build, device, variant="common"): |
658
|
|
|
""" |
659
|
|
|
Make an Android autoloader/hash URL. |
660
|
|
|
|
661
|
|
|
:param method: None for regular OS links, "sha256/512" for SHA256 or 512 hash. |
662
|
|
|
:type method: str |
663
|
|
|
|
664
|
|
|
:param build: Build to check, 3 letters + 3 numbers. |
665
|
|
|
:type build: str |
666
|
|
|
|
667
|
|
|
:param device: Device to check. |
668
|
|
|
:type device: str |
669
|
|
|
|
670
|
|
|
:param variant: Autoloader variant. Default is "common". |
671
|
|
|
:type variant: str |
672
|
|
|
""" |
673
|
4 |
|
folder = {"vzw-vzw": "verizon", "na-att": "att", "na-tmo": "tmo", "common": "default"} |
674
|
4 |
|
devices = {"Priv": "qc8992", "DTEK50": "qc8952_64_sfi", "DTEK60": "qc8996"} |
675
|
4 |
|
roots = root_generator(folder, build, variant) |
676
|
4 |
|
base = "bbry_{2}_autoloader_user-{0}-{1}".format(variant, build.upper(), devices[device]) |
677
|
4 |
|
if method is None: |
678
|
4 |
|
skel = "https://bbapps.download.blackberry.com/Priv/{0}.zip".format(base) |
679
|
|
|
else: |
680
|
4 |
|
skel = "http://ca.blackberry.com/content/dam/{1}/{0}.{2}sum".format(base, roots[device], method.lower()) |
681
|
4 |
|
return skel |
682
|
|
|
|
683
|
|
|
|
684
|
4 |
|
def bulk_droid_skeletons(devs, build, method=None): |
685
|
|
|
""" |
686
|
|
|
Prepare list of Android autoloader/hash URLs. |
687
|
|
|
|
688
|
|
|
:param devs: List of devices. |
689
|
|
|
:type devs: list(str) |
690
|
|
|
|
691
|
|
|
:param build: Build to check, 3 letters + 3 numbers. |
692
|
|
|
:type build: str |
693
|
|
|
|
694
|
|
|
:param method: None for regular OS links, "sha256/512" for SHA256 or 512 hash. |
695
|
|
|
:type method: str |
696
|
|
|
""" |
697
|
4 |
|
carrier_variants = ("common", "vzw-vzw", "na-tmo", "na-att") # device variants |
698
|
4 |
|
common_variants = ("common", ) # no Americans |
699
|
4 |
|
carrier_devices = ("Priv", ) # may this list never expand in the future |
700
|
4 |
|
skels = [] |
701
|
4 |
|
for dev in devs: |
702
|
4 |
|
varlist = carrier_variants if dev in carrier_devices else common_variants |
703
|
4 |
|
for var in varlist: |
704
|
4 |
|
skel = make_droid_skeleton(method, build, dev, var) |
705
|
4 |
|
skels.append(skel) |
706
|
4 |
|
return skels |
707
|
|
|
|
708
|
|
|
|
709
|
4 |
|
def prepare_droid_list(device): |
710
|
|
|
""" |
711
|
|
|
Convert single devices to a list, if necessary. |
712
|
|
|
|
713
|
|
|
:param device: Device to check. |
714
|
|
|
:type device: str |
715
|
|
|
""" |
716
|
4 |
|
if isinstance(device, list): |
717
|
4 |
|
devs = device |
718
|
|
|
else: |
719
|
4 |
|
devs = [device] |
720
|
4 |
|
return devs |
721
|
|
|
|
722
|
|
|
|
723
|
4 |
|
def droid_scanner(build, device, method=None, session=None): |
724
|
|
|
""" |
725
|
|
|
Check for Android autoloaders on BlackBerry's site. |
726
|
|
|
|
727
|
|
|
:param build: Build to check, 3 letters + 3 numbers. |
728
|
|
|
:type build: str |
729
|
|
|
|
730
|
|
|
:param device: Device to check. |
731
|
|
|
:type device: str |
732
|
|
|
|
733
|
|
|
:param method: None for regular OS links, "sha256/512" for SHA256 or 512 hash. |
734
|
|
|
:type method: str |
735
|
|
|
|
736
|
|
|
:param session: Requests session object, default is created on the fly. |
737
|
|
|
:type session: requests.Session() |
738
|
|
|
""" |
739
|
4 |
|
devs = prepare_droid_list(device) |
740
|
4 |
|
skels = bulk_droid_skeletons(devs, build, method) |
741
|
4 |
|
with concurrent.futures.ThreadPoolExecutor(max_workers=len(skels)) as xec: |
742
|
4 |
|
results = [] |
743
|
4 |
|
for skel in skels: |
744
|
4 |
|
avail = xec.submit(availability, skel, session) |
745
|
4 |
|
if avail.result(): |
746
|
4 |
|
results.append(skel) |
747
|
4 |
|
return results if results else None |
748
|
|
|
|
749
|
|
|
|
750
|
4 |
|
def chunker(iterable, inc): |
751
|
|
|
""" |
752
|
|
|
Convert an iterable into a list of inc sized lists. |
753
|
|
|
|
754
|
|
|
:param chunker: Iterable to chunk. |
755
|
|
|
:type chunker: list |
756
|
|
|
|
757
|
|
|
:param inc: Increment; how big each chunk is. |
758
|
|
|
:type inc: int |
759
|
|
|
""" |
760
|
4 |
|
chunks = [iterable[x:x+inc] for x in range(0, len(iterable), inc)] |
761
|
4 |
|
return chunks |
762
|
|
|
|
763
|
|
|
|
764
|
4 |
|
def unicode_filter(intext): |
765
|
|
|
""" |
766
|
|
|
Remove Unicode crap. |
767
|
|
|
|
768
|
|
|
:param intext: Text to filter. |
769
|
|
|
:type intext: str |
770
|
|
|
""" |
771
|
4 |
|
return intext.replace("\u2013", "").strip() |
772
|
|
|
|
773
|
|
|
|
774
|
4 |
|
def table_header_filter(ptag): |
775
|
|
|
""" |
776
|
|
|
Validate p tag, to see if it's relevant. |
777
|
|
|
|
778
|
|
|
:param ptag: P tag. |
779
|
|
|
:type ptag: bs4.element.Tag |
780
|
|
|
""" |
781
|
4 |
|
valid = ptag.find("b") and "BlackBerry" in ptag.text and not "experts" in ptag.text |
782
|
4 |
|
return valid |
783
|
|
|
|
784
|
|
|
|
785
|
4 |
|
def table_headers(pees): |
786
|
|
|
""" |
787
|
|
|
Generate table headers from list of p tags. |
788
|
|
|
|
789
|
|
|
:param pees: List of p tags. |
790
|
|
|
:type pees: list(bs4.element.Tag) |
791
|
|
|
""" |
792
|
4 |
|
bolds = [x.text for x in pees if table_header_filter(x)] |
793
|
4 |
|
return bolds |
794
|
|
|
|
795
|
|
|
|
796
|
4 |
|
@pem_wrapper |
797
|
|
|
def loader_page_scraper(): |
798
|
|
|
""" |
799
|
|
|
Return scraped autoloader page. |
800
|
|
|
""" |
801
|
4 |
|
url = "http://ca.blackberry.com/content/blackberry-com/en_ca/support/smartphones/Android-OS-Reload.html" |
802
|
4 |
|
sess = requests.Session() |
803
|
4 |
|
soup = generic_soup_parser(url, sess) |
804
|
4 |
|
tables = soup.find_all("table") |
805
|
4 |
|
headers = table_headers(soup.find_all("p")) |
806
|
4 |
|
for idx, table in enumerate(tables): |
807
|
4 |
|
print("~~~{0}~~~".format(headers[idx])) |
808
|
4 |
|
chunks = chunker(table.find_all("td"), 4) |
809
|
4 |
|
for chunk in chunks: |
810
|
4 |
|
key = unicode_filter(chunk[0].text) |
811
|
4 |
|
ver = unicode_filter(chunk[1].text) |
812
|
4 |
|
link = unicode_filter(chunk[2].find("a")["href"]) |
813
|
4 |
|
print("{0}\n {1}: {2}".format(key, ver, link)) |
814
|
4 |
|
print(" ") |
815
|
|
|
|
816
|
|
|
|
817
|
4 |
|
@pem_wrapper |
818
|
4 |
|
def base_metadata(url, session=None): |
819
|
|
|
""" |
820
|
|
|
Get BBNDK metadata, base function. |
821
|
|
|
|
822
|
|
|
:param url: URL to check. |
823
|
|
|
:type url: str |
824
|
|
|
|
825
|
|
|
:param session: Requests session object, default is created on the fly. |
826
|
|
|
:type session: requests.Session() |
827
|
|
|
""" |
828
|
4 |
|
session = requests.Session() if session is None else session |
829
|
4 |
|
req = session.get(url) |
830
|
4 |
|
data = req.content |
831
|
4 |
|
entries = data.split(b"\n") |
832
|
4 |
|
metadata = [entry.split(b",")[1].decode("utf-8") for entry in entries if entry] |
833
|
4 |
|
return metadata |
834
|
|
|
|
835
|
|
|
|
836
|
4 |
|
def ndk_metadata(session=None): |
837
|
|
|
""" |
838
|
|
|
Get BBNDK target metadata. |
839
|
|
|
|
840
|
|
|
:param session: Requests session object, default is created on the fly. |
841
|
|
|
:type session: requests.Session() |
842
|
|
|
""" |
843
|
4 |
|
data = base_metadata("http://downloads.blackberry.com/upr/developers/update/bbndk/metadata", session) |
844
|
4 |
|
metadata = [entry for entry in data if entry.startswith(("10.0", "10.1", "10.2"))] |
845
|
4 |
|
return metadata |
846
|
|
|
|
847
|
|
|
|
848
|
4 |
|
def sim_metadata(session=None): |
849
|
|
|
""" |
850
|
|
|
Get BBNDK simulator metadata. |
851
|
|
|
|
852
|
|
|
:param session: Requests session object, default is created on the fly. |
853
|
|
|
:type session: requests.Session() |
854
|
|
|
""" |
855
|
4 |
|
metadata = base_metadata("http://downloads.blackberry.com/upr/developers/update/bbndk/simulator/simulator_metadata", session) |
856
|
4 |
|
return metadata |
857
|
|
|
|
858
|
|
|
|
859
|
4 |
|
def runtime_metadata(session=None): |
860
|
|
|
""" |
861
|
|
|
Get BBNDK runtime metadata. |
862
|
|
|
|
863
|
|
|
:param session: Requests session object, default is created on the fly. |
864
|
|
|
:type session: requests.Session() |
865
|
|
|
""" |
866
|
4 |
|
metadata = base_metadata("http://downloads.blackberry.com/upr/developers/update/bbndk/runtime/runtime_metadata", session) |
867
|
4 |
|
return metadata |
868
|
|
|
|
869
|
|
|
|
870
|
4 |
|
def series_generator(osversion): |
871
|
|
|
""" |
872
|
|
|
Generate series/branch name from OS version. |
873
|
|
|
|
874
|
|
|
:param osversion: OS version. |
875
|
|
|
:type osversion: str |
876
|
|
|
""" |
877
|
4 |
|
splits = osversion.split(".") |
878
|
4 |
|
return "BB{0}_{1}_{2}".format(*splits[0:3]) |
879
|
|
|
|
880
|
|
|
|
881
|
4 |
|
@pem_wrapper |
882
|
4 |
|
def devalpha_urls(osversion, skel, session=None): |
883
|
|
|
""" |
884
|
|
|
Check individual Dev Alpha autoloader URLs. |
885
|
|
|
|
886
|
|
|
:param osversion: OS version. |
887
|
|
|
:type osversion: str |
888
|
|
|
|
889
|
|
|
:param skel: Individual skeleton format to try. |
890
|
|
|
:type skel: str |
891
|
|
|
|
892
|
|
|
:param session: Requests session object, default is created on the fly. |
893
|
|
|
:type session: requests.Session() |
894
|
|
|
""" |
895
|
4 |
|
session = requests.Session() if session is None else session |
896
|
4 |
|
url = "http://downloads.blackberry.com/upr/developers/downloads/{0}{1}.exe".format(skel, osversion) |
897
|
4 |
|
req = session.head(url) |
898
|
4 |
|
if req.status_code == 200: |
899
|
4 |
|
finals = (url, req.headers["content-length"]) |
900
|
|
|
else: |
901
|
4 |
|
finals = () |
902
|
4 |
|
return finals |
903
|
|
|
|
904
|
|
|
|
905
|
4 |
|
def devalpha_urls_bootstrap(osversion, skeletons, session=None): |
906
|
|
|
""" |
907
|
|
|
Get list of valid Dev Alpha autoloader URLs. |
908
|
|
|
|
909
|
|
|
:param osversion: OS version. |
910
|
|
|
:type osversion: str |
911
|
|
|
|
912
|
|
|
:param skeletons: List of skeleton formats to try. |
913
|
|
|
:type skeletons: list |
914
|
|
|
|
915
|
|
|
:param session: Requests session object, default is created on the fly. |
916
|
|
|
:type session: requests.Session() |
917
|
|
|
""" |
918
|
4 |
|
with concurrent.futures.ThreadPoolExecutor(max_workers=5) as xec: |
919
|
4 |
|
try: |
920
|
4 |
|
finals = {} |
921
|
4 |
|
skels = skeletons |
922
|
4 |
|
for idx, skel in enumerate(skeletons): |
923
|
4 |
|
if "<SERIES>" in skel: |
924
|
4 |
|
skels[idx] = skel.replace("<SERIES>", series_generator(osversion)) |
925
|
4 |
|
for skel in skels: |
926
|
4 |
|
final = xec.submit(devalpha_urls, osversion, skel, session).result() |
927
|
4 |
|
if final: |
928
|
4 |
|
finals[final[0]] = final[1] |
929
|
4 |
|
return finals |
930
|
|
|
except KeyboardInterrupt: |
931
|
|
|
xec.shutdown(wait=False) |
932
|
|
|
|
933
|
|
|
|
934
|
4 |
|
def dev_dupe_cleaner(finals): |
935
|
|
|
""" |
936
|
|
|
Clean duplicate autoloader entries. |
937
|
|
|
|
938
|
|
|
:param finals: Dict of URL:content-length pairs. |
939
|
|
|
:type finals: dict(str: str) |
940
|
|
|
""" |
941
|
4 |
|
revo = {} |
942
|
4 |
|
for key, val in finals.items(): |
943
|
4 |
|
revo.setdefault(val, set()).add(key) |
944
|
4 |
|
dupelist = [val for key, val in revo.items() if len(val) > 1] |
945
|
4 |
|
for dupe in dupelist: |
946
|
4 |
|
for entry in dupe: |
947
|
4 |
|
if "DevAlpha" in entry: |
948
|
4 |
|
del finals[entry] |
949
|
|
|
return finals |
950
|
|
|
|