annotate utils/odict.py @ 0:d4d33e26deef

Imported from capsule None
author devteam
date Tue, 01 Apr 2014 09:13:16 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
1 """
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
2 Ordered dictionary implementation.
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
3 """
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
4
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
5 from UserDict import UserDict
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
6
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
7 class odict(UserDict):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
8 """
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
9 http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/107747
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
10
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
11 This dictionary class extends UserDict to record the order in which items are
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
12 added. Calling keys(), values(), items(), etc. will return results in this
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
13 order.
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
14 """
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
15 def __init__( self, dict = None ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
16 self._keys = []
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
17 UserDict.__init__( self, dict )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
18
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
19 def __delitem__( self, key ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
20 UserDict.__delitem__( self, key )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
21 self._keys.remove( key )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
22
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
23 def __setitem__( self, key, item ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
24 UserDict.__setitem__( self, key, item )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
25 if key not in self._keys:
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
26 self._keys.append( key )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
27
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
28 def clear( self ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
29 UserDict.clear( self )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
30 self._keys = []
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
31
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
32 def copy(self):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
33 new = odict()
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
34 new.update( self )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
35 return new
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
36
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
37 def items( self ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
38 return zip( self._keys, self.values() )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
39
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
40 def keys( self ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
41 return self._keys[:]
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
42
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
43 def popitem( self ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
44 try:
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
45 key = self._keys[-1]
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
46 except IndexError:
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
47 raise KeyError( 'dictionary is empty' )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
48 val = self[ key ]
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
49 del self[ key ]
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
50 return ( key, val )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
51
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
52 def setdefault( self, key, failobj=None ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
53 if key not in self._keys:
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
54 self._keys.append( key )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
55 return UserDict.setdefault( self, key, failobj )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
56
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
57 def update( self, dict ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
58 for ( key, val ) in dict.items():
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
59 self.__setitem__( key, val )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
60
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
61 def values( self ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
62 return map( self.get, self._keys )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
63
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
64 def iterkeys( self ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
65 return iter( self._keys )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
66
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
67 def itervalues( self ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
68 for key in self._keys:
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
69 yield self.get( key )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
70
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
71 def iteritems( self ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
72 for key in self._keys:
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
73 yield key, self.get( key )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
74
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
75 def __iter__( self ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
76 for key in self._keys:
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
77 yield key
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
78
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
79 def reverse( self ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
80 self._keys.reverse()
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
81
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
82 def insert( self, index, key, item ):
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
83 if key not in self._keys:
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
84 self._keys.insert( index, key )
d4d33e26deef Imported from capsule None
devteam
parents:
diff changeset
85 UserDict.__setitem__( self, key, item )