1
|
|
|
#!/usr/bin/env python3 |
2
|
|
|
"""This module is used for network connections; APIs, downloading, etc.""" |
3
|
|
|
|
4
|
|
|
import os # filesystem read |
5
|
|
|
import xml.etree.ElementTree # XML parsing |
6
|
|
|
import re # regexes |
7
|
|
|
import hashlib # base url creation |
8
|
|
|
import concurrent.futures # multiprocessing/threading |
9
|
|
|
import glob # pem file lookup |
10
|
|
|
import requests # downloading |
11
|
|
|
from bs4 import BeautifulSoup # scraping |
|
|
|
|
12
|
|
|
from bbarchivist import utilities # parse filesize |
13
|
|
|
from bbarchivist.bbconstants import SERVERS # lookup servers |
14
|
|
|
|
15
|
|
|
__author__ = "Thurask" |
16
|
|
|
__license__ = "WTFPL v2" |
17
|
|
|
__copyright__ = "Copyright 2015-2016 Thurask" |
18
|
|
|
|
19
|
|
|
|
20
|
|
|
def grab_pem(): |
21
|
|
|
""" |
22
|
|
|
Work with either local cacerts or system cacerts. Since cx_freeze is dumb. |
23
|
|
|
""" |
24
|
|
|
try: |
25
|
|
|
pemfile = glob.glob(os.path.join(os.getcwd(), "cacert.pem"))[0] |
26
|
|
|
except IndexError: |
27
|
|
|
return requests.certs.where() # no local cacerts |
28
|
|
|
else: |
29
|
|
|
return os.path.abspath(pemfile) # local cacerts |
30
|
|
|
|
31
|
|
|
|
32
|
|
|
def get_length(url): |
33
|
|
|
""" |
34
|
|
|
Get content-length header from some URL. |
35
|
|
|
|
36
|
|
|
:param url: The URL to check. |
37
|
|
|
:type url: str |
38
|
|
|
""" |
39
|
|
|
os.environ["REQUESTS_CA_BUNDLE"] = grab_pem() |
40
|
|
|
if url is None: |
41
|
|
|
return 0 |
42
|
|
|
try: |
43
|
|
|
heads = requests.head(url) |
44
|
|
|
fsize = heads.headers['content-length'] |
45
|
|
|
return int(fsize) |
46
|
|
|
except requests.ConnectionError: |
47
|
|
|
return 0 |
48
|
|
|
|
49
|
|
|
|
50
|
|
|
def download(url, output_directory=None): |
51
|
|
|
""" |
52
|
|
|
Download file from given URL. |
53
|
|
|
|
54
|
|
|
:param url: URL to download from. |
55
|
|
|
:type url: str |
56
|
|
|
|
57
|
|
|
:param output_directory: Download folder. Default is local. |
58
|
|
|
:type output_directory: str |
59
|
|
|
""" |
60
|
|
|
if output_directory is None: |
61
|
|
|
output_directory = os.getcwd() |
62
|
|
|
lfname = url.split('/')[-1] |
63
|
|
|
sname = utilities.stripper(lfname) |
64
|
|
|
os.environ["REQUESTS_CA_BUNDLE"] = grab_pem() |
65
|
|
|
fname = os.path.join(output_directory, lfname) |
66
|
|
|
with open(fname, "wb") as file: |
67
|
|
|
req = requests.get(url, stream=True) |
68
|
|
|
clength = req.headers['content-length'] |
69
|
|
|
fsize = utilities.fsizer(clength) |
70
|
|
|
if req.status_code == 200: # 200 OK |
71
|
|
|
print("DOWNLOADING {0} [{1}]".format(sname, fsize)) |
72
|
|
|
for chunk in req.iter_content(chunk_size=1024): |
73
|
|
|
file.write(chunk) |
74
|
|
|
else: |
75
|
|
|
print("ERROR: HTTP {0} IN {1}".format(req.status_code, lfname)) |
76
|
|
|
|
77
|
|
|
|
78
|
|
|
def download_bootstrap(urls, outdir=None, workers=5): |
79
|
|
|
""" |
80
|
|
|
Run downloaders for each file in given URL iterable. |
81
|
|
|
|
82
|
|
|
:param urls: URLs to download. |
83
|
|
|
:type urls: list |
84
|
|
|
|
85
|
|
|
:param outdir: Download folder. Default is handled in :func:`download`. |
86
|
|
|
:type outdir: str |
87
|
|
|
|
88
|
|
|
:param workers: Number of worker processes. Default is 5. |
89
|
|
|
:type workers: int |
90
|
|
|
""" |
91
|
|
|
workers = len(urls) if len(urls) < workers else workers |
92
|
|
|
spinman = utilities.SpinManager() |
93
|
|
|
with concurrent.futures.ThreadPoolExecutor(max_workers=workers) as xec: |
94
|
|
|
try: |
95
|
|
|
spinman.start() |
96
|
|
|
for url in urls: |
97
|
|
|
xec.submit(download, url, outdir) |
98
|
|
|
except (KeyboardInterrupt, SystemExit): # pragma: no cover |
99
|
|
|
xec.shutdown() |
100
|
|
|
spinman.stop() |
101
|
|
|
spinman.stop() |
102
|
|
|
utilities.spinner_clear() |
103
|
|
|
utilities.line_begin() |
104
|
|
|
|
105
|
|
|
|
106
|
|
|
def create_base_url(softwareversion): |
107
|
|
|
""" |
108
|
|
|
Make the root URL for production server files. |
109
|
|
|
|
110
|
|
|
:param softwareversion: Software version to hash. |
111
|
|
|
:type softwareversion: str |
112
|
|
|
""" |
113
|
|
|
# Hash software version |
114
|
|
|
swhash = hashlib.sha1(softwareversion.encode('utf-8')) |
115
|
|
|
hashedsoftwareversion = swhash.hexdigest() |
116
|
|
|
# Root of all urls |
117
|
|
|
baseurl = "http://cdn.fs.sl.blackberry.com/fs/qnx/production/" + hashedsoftwareversion |
118
|
|
|
return baseurl |
119
|
|
|
|
120
|
|
|
|
121
|
|
|
def availability(url): |
122
|
|
|
""" |
123
|
|
|
Check HTTP status code of given URL. |
124
|
|
|
200 or 301-308 is OK, else is not. |
125
|
|
|
|
126
|
|
|
:param url: URL to check. |
127
|
|
|
:type url: str |
128
|
|
|
""" |
129
|
|
|
os.environ["REQUESTS_CA_BUNDLE"] = grab_pem() |
130
|
|
|
try: |
131
|
|
|
avlty = requests.head(url) |
132
|
|
|
status = int(avlty.status_code) |
133
|
|
|
return status == 200 or 300 < status <= 308 |
134
|
|
|
except requests.ConnectionError: |
135
|
|
|
return False |
136
|
|
|
|
137
|
|
|
|
138
|
|
|
def clean_availability(results, server): |
139
|
|
|
""" |
140
|
|
|
Clean availability for autolookup script. |
141
|
|
|
|
142
|
|
|
:param results: Result dict. |
143
|
|
|
:type results: dict(str: str) |
144
|
|
|
|
145
|
|
|
:param server: Server, key for result dict. |
146
|
|
|
:type server: str |
147
|
|
|
""" |
148
|
|
|
marker = "PD" if server == "p" else server.upper() |
149
|
|
|
rel = results[server.lower()] |
150
|
|
|
avail = marker if rel != "SR not in system" and rel is not None else " " |
151
|
|
|
return rel, avail |
152
|
|
|
|
153
|
|
|
|
154
|
|
|
def carrier_checker(mcc, mnc): |
155
|
|
|
""" |
156
|
|
|
Query BlackBerry World to map a MCC and a MNC to a country and carrier. |
157
|
|
|
|
158
|
|
|
:param mcc: Country code. |
159
|
|
|
:type mcc: int |
160
|
|
|
|
161
|
|
|
:param mnc: Network code. |
162
|
|
|
:type mnc: int |
163
|
|
|
""" |
164
|
|
|
url = "http://appworld.blackberry.com/ClientAPI/checkcarrier?homemcc={0}&homemnc={1}&devicevendorid=-1&pin=0".format( |
|
|
|
|
165
|
|
|
mcc, mnc) |
166
|
|
|
user_agent = {'User-agent': 'AppWorld/5.1.0.60'} |
167
|
|
|
os.environ["REQUESTS_CA_BUNDLE"] = grab_pem() |
168
|
|
|
req = requests.get(url, headers=user_agent) |
169
|
|
|
root = xml.etree.ElementTree.fromstring(req.text) |
170
|
|
|
for child in root: |
171
|
|
|
if child.tag == "country": |
172
|
|
|
country = child.get("name") |
173
|
|
|
if child.tag == "carrier": |
174
|
|
|
carrier = child.get("name") |
175
|
|
|
return country, carrier |
176
|
|
|
|
177
|
|
|
|
178
|
|
|
def return_npc(mcc, mnc): |
179
|
|
|
""" |
180
|
|
|
Format MCC and MNC into a NPC. |
181
|
|
|
|
182
|
|
|
:param mcc: Country code. |
183
|
|
|
:type mcc: int |
184
|
|
|
|
185
|
|
|
:param mnc: Network code. |
186
|
|
|
:type mnc: int |
187
|
|
|
""" |
188
|
|
|
return "{0}{1}30".format(str(mcc).zfill(3), str(mnc).zfill(3)) |
189
|
|
|
|
190
|
|
|
|
191
|
|
|
def carrier_query(npc, device, upgrade=False, blitz=False, forced=None): |
192
|
|
|
""" |
193
|
|
|
Query BlackBerry servers, check which update is out for a carrier. |
194
|
|
|
|
195
|
|
|
:param npc: MCC + MNC (see `func:return_npc`) |
196
|
|
|
:type npc: int |
197
|
|
|
|
198
|
|
|
:param device: Hexadecimal hardware ID. |
199
|
|
|
:type device: str |
200
|
|
|
|
201
|
|
|
:param upgrade: Whether to use upgrade files. False by default. |
202
|
|
|
:type upgrade: bool |
203
|
|
|
|
204
|
|
|
:param blitz: Whether or not to create a blitz package. False by default. |
205
|
|
|
:type blitz: bool |
206
|
|
|
|
207
|
|
|
:param forced: Force a software release. |
208
|
|
|
:type forced: str |
209
|
|
|
""" |
210
|
|
|
upg = "upgrade" if upgrade else "repair" |
211
|
|
|
forced = "latest" if forced is None else forced |
212
|
|
|
url = "https://cs.sl.blackberry.com/cse/updateDetails/2.2/" |
213
|
|
|
query = '<?xml version="1.0" encoding="UTF-8"?>' |
214
|
|
|
query += '<updateDetailRequest version="2.2.1" authEchoTS="1366644680359">' |
215
|
|
|
query += "<clientProperties>" |
216
|
|
|
query += "<hardware>" |
217
|
|
|
query += "<pin>0x2FFFFFB3</pin><bsn>1128121361</bsn>" |
218
|
|
|
query += "<imei>004401139269240</imei>" |
219
|
|
|
query += "<id>0x{0}</id>".format(device) |
220
|
|
|
query += "</hardware>" |
221
|
|
|
query += "<network>" |
222
|
|
|
query += "<homeNPC>0x{0}</homeNPC>".format(npc) |
223
|
|
|
query += "<iccid>89014104255505565333</iccid>" |
224
|
|
|
query += "</network>" |
225
|
|
|
query += "<software>" |
226
|
|
|
query += "<currentLocale>en_US</currentLocale>" |
227
|
|
|
query += "<legalLocale>en_US</legalLocale>" |
228
|
|
|
query += "</software>" |
229
|
|
|
query += "</clientProperties>" |
230
|
|
|
query += "<updateDirectives>" |
231
|
|
|
query += '<allowPatching type="REDBEND">true</allowPatching>' |
232
|
|
|
query += "<upgradeMode>{0}</upgradeMode>".format(upg) |
233
|
|
|
query += "<provideDescriptions>false</provideDescriptions>" |
234
|
|
|
query += "<provideFiles>true</provideFiles>" |
235
|
|
|
query += "<queryType>NOTIFICATION_CHECK</queryType>" |
236
|
|
|
query += "</updateDirectives>" |
237
|
|
|
query += "<pollType>manual</pollType>" |
238
|
|
|
query += "<resultPackageSetCriteria>" |
239
|
|
|
query += '<softwareRelease softwareReleaseVersion="{0}" />'.format(forced) |
240
|
|
|
query += "<releaseIndependent>" |
241
|
|
|
query += '<packageType operation="include">application</packageType>' |
242
|
|
|
query += "</releaseIndependent>" |
243
|
|
|
query += "</resultPackageSetCriteria>" |
244
|
|
|
query += "</updateDetailRequest>" |
245
|
|
|
header = {"Content-Type": "text/xml;charset=UTF-8"} |
246
|
|
|
os.environ["REQUESTS_CA_BUNDLE"] = grab_pem() |
247
|
|
|
req = requests.post(url, headers=header, data=query) |
248
|
|
|
return parse_carrier_xml(req.text, blitz) |
249
|
|
|
|
250
|
|
|
|
251
|
|
|
def parse_carrier_xml(data, blitz=False): |
252
|
|
|
""" |
253
|
|
|
Parse the response to a carrier update request and return the juicy bits. |
254
|
|
|
|
255
|
|
|
:param data: The data to parse. |
256
|
|
|
:type data: xml |
257
|
|
|
|
258
|
|
|
:param blitz: Whether or not to create a blitz package. False by default. |
259
|
|
|
:type blitz: bool |
260
|
|
|
""" |
261
|
|
|
root = xml.etree.ElementTree.fromstring(data) |
262
|
|
|
sw_exists = root.find('./data/content/softwareReleaseMetadata') |
263
|
|
|
swver = "N/A" if sw_exists is None else "" |
264
|
|
|
if sw_exists is not None: |
265
|
|
|
for child in root.iter("softwareReleaseMetadata"): |
266
|
|
|
swver = child.get("softwareReleaseVersion") |
267
|
|
|
files = [] |
268
|
|
|
osver = "" |
269
|
|
|
radver = "" |
270
|
|
|
package_exists = root.find('./data/content/fileSets/fileSet') |
271
|
|
|
if package_exists is not None: |
272
|
|
|
baseurl = "{0}/".format(package_exists.get("url")) |
273
|
|
|
for child in root.iter("package"): |
274
|
|
|
if not blitz: |
275
|
|
|
files.append(baseurl + child.get("path")) |
276
|
|
|
else: |
277
|
|
|
if child.get("type") not in ["system:radio", "system:desktop", "system:os"]: |
278
|
|
|
files.append(baseurl + child.get("path")) |
279
|
|
|
if child.get("type") == "system:radio": |
280
|
|
|
radver = child.get("version") |
281
|
|
|
if child.get("type") == "system:desktop": |
282
|
|
|
osver = child.get("version") |
283
|
|
|
if child.get("type") == "system:os": |
284
|
|
|
osver = child.get("version") |
285
|
|
|
else: |
286
|
|
|
pass |
287
|
|
|
return(swver, osver, radver, files) |
288
|
|
|
|
289
|
|
|
|
290
|
|
|
def sr_lookup(osver, server): |
291
|
|
|
""" |
292
|
|
|
Software release lookup, with choice of server. |
293
|
|
|
:data:`bbarchivist.bbconstants.SERVERLIST` for server list. |
294
|
|
|
|
295
|
|
|
:param osver: OS version to lookup, 10.x.y.zzzz. |
296
|
|
|
:type osver: str |
297
|
|
|
|
298
|
|
|
:param server: Server to use. |
299
|
|
|
:type server: str |
300
|
|
|
""" |
301
|
|
|
reg = re.compile(r"(\d{1,4}\.)(\d{1,4}\.)(\d{1,4}\.)(\d{1,4})") |
302
|
|
|
query = '<?xml version="1.0" encoding="UTF-8"?>' |
303
|
|
|
query += '<srVersionLookupRequest version="2.0.0"' |
304
|
|
|
query += ' authEchoTS="1366644680359">' |
305
|
|
|
query += '<clientProperties><hardware>' |
306
|
|
|
query += '<pin>0x2FFFFFB3</pin><bsn>1140011878</bsn>' |
307
|
|
|
query += '<imei>004402242176786</imei><id>0x8D00240A</id>' |
308
|
|
|
query += '<isBootROMSecure>true</isBootROMSecure>' |
309
|
|
|
query += '</hardware>' |
310
|
|
|
query += '<network>' |
311
|
|
|
query += '<vendorId>0x0</vendorId><homeNPC>0x60</homeNPC>' |
312
|
|
|
query += '<currentNPC>0x60</currentNPC><ecid>0x1</ecid>' |
313
|
|
|
query += '</network>' |
314
|
|
|
query += '<software><currentLocale>en_US</currentLocale>' |
315
|
|
|
query += '<legalLocale>en_US</legalLocale>' |
316
|
|
|
query += '<osVersion>{0}</osVersion>'.format(osver) |
317
|
|
|
query += '<omadmEnabled>false</omadmEnabled>' |
318
|
|
|
query += '</software></clientProperties>' |
319
|
|
|
query += '</srVersionLookupRequest>' |
320
|
|
|
header = {"Content-Type": "text/xml;charset=UTF-8"} |
321
|
|
|
os.environ["REQUESTS_CA_BUNDLE"] = grab_pem() |
322
|
|
|
try: |
323
|
|
|
req = requests.post(server, headers=header, data=query, timeout=1) |
324
|
|
|
except (requests.exceptions.Timeout, requests.exceptions.ConnectionError): |
325
|
|
|
return "SR not in system" |
326
|
|
|
try: |
327
|
|
|
root = xml.etree.ElementTree.fromstring(req.text) |
328
|
|
|
except xml.etree.ElementTree.ParseError: |
329
|
|
|
return "SR not in system" |
330
|
|
|
else: |
331
|
|
|
packages = root.findall('./data/content/') |
332
|
|
|
for package in packages: |
333
|
|
|
if package.text is not None: |
334
|
|
|
match = reg.match(package.text) |
335
|
|
|
if match: |
336
|
|
|
return package.text |
337
|
|
|
else: |
338
|
|
|
return "SR not in system" |
339
|
|
|
|
340
|
|
|
|
341
|
|
|
def sr_lookup_bootstrap(osv): |
342
|
|
|
""" |
343
|
|
|
Run lookups for each server for given OS. |
344
|
|
|
|
345
|
|
|
:param osv: OS to check. |
346
|
|
|
:type osv: str |
347
|
|
|
""" |
348
|
|
|
with concurrent.futures.ThreadPoolExecutor(max_workers=5) as xec: |
349
|
|
|
try: |
350
|
|
|
results = { |
351
|
|
|
"p": None, |
352
|
|
|
"a1": None, |
353
|
|
|
"a2": None, |
354
|
|
|
"b1": None, |
355
|
|
|
"b2": None |
356
|
|
|
} |
357
|
|
|
for key in results: |
358
|
|
|
results[key] = xec.submit(sr_lookup, osv, SERVERS[key]).result() |
359
|
|
|
return results |
360
|
|
|
except KeyboardInterrupt: # pragma: no cover |
361
|
|
|
xec.shutdown(wait=False) |
362
|
|
|
|
363
|
|
|
|
364
|
|
|
def available_bundle_lookup(mcc, mnc, device): |
365
|
|
|
""" |
366
|
|
|
Check which software releases were ever released for a carrier. |
367
|
|
|
|
368
|
|
|
:param mcc: Country code. |
369
|
|
|
:type mcc: int |
370
|
|
|
|
371
|
|
|
:param mnc: Network code. |
372
|
|
|
:type mnc: int |
373
|
|
|
|
374
|
|
|
:param device: Hexadecimal hardware ID. |
375
|
|
|
:type device: str |
376
|
|
|
""" |
377
|
|
|
server = "https://cs.sl.blackberry.com/cse/availableBundles/1.0.0/" |
378
|
|
|
npc = return_npc(mcc, mnc) |
379
|
|
|
query = '<?xml version="1.0" encoding="UTF-8"?>' |
380
|
|
|
query += '<availableBundlesRequest version="1.0.0" ' |
381
|
|
|
query += 'authEchoTS="1366644680359">' |
382
|
|
|
query += '<deviceId><pin>0x2FFFFFB3</pin></deviceId>' |
383
|
|
|
query += '<clientProperties><hardware><id>0x{0}</id>'.format(device) |
384
|
|
|
query += '<isBootROMSecure>true</isBootROMSecure></hardware>' |
385
|
|
|
query += '<network><vendorId>0x0</vendorId><homeNPC>0x{0}</homeNPC>'.format(npc) |
386
|
|
|
query += '<currentNPC>0x{0}</currentNPC></network><software>'.format(npc) |
387
|
|
|
query += '<currentLocale>en_US</currentLocale>' |
388
|
|
|
query += '<legalLocale>en_US</legalLocale>' |
389
|
|
|
query += '<osVersion>10.0.0.0</osVersion>' |
390
|
|
|
query += '<radioVersion>10.0.0.0</radioVersion></software>' |
391
|
|
|
query += '</clientProperties><updateDirectives><bundleVersionFilter>' |
392
|
|
|
query += '</bundleVersionFilter></updateDirectives>' |
393
|
|
|
query += '</availableBundlesRequest>' |
394
|
|
|
header = {"Content-Type": "text/xml;charset=UTF-8"} |
395
|
|
|
os.environ["REQUESTS_CA_BUNDLE"] = grab_pem() |
396
|
|
|
req = requests.post(server, headers=header, data=query) |
397
|
|
|
root = xml.etree.ElementTree.fromstring(req.text) |
398
|
|
|
package = root.find('./data/content') |
399
|
|
|
bundlelist = [child.attrib["version"] for child in package] |
400
|
|
|
return bundlelist |
401
|
|
|
|
402
|
|
|
|
403
|
|
|
def ptcrb_scraper(ptcrbid): |
404
|
|
|
""" |
405
|
|
|
Get the PTCRB results for a given device. |
406
|
|
|
|
407
|
|
|
:param ptcrbid: Numerical ID from PTCRB (end of URL). |
408
|
|
|
:type ptcrbid: str |
409
|
|
|
""" |
410
|
|
|
baseurl = "https://ptcrb.com/vendor/complete/view_complete_request_guest.cfm?modelid={0}".format( |
|
|
|
|
411
|
|
|
ptcrbid) |
412
|
|
|
os.environ["REQUESTS_CA_BUNDLE"] = grab_pem() |
413
|
|
|
req = requests.get(baseurl) |
414
|
|
|
soup = BeautifulSoup(req.content, 'html.parser') |
415
|
|
|
text = soup.get_text() |
416
|
|
|
text = text.replace("\r\n", " ") |
417
|
|
|
prelimlist = re.findall("OS .+[^\\n]", text, re.IGNORECASE) |
418
|
|
|
if not prelimlist: # Priv |
419
|
|
|
prelimlist = re.findall(r"[A-Z]{3}[0-9]{3}[\s]", text) |
420
|
|
|
cleanlist = [] |
421
|
|
|
for item in prelimlist: |
422
|
|
|
if not item.endswith("\r\n"): # they should hire QC people... |
423
|
|
|
cleanlist.append(ptcrb_item_cleaner(item)) |
424
|
|
|
return cleanlist |
425
|
|
|
|
426
|
|
|
|
427
|
|
|
def ptcrb_item_cleaner(item): |
428
|
|
|
""" |
429
|
|
|
Cleanup poorly formatted PTCRB entries written by an intern. |
430
|
|
|
|
431
|
|
|
:param item: The item to clean. |
432
|
|
|
:type item: str |
433
|
|
|
""" |
434
|
|
|
item = item.replace("<td>", "") |
435
|
|
|
item = item.replace("</td>", "") |
436
|
|
|
item = item.replace("\n", "") |
437
|
|
|
item = item.replace(" (SR", ", SR") |
438
|
|
|
item = re.sub(r"\s?\((.*)$", "", item) |
439
|
|
|
item = re.sub(r"\sSV.*$", "", item) |
440
|
|
|
item = item.replace(")", "") |
441
|
|
|
item = item.replace(". ", ".") |
442
|
|
|
item = item.replace(";", "") |
443
|
|
|
item = item.replace("version", "Version") |
444
|
|
|
item = item.replace("Verison", "Version") |
445
|
|
|
if item.count("OS") > 1: |
446
|
|
|
templist = item.split("OS") |
447
|
|
|
templist[0] = "OS" |
448
|
|
|
item = "".join([templist[0], templist[1]]) |
449
|
|
|
item = item.replace("SR", "SW Release") |
450
|
|
|
item = item.replace(" Version:", ":") |
451
|
|
|
item = item.replace("Version ", " ") |
452
|
|
|
item = item.replace(":1", ": 1") |
453
|
|
|
item = item.replace(", ", " ") |
454
|
|
|
item = item.replace("Software", "SW") |
455
|
|
|
item = item.replace(" ", " ") |
456
|
|
|
item = item.replace("OS ", "OS: ") |
457
|
|
|
item = item.replace("Radio ", "Radio: ") |
458
|
|
|
item = item.replace("Release ", "Release: ") |
459
|
|
|
spaclist = item.split(" ") |
460
|
|
|
if len(spaclist) > 1: |
461
|
|
|
while len(spaclist[1]) < 11: |
462
|
|
|
spaclist[1] += " " |
463
|
|
|
while len(spaclist[3]) < 11: |
464
|
|
|
spaclist[3] += " " |
465
|
|
|
else: |
466
|
|
|
spaclist.insert(0, "OS:") |
467
|
|
|
item = " ".join(spaclist) |
468
|
|
|
item = item.strip() |
469
|
|
|
return item |
470
|
|
|
|
471
|
|
|
|
472
|
|
|
def kernel_scraper(utils=False): |
473
|
|
|
""" |
474
|
|
|
Scrape BlackBerry's GitHub kernel repo for available branches. |
475
|
|
|
|
476
|
|
|
:param utils: Check android-utils repo instead of android-linux-kernel. Default is False. |
477
|
|
|
:type utils: bool |
478
|
|
|
""" |
479
|
|
|
repo = "android-utils" if utils else "android-linux-kernel" |
480
|
|
|
url = "https://github.com/blackberry/{0}/branches/all".format(repo) |
481
|
|
|
os.environ["REQUESTS_CA_BUNDLE"] = grab_pem() |
482
|
|
|
req = requests.get(url) |
483
|
|
|
soup = BeautifulSoup(req.content, 'html.parser') |
484
|
|
|
text = soup.get_text() |
485
|
|
|
kernlist = re.findall(r"msm[0-9]{4}\/[A-Z0-9]{6}", text, re.IGNORECASE) |
486
|
|
|
return kernlist |
487
|
|
|
|
488
|
|
|
|
489
|
|
|
def make_priv_skeleton(method, variant, build): |
490
|
|
|
""" |
491
|
|
|
Make a Priv autoloader/hash URL. |
492
|
|
|
|
493
|
|
|
:param method: None for regular OS links, "sha256/512" for SHA256 or 512 hash. |
494
|
|
|
:type method: str |
495
|
|
|
|
496
|
|
|
:param variant: |
497
|
|
|
:type variant: str |
498
|
|
|
|
499
|
|
|
:param build: Build to check, 3 letters + 3 numbers. |
500
|
|
|
:type build: str |
501
|
|
|
""" |
502
|
|
|
folder = {"vzw-vzw": "verizon", "na-att": "att", "na-tmo": "tmo", "common": "default"} |
503
|
|
|
if method is None: |
504
|
|
|
skel = "https://bbapps.download.blackberry.com/Priv/bbry_qc8992_autoloader_user-{0}-{1}.zip".format(variant, build.upper()) |
|
|
|
|
505
|
|
|
else: |
506
|
|
|
skel = "http://us.blackberry.com/content/dam/bbfoundation/hashfiles_priv/{2}/bbry_qc8992_autoloader_user-{0}-{1}.{3}sum".format(variant, build.upper(), folder[variant], method.lower()) |
|
|
|
|
507
|
|
|
return skel |
508
|
|
|
|
509
|
|
|
|
510
|
|
|
def priv_scanner(build, method=None): |
511
|
|
|
""" |
512
|
|
|
Check for Priv autoloaders on BlackBerry's site. |
513
|
|
|
|
514
|
|
|
:param build: Build to check, 3 letters + 3 numbers. |
515
|
|
|
:type build: str |
516
|
|
|
|
517
|
|
|
:param method: None for regular OS links, "sha256/512" for SHA256 or 512 hash. |
518
|
|
|
:type method: str |
519
|
|
|
""" |
520
|
|
|
variants = ("common", "vzw-vzw", "na-tmo", "na-att") # device variants |
521
|
|
|
with concurrent.futures.ThreadPoolExecutor(max_workers=len(variants)) as xec: |
522
|
|
|
results = [] |
523
|
|
|
for var in variants: |
524
|
|
|
skel = make_priv_skeleton(method, var, build) |
525
|
|
|
avail = xec.submit(availability, skel) |
526
|
|
|
if avail.result(): |
527
|
|
|
results.append(skel) |
528
|
|
|
return results if results else None |
529
|
|
|
|
530
|
|
|
|
531
|
|
|
def base_metadata(url): |
532
|
|
|
""" |
533
|
|
|
Get BBNDK metadata, base function. |
534
|
|
|
""" |
535
|
|
|
req = requests.get(url) |
536
|
|
|
data = req.content |
537
|
|
|
entries = data.split(b"\n") |
538
|
|
|
metadata = [entry.split(b",")[1].decode("utf-8") for entry in entries if entry] |
539
|
|
|
return metadata |
540
|
|
|
|
541
|
|
|
|
542
|
|
|
def ndk_metadata(): |
543
|
|
|
""" |
544
|
|
|
Get BBNDK target metadata. |
545
|
|
|
""" |
546
|
|
|
data = base_metadata("http://downloads.blackberry.com/upr/developers/update/bbndk/metadata") |
547
|
|
|
metadata = [entry for entry in data if entry.startswith(("10.0", "10.1", "10.2"))] |
548
|
|
|
return metadata |
549
|
|
|
|
550
|
|
|
|
551
|
|
|
def sim_metadata(): |
552
|
|
|
""" |
553
|
|
|
Get BBNDK simulator metadata. |
554
|
|
|
""" |
555
|
|
|
metadata = base_metadata("http://downloads.blackberry.com/upr/developers/update/bbndk/simulator/simulator_metadata") |
|
|
|
|
556
|
|
|
return metadata |
557
|
|
|
|
558
|
|
|
|
559
|
|
|
def runtime_metadata(): |
560
|
|
|
""" |
561
|
|
|
Get BBNDK runtime metadata. |
562
|
|
|
""" |
563
|
|
|
metadata = base_metadata("http://downloads.blackberry.com/upr/developers/update/bbndk/runtime/runtime_metadata") |
|
|
|
|
564
|
|
|
return metadata |
565
|
|
|
|
566
|
|
|
|
567
|
|
|
def series_generator(osversion): |
568
|
|
|
""" |
569
|
|
|
Generate series/branch name from OS version. |
570
|
|
|
|
571
|
|
|
:param osversion: OS version. |
572
|
|
|
:type osversion: str |
573
|
|
|
""" |
574
|
|
|
splits = osversion.split(".") |
575
|
|
|
return "BB{0}_{1}_{2}".format(*splits[0:3]) |
576
|
|
|
|
577
|
|
|
|
578
|
|
|
def devalpha_urls(osversion, skeletons): |
579
|
|
|
""" |
580
|
|
|
Get list of valid Dev Alpha autoloader URLs. |
581
|
|
|
|
582
|
|
|
:param osversion: OS version. |
583
|
|
|
:type osversion: str |
584
|
|
|
|
585
|
|
|
:param skeletons: List of skeleton formats to try. |
586
|
|
|
:type skeletons: list |
587
|
|
|
""" |
588
|
|
|
finals = {} |
589
|
|
|
for skel in skeletons: |
590
|
|
|
if "<SERIES>" in skel: |
591
|
|
|
skel = skel.replace("<SERIES>", series_generator(osversion)) |
592
|
|
|
url = "http://downloads.blackberry.com/upr/developers/downloads/{0}{1}.exe".format(skel, osversion) |
|
|
|
|
593
|
|
|
req = requests.head(url) |
594
|
|
|
if req.status_code == 200: |
595
|
|
|
finals[url] = req.headers["content-length"] |
596
|
|
|
return finals |
597
|
|
|
|
598
|
|
|
|
599
|
|
|
def dev_dupe_cleaner(finals): |
600
|
|
|
""" |
601
|
|
|
Clean duplicate autoloader entries. |
602
|
|
|
|
603
|
|
|
:param finals: Dict of URL:content-length pairs. |
604
|
|
|
:type finals: dict(str: str) |
605
|
|
|
""" |
606
|
|
|
revo = {} |
607
|
|
|
for key, val in finals.items(): |
608
|
|
|
revo.setdefault(val, set()).add(key) |
609
|
|
|
dupelist = [val for key, val in revo.items() if len(val) > 1] |
610
|
|
|
for dupe in dupelist: |
611
|
|
|
for entry in dupe: |
612
|
|
|
if "DevAlpha" in entry: |
613
|
|
|
del finals[entry] |
614
|
|
|
return finals |
615
|
|
|
|
This can be caused by one of the following:
1. Missing Dependencies
This error could indicate a configuration issue of Pylint. Make sure that your libraries are available by adding the necessary commands.
2. Missing __init__.py files
This error could also result from missing
__init__.py
files in your module folders. Make sure that you place one file in each sub-folder.