blob: 348ea76cdba632da9a25d4721bdff732235a5bd0 [file] [log] [blame]
Guido van Rossum4acc25b2000-02-02 15:10:15 +00001"""A more or less complete user-defined wrapper around list objects."""
Guido van Rossumae3b3a31993-11-30 13:43:54 +00002
Raymond Hettingerb8b6d3e2008-02-06 20:59:41 +00003import collections
4
5class UserList(collections.MutableSequence):
Jeremy Hylton6a973c72000-03-31 00:17:46 +00006 def __init__(self, initlist=None):
Guido van Rossum2a340b31999-03-26 16:20:18 +00007 self.data = []
Jeremy Hylton6a973c72000-03-31 00:17:46 +00008 if initlist is not None:
Thomas Wouters7e474022000-07-16 12:04:32 +00009 # XXX should this accept an arbitrary sequence?
Jeremy Hylton6a973c72000-03-31 00:17:46 +000010 if type(initlist) == type(self.data):
11 self.data[:] = initlist
12 elif isinstance(initlist, UserList):
13 self.data[:] = initlist.data[:]
Guido van Rossum2a340b31999-03-26 16:20:18 +000014 else:
Jeremy Hylton6a973c72000-03-31 00:17:46 +000015 self.data = list(initlist)
Guido van Rossum2a340b31999-03-26 16:20:18 +000016 def __repr__(self): return repr(self.data)
Guido van Rossum753a68e2001-01-18 16:09:55 +000017 def __lt__(self, other): return self.data < self.__cast(other)
18 def __le__(self, other): return self.data <= self.__cast(other)
19 def __eq__(self, other): return self.data == self.__cast(other)
20 def __ne__(self, other): return self.data != self.__cast(other)
21 def __gt__(self, other): return self.data > self.__cast(other)
22 def __ge__(self, other): return self.data >= self.__cast(other)
23 def __cast(self, other):
24 if isinstance(other, UserList): return other.data
25 else: return other
Guido van Rossum2a340b31999-03-26 16:20:18 +000026 def __cmp__(self, other):
Martin v. Löwis0163d6d2001-06-09 07:34:05 +000027 return cmp(self.data, self.__cast(other))
Tim Peters7b393fc2000-09-19 20:29:03 +000028 def __contains__(self, item): return item in self.data
Guido van Rossum2a340b31999-03-26 16:20:18 +000029 def __len__(self): return len(self.data)
30 def __getitem__(self, i): return self.data[i]
31 def __setitem__(self, i, item): self.data[i] = item
32 def __delitem__(self, i): del self.data[i]
Guido van Rossum2a340b31999-03-26 16:20:18 +000033 def __add__(self, other):
34 if isinstance(other, UserList):
35 return self.__class__(self.data + other.data)
36 elif isinstance(other, type(self.data)):
37 return self.__class__(self.data + other)
38 else:
39 return self.__class__(self.data + list(other))
40 def __radd__(self, other):
41 if isinstance(other, UserList):
42 return self.__class__(other.data + self.data)
43 elif isinstance(other, type(self.data)):
44 return self.__class__(other + self.data)
45 else:
46 return self.__class__(list(other) + self.data)
Thomas Wouters104a7bc2000-08-24 20:14:10 +000047 def __iadd__(self, other):
48 if isinstance(other, UserList):
49 self.data += other.data
50 elif isinstance(other, type(self.data)):
51 self.data += other
52 else:
53 self.data += list(other)
54 return self
Guido van Rossum2a340b31999-03-26 16:20:18 +000055 def __mul__(self, n):
56 return self.__class__(self.data*n)
57 __rmul__ = __mul__
Thomas Wouters104a7bc2000-08-24 20:14:10 +000058 def __imul__(self, n):
59 self.data *= n
60 return self
Guido van Rossum2a340b31999-03-26 16:20:18 +000061 def append(self, item): self.data.append(item)
62 def insert(self, i, item): self.data.insert(i, item)
63 def pop(self, i=-1): return self.data.pop(i)
64 def remove(self, item): self.data.remove(item)
65 def count(self, item): return self.data.count(item)
Raymond Hettingerd05abde2003-06-17 05:05:49 +000066 def index(self, item, *args): return self.data.index(item, *args)
Guido van Rossum2a340b31999-03-26 16:20:18 +000067 def reverse(self): self.data.reverse()
Raymond Hettinger6b59f5f2003-10-16 05:53:16 +000068 def sort(self, *args, **kwds): self.data.sort(*args, **kwds)
Guido van Rossum2a340b31999-03-26 16:20:18 +000069 def extend(self, other):
70 if isinstance(other, UserList):
71 self.data.extend(other.data)
72 else:
73 self.data.extend(other)
Raymond Hettingerb8b6d3e2008-02-06 20:59:41 +000074
75collections.MutableSequence.register(UserList)