annotate utils/odict.py @ 0:e928e029f6eb draft

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