annotate utils/odict.py @ 1:d9f0a11824e9

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