1341 lines
41 KiB
Python
Executable File
1341 lines
41 KiB
Python
Executable File
#!/usr/bin/env python
|
|
# -*- coding: utf-8 -*-
|
|
# Copyright 2012-2015 Matt Martz
|
|
# All Rights Reserved.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
# not use this file except in compliance with the License. You may obtain
|
|
# a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
# License for the specific language governing permissions and limitations
|
|
# under the License.
|
|
|
|
import os
|
|
import re
|
|
import csv
|
|
import sys
|
|
import math
|
|
import errno
|
|
import signal
|
|
import socket
|
|
import timeit
|
|
import datetime
|
|
import platform
|
|
import threading
|
|
import xml.parsers.expat
|
|
|
|
__version__ = '1.0.0'
|
|
|
|
|
|
class FakeShutdownEvent(object):
|
|
"""Class to fake a threading.Event.isSet so that users of this module
|
|
are not required to register their own threading.Event()
|
|
"""
|
|
|
|
@staticmethod
|
|
def isSet():
|
|
"Dummy method to always return false"""
|
|
return False
|
|
|
|
|
|
# Some global variables we use
|
|
USER_AGENT = None
|
|
SOURCE = None
|
|
SHUTDOWN_EVENT = FakeShutdownEvent()
|
|
SCHEME = 'http'
|
|
DEBUG = False
|
|
|
|
# Used for bound_interface
|
|
SOCKET_SOCKET = socket.socket
|
|
|
|
# Begin import game to handle Python 2 and Python 3
|
|
try:
|
|
import json
|
|
except ImportError:
|
|
try:
|
|
import simplejson as json
|
|
except ImportError:
|
|
json = None
|
|
|
|
try:
|
|
import xml.etree.cElementTree as ET
|
|
except ImportError:
|
|
try:
|
|
import xml.etree.ElementTree as ET
|
|
except ImportError:
|
|
from xml.dom import minidom as DOM
|
|
ET = None
|
|
|
|
try:
|
|
from urllib2 import urlopen, Request, HTTPError, URLError
|
|
except ImportError:
|
|
from urllib.request import urlopen, Request, HTTPError, URLError
|
|
|
|
try:
|
|
from httplib import HTTPConnection
|
|
except ImportError:
|
|
from http.client import HTTPConnection
|
|
|
|
try:
|
|
from httplib import HTTPSConnection
|
|
except ImportError:
|
|
try:
|
|
from http.client import HTTPSConnection
|
|
except ImportError:
|
|
HTTPSConnection = None
|
|
|
|
try:
|
|
from Queue import Queue
|
|
except ImportError:
|
|
from queue import Queue
|
|
|
|
try:
|
|
from urlparse import urlparse
|
|
except ImportError:
|
|
from urllib.parse import urlparse
|
|
|
|
try:
|
|
from urlparse import parse_qs
|
|
except ImportError:
|
|
try:
|
|
from urllib.parse import parse_qs
|
|
except ImportError:
|
|
from cgi import parse_qs
|
|
|
|
try:
|
|
from hashlib import md5
|
|
except ImportError:
|
|
from md5 import md5
|
|
|
|
try:
|
|
from argparse import ArgumentParser as ArgParser
|
|
from argparse import SUPPRESS as ARG_SUPPRESS
|
|
PARSER_TYPE_INT = int
|
|
PARSER_TYPE_STR = str
|
|
except ImportError:
|
|
from optparse import OptionParser as ArgParser
|
|
from optparse import SUPPRESS_HELP as ARG_SUPPRESS
|
|
PARSER_TYPE_INT = 'int'
|
|
PARSER_TYPE_STR = 'string'
|
|
|
|
try:
|
|
from cStringIO import StringIO
|
|
except ImportError:
|
|
try:
|
|
from io import StringIO
|
|
except ImportError:
|
|
from StringIO import StringIO
|
|
|
|
try:
|
|
import builtins
|
|
except ImportError:
|
|
def print_(*args, **kwargs):
|
|
"""The new-style print function for Python 2.4 and 2.5.
|
|
|
|
Taken from https://pypi.python.org/pypi/six/
|
|
|
|
Modified to set encoding to UTF-8 if not set when stdout may not be
|
|
a tty such as when piping to head
|
|
"""
|
|
fp = kwargs.pop("file", sys.stdout)
|
|
if fp is None:
|
|
return
|
|
|
|
def write(data):
|
|
if not isinstance(data, basestring):
|
|
data = str(data)
|
|
# If the file has an encoding, encode unicode with it.
|
|
encoding = fp.encoding or 'UTF-8' # Diverges for notty
|
|
if (isinstance(fp, file) and
|
|
isinstance(data, unicode) and
|
|
encoding is not None):
|
|
errors = getattr(fp, "errors", None)
|
|
if errors is None:
|
|
errors = "strict"
|
|
data = data.encode(encoding, errors)
|
|
fp.write(data)
|
|
want_unicode = False
|
|
sep = kwargs.pop("sep", None)
|
|
if sep is not None:
|
|
if isinstance(sep, unicode):
|
|
want_unicode = True
|
|
elif not isinstance(sep, str):
|
|
raise TypeError("sep must be None or a string")
|
|
end = kwargs.pop("end", None)
|
|
if end is not None:
|
|
if isinstance(end, unicode):
|
|
want_unicode = True
|
|
elif not isinstance(end, str):
|
|
raise TypeError("end must be None or a string")
|
|
if kwargs:
|
|
raise TypeError("invalid keyword arguments to print()")
|
|
if not want_unicode:
|
|
for arg in args:
|
|
if isinstance(arg, unicode):
|
|
want_unicode = True
|
|
break
|
|
if want_unicode:
|
|
newline = unicode("\n")
|
|
space = unicode(" ")
|
|
else:
|
|
newline = "\n"
|
|
space = " "
|
|
if sep is None:
|
|
sep = space
|
|
if end is None:
|
|
end = newline
|
|
for i, arg in enumerate(args):
|
|
if i:
|
|
write(sep)
|
|
write(arg)
|
|
write(end)
|
|
else:
|
|
print_ = getattr(builtins, 'print')
|
|
del builtins
|
|
|
|
# Exception "constants" to support Python 2 through Python 3
|
|
try:
|
|
import ssl
|
|
try:
|
|
CERT_ERROR = (ssl.CertificateError,)
|
|
except AttributeError:
|
|
CERT_ERROR = tuple()
|
|
|
|
HTTP_ERRORS = ((HTTPError, URLError, socket.error, ssl.SSLError) +
|
|
CERT_ERROR)
|
|
except ImportError:
|
|
HTTP_ERRORS = (HTTPError, URLError, socket.error)
|
|
|
|
|
|
class SpeedtestException(Exception):
|
|
"""Base exception for this module"""
|
|
|
|
|
|
class SpeedtestConfigError(SpeedtestException):
|
|
"""Configuration provided is invalid"""
|
|
|
|
|
|
class ConfigRetrievalError(SpeedtestException):
|
|
"""Could not retrieve config.php"""
|
|
|
|
|
|
class ServersRetrievalError(SpeedtestException):
|
|
"""Could not retrieve speedtest-servers.php"""
|
|
|
|
|
|
class InvalidServerIDType(SpeedtestException):
|
|
"""Server ID used for filtering was not an integer"""
|
|
|
|
|
|
class NoMatchedServers(SpeedtestException):
|
|
"""No servers matched when filtering"""
|
|
|
|
|
|
class SpeedtestMiniConnectFailure(SpeedtestException):
|
|
"""Could not connect to the provided speedtest mini server"""
|
|
|
|
|
|
class InvalidSpeedtestMiniServer(SpeedtestException):
|
|
"""Server provided as a speedtest mini server does not actually appear
|
|
to be a speedtest mini server
|
|
"""
|
|
|
|
|
|
class ShareResultsConnectFailure(SpeedtestException):
|
|
"""Could not connect to speedtest.net API to POST results"""
|
|
|
|
|
|
class ShareResultsSubmitFailure(SpeedtestException):
|
|
"""Unable to successfully POST results to speedtest.net API after
|
|
connection
|
|
"""
|
|
|
|
|
|
class SpeedtestUploadTimeout(SpeedtestException):
|
|
"""testlength configuration reached during upload
|
|
Used to ensure the upload halts when no additional data should be sent
|
|
"""
|
|
|
|
|
|
def bound_socket(*args, **kwargs):
|
|
"""Bind socket to a specified source IP address"""
|
|
|
|
sock = SOCKET_SOCKET(*args, **kwargs)
|
|
sock.bind((SOURCE, 0))
|
|
return sock
|
|
|
|
|
|
def distance(origin, destination):
|
|
"""Determine distance between 2 sets of [lat,lon] in km"""
|
|
|
|
lat1, lon1 = origin
|
|
lat2, lon2 = destination
|
|
radius = 6371 # km
|
|
|
|
dlat = math.radians(lat2 - lat1)
|
|
dlon = math.radians(lon2 - lon1)
|
|
a = (math.sin(dlat / 2) * math.sin(dlat / 2) +
|
|
math.cos(math.radians(lat1)) *
|
|
math.cos(math.radians(lat2)) * math.sin(dlon / 2) *
|
|
math.sin(dlon / 2))
|
|
c = 2 * math.atan2(math.sqrt(a), math.sqrt(1 - a))
|
|
d = radius * c
|
|
|
|
return d
|
|
|
|
|
|
def build_user_agent():
|
|
"""Build a Mozilla/5.0 compatible User-Agent string"""
|
|
|
|
global USER_AGENT
|
|
if USER_AGENT:
|
|
return USER_AGENT
|
|
|
|
ua_tuple = (
|
|
'Mozilla/5.0',
|
|
'(%s; U; %s; en-us)' % (platform.system(), platform.architecture()[0]),
|
|
'Python/%s' % platform.python_version(),
|
|
'(KHTML, like Gecko)',
|
|
'speedtest-cli/%s' % __version__
|
|
)
|
|
USER_AGENT = ' '.join(ua_tuple)
|
|
printer(USER_AGENT, debug=True)
|
|
return USER_AGENT
|
|
|
|
|
|
def build_request(url, data=None, headers={}):
|
|
"""Build a urllib2 request object
|
|
|
|
This function automatically adds a User-Agent header to all requests
|
|
|
|
"""
|
|
|
|
if not USER_AGENT:
|
|
build_user_agent()
|
|
|
|
if url[0] == ':':
|
|
schemed_url = '%s%s' % (SCHEME, url)
|
|
else:
|
|
schemed_url = url
|
|
|
|
if '?' in url:
|
|
delim = '&'
|
|
else:
|
|
delim = '?'
|
|
|
|
# WHO YOU GONNA CALL? CACHE BUSTERS!
|
|
final_url = '%s%sx=%s' % (schemed_url, delim,
|
|
int(timeit.time.time() * 1000))
|
|
|
|
headers['User-Agent'] = USER_AGENT
|
|
|
|
printer('%s %s' % (('GET', 'POST')[bool(data)], final_url),
|
|
debug=True)
|
|
|
|
return Request(final_url, data=data, headers=headers)
|
|
|
|
|
|
def catch_request(request):
|
|
"""Helper function to catch common exceptions encountered when
|
|
establishing a connection with a HTTP/HTTPS request
|
|
|
|
"""
|
|
|
|
try:
|
|
uh = urlopen(request)
|
|
return uh, False
|
|
except HTTP_ERRORS:
|
|
e = sys.exc_info()[1]
|
|
return None, e
|
|
|
|
|
|
def get_attributes_by_tag_name(dom, tag_name):
|
|
"""Retrieve an attribute from an XML document and return it in a
|
|
consistent format
|
|
|
|
Only used with xml.dom.minidom, which is likely only to be used
|
|
with python versions older than 2.5
|
|
"""
|
|
elem = dom.getElementsByTagName(tag_name)[0]
|
|
return dict(list(elem.attributes.items()))
|
|
|
|
|
|
def print_dots(current, total, start=False, end=False):
|
|
"""Built in callback function used by Thread classes for printing
|
|
status
|
|
"""
|
|
|
|
if SHUTDOWN_EVENT.isSet():
|
|
return
|
|
|
|
sys.stdout.write('.')
|
|
if current + 1 == total and end is True:
|
|
sys.stdout.write('\n')
|
|
sys.stdout.flush()
|
|
|
|
|
|
def do_nothing(*args, **kwargs):
|
|
pass
|
|
|
|
|
|
class HTTPDownloader(threading.Thread):
|
|
"""Thread class for retrieving a URL"""
|
|
|
|
def __init__(self, i, request, start, timeout):
|
|
threading.Thread.__init__(self)
|
|
self.request = request
|
|
self.result = [0]
|
|
self.starttime = start
|
|
self.timeout = timeout
|
|
self.i = i
|
|
|
|
def run(self):
|
|
try:
|
|
if (timeit.default_timer() - self.starttime) <= self.timeout:
|
|
f = urlopen(self.request)
|
|
while (not SHUTDOWN_EVENT.isSet() and
|
|
(timeit.default_timer() - self.starttime) <=
|
|
self.timeout):
|
|
self.result.append(len(f.read(10240)))
|
|
if self.result[-1] == 0:
|
|
break
|
|
f.close()
|
|
except IOError:
|
|
pass
|
|
|
|
|
|
class HTTPUploaderData(object):
|
|
"""File like object to improve cutting off the upload once the timeout
|
|
has been reached
|
|
"""
|
|
|
|
def __init__(self, length, start, timeout):
|
|
self.length = length
|
|
self.start = start
|
|
self.timeout = timeout
|
|
|
|
self._data = None
|
|
|
|
self.total = [0]
|
|
|
|
def _create_data(self):
|
|
chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'
|
|
multiplier = int(round(int(self.length) / 36.0))
|
|
self._data = StringIO('content1=%s' %
|
|
(chars * multiplier)[0:int(self.length) - 9])
|
|
|
|
@property
|
|
def data(self):
|
|
if not self._data:
|
|
self._create_data()
|
|
return self._data
|
|
|
|
def read(self, n=10240):
|
|
if ((timeit.default_timer() - self.start) <= self.timeout and
|
|
not SHUTDOWN_EVENT.isSet()):
|
|
chunk = self.data.read(n).encode()
|
|
self.total.append(len(chunk))
|
|
return chunk
|
|
else:
|
|
raise SpeedtestUploadTimeout
|
|
|
|
def __len__(self):
|
|
return self.length
|
|
|
|
|
|
class HTTPUploader(threading.Thread):
|
|
"""Thread class for putting a URL"""
|
|
|
|
def __init__(self, i, request, start, size, timeout):
|
|
threading.Thread.__init__(self)
|
|
self.request = request
|
|
self.request.data.start = self.starttime = start
|
|
self.size = size
|
|
self.result = None
|
|
self.timeout = timeout
|
|
self.i = i
|
|
|
|
def run(self):
|
|
request = self.request
|
|
try:
|
|
if ((timeit.default_timer() - self.starttime) <= self.timeout and
|
|
not SHUTDOWN_EVENT.isSet()):
|
|
try:
|
|
f = urlopen(request)
|
|
except TypeError:
|
|
# PY24 expects a string or buffer
|
|
# This also causes issues with Ctrl-C, but we will concede
|
|
# for the moment that Ctrl-C on PY24 isn't immediate
|
|
request = build_request(self.request.get_full_url(),
|
|
data=request.data.read(self.size))
|
|
f = urlopen(request)
|
|
f.read(11)
|
|
f.close()
|
|
self.result = sum(self.request.data.total)
|
|
else:
|
|
self.result = 0
|
|
except (IOError, SpeedtestUploadTimeout):
|
|
self.result = sum(self.request.data.total)
|
|
|
|
|
|
class UnitsDataDescriptor(object):
|
|
"""Data Descriptor class, that converts values from Bytes to specified
|
|
units when setting the value.
|
|
"""
|
|
|
|
def __init__(self, name, default=None):
|
|
self.name = name
|
|
self.default = default
|
|
|
|
def __get__(self, obj, objtype=None):
|
|
return getattr(obj, '_%s' % self.name, self.default)
|
|
|
|
def __set__(self, obj, val):
|
|
setattr(obj, '_%s' % self.name, val * obj.units[1])
|
|
|
|
def __delete__(self, obj):
|
|
raise NotImplementedError()
|
|
|
|
|
|
class SpeedtestResults(object):
|
|
"""Class for holding the results of a speedtest, including:
|
|
|
|
Download speed
|
|
Upload speed
|
|
Ping/Latency to test server
|
|
Data about server that the test was run against
|
|
|
|
Additionally this class can return a result data as a dictionary or CSV,
|
|
as well as submit a POST of the result data to the speedtest.net API
|
|
to get a share results image link.
|
|
"""
|
|
|
|
download = UnitsDataDescriptor('download', default=0)
|
|
upload = UnitsDataDescriptor('upload', default=0)
|
|
|
|
def __init__(self, download=0, upload=0, ping=0, server=None,
|
|
units=('bit', 8)):
|
|
self._download = download
|
|
self._upload = upload
|
|
self.ping = ping
|
|
if server is None:
|
|
self.server = {}
|
|
else:
|
|
self.server = server
|
|
self._share = None
|
|
self.timestamp = datetime.datetime.utcnow().isoformat()
|
|
|
|
self.units = units
|
|
|
|
def __repr__(self):
|
|
return repr(self.dict())
|
|
|
|
def share(self):
|
|
"""POST data to the speedtest.net API to obtain a share results
|
|
link
|
|
"""
|
|
|
|
if self._share:
|
|
return self._share
|
|
|
|
if self.units[1] == 1:
|
|
bit_download = self.download * 8
|
|
bit_upload = self.upload * 8
|
|
elif self.units[1] == 8:
|
|
bit_download = self.download
|
|
bit_upload = self.upload
|
|
else:
|
|
raise SpeedtestConfigError('Unknown units, valid configurations '
|
|
'are ("bit", 8) and ("byte", 1)')
|
|
|
|
download = int(round(bit_download / 1000, 0))
|
|
ping = int(round(self.ping, 0))
|
|
upload = int(round(bit_upload / 1000, 0))
|
|
|
|
# Build the request to send results back to speedtest.net
|
|
# We use a list instead of a dict because the API expects parameters
|
|
# in a certain order
|
|
api_data = [
|
|
'download=%s' % download,
|
|
'ping=%s' % ping,
|
|
'upload=%s' % upload,
|
|
'promo=',
|
|
'startmode=%s' % 'pingselect',
|
|
'recommendedserverid=%s' % self.server['id'],
|
|
'accuracy=%s' % 1,
|
|
'serverid=%s' % self.server['id'],
|
|
'hash=%s' % md5(('%s-%s-%s-%s' %
|
|
(ping, upload, download, '297aae72'))
|
|
.encode()).hexdigest()]
|
|
|
|
headers = {'Referer': 'http://c.speedtest.net/flash/speedtest.swf'}
|
|
request = build_request('://www.speedtest.net/api/api.php',
|
|
data='&'.join(api_data).encode(),
|
|
headers=headers)
|
|
f, e = catch_request(request)
|
|
if e:
|
|
raise ShareResultsConnectFailure(e)
|
|
|
|
response = f.read()
|
|
code = f.code
|
|
f.close()
|
|
|
|
if int(code) != 200:
|
|
raise ShareResultsSubmitFailure('Could not submit results to '
|
|
'speedtest.net')
|
|
|
|
qsargs = parse_qs(response.decode())
|
|
resultid = qsargs.get('resultid')
|
|
if not resultid or len(resultid) != 1:
|
|
raise ShareResultsSubmitFailure('Could not submit results to '
|
|
'speedtest.net')
|
|
|
|
self._share = 'http://www.speedtest.net/result/%s.png' % resultid[0]
|
|
|
|
return self._share
|
|
|
|
def dict(self):
|
|
"""Return dictionary of result data"""
|
|
|
|
return {
|
|
'download': self.download,
|
|
'upload': self.upload,
|
|
'ping': self.ping,
|
|
'server': self.server,
|
|
'timestamp': self.timestamp
|
|
}
|
|
|
|
def csv(self, delimiter=','):
|
|
"""Return data in CSV format"""
|
|
|
|
data = self.dict()
|
|
out = StringIO()
|
|
writer = csv.writer(out, delimiter=delimiter, lineterminator='')
|
|
writer.writerow([data['server']['id'], data['server']['sponsor'],
|
|
data['server']['name'], data['timestamp'],
|
|
data['server']['d'], data['ping'], data['download'],
|
|
data['upload']])
|
|
return out.getvalue()
|
|
|
|
def json(self, pretty=False):
|
|
"""Return data in JSON format"""
|
|
|
|
kwargs = {}
|
|
if pretty:
|
|
kwargs.update({
|
|
'indent': 4,
|
|
'sort_keys': True
|
|
})
|
|
return json.dumps(self.dict(), **kwargs)
|
|
|
|
def simple(self):
|
|
return """Ping: %s ms
|
|
Download: %0.2f M%s/s
|
|
Upload: %0.2f M%s/s""" % (self.ping,
|
|
(self.download / 1000 / 1000),
|
|
self.units[0],
|
|
(self.upload / 1000 / 1000),
|
|
self.units[0])
|
|
|
|
|
|
class Speedtest(object):
|
|
"""Class for performing standard speedtest.net testing operations"""
|
|
|
|
def __init__(self, config=None, units=('bit', 8)):
|
|
self.config = {}
|
|
self.get_config()
|
|
if config is not None:
|
|
self.config.update(config)
|
|
|
|
self.servers = {}
|
|
self.closest = []
|
|
self.best = {}
|
|
|
|
self.results = SpeedtestResults(units=units)
|
|
|
|
def get_config(self):
|
|
"""Download the speedtest.net configuration and return only the data
|
|
we are interested in
|
|
"""
|
|
|
|
request = build_request('://www.speedtest.net/speedtest-config.php')
|
|
uh, e = catch_request(request)
|
|
if e:
|
|
raise ConfigRetrievalError(e)
|
|
configxml = []
|
|
|
|
while 1:
|
|
configxml.append(uh.read(10240))
|
|
if len(configxml[-1]) == 0:
|
|
break
|
|
if int(uh.code) != 200:
|
|
return None
|
|
|
|
uh.close()
|
|
|
|
printer(''.encode().join(configxml), debug=True)
|
|
|
|
try:
|
|
root = ET.fromstring(''.encode().join(configxml))
|
|
server_config = root.find('server-config').attrib
|
|
download = root.find('download').attrib
|
|
upload = root.find('upload').attrib
|
|
# times = root.find('times').attrib
|
|
client = root.find('client').attrib
|
|
|
|
except AttributeError:
|
|
root = DOM.parseString(''.join(configxml))
|
|
server_config = get_attributes_by_tag_name(root, 'server-config')
|
|
download = get_attributes_by_tag_name(root, 'download')
|
|
upload = get_attributes_by_tag_name(root, 'upload')
|
|
# times = get_attributes_by_tag_name(root, 'times')
|
|
client = get_attributes_by_tag_name(root, 'client')
|
|
|
|
ignore_servers = list(
|
|
map(int, server_config['ignoreids'].split(','))
|
|
)
|
|
|
|
# sizes = dict(upload=[], download=[])
|
|
# sizes = {}
|
|
# for desc, size in times.items():
|
|
# if desc.startswith('ul'):
|
|
# sizes['upload'].append(int(size))
|
|
# elif desc.startswith('dl'):
|
|
# sizes['download'].append(int(int(size) / 10000))
|
|
ratio = int(upload['ratio'])
|
|
upload_max = int(upload['maxchunkcount'])
|
|
up_sizes = [32768, 65536, 131072, 262144, 524288, 1048576, 7340032]
|
|
sizes = {
|
|
'upload': up_sizes[ratio - 1:],
|
|
'download': [350, 500, 750, 1000, 1500, 2000, 2500,
|
|
3000, 3500, 4000]
|
|
}
|
|
|
|
# sizes['upload'].sort()
|
|
# sizes['download'].sort()
|
|
|
|
counts = {
|
|
# 'upload': int(upload['threadsperurl']),
|
|
'upload': int(upload_max * 2 / len(sizes['upload'])),
|
|
'download': int(download['threadsperurl'])
|
|
}
|
|
|
|
threads = {
|
|
'upload': int(upload['threads']),
|
|
# 'download': int(server_config['threadcount'])
|
|
'download': int(server_config['threadcount']) * 2
|
|
}
|
|
|
|
length = {
|
|
'upload': int(upload['testlength']),
|
|
'download': int(download['testlength'])
|
|
}
|
|
|
|
self.config.update({
|
|
'client': client,
|
|
'ignore_servers': ignore_servers,
|
|
'sizes': sizes,
|
|
'counts': counts,
|
|
'threads': threads,
|
|
'length': length,
|
|
'upload_max': upload_max
|
|
})
|
|
|
|
self.lat_lon = (float(client['lat']), float(client['lon']))
|
|
|
|
return self.config
|
|
|
|
def get_servers(self, servers=[]):
|
|
"""Retrieve a the list of speedtest.net servers, optionally filtered
|
|
to servers matching those specified in the ``servers`` argument
|
|
"""
|
|
self.servers.clear()
|
|
|
|
for i, s in enumerate(servers):
|
|
try:
|
|
servers[i] = int(s)
|
|
except ValueError:
|
|
raise InvalidServerIDType('%s is an invalid server type, must '
|
|
'be int' % s)
|
|
|
|
urls = [
|
|
'://www.speedtest.net/speedtest-servers-static.php',
|
|
'http://c.speedtest.net/speedtest-servers-static.php',
|
|
'://www.speedtest.net/speedtest-servers.php',
|
|
'http://c.speedtest.net/speedtest-servers.php',
|
|
]
|
|
|
|
errors = []
|
|
for url in urls:
|
|
try:
|
|
request = build_request('%s?threads=%s' %
|
|
(url,
|
|
self.config['threads']['download']))
|
|
uh, e = catch_request(request)
|
|
if e:
|
|
errors.append('%s' % e)
|
|
raise ServersRetrievalError
|
|
|
|
serversxml = []
|
|
while 1:
|
|
serversxml.append(uh.read(10240))
|
|
if len(serversxml[-1]) == 0:
|
|
break
|
|
if int(uh.code) != 200:
|
|
uh.close()
|
|
raise ServersRetrievalError
|
|
|
|
uh.close()
|
|
|
|
try:
|
|
try:
|
|
root = ET.fromstring(''.encode().join(serversxml))
|
|
elements = root.getiterator('server')
|
|
except AttributeError:
|
|
root = DOM.parseString(''.join(serversxml))
|
|
elements = root.getElementsByTagName('server')
|
|
except (SyntaxError, xml.parsers.expat.ExpatError):
|
|
raise ServersRetrievalError
|
|
|
|
for server in elements:
|
|
try:
|
|
attrib = server.attrib
|
|
except AttributeError:
|
|
attrib = dict(list(server.attributes.items()))
|
|
|
|
if servers and int(attrib.get('id')) not in servers:
|
|
continue
|
|
|
|
if int(attrib.get('id')) in self.config['ignore_servers']:
|
|
continue
|
|
|
|
try:
|
|
d = distance(self.lat_lon,
|
|
(float(attrib.get('lat')),
|
|
float(attrib.get('lon'))))
|
|
except:
|
|
continue
|
|
|
|
attrib['d'] = d
|
|
|
|
try:
|
|
self.servers[d].append(attrib)
|
|
except KeyError:
|
|
self.servers[d] = [attrib]
|
|
|
|
printer(''.encode().join(serversxml), debug=True)
|
|
|
|
break
|
|
|
|
except ServersRetrievalError:
|
|
continue
|
|
|
|
if servers and not self.servers:
|
|
raise NoMatchedServers
|
|
|
|
return self.servers
|
|
|
|
def set_mini_server(self, server):
|
|
"""Instead of querying for a list of servers, set a link to a
|
|
speedtest mini server
|
|
"""
|
|
|
|
urlparts = urlparse(server)
|
|
|
|
name, ext = os.path.splitext(urlparts[2])
|
|
if ext:
|
|
url = os.path.dirname(server)
|
|
else:
|
|
url = server
|
|
|
|
request = build_request(url)
|
|
uh, e = catch_request(request)
|
|
if e:
|
|
raise SpeedtestMiniConnectFailure('Failed to connect to %s' %
|
|
server)
|
|
else:
|
|
text = uh.read()
|
|
uh.close()
|
|
|
|
extension = re.findall('upload_?[Ee]xtension: "([^"]+)"',
|
|
text.decode())
|
|
if not extension:
|
|
for ext in ['php', 'asp', 'aspx', 'jsp']:
|
|
try:
|
|
f = urlopen('%s/speedtest/upload.%s' % (url, ext))
|
|
except:
|
|
pass
|
|
else:
|
|
data = f.read().strip().decode()
|
|
if (f.code == 200 and
|
|
len(data.splitlines()) == 1 and
|
|
re.match('size=[0-9]', data)):
|
|
extension = [ext]
|
|
break
|
|
if not urlparts or not extension:
|
|
raise InvalidSpeedtestMiniServer('Invalid Speedtest Mini Server: '
|
|
'%s' % server)
|
|
|
|
self.servers = [{
|
|
'sponsor': 'Speedtest Mini',
|
|
'name': urlparts[1],
|
|
'd': 0,
|
|
'url': '%s/speedtest/upload.%s' % (url.rstrip('/'), extension[0]),
|
|
'latency': 0,
|
|
'id': 0
|
|
}]
|
|
|
|
return self.servers
|
|
|
|
def get_closest_servers(self, limit=5):
|
|
"""Limit servers to the closest speedtest.net servers based on
|
|
geographic distance
|
|
"""
|
|
|
|
if not self.servers:
|
|
self.get_servers()
|
|
|
|
for d in sorted(self.servers.keys()):
|
|
for s in self.servers[d]:
|
|
self.closest.append(s)
|
|
if len(self.closest) == limit:
|
|
break
|
|
else:
|
|
continue
|
|
break
|
|
|
|
printer(self.closest, debug=True)
|
|
return self.closest
|
|
|
|
def get_best_server(self, servers=[]):
|
|
"""Perform a speedtest.net "ping" to determine which speedtest.net
|
|
server has the lowest latency
|
|
"""
|
|
|
|
if not servers:
|
|
if not self.closest:
|
|
servers = self.get_closest_servers()
|
|
servers = self.closest
|
|
|
|
results = {}
|
|
for server in servers:
|
|
cum = []
|
|
url = os.path.dirname(server['url'])
|
|
urlparts = urlparse('%s/latency.txt' % url)
|
|
for _ in range(0, 3):
|
|
try:
|
|
if urlparts[0] == 'https':
|
|
h = HTTPSConnection(urlparts[1])
|
|
else:
|
|
h = HTTPConnection(urlparts[1])
|
|
headers = {'User-Agent': USER_AGENT}
|
|
start = timeit.default_timer()
|
|
h.request("GET", urlparts[2], headers=headers)
|
|
r = h.getresponse()
|
|
total = (timeit.default_timer() - start)
|
|
except HTTP_ERRORS:
|
|
cum.append(3600)
|
|
continue
|
|
|
|
text = r.read(9)
|
|
if int(r.status) == 200 and text == 'test=test'.encode():
|
|
cum.append(total)
|
|
else:
|
|
cum.append(3600)
|
|
h.close()
|
|
|
|
avg = round((sum(cum) / 6) * 1000, 3)
|
|
results[avg] = server
|
|
|
|
fastest = sorted(results.keys())[0]
|
|
best = results[fastest]
|
|
best['latency'] = fastest
|
|
|
|
self.results.ping = fastest
|
|
self.results.server = best
|
|
|
|
self.best.update(best)
|
|
printer(best, debug=True)
|
|
return best
|
|
|
|
def download(self, callback=do_nothing):
|
|
"""Test download speed against speedtest.net"""
|
|
|
|
urls = []
|
|
for size in self.config['sizes']['download']:
|
|
for _ in range(0, self.config['counts']['download']):
|
|
urls.append('%s/random%sx%s.jpg' %
|
|
(os.path.dirname(self.best['url']), size, size))
|
|
|
|
request_count = len(urls)
|
|
requests = []
|
|
for url in urls:
|
|
requests.append(build_request(url))
|
|
|
|
def producer(q, requests, request_count):
|
|
for i, request in enumerate(requests):
|
|
thread = HTTPDownloader(i, request, start,
|
|
self.config['length']['download'])
|
|
thread.start()
|
|
q.put(thread, True)
|
|
callback(i, request_count, start=True)
|
|
|
|
finished = []
|
|
|
|
def consumer(q, request_count):
|
|
while len(finished) < request_count:
|
|
thread = q.get(True)
|
|
while thread.isAlive():
|
|
thread.join(timeout=0.1)
|
|
finished.append(sum(thread.result))
|
|
callback(thread.i, request_count, end=True)
|
|
|
|
q = Queue(self.config['threads']['download'])
|
|
prod_thread = threading.Thread(target=producer,
|
|
args=(q, requests, request_count))
|
|
cons_thread = threading.Thread(target=consumer,
|
|
args=(q, request_count))
|
|
start = timeit.default_timer()
|
|
prod_thread.start()
|
|
cons_thread.start()
|
|
while prod_thread.isAlive():
|
|
prod_thread.join(timeout=0.1)
|
|
while cons_thread.isAlive():
|
|
cons_thread.join(timeout=0.1)
|
|
|
|
stop = timeit.default_timer()
|
|
|
|
self.results.download = (
|
|
sum(finished) / (stop - start)
|
|
)
|
|
if self.results.download > 100000:
|
|
self.config['threads']['upload'] = 8
|
|
return self.results.download
|
|
|
|
def upload(self, callback=do_nothing):
|
|
"""Test upload speed against speedtest.net"""
|
|
|
|
sizes = []
|
|
|
|
for size in self.config['sizes']['upload']:
|
|
for _ in range(0, self.config['counts']['upload']):
|
|
sizes.append(size)
|
|
|
|
# request_count = len(sizes)
|
|
request_count = self.config['upload_max']
|
|
|
|
requests = []
|
|
for size in sizes:
|
|
# We set ``0`` for ``start`` and handle setting the actual
|
|
# ``start`` in ``HTTPUploader`` to get better measurements
|
|
requests.append(
|
|
(
|
|
build_request(
|
|
self.best['url'],
|
|
HTTPUploaderData(size, 0,
|
|
self.config['length']['upload'])
|
|
),
|
|
size
|
|
)
|
|
)
|
|
|
|
def producer(q, requests, request_count):
|
|
for i, request in enumerate(requests[:request_count]):
|
|
thread = HTTPUploader(i, request[0], start, request[1],
|
|
self.config['length']['upload'])
|
|
thread.start()
|
|
q.put(thread, True)
|
|
callback(i, request_count, start=True)
|
|
|
|
finished = []
|
|
|
|
def consumer(q, request_count):
|
|
while len(finished) < request_count:
|
|
thread = q.get(True)
|
|
while thread.isAlive():
|
|
thread.join(timeout=0.1)
|
|
finished.append(thread.result)
|
|
callback(thread.i, request_count, end=True)
|
|
|
|
q = Queue(self.config['threads']['upload'])
|
|
prod_thread = threading.Thread(target=producer,
|
|
args=(q, requests, request_count))
|
|
cons_thread = threading.Thread(target=consumer,
|
|
args=(q, request_count))
|
|
start = timeit.default_timer()
|
|
prod_thread.start()
|
|
cons_thread.start()
|
|
while prod_thread.isAlive():
|
|
prod_thread.join(timeout=0.1)
|
|
while cons_thread.isAlive():
|
|
cons_thread.join(timeout=0.1)
|
|
|
|
stop = timeit.default_timer()
|
|
|
|
self.results.upload = (
|
|
sum(finished) / (stop - start)
|
|
)
|
|
return self.results.upload
|
|
|
|
|
|
def ctrl_c(signum, frame):
|
|
"""Catch Ctrl-C key sequence and set a SHUTDOWN_EVENT for our threaded
|
|
operations
|
|
"""
|
|
|
|
SHUTDOWN_EVENT.set()
|
|
print_('\nCancelling...')
|
|
sys.exit(0)
|
|
|
|
|
|
def version():
|
|
"""Print the version"""
|
|
|
|
print_(__version__)
|
|
sys.exit(0)
|
|
|
|
|
|
def parse_args():
|
|
"""Function to handle building and parsing of command line arguments"""
|
|
description = (
|
|
'Command line interface for testing internet bandwidth using '
|
|
'speedtest.net.\n'
|
|
'------------------------------------------------------------'
|
|
'--------------\n'
|
|
'https://github.com/sivel/speedtest-cli')
|
|
|
|
parser = ArgParser(description=description)
|
|
# Give optparse.OptionParser an `add_argument` method for
|
|
# compatibility with argparse.ArgumentParser
|
|
try:
|
|
parser.add_argument = parser.add_option
|
|
except AttributeError:
|
|
pass
|
|
parser.add_argument('--bytes', dest='units', action='store_const',
|
|
const=('byte', 1), default=('bit', 8),
|
|
help='Display values in bytes instead of bits. Does '
|
|
'not affect the image generated by --share')
|
|
parser.add_argument('--share', action='store_true',
|
|
help='Generate and provide a URL to the speedtest.net '
|
|
'share results image')
|
|
parser.add_argument('--simple', action='store_true', default=False,
|
|
help='Suppress verbose output, only show basic '
|
|
'information')
|
|
parser.add_argument('--csv', action='store_true', default=False,
|
|
help='Suppress verbose output, only show basic '
|
|
'information in CSV format')
|
|
parser.add_argument('--csv-delimiter', default=',', type=PARSER_TYPE_STR,
|
|
help='Single character delimiter to use in CSV '
|
|
'output. Default ","')
|
|
parser.add_argument('--json', action='store_true', default=False,
|
|
help='Suppress verbose output, only show basic '
|
|
'information in JSON format')
|
|
parser.add_argument('--list', action='store_true',
|
|
help='Display a list of speedtest.net servers '
|
|
'sorted by distance')
|
|
parser.add_argument('--server', help='Specify a server ID to test against',
|
|
type=PARSER_TYPE_INT)
|
|
parser.add_argument('--mini', help='URL of the Speedtest Mini server')
|
|
parser.add_argument('--source', help='Source IP address to bind to')
|
|
parser.add_argument('--timeout', default=10, type=PARSER_TYPE_INT,
|
|
help='HTTP timeout in seconds. Default 10')
|
|
parser.add_argument('--secure', action='store_true',
|
|
help='Use HTTPS instead of HTTP when communicating '
|
|
'with speedtest.net operated servers')
|
|
parser.add_argument('--version', action='store_true',
|
|
help='Show the version number and exit')
|
|
parser.add_argument('--debug', action='store_true',
|
|
help=ARG_SUPPRESS, default=ARG_SUPPRESS)
|
|
|
|
options = parser.parse_args()
|
|
if isinstance(options, tuple):
|
|
args = options[0]
|
|
else:
|
|
args = options
|
|
return args
|
|
|
|
|
|
def validate_optional_args(args):
|
|
"""Check if an argument was provided that depends on a module that may
|
|
not be part of the Python standard library.
|
|
|
|
If such an argument is supplied, and the module does not exist, exit
|
|
with an error stating which module is missing.
|
|
"""
|
|
optional_args = {
|
|
'json': ('json/simplejson python module', json),
|
|
'secure': ('SSL support', HTTPSConnection),
|
|
}
|
|
|
|
for arg, info in optional_args.items():
|
|
if getattr(args, arg, False) and info[1] is None:
|
|
raise SystemExit('%s is not installed. --%s is '
|
|
'unavailable' % (info[0], arg))
|
|
|
|
|
|
def printer(string, quiet=False, debug=False, **kwargs):
|
|
"""Helper function to print a string only when not quiet"""
|
|
|
|
if debug and not DEBUG:
|
|
return
|
|
|
|
if debug:
|
|
out = '\033[1;30mDEBUG: %s\033[0m' % string
|
|
else:
|
|
out = string
|
|
|
|
if not quiet:
|
|
print_(out, **kwargs)
|
|
|
|
|
|
def shell():
|
|
"""Run the full speedtest.net test"""
|
|
|
|
global SHUTDOWN_EVENT, SOURCE, SCHEME, DEBUG
|
|
SHUTDOWN_EVENT = threading.Event()
|
|
|
|
signal.signal(signal.SIGINT, ctrl_c)
|
|
|
|
args = parse_args()
|
|
|
|
# Print the version and exit
|
|
if args.version:
|
|
version()
|
|
|
|
if len(args.csv_delimiter) != 1:
|
|
raise SystemExit('--csv-delimiter must be a single character')
|
|
|
|
validate_optional_args(args)
|
|
|
|
socket.setdefaulttimeout(args.timeout)
|
|
|
|
# If specified bind to a specific IP address
|
|
if args.source:
|
|
SOURCE = args.source
|
|
socket.socket = bound_socket
|
|
|
|
if args.secure:
|
|
SCHEME = 'https'
|
|
|
|
debug = getattr(args, 'debug', False)
|
|
if debug and debug != 'SUPPRESSHELP':
|
|
DEBUG = True
|
|
|
|
# Pre-cache the user agent string
|
|
build_user_agent()
|
|
|
|
if args.simple or args.csv or args.json:
|
|
quiet = True
|
|
else:
|
|
quiet = False
|
|
|
|
# Don't set a callback if we are running quietly
|
|
if quiet or debug:
|
|
callback = do_nothing
|
|
else:
|
|
callback = print_dots
|
|
|
|
printer('Retrieving speedtest.net configuration...', quiet)
|
|
try:
|
|
speedtest = Speedtest(units=args.units)
|
|
except ConfigRetrievalError:
|
|
printer('Cannot retrieve speedtest configuration')
|
|
sys.exit(1)
|
|
|
|
if args.list:
|
|
try:
|
|
speedtest.get_servers()
|
|
except ServersRetrievalError:
|
|
print_('Cannot retrieve speedtest server list')
|
|
sys.exit(1)
|
|
|
|
for _, servers in sorted(speedtest.servers.items()):
|
|
for server in servers:
|
|
line = ('%(id)5s) %(sponsor)s (%(name)s, %(country)s) '
|
|
'[%(d)0.2f km]' % server)
|
|
try:
|
|
print_(line)
|
|
except IOError:
|
|
e = sys.exc_info()[1]
|
|
if e.errno != errno.EPIPE:
|
|
raise
|
|
sys.exit(0)
|
|
|
|
# Set a filter of servers to retrieve
|
|
servers = []
|
|
if args.server:
|
|
servers.append(args.server)
|
|
|
|
printer('Testing from %(isp)s (%(ip)s)...' % speedtest.config['client'],
|
|
quiet)
|
|
|
|
if not args.mini:
|
|
printer('Retrieving speedtest.net server list...', quiet)
|
|
try:
|
|
speedtest.get_servers(servers)
|
|
except NoMatchedServers:
|
|
print_('No matched servers: %s' % args.server)
|
|
sys.exit(1)
|
|
except ServersRetrievalError:
|
|
print_('Cannot retrieve speedtest server list')
|
|
sys.exit(1)
|
|
except InvalidServerIDType:
|
|
print_('%s is an invalid server type, must be int' % args.server)
|
|
sys.exit(1)
|
|
|
|
printer('Selecting best server based on ping...', quiet)
|
|
speedtest.get_best_server()
|
|
elif args.mini:
|
|
speedtest.get_best_server(speedtest.set_mini_server(args.mini))
|
|
|
|
results = speedtest.results
|
|
|
|
printer('Hosted by %(sponsor)s (%(name)s) [%(d)0.2f km]: '
|
|
'%(latency)s ms' % results.server, quiet)
|
|
|
|
printer('Testing download speed', quiet,
|
|
end=('', '\n')[bool(debug)])
|
|
speedtest.download(callback=callback)
|
|
printer('Download: %0.2f M%s/s' %
|
|
((results.download / 1000 / 1000), args.units[0]),
|
|
quiet)
|
|
|
|
printer('Testing upload speed', quiet,
|
|
end=('', '\n')[bool(debug)])
|
|
speedtest.upload(callback=callback)
|
|
printer('Upload: %0.2f M%s/s' %
|
|
((results.upload / 1000 / 1000), args.units[0]),
|
|
quiet)
|
|
|
|
if args.simple:
|
|
print_(results.simple())
|
|
elif args.csv:
|
|
print_(results.csv(delimiter=args.csv_delimiter))
|
|
elif args.json:
|
|
print_(results.json())
|
|
|
|
if args.share:
|
|
printer('Share results: %s' % results.share(), quiet)
|
|
|
|
|
|
def main():
|
|
try:
|
|
shell()
|
|
except KeyboardInterrupt:
|
|
print_('\nCancelling...')
|
|
except (SpeedtestException, SystemExit):
|
|
e = sys.exc_info()[1]
|
|
if getattr(e, 'code', 1) != 0:
|
|
raise SystemExit('ERROR: %s' % e)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|
|
|
|
# vim:ts=4:sw=4:expandtab
|