API Reference for Enthought Tool Suite 3.0.1

Function summary

• dict_zip(*dicts)
• filter_items(p, d)
• filter_keys(p, d)
• filter_values(p, d)
• map_items(f, d)
• map_keys(f, d)
• map_values(f, d)
• sub_dict(d, keys)

Functions

• dict_zip(*dicts)

  Zip dictionaries.

  >>> dict_zip(dict(a=True), dict(a='foo'))
  {'a': (True, 'foo')}
  >>> dict_zip(dict(a=0, b=2), dict(a=1, c=3), dict(a=None, c=4))
  {'a': (0, 1, None)}
  >>> dict_zip(dict(a=0), dict(b=1, c=2, d=3))
  {}
  

• filter_items(p, d)

  Filter a dictionary by a predicate on key-value pairs.

  >>> import operator
  >>> filter_items(operator.le, {0: 0, 1: 2, 3: 2}) == {0: 0, 1: 2}
  True
  

• filter_keys(p, d)

  Filter a dictionary by a predicate on keys.

  >>> filter_keys(lambda n: n % 2, {0: 1, 1: 2, 2: 3}) == {1: 2}
  True
  

• filter_values(p, d)

  Filter a dictionary by a predicate on values.

  >>> filter_values(lambda n: n % 2, {0: 1, 1: 2, 2: 3}) == {0: 1, 2: 3}
  True
  

• map_items(f, d)

  Map a binary function over the key-value pairs in a dictionary.

  >>> map_items(lambda a,b: (a*2, b**2), {1: 2, 3: 4}) == {2: 4, 6: 16}
  True
  

• map_keys(f, d)

  Map a function over the keys in a dictionary.

  >>> map_keys(str, {1: 2, 3: 4}) == {'1': 2, '3': 4}
  True
  >>> map_keys(lambda x: 0, {1: 2, 3: 4}) in [{0: 2}, {0: 4}]
  True
  

• map_values(f, d)

  Map a function over the values in a dictionary.

  >>> map_values(str, {1: 2, 3: 4}) == {1: '2', 3: '4'}
  True
  >>> map_values(lambda x: 0, {1: 2, 3: 4}) == {1: 0, 3: 0}
  True
  

• sub_dict(d, keys)

  Create a dictionary from a subset of another.

  >>> sub_dict({1: 2, 3: 4, 'a': 'b'}, [1, 3]) == {1: 2, 3: 4}
  True
  

  >>> try:
  ...     sub_dict({1: 2}, [1, 3])
  ...     assert False
  ... except KeyError:
  ...     print 'Key error!'
  Key error!
  

Imported Names

© Copyright 2002-2008 Enthought, Inc.