blob: 38f0d2631bd00d3985c1ef170d92cfc467d67ac2 [file] [log] [blame]
Guido van Rossum4acc25b2000-02-02 15:10:15 +00001"""A more or less complete user-defined wrapper around dictionary objects."""
Guido van Rossumae3b3a31993-11-30 13:43:54 +00002
Skip Montanaroe99d5ea2001-01-20 19:54:20 +00003__all__ = ["UserDict"]
4
Guido van Rossumae3b3a31993-11-30 13:43:54 +00005class UserDict:
Guido van Rossum1697b9c1999-03-26 15:31:12 +00006 def __init__(self, dict=None):
7 self.data = {}
8 if dict is not None: self.update(dict)
Guido van Rossumb94cd961997-06-03 14:10:01 +00009 def __repr__(self): return repr(self.data)
10 def __cmp__(self, dict):
Guido van Rossum1697b9c1999-03-26 15:31:12 +000011 if isinstance(dict, UserDict):
Guido van Rossum45e2fbc1998-03-26 21:13:24 +000012 return cmp(self.data, dict.data)
Guido van Rossum1697b9c1999-03-26 15:31:12 +000013 else:
14 return cmp(self.data, dict)
Guido van Rossumb94cd961997-06-03 14:10:01 +000015 def __len__(self): return len(self.data)
16 def __getitem__(self, key): return self.data[key]
17 def __setitem__(self, key, item): self.data[key] = item
18 def __delitem__(self, key): del self.data[key]
Guido van Rossum1697b9c1999-03-26 15:31:12 +000019 def clear(self): self.data.clear()
Guido van Rossumb94cd961997-06-03 14:10:01 +000020 def copy(self):
Guido van Rossum1697b9c1999-03-26 15:31:12 +000021 if self.__class__ is UserDict:
22 return UserDict(self.data)
Guido van Rossum45e2fbc1998-03-26 21:13:24 +000023 import copy
24 return copy.copy(self)
Guido van Rossumb94cd961997-06-03 14:10:01 +000025 def keys(self): return self.data.keys()
26 def items(self): return self.data.items()
27 def values(self): return self.data.values()
28 def has_key(self, key): return self.data.has_key(key)
Guido van Rossum1697b9c1999-03-26 15:31:12 +000029 def update(self, dict):
30 if isinstance(dict, UserDict):
31 self.data.update(dict.data)
32 elif isinstance(dict, type(self.data)):
33 self.data.update(dict)
Guido van Rossum45e2fbc1998-03-26 21:13:24 +000034 else:
Guido van Rossum1697b9c1999-03-26 15:31:12 +000035 for k, v in dict.items():
Guido van Rossum45e2fbc1998-03-26 21:13:24 +000036 self.data[k] = v
Barry Warsawfc3e61c1997-10-06 17:50:04 +000037 def get(self, key, failobj=None):
Guido van Rossum1697b9c1999-03-26 15:31:12 +000038 return self.data.get(key, failobj)
Guido van Rossum164452c2000-08-08 16:12:54 +000039 def setdefault(self, key, failobj=None):
40 if not self.data.has_key(key):
41 self.data[key] = failobj
42 return self.data[key]
Guido van Rossum1072c382000-12-12 22:06:00 +000043 def popitem(self):
44 return self.data.popitem()