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
18These values come from http://www.webpagetest.org/
19
20See:
21https://sites.google.com/a/webpagetest.org/docs/other-resources/2011-fcc-broadband-data
22https://github.com/WPO-Foundation/webpagetest/blob/HEAD/www/settings/connectivity.ini.sample
23"""
24
25import collections
26
27
28NetConfig = 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
41NET_CONFIG_NAMES = _NET_CONFIGS.keys()
42
43
44def 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]
49