1  """ 
 2  Provides general-purpose utilities. 
 3   
 4  @sort: FirstClass, _SecondClass, method2, methodOne, CONSTANT_ONE, CONSTANT_TWO 
 5   
 6  @var CONSTANT_ONE: The first constant 
 7  @var CONSTANT_TWO: The second constant 
 8   
 9  @author: Kenneth J. Pronovici <pronovic@ieee.org> 
10  """ 
11   
12  CONSTANT_ONE       = "one" 
13  CONSTANT_TWO       = "two" 
14   
16   
17     """ 
18     Special list class. 
19   
20     This is a special class that extends list. 
21   
22     It has some special behavior that users will find really interesting. 
23     Or, it would if I had remembered to implement that. 
24     """ 
25   
27        """ 
28        Definition of C{==} operator for this class. 
29        @param other: Other object to compare to. 
30        @return: True/false depending on whether C{other is None} 
31        """ 
32        if other is None: 
33           return False 
34        else: 
35           return True 
  36   
38   
39     """ 
40     Represents something else that I forgot just now. 
41     """ 
42   
44        """ 
45        Constructor. 
46        @param name: Name of this instance 
47        """ 
48        self.name = name 
49        self.state = None 
  50   
52     """ 
53     Returns the keys of the dictionary sorted by value. 
54   
55     There are cuter ways to do this in Python 2.4, but we were originally 
56     attempting to stay compatible with Python 2.3. 
57   
58     @param d: Dictionary to operate on 
59     @return: List of dictionary keys sorted in order by dictionary value. 
60     """ 
61     items = d.items() 
62     items.sort(lambda x, y: cmp(x[1], y[1])) 
63     return [key for key, value in items] 
 64   
66     """ 
67     Removes all of the keys from the dictionary. 
68     The dictionary is altered in-place. 
69     Each key must exist in the dictionary. 
70     @param d: Dictionary to operate on 
71     @param keys: List of keys to remove 
72     @raise KeyError: If one of the keys does not exist 
73     """ 
74     for key in keys: 
75        del d[key] 
 76