| Line 1: |
Line 1: |
| | curl -s https://raw.githubusercontent.com/sivel/speedtest-cli/master/speedtest.py | python - | | curl -s https://raw.githubusercontent.com/sivel/speedtest-cli/master/speedtest.py | python - |
| | + | |
| | + | <source lang=python>#!/usr/bin/env python |
| | + | # -*- coding: utf-8 -*- |
| | + | # Copyright 2012-2018 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.2' |
| | + | |
| | + | |
| | + | 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 |
| | + | 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 |
| | + | from xml.parsers.expat import ExpatError |
| | + | 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, BadStatusLine |
| | + | except ImportError: |
| | + | from http.client import HTTPConnection, BadStatusLine |
| | + | |
| | + | 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 _Py3Utf8Output(TextIOWrapper): |
| | + | """UTF-8 encoded wrapper around stdout for py3, to override |
| | + | ASCII stdout |
| | + | """ |
| | + | def __init__(self, f, **kwargs): |
| | + | buf = FileIO(f.fileno(), 'w') |
| | + | super(_Py3Utf8Output, self).__init__( |
| | + | buf, |
| | + | encoding='utf8', |
| | + | errors='strict' |
| | + | ) |
| | + | |
| | + | def write(self, s): |
| | + | super(_Py3Utf8Output, self).write(s) |
| | + | self.flush() |
| | + | |
| | + | _py3_print = getattr(builtins, 'print') |
| | + | try: |
| | + | _py3_utf8_stdout = _Py3Utf8Output(sys.stdout) |
| | + | _py3_utf8_stderr = _Py3Utf8Output(sys.stderr) |
| | + | except OSError: |
| | + | # sys.stdout/sys.stderr is not a compatible stdout/stderr object |
| | + | # just use it and hope things go ok |
| | + | _py3_utf8_stdout = sys.stdout |
| | + | _py3_utf8_stderr = sys.stderr |
| | + | |
| | + | 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""" |
| | + | if kwargs.get('file') == sys.stderr: |
| | + | kwargs['file'] = _py3_utf8_stderr |
| | + | else: |
| | + | kwargs['file'] = kwargs.get('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, BadStatusLine) + |
| | + | CERT_ERROR |
| | + | ) |
| | + | except ImportError: |
| | + | ssl = None |
| | + | HTTP_ERRORS = (HTTPError, URLError, socket.error, BadStatusLine) |
| | + | |
| | + | |
| | + | 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 XML is invalid""" |
| | + | |
| | + | |
| | + | class SpeedtestServersError(SpeedtestException): |
| | + | """Servers XML 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) |
| | + | timeout = kwargs.pop('timeout', 10) |
| | + | |
| | + | HTTPConnection.__init__(self, *args, **kwargs) |
| | + | |
| | + | self.source_address = source_address |
| | + | 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 __init__(self, *args, **kwargs): |
| | + | source_address = kwargs.pop('source_address', None) |
| | + | timeout = kwargs.pop('timeout', 10) |
| | + | |
| | + | HTTPSConnection.__init__(self, *args, **kwargs) |
| | + | |
| | + | self.timeout = timeout |
| | + | self.source_address = source_address |
| | + | |
| | + | def connect(self): |
| | + | "Connect to a host on a given (SSL) port." |
| | + | |
| | + | SpeedtestHTTPConnection.connect(self) |
| | + | |
| | + | kwargs = {} |
| | + | if ssl: |
| | + | if hasattr(ssl, 'SSLContext'): |
| | + | kwargs['server_hostname'] = self.host |
| | + | try: |
| | + | self.sock = self._context.wrap_socket(self.sock, **kwargs) |
| | + | except AttributeError: |
| | + | self.sock = ssl.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(shutdown_event): |
| | + | """Built in callback function used by Thread classes for printing |
| | + | status |
| | + | """ |
| | + | def inner(current, total, start=False, end=False): |
| | + | if shutdown_event.isSet(): |
| | + | return |
| | + | |
| | + | sys.stdout.write('.') |
| | + | if current + 1 == total and end is True: |
| | + | sys.stdout.write('\n') |
| | + | sys.stdout.flush() |
| | + | return inner |
| | + | |
| | + | |
| | + | 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, |
| | + | shutdown_event=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 |
| | + | |
| | + | if shutdown_event: |
| | + | self._shutdown_event = shutdown_event |
| | + | else: |
| | + | self._shutdown_event = FakeShutdownEvent() |
| | + | |
| | + | def run(self): |
| | + | try: |
| | + | if (timeit.default_timer() - self.starttime) <= self.timeout: |
| | + | f = self._opener(self.request) |
| | + | while (not self._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, shutdown_event=None): |
| | + | self.length = length |
| | + | self.start = start |
| | + | self.timeout = timeout |
| | + | |
| | + | if shutdown_event: |
| | + | self._shutdown_event = shutdown_event |
| | + | else: |
| | + | self._shutdown_event = FakeShutdownEvent() |
| | + | |
| | + | self._data = None |
| | + | |
| | + | self.total = [0] |
| | + | |
| | + | def pre_allocate(self): |
| | + | chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ' |
| | + | multiplier = int(round(int(self.length) / 36.0)) |
| | + | IO = BytesIO or StringIO |
| | + | try: |
| | + | self._data = IO( |
| | + | ('content1=%s' % |
| | + | (chars * multiplier)[0:int(self.length) - 9] |
| | + | ).encode() |
| | + | ) |
| | + | except MemoryError: |
| | + | raise SpeedtestCLIError( |
| | + | 'Insufficient memory to pre-allocate upload data. Please ' |
| | + | 'use --no-pre-allocate' |
| | + | ) |
| | + | |
| | + | @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 self._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, |
| | + | shutdown_event=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 |
| | + | |
| | + | if shutdown_event: |
| | + | self._shutdown_event = shutdown_event |
| | + | else: |
| | + | self._shutdown_event = FakeShutdownEvent() |
| | + | |
| | + | def run(self): |
| | + | request = self.request |
| | + | try: |
| | + | if ((timeit.default_timer() - self.starttime) <= self.timeout and |
| | + | not self._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, client=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.client = client or {} |
| | + | |
| | + | 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, |
| | + | 'client': self.client, |
| | + | } |
| | + | |
| | + | @staticmethod |
| | + | def csv_header(delimiter=','): |
| | + | """Return CSV Headers""" |
| | + | |
| | + | row = ['Server ID', 'Sponsor', 'Server Name', 'Timestamp', 'Distance', |
| | + | 'Ping', 'Download', 'Upload', 'Share', 'IP Address'] |
| | + | out = StringIO() |
| | + | writer = csv.writer(out, delimiter=delimiter, lineterminator='') |
| | + | writer.writerow([to_utf8(v) for v in row]) |
| | + | return out.getvalue() |
| | + | |
| | + | 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'], self._share or '', self.client['ip']] |
| | + | 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, shutdown_event=None): |
| | + | self.config = {} |
| | + | |
| | + | self._source_address = source_address |
| | + | self._timeout = timeout |
| | + | self._opener = build_opener(source_address, timeout) |
| | + | |
| | + | self._secure = secure |
| | + | |
| | + | if shutdown_event: |
| | + | self._shutdown_event = shutdown_event |
| | + | else: |
| | + | self._shutdown_event = FakeShutdownEvent() |
| | + | |
| | + | self.get_config() |
| | + | if config is not None: |
| | + | self.config.update(config) |
| | + | |
| | + | self.servers = {} |
| | + | self.closest = [] |
| | + | self._best = {} |
| | + | |
| | + | self.results = SpeedtestResults( |
| | + | client=self.config['client'], |
| | + | 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_list = [] |
| | + | |
| | + | stream = get_response_stream(uh) |
| | + | |
| | + | while 1: |
| | + | try: |
| | + | configxml_list.append(stream.read(1024)) |
| | + | except (OSError, EOFError): |
| | + | raise ConfigRetrievalError(get_exception()) |
| | + | if len(configxml_list[-1]) == 0: |
| | + | break |
| | + | stream.close() |
| | + | uh.close() |
| | + | |
| | + | if int(uh.code) != 200: |
| | + | return None |
| | + | |
| | + | configxml = ''.encode().join(configxml_list) |
| | + | |
| | + | printer('Config XML:\n%s' % configxml, debug=True) |
| | + | |
| | + | try: |
| | + | try: |
| | + | root = ET.fromstring(configxml) |
| | + | except ET.ParseError: |
| | + | e = get_exception() |
| | + | raise SpeedtestConfigError( |
| | + | 'Malformed speedtest.net configuration: %s' % e |
| | + | ) |
| | + | 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: |
| | + | try: |
| | + | root = DOM.parseString(configxml) |
| | + | except ExpatError: |
| | + | e = get_exception() |
| | + | raise SpeedtestConfigError( |
| | + | 'Malformed speedtest.net configuration: %s' % e |
| | + | ) |
| | + | 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 |
| | + | }) |
| | + | |
| | + | try: |
| | + | self.lat_lon = (float(client['lat']), float(client['lon'])) |
| | + | except ValueError: |
| | + | raise SpeedtestConfigError( |
| | + | 'Unknown location: lat=%r lon=%r' % |
| | + | (client.get('lat'), client.get('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_list = [] |
| | + | while 1: |
| | + | try: |
| | + | serversxml_list.append(stream.read(1024)) |
| | + | except (OSError, EOFError): |
| | + | raise ServersRetrievalError(get_exception()) |
| | + | if len(serversxml_list[-1]) == 0: |
| | + | break |
| | + | |
| | + | stream.close() |
| | + | uh.close() |
| | + | |
| | + | if int(uh.code) != 200: |
| | + | raise ServersRetrievalError() |
| | + | |
| | + | serversxml = ''.encode().join(serversxml_list) |
| | + | |
| | + | printer('Servers XML:\n%s' % serversxml, debug=True) |
| | + | |
| | + | try: |
| | + | try: |
| | + | try: |
| | + | root = ET.fromstring(serversxml) |
| | + | except ET.ParseError: |
| | + | e = get_exception() |
| | + | raise SpeedtestServersError( |
| | + | 'Malformed speedtest.net server list: %s' % e |
| | + | ) |
| | + | elements = root.getiterator('server') |
| | + | except AttributeError: |
| | + | try: |
| | + | root = DOM.parseString(serversxml) |
| | + | except ExpatError: |
| | + | e = get_exception() |
| | + | raise SpeedtestServersError( |
| | + | 'Malformed speedtest.net server list: %s' % e |
| | + | ) |
| | + | 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 Exception: |
| | + | 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 Exception: |
| | + | 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, |
| | + | shutdown_event=self._shutdown_event |
| | + | ) |
| | + | 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'], |
| | + | shutdown_event=self._shutdown_event |
| | + | ) |
| | + | 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, |
| | + | shutdown_event=self._shutdown_event |
| | + | ) |
| | + | 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(shutdown_event): |
| | + | """Catch Ctrl-C key sequence and set a SHUTDOWN_EVENT for our threaded |
| | + | operations |
| | + | """ |
| | + | def inner(signum, frame): |
| | + | shutdown_event.set() |
| | + | printer('\nCancelling...', error=True) |
| | + | sys.exit(0) |
| | + | return inner |
| | + | |
| | + | |
| | + | def version(): |
| | + | """Print the version""" |
| | + | |
| | + | printer(__version__) |
| | + | sys.exit(0) |
| | + | |
| | + | |
| | + | def csv_header(delimiter=','): |
| | + | """Print the CSV Headers""" |
| | + | |
| | + | printer(SpeedtestResults.csv_header(delimiter=delimiter)) |
| | + | 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. Can be ' |
| | + | 'supplied multiple times') |
| | + | 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, error=False, **kwargs): |
| | + | """Helper function print a string with various features""" |
| | + | |
| | + | if debug and not DEBUG: |
| | + | return |
| | + | |
| | + | if debug: |
| | + | if sys.stdout.isatty(): |
| | + | out = '\033[1;30mDEBUG: %s\033[0m' % string |
| | + | else: |
| | + | out = 'DEBUG: %s' % string |
| | + | else: |
| | + | out = string |
| | + | |
| | + | if error: |
| | + | kwargs['file'] = sys.stderr |
| | + | |
| | + | if not quiet: |
| | + | print_(out, **kwargs) |
| | + | |
| | + | |
| | + | def shell(): |
| | + | """Run the full speedtest.net test""" |
| | + | |
| | + | global DEBUG |
| | + | shutdown_event = threading.Event() |
| | + | |
| | + | signal.signal(signal.SIGINT, ctrl_c(shutdown_event)) |
| | + | |
| | + | 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(shutdown_event) |
| | + | |
| | + | 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', error=True) |
| | + | raise SpeedtestCLIError(get_exception()) |
| | + | |
| | + | if args.list: |
| | + | try: |
| | + | speedtest.get_servers() |
| | + | except (ServersRetrievalError,) + HTTP_ERRORS: |
| | + | printer('Cannot retrieve speedtest server list', error=True) |
| | + | 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: |
| | + | printer(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: |
| | + | printer('Cannot retrieve speedtest server list', error=True) |
| | + | 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) |
| | + | ) |
| | + | |
| | + | if args.server and len(args.server) == 1: |
| | + | printer('Retrieving information for the selected server...', quiet) |
| | + | else: |
| | + | 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', quiet) |
| | + | |
| | + | 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', quiet) |
| | + | |
| | + | printer('Results:\n%r' % results.dict(), debug=True) |
| | + | |
| | + | if not args.simple and args.share: |
| | + | results.share() |
| | + | |
| | + | if args.simple: |
| | + | printer('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: |
| | + | printer(results.csv(delimiter=args.csv_delimiter)) |
| | + | elif args.json: |
| | + | printer(results.json()) |
| | + | |
| | + | if args.share and not machine_format: |
| | + | printer('Share results: %s' % results.share()) |
| | + | |
| | + | |
| | + | def main(): |
| | + | try: |
| | + | shell() |
| | + | except KeyboardInterrupt: |
| | + | printer('\nCancelling...', error=True) |
| | + | except (SpeedtestException, SystemExit): |
| | + | e = get_exception() |
| | + | # Ignore a successful exit, or argparse exit |
| | + | if getattr(e, 'code', 1) not in (0, 2): |
| | + | raise SystemExit('ERROR: %s' % e) |
| | + | |
| | + | |
| | + | if __name__ == '__main__': |
| | + | main()</source> |