1759 lines
55 KiB
Python
Executable File
1759 lines
55 KiB
Python
Executable File
#!/usr/bin/env python
|
|
# -*- coding: utf-8 -*-
|
|
# Copyright 2012-2016 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
|
|
|
|
try:
|
|
import gzip
|
|
GZIP_BASE = gzip.GzipFile
|
|
except ImportError:
|
|
gzip = None
|
|
GZIP_BASE = object
|
|
|
|
__version__ = '2.0.0a'
|
|
|
|
|
|
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
|
|
SHUTDOWN_EVENT = FakeShutdownEvent()
|
|
DEBUG = False
|
|
_GLOBAL_DEFAULT_TIMEOUT = object()
|
|
|
|
# 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,
|
|
AbstractHTTPHandler, ProxyHandler,
|
|
HTTPDefaultErrorHandler, HTTPRedirectHandler,
|
|
HTTPErrorProcessor, OpenerDirector)
|
|
except ImportError:
|
|
from urllib.request import (urlopen, Request, HTTPError, URLError,
|
|
AbstractHTTPHandler, ProxyHandler,
|
|
HTTPDefaultErrorHandler, HTTPRedirectHandler,
|
|
HTTPErrorProcessor, OpenerDirector)
|
|
|
|
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
|
|
PARSER_TYPE_FLOAT = float
|
|
except ImportError:
|
|
from optparse import OptionParser as ArgParser
|
|
from optparse import SUPPRESS_HELP as ARG_SUPPRESS
|
|
PARSER_TYPE_INT = 'int'
|
|
PARSER_TYPE_STR = 'string'
|
|
PARSER_TYPE_FLOAT = 'float'
|
|
|
|
try:
|
|
from cStringIO import StringIO
|
|
BytesIO = None
|
|
except ImportError:
|
|
try:
|
|
from StringIO import StringIO
|
|
BytesIO = None
|
|
except ImportError:
|
|
from io import StringIO, BytesIO
|
|
|
|
try:
|
|
import __builtin__
|
|
except ImportError:
|
|
import builtins
|
|
from io import TextIOWrapper, FileIO
|
|
|
|
class _Py3Utf8Stdout(TextIOWrapper):
|
|
"""UTF-8 encoded wrapper around stdout for py3, to override
|
|
ASCII stdout
|
|
"""
|
|
def __init__(self, **kwargs):
|
|
buf = FileIO(sys.stdout.fileno(), 'w')
|
|
super(_Py3Utf8Stdout, self).__init__(
|
|
buf,
|
|
encoding='utf8',
|
|
errors='strict'
|
|
)
|
|
|
|
def write(self, s):
|
|
super(_Py3Utf8Stdout, self).write(s)
|
|
self.flush()
|
|
|
|
_py3_print = getattr(builtins, 'print')
|
|
_py3_utf8_stdout = _Py3Utf8Stdout()
|
|
|
|
def to_utf8(v):
|
|
"""No-op encode to utf-8 for py3"""
|
|
return v
|
|
|
|
def print_(*args, **kwargs):
|
|
"""Wrapper function for py3 to print, with a utf-8 encoded stdout"""
|
|
kwargs['file'] = _py3_utf8_stdout
|
|
_py3_print(*args, **kwargs)
|
|
else:
|
|
del __builtin__
|
|
|
|
def to_utf8(v):
|
|
"""Encode value to utf-8 if possible for py2"""
|
|
try:
|
|
return v.encode('utf8', 'strict')
|
|
except AttributeError:
|
|
return v
|
|
|
|
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 always, and to flush after write
|
|
"""
|
|
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 = 'utf8' # Always trust UTF-8 for output
|
|
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)
|
|
fp.flush()
|
|
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)
|
|
|
|
|
|
# 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 SpeedtestCLIError(SpeedtestException):
|
|
"""Generic exception for raising errors during CLI operation"""
|
|
|
|
|
|
class SpeedtestHTTPError(SpeedtestException):
|
|
"""Base HTTP exception for this module"""
|
|
|
|
|
|
class SpeedtestConfigError(SpeedtestException):
|
|
"""Configuration provided is invalid"""
|
|
|
|
|
|
class ConfigRetrievalError(SpeedtestHTTPError):
|
|
"""Could not retrieve config.php"""
|
|
|
|
|
|
class ServersRetrievalError(SpeedtestHTTPError):
|
|
"""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
|
|
"""
|
|
|
|
|
|
class SpeedtestBestServerFailure(SpeedtestException):
|
|
"""Unable to determine best server"""
|
|
|
|
|
|
class SpeedtestMissingBestServer(SpeedtestException):
|
|
"""get_best_server not called or not able to determine best server"""
|
|
|
|
|
|
def create_connection(address, timeout=_GLOBAL_DEFAULT_TIMEOUT,
|
|
source_address=None):
|
|
"""Connect to *address* and return the socket object.
|
|
|
|
Convenience function. Connect to *address* (a 2-tuple ``(host,
|
|
port)``) and return the socket object. Passing the optional
|
|
*timeout* parameter will set the timeout on the socket instance
|
|
before attempting to connect. If no *timeout* is supplied, the
|
|
global default timeout setting returned by :func:`getdefaulttimeout`
|
|
is used. If *source_address* is set it must be a tuple of (host, port)
|
|
for the socket to bind as a source address before making the connection.
|
|
An host of '' or port 0 tells the OS to use the default.
|
|
|
|
Largely vendored from Python 2.7, modified to work with Python 2.4
|
|
"""
|
|
|
|
host, port = address
|
|
err = None
|
|
for res in socket.getaddrinfo(host, port, 0, socket.SOCK_STREAM):
|
|
af, socktype, proto, canonname, sa = res
|
|
sock = None
|
|
try:
|
|
sock = socket.socket(af, socktype, proto)
|
|
if timeout is not _GLOBAL_DEFAULT_TIMEOUT:
|
|
sock.settimeout(float(timeout))
|
|
if source_address:
|
|
sock.bind(source_address)
|
|
sock.connect(sa)
|
|
return sock
|
|
|
|
except socket.error:
|
|
err = get_exception()
|
|
if sock is not None:
|
|
sock.close()
|
|
|
|
if err is not None:
|
|
raise err
|
|
else:
|
|
raise socket.error("getaddrinfo returns an empty list")
|
|
|
|
|
|
class SpeedtestHTTPConnection(HTTPConnection):
|
|
"""Custom HTTPConnection to support source_address across
|
|
Python 2.4 - Python 3
|
|
"""
|
|
def __init__(self, *args, **kwargs):
|
|
source_address = kwargs.pop('source_address', None)
|
|
context = kwargs.pop('context', None)
|
|
timeout = kwargs.pop('timeout', 10)
|
|
|
|
HTTPConnection.__init__(self, *args, **kwargs)
|
|
|
|
self.source_address = source_address
|
|
self._context = context
|
|
self.timeout = timeout
|
|
|
|
def connect(self):
|
|
"""Connect to the host and port specified in __init__."""
|
|
try:
|
|
self.sock = socket.create_connection(
|
|
(self.host, self.port),
|
|
self.timeout,
|
|
self.source_address
|
|
)
|
|
except (AttributeError, TypeError):
|
|
self.sock = create_connection(
|
|
(self.host, self.port),
|
|
self.timeout,
|
|
self.source_address
|
|
)
|
|
|
|
|
|
if HTTPSConnection:
|
|
class SpeedtestHTTPSConnection(HTTPSConnection,
|
|
SpeedtestHTTPConnection):
|
|
"""Custom HTTPSConnection to support source_address across
|
|
Python 2.4 - Python 3
|
|
"""
|
|
def connect(self):
|
|
"Connect to a host on a given (SSL) port."
|
|
|
|
SpeedtestHTTPConnection.connect(self)
|
|
|
|
kwargs = {}
|
|
if hasattr(ssl, 'SSLContext'):
|
|
kwargs['server_hostname'] = self.host
|
|
|
|
self.sock = self._context.wrap_socket(self.sock, **kwargs)
|
|
|
|
|
|
def _build_connection(connection, source_address, timeout, context=None):
|
|
"""Cross Python 2.4 - Python 3 callable to build an ``HTTPConnection`` or
|
|
``HTTPSConnection`` with the args we need
|
|
|
|
Called from ``http(s)_open`` methods of ``SpeedtestHTTPHandler`` or
|
|
``SpeedtestHTTPSHandler``
|
|
"""
|
|
def inner(host, **kwargs):
|
|
kwargs.update({
|
|
'source_address': source_address,
|
|
'timeout': timeout
|
|
})
|
|
if context:
|
|
kwargs['context'] = context
|
|
return connection(host, **kwargs)
|
|
return inner
|
|
|
|
|
|
class SpeedtestHTTPHandler(AbstractHTTPHandler):
|
|
"""Custom ``HTTPHandler`` that can build a ``HTTPConnection`` with the
|
|
args we need for ``source_address`` and ``timeout``
|
|
"""
|
|
def __init__(self, debuglevel=0, source_address=None, timeout=10):
|
|
AbstractHTTPHandler.__init__(self, debuglevel)
|
|
self.source_address = source_address
|
|
self.timeout = timeout
|
|
|
|
def http_open(self, req):
|
|
return self.do_open(
|
|
_build_connection(
|
|
SpeedtestHTTPConnection,
|
|
self.source_address,
|
|
self.timeout
|
|
),
|
|
req
|
|
)
|
|
|
|
http_request = AbstractHTTPHandler.do_request_
|
|
|
|
|
|
class SpeedtestHTTPSHandler(AbstractHTTPHandler):
|
|
"""Custom ``HTTPSHandler`` that can build a ``HTTPSConnection`` with the
|
|
args we need for ``source_address`` and ``timeout``
|
|
"""
|
|
def __init__(self, debuglevel=0, context=None, source_address=None,
|
|
timeout=10):
|
|
AbstractHTTPHandler.__init__(self, debuglevel)
|
|
self._context = context
|
|
self.source_address = source_address
|
|
self.timeout = timeout
|
|
|
|
def https_open(self, req):
|
|
return self.do_open(
|
|
_build_connection(
|
|
SpeedtestHTTPSConnection,
|
|
self.source_address,
|
|
self.timeout,
|
|
context=self._context,
|
|
),
|
|
req
|
|
)
|
|
|
|
https_request = AbstractHTTPHandler.do_request_
|
|
|
|
|
|
def build_opener(source_address=None, timeout=10):
|
|
"""Function similar to ``urllib2.build_opener`` that will build
|
|
an ``OpenerDirector`` with the explicit handlers we want,
|
|
``source_address`` for binding, ``timeout`` and our custom
|
|
`User-Agent`
|
|
"""
|
|
|
|
printer('Timeout set to %d' % timeout, debug=True)
|
|
|
|
if source_address:
|
|
source_address_tuple = (source_address, 0)
|
|
printer('Binding to source address: %r' % (source_address_tuple,),
|
|
debug=True)
|
|
else:
|
|
source_address_tuple = None
|
|
|
|
handlers = [
|
|
ProxyHandler(),
|
|
SpeedtestHTTPHandler(source_address=source_address_tuple,
|
|
timeout=timeout),
|
|
SpeedtestHTTPSHandler(source_address=source_address_tuple,
|
|
timeout=timeout),
|
|
HTTPDefaultErrorHandler(),
|
|
HTTPRedirectHandler(),
|
|
HTTPErrorProcessor()
|
|
]
|
|
|
|
opener = OpenerDirector()
|
|
opener.addheaders = [('User-agent', build_user_agent())]
|
|
|
|
for handler in handlers:
|
|
opener.add_handler(handler)
|
|
|
|
return opener
|
|
|
|
|
|
class GzipDecodedResponse(GZIP_BASE):
|
|
"""A file-like object to decode a response encoded with the gzip
|
|
method, as described in RFC 1952.
|
|
|
|
Largely copied from ``xmlrpclib``/``xmlrpc.client`` and modified
|
|
to work for py2.4-py3
|
|
"""
|
|
def __init__(self, response):
|
|
# response doesn't support tell() and read(), required by
|
|
# GzipFile
|
|
if not gzip:
|
|
raise SpeedtestHTTPError('HTTP response body is gzip encoded, '
|
|
'but gzip support is not available')
|
|
IO = BytesIO or StringIO
|
|
self.io = IO()
|
|
while 1:
|
|
chunk = response.read(1024)
|
|
if len(chunk) == 0:
|
|
break
|
|
self.io.write(chunk)
|
|
self.io.seek(0)
|
|
gzip.GzipFile.__init__(self, mode='rb', fileobj=self.io)
|
|
|
|
def close(self):
|
|
try:
|
|
gzip.GzipFile.close(self)
|
|
finally:
|
|
self.io.close()
|
|
|
|
|
|
def get_exception():
|
|
"""Helper function to work with py2.4-py3 for getting the current
|
|
exception in a try/except block
|
|
"""
|
|
return sys.exc_info()[1]
|
|
|
|
|
|
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"""
|
|
|
|
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: %s' % user_agent, debug=True)
|
|
return user_agent
|
|
|
|
|
|
def build_request(url, data=None, headers=None, bump='0', secure=False):
|
|
"""Build a urllib2 request object
|
|
|
|
This function automatically adds a User-Agent header to all requests
|
|
|
|
"""
|
|
|
|
if not headers:
|
|
headers = {}
|
|
|
|
if url[0] == ':':
|
|
scheme = ('http', 'https')[bool(secure)]
|
|
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.%s' % (schemed_url, delim,
|
|
int(timeit.time.time() * 1000),
|
|
bump)
|
|
|
|
headers.update({
|
|
'Cache-Control': 'no-cache',
|
|
})
|
|
|
|
printer('%s %s' % (('GET', 'POST')[bool(data)], final_url),
|
|
debug=True)
|
|
|
|
return Request(final_url, data=data, headers=headers)
|
|
|
|
|
|
def catch_request(request, opener=None):
|
|
"""Helper function to catch common exceptions encountered when
|
|
establishing a connection with a HTTP/HTTPS request
|
|
|
|
"""
|
|
|
|
if opener:
|
|
_open = opener.open
|
|
else:
|
|
_open = urlopen
|
|
|
|
try:
|
|
uh = _open(request)
|
|
return uh, False
|
|
except HTTP_ERRORS:
|
|
e = get_exception()
|
|
return None, e
|
|
|
|
|
|
def get_response_stream(response):
|
|
"""Helper function to return either a Gzip reader if
|
|
``Content-Encoding`` is ``gzip`` otherwise the response itself
|
|
|
|
"""
|
|
|
|
try:
|
|
getheader = response.headers.getheader
|
|
except AttributeError:
|
|
getheader = response.getheader
|
|
|
|
if getheader('content-encoding') == 'gzip':
|
|
return GzipDecodedResponse(response)
|
|
|
|
return response
|
|
|
|
|
|
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, opener=None):
|
|
threading.Thread.__init__(self)
|
|
self.request = request
|
|
self.result = [0]
|
|
self.starttime = start
|
|
self.timeout = timeout
|
|
self.i = i
|
|
if opener:
|
|
self._opener = opener.open
|
|
else:
|
|
self._opener = urlopen
|
|
|
|
def run(self):
|
|
try:
|
|
if (timeit.default_timer() - self.starttime) <= self.timeout:
|
|
f = self._opener(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 pre_allocate(self):
|
|
chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'
|
|
multiplier = int(round(int(self.length) / 36.0))
|
|
IO = BytesIO or StringIO
|
|
self._data = IO(
|
|
('content1=%s' %
|
|
(chars * multiplier)[0:int(self.length) - 9]
|
|
).encode()
|
|
)
|
|
|
|
@property
|
|
def data(self):
|
|
if not self._data:
|
|
self.pre_allocate()
|
|
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)
|
|
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, opener=None):
|
|
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
|
|
|
|
if opener:
|
|
self._opener = opener.open
|
|
else:
|
|
self._opener = urlopen
|
|
|
|
def run(self):
|
|
request = self.request
|
|
try:
|
|
if ((timeit.default_timer() - self.starttime) <= self.timeout and
|
|
not SHUTDOWN_EVENT.isSet()):
|
|
try:
|
|
f = self._opener(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 = self._opener(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 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.
|
|
"""
|
|
|
|
def __init__(self, download=0, upload=0, ping=0, server=None, opener=None,
|
|
secure=False):
|
|
self.download = download
|
|
self.upload = upload
|
|
self.ping = ping
|
|
if server is None:
|
|
self.server = {}
|
|
else:
|
|
self.server = server
|
|
self._share = None
|
|
self.timestamp = '%sZ' % datetime.datetime.utcnow().isoformat()
|
|
self.bytes_received = 0
|
|
self.bytes_sent = 0
|
|
|
|
if opener:
|
|
self._opener = opener
|
|
else:
|
|
self._opener = build_opener()
|
|
|
|
self._secure = secure
|
|
|
|
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
|
|
|
|
download = int(round(self.download / 1000.0, 0))
|
|
ping = int(round(self.ping, 0))
|
|
upload = int(round(self.upload / 1000.0, 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 = [
|
|
'recommendedserverid=%s' % self.server['id'],
|
|
'ping=%s' % ping,
|
|
'screenresolution=',
|
|
'promo=',
|
|
'download=%s' % download,
|
|
'screendpi=',
|
|
'upload=%s' % upload,
|
|
'testmethod=http',
|
|
'hash=%s' % md5(('%s-%s-%s-%s' %
|
|
(ping, upload, download, '297aae72'))
|
|
.encode()).hexdigest(),
|
|
'touchscreen=none',
|
|
'startmode=pingselect',
|
|
'accuracy=1',
|
|
'bytesreceived=%s' % self.bytes_received,
|
|
'bytessent=%s' % self.bytes_sent,
|
|
'serverid=%s' % self.server['id'],
|
|
]
|
|
|
|
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, secure=self._secure)
|
|
f, e = catch_request(request, opener=self._opener)
|
|
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,
|
|
'bytes_sent': self.bytes_sent,
|
|
'bytes_received': self.bytes_received,
|
|
'share': self._share,
|
|
}
|
|
|
|
def csv(self, delimiter=','):
|
|
"""Return data in CSV format"""
|
|
|
|
data = self.dict()
|
|
out = StringIO()
|
|
writer = csv.writer(out, delimiter=delimiter, lineterminator='')
|
|
row = [data['server']['id'], data['server']['sponsor'],
|
|
data['server']['name'], data['timestamp'],
|
|
data['server']['d'], data['ping'], data['download'],
|
|
data['upload']]
|
|
writer.writerow([to_utf8(v) for v in row])
|
|
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)
|
|
|
|
|
|
class Speedtest(object):
|
|
"""Class for performing standard speedtest.net testing operations"""
|
|
|
|
def __init__(self, config=None, source_address=None, timeout=10,
|
|
secure=False):
|
|
self.config = {}
|
|
|
|
self._source_address = source_address
|
|
self._timeout = timeout
|
|
self._opener = build_opener(source_address, timeout)
|
|
|
|
self._secure = secure
|
|
|
|
self.get_config()
|
|
if config is not None:
|
|
self.config.update(config)
|
|
|
|
self.servers = {}
|
|
self.closest = []
|
|
self._best = {}
|
|
|
|
self.results = SpeedtestResults(opener=self._opener, secure=secure)
|
|
|
|
@property
|
|
def best(self):
|
|
if not self._best:
|
|
raise SpeedtestMissingBestServer(
|
|
'get_best_server not called or not able to determine best '
|
|
'server'
|
|
)
|
|
return self._best
|
|
|
|
def get_config(self):
|
|
"""Download the speedtest.net configuration and return only the data
|
|
we are interested in
|
|
"""
|
|
|
|
headers = {}
|
|
if gzip:
|
|
headers['Accept-Encoding'] = 'gzip'
|
|
request = build_request('://www.speedtest.net/speedtest-config.php',
|
|
headers=headers, secure=self._secure)
|
|
uh, e = catch_request(request, opener=self._opener)
|
|
if e:
|
|
raise ConfigRetrievalError(e)
|
|
configxml = []
|
|
|
|
stream = get_response_stream(uh)
|
|
|
|
while 1:
|
|
configxml.append(stream.read(1024))
|
|
if len(configxml[-1]) == 0:
|
|
break
|
|
stream.close()
|
|
uh.close()
|
|
|
|
if int(uh.code) != 200:
|
|
return None
|
|
|
|
printer('Config XML:\n%s' % ''.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(','))
|
|
)
|
|
|
|
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]
|
|
}
|
|
|
|
size_count = len(sizes['upload'])
|
|
|
|
upload_count = int(math.ceil(upload_max / size_count))
|
|
|
|
counts = {
|
|
'upload': upload_count,
|
|
'download': int(download['threadsperurl'])
|
|
}
|
|
|
|
threads = {
|
|
'upload': int(upload['threads']),
|
|
'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_count * size_count
|
|
})
|
|
|
|
self.lat_lon = (float(client['lat']), float(client['lon']))
|
|
|
|
printer('Config:\n%r' % self.config, debug=True)
|
|
|
|
return self.config
|
|
|
|
def get_servers(self, servers=None, exclude=None):
|
|
"""Retrieve a the list of speedtest.net servers, optionally filtered
|
|
to servers matching those specified in the ``servers`` argument
|
|
"""
|
|
if servers is None:
|
|
servers = []
|
|
|
|
if exclude is None:
|
|
exclude = []
|
|
|
|
self.servers.clear()
|
|
|
|
for server_list in (servers, exclude):
|
|
for i, s in enumerate(server_list):
|
|
try:
|
|
server_list[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',
|
|
]
|
|
|
|
headers = {}
|
|
if gzip:
|
|
headers['Accept-Encoding'] = 'gzip'
|
|
|
|
errors = []
|
|
for url in urls:
|
|
try:
|
|
request = build_request(
|
|
'%s?threads=%s' % (url,
|
|
self.config['threads']['download']),
|
|
headers=headers,
|
|
secure=self._secure
|
|
)
|
|
uh, e = catch_request(request, opener=self._opener)
|
|
if e:
|
|
errors.append('%s' % e)
|
|
raise ServersRetrievalError()
|
|
|
|
stream = get_response_stream(uh)
|
|
|
|
serversxml = []
|
|
while 1:
|
|
serversxml.append(stream.read(1024))
|
|
if len(serversxml[-1]) == 0:
|
|
break
|
|
|
|
stream.close()
|
|
uh.close()
|
|
|
|
if int(uh.code) != 200:
|
|
raise ServersRetrievalError()
|
|
|
|
printer('Servers XML:\n%s' % ''.encode().join(serversxml),
|
|
debug=True)
|
|
|
|
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']
|
|
or int(attrib.get('id')) in exclude):
|
|
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]
|
|
|
|
break
|
|
|
|
except ServersRetrievalError:
|
|
continue
|
|
|
|
if (servers or exclude) 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, opener=self._opener)
|
|
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 = self._opener.open(
|
|
'%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('Closest Servers:\n%r' % self.closest, debug=True)
|
|
return self.closest
|
|
|
|
def get_best_server(self, servers=None):
|
|
"""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
|
|
|
|
if self._source_address:
|
|
source_address_tuple = (self._source_address, 0)
|
|
else:
|
|
source_address_tuple = None
|
|
|
|
user_agent = build_user_agent()
|
|
|
|
results = {}
|
|
for server in servers:
|
|
cum = []
|
|
url = os.path.dirname(server['url'])
|
|
stamp = int(timeit.time.time() * 1000)
|
|
latency_url = '%s/latency.txt?x=%s' % (url, stamp)
|
|
for i in range(0, 3):
|
|
this_latency_url = '%s.%s' % (latency_url, i)
|
|
printer('%s %s' % ('GET', this_latency_url),
|
|
debug=True)
|
|
urlparts = urlparse(latency_url)
|
|
try:
|
|
if urlparts[0] == 'https':
|
|
h = SpeedtestHTTPSConnection(
|
|
urlparts[1],
|
|
source_address=source_address_tuple
|
|
)
|
|
else:
|
|
h = SpeedtestHTTPConnection(
|
|
urlparts[1],
|
|
source_address=source_address_tuple
|
|
)
|
|
headers = {'User-Agent': user_agent}
|
|
path = '%s?%s' % (urlparts[2], urlparts[4])
|
|
start = timeit.default_timer()
|
|
h.request("GET", path, headers=headers)
|
|
r = h.getresponse()
|
|
total = (timeit.default_timer() - start)
|
|
except HTTP_ERRORS:
|
|
e = get_exception()
|
|
printer('ERROR: %r' % e, debug=True)
|
|
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.0, 3)
|
|
results[avg] = server
|
|
|
|
try:
|
|
fastest = sorted(results.keys())[0]
|
|
except IndexError:
|
|
raise SpeedtestBestServerFailure('Unable to connect to servers to '
|
|
'test latency.')
|
|
best = results[fastest]
|
|
best['latency'] = fastest
|
|
|
|
self.results.ping = fastest
|
|
self.results.server = best
|
|
|
|
self._best.update(best)
|
|
printer('Best Server:\n%r' % 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 i, url in enumerate(urls):
|
|
requests.append(
|
|
build_request(url, bump=i, secure=self._secure)
|
|
)
|
|
|
|
def producer(q, requests, request_count):
|
|
for i, request in enumerate(requests):
|
|
thread = HTTPDownloader(i, request, start,
|
|
self.config['length']['download'],
|
|
opener=self._opener)
|
|
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.bytes_received = sum(finished)
|
|
self.results.download = (
|
|
(self.results.bytes_received / (stop - start)) * 8.0
|
|
)
|
|
if self.results.download > 100000:
|
|
self.config['threads']['upload'] = 8
|
|
return self.results.download
|
|
|
|
def upload(self, callback=do_nothing, pre_allocate=True):
|
|
"""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 i, size in enumerate(sizes):
|
|
# We set ``0`` for ``start`` and handle setting the actual
|
|
# ``start`` in ``HTTPUploader`` to get better measurements
|
|
data = HTTPUploaderData(size, 0, self.config['length']['upload'])
|
|
if pre_allocate:
|
|
data.pre_allocate()
|
|
requests.append(
|
|
(
|
|
build_request(self.best['url'], data, secure=self._secure),
|
|
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'],
|
|
opener=self._opener)
|
|
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.bytes_sent = sum(finished)
|
|
self.results.upload = (
|
|
(self.results.bytes_sent / (stop - start)) * 8.0
|
|
)
|
|
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 csv_header(delimiter=','):
|
|
"""Print the CSV Headers"""
|
|
|
|
row = ['Server ID', 'Sponsor', 'Server Name', 'Timestamp', 'Distance',
|
|
'Ping', 'Download', 'Upload']
|
|
out = StringIO()
|
|
writer = csv.writer(out, delimiter=delimiter, lineterminator='')
|
|
writer.writerow([to_utf8(v) for v in row])
|
|
print_(out.getvalue())
|
|
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('--no-download', dest='download', default=True,
|
|
action='store_const', const=False,
|
|
help='Do not perform download test')
|
|
parser.add_argument('--no-upload', dest='upload', default=True,
|
|
action='store_const', const=False,
|
|
help='Do not perform upload test')
|
|
parser.add_argument('--bytes', dest='units', action='store_const',
|
|
const=('byte', 8), default=('bit', 1),
|
|
help='Display values in bytes instead of bits. Does '
|
|
'not affect the image generated by --share, nor '
|
|
'output from --json or --csv')
|
|
parser.add_argument('--share', action='store_true',
|
|
help='Generate and provide a URL to the speedtest.net '
|
|
'share results image, not displayed with --csv')
|
|
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. Speeds listed in '
|
|
'bit/s and not affected by --bytes')
|
|
parser.add_argument('--csv-delimiter', default=',', type=PARSER_TYPE_STR,
|
|
help='Single character delimiter to use in CSV '
|
|
'output. Default ","')
|
|
parser.add_argument('--csv-header', action='store_true', default=False,
|
|
help='Print CSV headers')
|
|
parser.add_argument('--json', action='store_true', default=False,
|
|
help='Suppress verbose output, only show basic '
|
|
'information in JSON format. Speeds listed in '
|
|
'bit/s and not affected by --bytes')
|
|
parser.add_argument('--list', action='store_true',
|
|
help='Display a list of speedtest.net servers '
|
|
'sorted by distance')
|
|
parser.add_argument('--server', type=PARSER_TYPE_INT, action='append',
|
|
help='Specify a server ID to test against')
|
|
parser.add_argument('--exclude', type=PARSER_TYPE_INT, action='append',
|
|
help='Exclude a server from selection. Can be '
|
|
'supplied multiple times')
|
|
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_FLOAT,
|
|
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('--no-pre-allocate', dest='pre_allocate',
|
|
action='store_const', default=True, const=False,
|
|
help='Do not pre allocate upload data. Pre allocation '
|
|
'is enabled by default to improve upload '
|
|
'performance. To support systems with '
|
|
'insufficient memory, use this option to avoid a '
|
|
'MemoryError')
|
|
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, DEBUG
|
|
SHUTDOWN_EVENT = threading.Event()
|
|
|
|
signal.signal(signal.SIGINT, ctrl_c)
|
|
|
|
args = parse_args()
|
|
|
|
# Print the version and exit
|
|
if args.version:
|
|
version()
|
|
|
|
if not args.download and not args.upload:
|
|
raise SpeedtestCLIError('Cannot supply both --no-download and '
|
|
'--no-upload')
|
|
|
|
if len(args.csv_delimiter) != 1:
|
|
raise SpeedtestCLIError('--csv-delimiter must be a single character')
|
|
|
|
if args.csv_header:
|
|
csv_header(args.csv_delimiter)
|
|
|
|
validate_optional_args(args)
|
|
|
|
debug = getattr(args, 'debug', False)
|
|
if debug == 'SUPPRESSHELP':
|
|
debug = False
|
|
if debug:
|
|
DEBUG = True
|
|
|
|
if args.simple or args.csv or args.json:
|
|
quiet = True
|
|
else:
|
|
quiet = False
|
|
|
|
if args.csv or args.json:
|
|
machine_format = True
|
|
else:
|
|
machine_format = 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(
|
|
source_address=args.source,
|
|
timeout=args.timeout,
|
|
secure=args.secure
|
|
)
|
|
except (ConfigRetrievalError,) + HTTP_ERRORS:
|
|
printer('Cannot retrieve speedtest configuration')
|
|
raise SpeedtestCLIError(get_exception())
|
|
|
|
if args.list:
|
|
try:
|
|
speedtest.get_servers()
|
|
except (ServersRetrievalError,) + HTTP_ERRORS:
|
|
print_('Cannot retrieve speedtest server list')
|
|
raise SpeedtestCLIError(get_exception())
|
|
|
|
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 = get_exception()
|
|
if e.errno != errno.EPIPE:
|
|
raise
|
|
sys.exit(0)
|
|
|
|
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=args.server, exclude=args.exclude)
|
|
except NoMatchedServers:
|
|
raise SpeedtestCLIError(
|
|
'No matched servers: %s' %
|
|
', '.join('%s' % s for s in args.server)
|
|
)
|
|
except (ServersRetrievalError,) + HTTP_ERRORS:
|
|
print_('Cannot retrieve speedtest server list')
|
|
raise SpeedtestCLIError(get_exception())
|
|
except InvalidServerIDType:
|
|
raise SpeedtestCLIError(
|
|
'%s is an invalid server type, must '
|
|
'be an int' % ', '.join('%s' % s for s in args.server)
|
|
)
|
|
|
|
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)
|
|
|
|
if args.download:
|
|
printer('Testing download speed', quiet,
|
|
end=('', '\n')[bool(debug)])
|
|
speedtest.download(callback=callback)
|
|
printer('Download: %0.2f M%s/s' %
|
|
((results.download / 1000.0 / 1000.0) / args.units[1],
|
|
args.units[0]),
|
|
quiet)
|
|
else:
|
|
printer('Skipping download test')
|
|
|
|
if args.upload:
|
|
printer('Testing upload speed', quiet,
|
|
end=('', '\n')[bool(debug)])
|
|
speedtest.upload(callback=callback, pre_allocate=args.pre_allocate)
|
|
printer('Upload: %0.2f M%s/s' %
|
|
((results.upload / 1000.0 / 1000.0) / args.units[1],
|
|
args.units[0]),
|
|
quiet)
|
|
else:
|
|
printer('Skipping upload test')
|
|
|
|
printer('Results:\n%r' % results.dict(), debug=True)
|
|
|
|
if args.simple:
|
|
print_('Ping: %s ms\nDownload: %0.2f M%s/s\nUpload: %0.2f M%s/s' %
|
|
(results.ping,
|
|
(results.download / 1000.0 / 1000.0) / args.units[1],
|
|
args.units[0],
|
|
(results.upload / 1000.0 / 1000.0) / args.units[1],
|
|
args.units[0]))
|
|
elif args.csv:
|
|
print_(results.csv(delimiter=args.csv_delimiter))
|
|
elif args.json:
|
|
if args.share:
|
|
results.share()
|
|
print_(results.json())
|
|
|
|
if args.share and not machine_format:
|
|
printer('Share results: %s' % results.share())
|
|
|
|
|
|
def main():
|
|
try:
|
|
shell()
|
|
except KeyboardInterrupt:
|
|
print_('\nCancelling...')
|
|
except (SpeedtestException, SystemExit):
|
|
e = get_exception()
|
|
if getattr(e, 'code', 1) != 0:
|
|
raise SystemExit('ERROR: %s' % e)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|