tools/telemetry/third_party/webpagereplay/net_configs.py

   1 #!/usr/bin/env python
   2 # Copyright 2013 Google Inc. All Rights Reserved.
   3 #
   4 # Licensed under the Apache License, Version 2.0 (the "License");
   5 # you may not use this file except in compliance with the License.
   6 # You may obtain a copy of the License at
   7 #
   8 #      http://www.apache.org/licenses/LICENSE-2.0
   9 #
  10 # Unless required by applicable law or agreed to in writing, software
  11 # distributed under the License is distributed on an "AS IS" BASIS,
  12 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 # See the License for the specific language governing permissions and
  14 # limitations under the License.
  15
  16 """Defines a list of common network speeds.
  17
  18 These values come from http://www.webpagetest.org/
  19
  20 See:
  21 https://sites.google.com/a/webpagetest.org/docs/other-resources/2011-fcc-broadband-data
  22 https://github.com/WPO-Foundation/webpagetest/blob/HEAD/www/settings/connectivity.ini.sample
  23 """
  24
  25 import collections
  26
  27
  28 NetConfig = collections.namedtuple('NetConfig', ['down', 'up', 'delay_ms'])
  29
  30
  31 # pylint: disable=bad-whitespace
  32 _NET_CONFIGS = {
  33     'dialup': NetConfig(down=   '49Kbit/s', up=  '30Kbit/s', delay_ms= '120'),
  34     '3g':     NetConfig(down= '1638Kbit/s', up= '768Kbit/s', delay_ms= '150'),
  35     'dsl':    NetConfig(down= '1536Kbit/s', up= '384Kbit/s', delay_ms=  '50'),
  36     'cable':  NetConfig(down=    '5Mbit/s', up=   '1Mbit/s', delay_ms=  '28'),
  37     'fios':   NetConfig(down=   '20Mbit/s', up=   '5Mbit/s', delay_ms=   '4'),
  38     }
  39
  40
  41 NET_CONFIG_NAMES = _NET_CONFIGS.keys()
  42
  43
  44 def GetNetConfig(key):
  45   """Returns the NetConfig object corresponding to the given |key|."""
  46   if key not in _NET_CONFIGS:
  47     raise KeyError('No net config with key: %s' % key)
  48   return _NET_CONFIGS[key]